| name | here |
| description | HERE is a location data and mapping platform that provides APIs for maps, geocoding, routing, traffic, and fleet optimization, allowing developers and enterprises to build navigation, logistics, and geospatial applications with real-time location intelligence. Read and write Here data through One: subscriptions, openapispecification, version, features, health, problems and more, 224 actions with real parameter documentation. Use whenever the user asks to look something up in Here, create or update a record there, or build code against the Here API. |
Here through One
HERE is a location data and mapping platform that provides APIs for maps, geocoding, routing, traffic, and fleet optimization, allowing developers and enterprises to build navigation, logistics, and geospatial applications with real-time location intelligence.
One exposes Here through four MCP tools. The table below carries real action ids from One's knowledge base, so for a common operation you can skip search and go straight to reading the action's parameters.
How to run an action
- Find the action in the table below, or call
search_one_platform_actions with platform here if it is not listed.
- Call
get_one_action_knowledge with the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters.
- Call
execute_one_action with parameters copied from that knowledge.
Never guess a parameter name, a body field, or an enum value. The knowledge has the real schema, and a guessed field is either a 400 or a silent write of the wrong thing.
Before you start
Call list_one_integrations once and confirm Here is connected. If it is missing, the user has not connected it: say so and point them at https://app.withone.ai rather than reaching for raw HTTP.
Each connection carries an access field. If it reports {"policy": "methods", "methods": ["GET"]} the agent is read-only here, so plan a read-only answer instead of attempting a write that will be refused.
Before a write
Creates, updates, deletes and sends land on a real Here account and cannot be recalled. State the action and the specific target in one line before the first write in a task, and let the user stop you. Reads need no confirmation.
Actions
Subscriptions
| Action | Method | Path | Action id |
|---|
| Get Active Subscriptions | GET | /user-service/subscriptions | conn_mod_def::GL3RNN7JcJk::8OrE85zXR7mIWUtiv_QOcw |
| Get Subscription Details by Subscription Key | GET | /user-service/subscriptions/keys/{{subscriptionKey}} | conn_mod_def::GL3RNNxaMHk::V2eA0PcTRiSl6DLeImRezw |
| Add a Feature Group to a Subscription | POST | /user-service/subscriptions/keys/{{subscriptionKey}}/featureGroups/names/{{featureGroupName}} | conn_mod_def::GL3RNEL4ANU::C_cQixVITD6u38f4qADoyg |
| Add Feature Group to Subscription | POST | /user-service/subscriptions/keys/{{subscriptionKey}}/featureGroups/{{featureGroupId}} | conn_mod_def::GL3RM5dv5mQ::3rt7C8knTFyHxi993jSuQw |
| Create Subscription Keys | POST | /user-service/subscriptions | conn_mod_def::GL3RNELa1Wc::A9eN2HozSKqmAprH1iHaHQ |
| Deactivate Subscription | POST | /user-service/subscriptions/deactivate | conn_mod_def::GL3RNEwsFH0::uG6Mllm9Qd2pmd9Uvk9JsQ |
| Deactivate Subscription Devices | POST | /user-service/subscriptions/keys/{{subscriptionKey}}/deactivate | conn_mod_def::GL3RNEHsB4A::guH3n3p3QUOhsp2dvU2ZAA |
| Delete Associated Devices for a Subscription | DELETE | /user-service/subscriptions/devices | conn_mod_def::GL3RNDuwSwQ::ek096dycQqiBbCvd-4AJzw |
| Remove a Feature Group from a Subscription | DELETE | /user-service/subscriptions/{{subscriptionId}}/featureGroups/{{featureGroupId}} | conn_mod_def::GL3RNOILPRs::ISSID7tDSZWAPy6UBi04AQ |
| Remove a Feature Group from a Subscription | DELETE | /user-service/subscriptions/keys/{{subscriptionKey}}/featureGroups/{{featureGroupId}} | conn_mod_def::GL3RNTFdIao::57KG2J6nRrq7LDeHYqg82Q |
1 more Subscriptions actions are available through search.
OpenApiSpecification
| Action | Method | Path | Action id |
|---|
| Get OpenAPI Specification | GET | /v2/openapi | conn_mod_def::GL3RF9UowVw::1tCllWPpRYCyq_UYC6OjTw |
| Get OpenAPI Specification | GET | /v8/openapi | conn_mod_def::GL3RGHABJN4::kp5Hx1E0RpKPXWDBFR4GaA |
| Get OpenAPI Specification | GET | /v8/openapi | conn_mod_def::GL3RGNHeXpk::6Aa9Vf5JR2upxmFMutDaqQ |
| Get OpenAPI Specification | GET | /v3/openapi | conn_mod_def::GL3RGPSieYg::DV9-Sf8LSeypm5E5O30dPg |
| Get OpenAPI Specification | GET | /v1/openapi | conn_mod_def::GL3RGPkEfnA::4NEW4BFuQnqAR9h4g9dSVA |
| Get OpenAPI Specification | GET | /v3/openapi | conn_mod_def::GL3RGzGhD6I::Uhz7mhhKQau9foCgfz5mvg |
| Get OpenAPI Specification | GET | /v3/openapi | conn_mod_def::GL3RGz_CzmA::9jwpDiyxRVmhboS0GjqLyQ |
| Get OpenAPI Specification | GET | /v8/openapi | conn_mod_def::GL3RG0D7s54::RKZOHIA0SZi5Jqvv2YWn0A |
| Retrieve OpenAPI Specification | GET | /v8/openapi | conn_mod_def::GL3RGOO9VsY::mPys45LSTRmlvDh6cam2MQ |
| Retrieve OpenAPI Specification | GET | /v8/openapi | conn_mod_def::GL3RGUxV7y8::iBi87tGXRl627P56fwdkSw |
| Retrieve the OpenAPI Specification | GET | /v7/openapi | conn_mod_def::GL3RGE4Bur0::bB1psLuwRsCnCW4YT_0aEA |
Version
| Action | Method | Path | Action id |
|---|
| Get API Version | GET | /v1/version | conn_mod_def::GL3RGbcQgYQ::dbm5FfERQbi7oopjT-Ebiw |
| Get Version | GET | /v8/version | conn_mod_def::GL3RFQ7YzhA::hv3SJUSlSxe_2-j3sK5qYg |
| Get Version | GET | /v8/version | conn_mod_def::GL3RFu6vWvo::-zcAY2rxQQa4nNpcBBZIpw |
| Get Version | GET | /v3/version | conn_mod_def::GL3RG7ocenA::cXMTZr3fRCSTZFvf2qWpFg |
| Get Version | GET | /v8/version | conn_mod_def::GL3RG8kyXiw::D3V2-ka1Rv2hsLgm6-ZIcA |
| Get Version | GET | /v3/version | conn_mod_def::GL3RNZw8MSs::o7qAbpqDQRCtSAoKM8MUjg |
| Get Version Using Intermodal Router v8 | GET | /v8/version | conn_mod_def::GL3RG91DXhI::ACXz1NGXQl6g1L38T-nkOw |
| Get Version Using Isoline Router v8 | GET | /v8/version | conn_mod_def::GL3RFTK7Ips::Bxl1q7BjRECx2KqlSQzu_A |
| Version | GET | /v3/version | conn_mod_def::GL3RG8FkOaw::NkDtAbTDQ1KTJ7t_nB-HOg |
| Version Using Mia v3 | GET | /mia/v3/version | conn_mod_def::GL3RGE1KyUI::__V-S_bSTzaFO4qsGJRFww |
Features
| Action | Method | Path | Action id |
|---|
| Get a Feature by ID from a Layer | GET | /interactive/v1/catalogs/{{catalogHrn}}/layers/{{layerId}}/features/{{featureId}} | conn_mod_def::GL3RLuDWZyk::g8daglElRAaXefnqOLZfLQ |
| Get Features | GET | /mia/v3/features | conn_mod_def::GL3RLN8yjrk::_f04DFjdRsqUsRZPOZf6HQ |
| Get Features by ID for a Layer | GET | /interactive/v1/catalogs/{{catalogHrn}}/layers/{{layerId}}/features | conn_mod_def::GL3RL5_O5Dk::LOgoyzTVTZqtG26yzMMYqg |
| Get Features Using Maps v3 | GET | /v3/features | conn_mod_def::GL3RLbhCrjA::DmnWJj5bSWmRdGllFPHnPg |
| Iterate Features in a Layer | GET | /interactive/v1/catalogs/{{catalogHrn}}/layers/{{layerId}}/iterate | conn_mod_def::GL3RMCNlm2Y::baQC9qs0TwqDFZzfvPwqMQ |
| Search for Features in a Catalog Layer | GET | /interactive/v1/catalogs/{{catalogHrn}}/layers/{{layerId}}/search | conn_mod_def::GL3RMCCLp84::5_74HTCLQkGQXW5Ez3463g |
| Create or Replace Multiple Features in a Layer | PUT | /interactive/v1/catalogs/{{catalogHrn}}/layers/{{layerId}}/features | conn_mod_def::GL3RNtpzBak::w0KZg6ZZRkyCBkz5PiCVzw |
| Delete Multiple Features from a Layer | DELETE | /interactive/v1/catalogs/{{catalogHrn}}/layers/{{layerId}}/features | conn_mod_def::GL3RN-chIjM::RHNN6UBOTxiJfBcUhl-yFw |
| Modify Features in a Layer | POST | /interactive/v1/catalogs/{{catalogHrn}}/layers/{{layerId}}/features | conn_mod_def::GL3RN6pI3Pk::H8fE8cFyTIiMAqpTnhr9PA |
| Spatial Search Features in a Layer | POST | /interactive/v1/catalogs/{{catalogHrn}}/layers/{{layerId}}/spatial | conn_mod_def::GL3RL48G2gs::XUdpCe5YTnOYDduupJuyoA |
Health
| Action | Method | Path | Action id |
|---|
| Get Health | GET | /v8/health | conn_mod_def::GL3RF1mTyys::5oKy08TkTMuDizoVb6FzkA |
| Get Health | GET | /mia/v3/health | conn_mod_def::GL3RGqsf1HQ::MBPPf-3SSMqsudcqduOLFA |
| Get Health | GET | /v1/health | conn_mod_def::GL3RGswEslU::dAQKPmWBRgCmbvjsfi5GZA |
| Get Health | GET | /v3/health | conn_mod_def::GL3RGy5iHmE::GYxTstZTRQeiJ7QnS2TPEA |
| Get Health | GET | /v7/health | conn_mod_def::GL3RG2D0yG0::LkFtxMI9T2qAFX9oSw8HGA |
| Get Health | GET | /v3/health | conn_mod_def::GL3RNiCIc0I::dQ1OBATDQ4aq_syNX5ZS_g |
| Health | GET | /v3/health | conn_mod_def::GL3RF2rWZT8::ZLtEqs51TiCBr0aZPt0R3w |
| Health Using V2 | GET | /v2/health | conn_mod_def::GL3RG7xHXb8::heORHiJ8Twe5sHNqrp0dzg |
Problems
| Action | Method | Path | Action id |
|---|
| Get Solution for a Problem | GET | /v3/problems/{{problemId}}/solution | conn_mod_def::GL3RHEGvuCk::eczn2yg7TEm399BRkeyCOg |
| Cancel a Problem | PUT | /v3/problems/{{problemId}}/cancel | conn_mod_def::GL3RHEUpmoQ::GIsz3qN5StelVMD-63HjEA |
| Cancel a Problem | OPTIONS | /v3/problems/{{problemId}}/cancel | conn_mod_def::GL3RIPTVU9A::nik8hMyKQ2qik_HaoRjo8A |
| CORS Support for Problems | OPTIONS | /v3/problems | conn_mod_def::GL3RIJYwZA4::udTH3J7AToGfGR1jt7q4bQ |
| Enable CORS for a Problem Solution | OPTIONS | /v3/problems/{{problemId}}/solution | conn_mod_def::GL3RIQhucSA::h7qkbs5XQ8u1sFuPOxQG0w |
| Solve Vehicle Routing Problems Synchronously | POST | /v3/problems | conn_mod_def::GL3RNZthSM4::cRgNvbeqSJez9etUaNy_rA |
| Submit Problem Async Using Problems | POST | /v3/problems/async | conn_mod_def::GL3RHEVxfPY::1sdlZfdeR02IEe7HUb-68g |
BatchJobs
| Action | Method | Path | Action id |
|---|
| Get a Batch Job | GET | /v7/batch/jobs/{{jobId}} | conn_mod_def::GL3RHsFkDzo::lsbF7psvQyecFYoz5tFG_Q |
| Get Results for a Batch Job | GET | /v7/batch/jobs/{{jobId}}/results | conn_mod_def::GL3RHtnTMMQ::jm4AVXGjRdaaZTuSl2K64Q |
| List Batch Jobs | GET | /v7/batch/jobs | conn_mod_def::GL3RHs2qW0I::eKKCRfLXTtWYkNn0sXcUTA |
| Create Job Using Batch Search v7 | POST | /v7/batch/jobs | conn_mod_def::GL3RHlZ9n1U::DTJrJ7MqRluW9A6c4UeYSg |
| Delete a Batch Job | DELETE | /v7/batch/jobs/{{jobId}} | conn_mod_def::GL3RHguTIPQ::pyM01g4ATkSIwn1GPGcqKw |
| Start a Batch Job | PUT | /v7/batch/jobs/{{jobId}}/start | conn_mod_def::GL3RHw-0Mak::B7lUZ2mOSU2QwbmquR-hiA |
| Stop a Batch Job | PUT | /v7/batch/jobs/{{jobId}}/stop | conn_mod_def::GL3RH3oXzOU::UoRpj8aBSTynUNBcf5_izw |
Routes
| Action | Method | Path | Action id |
|---|
| Calculate Indoor Routes | GET | /v1/routes | conn_mod_def::GL3RJdQ1-DI::eiYthAycRNCzwOb-CF9Pxw |
| Calculate Routes | GET | /v8/routes | conn_mod_def::GL3RMcdBXN4::F2vmz7-_QXatpFCItSP9ZA |
| Get Route by Handle | GET | /v8/routes/{{routeHandle}} | conn_mod_def::GL3RMxXwomQ::KuctAIL6Tx2cD-hYy3ylYA |
| Calculate Routes | POST | /v8/routes | conn_mod_def::GL3RMxtifa8::K5UQvBETQOW8xTMuvVRSNw |
| Get Route by Handle Using Routes | POST | /v8/routes/{{routeHandle}} | conn_mod_def::GL3RM9aG7nk::4ZKnkc6LTyOjIGixNCzIqA |
| Import Route | POST | /v8/import | conn_mod_def::GL3RMbHZUIM::pw5_wKtwRi-DYGOg_O60fQ |
Notifications
| Action | Method | Path | Action id |
|---|
| Get a Notification | GET | /v7/batch/notifications/{{notificationId}} | conn_mod_def::GL3RH3qEGs8::ZVXS7iy0SuKU6gXkkSwGyA |
| Get All Notifications | GET | /v7/batch/notifications | conn_mod_def::GL3RH3ziOxA::Lt60xluQRmmXG9sh2Hk_wQ |
| Test a Notification | GET | /v7/batch/notifications/{{notificationId}}/test | conn_mod_def::GL3RH-yFPoY::hK9QkhjqST6p46eFM_zjMA |
| Create a New Notification | POST | /v7/batch/notifications | conn_mod_def::GL3RH4S1r5w::rym3ZzMARIaRIgJbvLAZPQ |
| Delete a Notification | DELETE | /v7/batch/notifications/{{notificationId}} | conn_mod_def::GL3RH3t1kk0::aoIJTkggTqS7Fmqk_ttmjw |
HealthStatus
| Action | Method | Path | Action id |
|---|
| Get Health Status | GET | /v3/health | conn_mod_def::GL3RF02P6ok::0Ipk1QrHQfOW9-5NEyh02w |
| Get Health Status | GET | /v8/health | conn_mod_def::GL3RF1VOSCI::DW8vO41IRUuCc5Kskr_gaQ |
| Get Health Status | GET | /v8/health | conn_mod_def::GL3RF8h-jfg::N-bhgZdIQ1O8YsOOxOiiUA |
| Get Health Status | GET | /v8/health | conn_mod_def::GL3RF-Yovpg::cgbOo7fDSXqQ8JgjjPdKEQ |
VersionInformation
| Action | Method | Path | Action id |
|---|
| Get Version Information | GET | /v3/version | conn_mod_def::GL3RF8bIAKc::AiGv9QYSQ0y2K3REe_hgIQ |
| Get Version Information | GET | /v7/version | conn_mod_def::GL3RGE3Fdjg::3rb1rp1BQg-BPj6jfc23ZQ |
| Get Version Information | GET | /v3/version | conn_mod_def::GL3RGGLX_Mk::mfvRb2OKRguvC0E7WXtuiA |
| Get Version Information | GET | /v2/version | conn_mod_def::GL3RGo_4API::bZ32RSW6SOWh19X-8GhkSQ |
FuelStations
| Action | Method | Path | Action id |
|---|
| Bulk Retrieve Fuel Stations | GET | /v3/stations/bulk | conn_mod_def::GL3RIhf5GK4::kaCPAQEvTrCvFceoppXDNA |
| Count Fuel Stations | GET | /v3/stations/count | conn_mod_def::GL3RIXNkKIs::kyAsROSETvimRRDQkEgtaA |
| Get a Fuel Station by ID | GET | /v3/stations/{{id}} | conn_mod_def::GL3RIXVwb7c::F3wtjUF8SlCFxUt6k-a5Cg |
| Search Fuel Stations | GET | /v3/stations | conn_mod_def::GL3RIZnMwT4::pUT-A8XCQpOkh5ZnkmjOoA |
LayerFeatures
| Action | Method | Path | Action id |
|---|
| Spatial Radius Search for Layer Features | GET | /interactive/v1/catalogs/{{catalogHrn}}/layers/{{layerId}}/spatial | conn_mod_def::GL3RL5Tflfg::kDr_8hTqSYqAqE5mVQEi6A |
| Create or Replace a Layer Feature | PUT | /interactive/v1/catalogs/{{catalogHrn}}/layers/{{layerId}}/features/{{featureId}} | conn_mod_def::GL3RNvddZGE::W0mr11gQQBmpj_JSk5WiKg |
2 more LayerFeatures actions are available through search.
This lists 90 of 224 actions. For anything not here, call search_one_platform_actions with platform here. The full catalog is at https://www.withone.ai/knowledge/here.
When a call fails
The error comes from Here, not from One. A 400 or 422 means your parameters do not match the schema, so re-read the knowledge and fix the field. A 401 or 403 means the connection needs re-authorizing, which no retry will fix. A 404 means the id is not on this account. A 429 means slow down. Never retry a write more than once: the first attempt may have landed.
Full catalog: https://www.withone.ai/knowledge/here
Integration knowledge by One (withone.ai), licensed under One-Knowledge-1.0. Attribution must be preserved in derivative works.