For AI agents: the docs index is at https://docs.here.com/location-reasoning/llms.txt. The index for every project on this site is at https://docs.here.com/llms.txt. Append .md to any documentation page URL to get its markdown version.
This topic summarizes the available HERE Location Reasoning tool categories and capabilities.
Use the MCP tools/list method to retrieve the enabled tools and their complete input and output schemas. Treat its response as the authoritative source for tool availability, supported parameters, required fields, and response formats.
Tools by task
The following table sorts the HERE Location Reasoning tools by task.
Task
Tool
Convert a concrete street or postal address to coordinates
geocode
Convert coordinates to an address or place name
reverse-geocode
Calculate a route between an origin and destination
calculate-route
Import a route from a polyline trace
get-route-from-polyline
Plan a public-transit journey
public-transit-route
Find regular stops along a calculated route
find-route-stops
Calculate travel time and distance for multiple origin and destination pairs
matrix-routing
Find places, cities, countries, categories, or brands, optionally within an area
discover
Find places near other places or a mapped feature (experimental)
find-places-near
Find places far from other places or a mapped feature (experimental)
find-places-far-from
Retrieve real-time traffic flow
real-time-traffic
Calculate an area reachable from an origin or toward a destination
isoline-route
Render an interactive map from inline GeoJSON or cached route, traffic, or isoline IDs
data-visualization
Reuse cached IDs
Some tools return cached IDs. Pass these IDs to follow-up tools to avoid recalculating the same route or geometry.
Converts a concrete street or postal address to geographic coordinates and detailed address information.
reverse-geocode
Converts latitude and longitude coordinates to an address or place name.
Routing
Tool
Description
calculate-route
Calculates an optimized route between an origin and destination, including distance, duration, navigation instructions, and a cached route ID for follow-up tools.
find-route-stops
Finds stop locations along a cached route at regular time or distance intervals by using stored route spans and polylines.
matrix-routing
Calculates travel-time and distance matrices between multiple origins and destinations.
Public Transit
Tool
Description
public-transit-route
Plans scheduled public-transit itineraries between two points and returns a cached public-transit route ID for follow-up map rendering.
Route import
Tool
Description
get-route-from-polyline
Imports a caller-supplied HERE flexpolyline or Google polyline into a cached route via HERE Route Import. This is useful when you already have GPS trace data and want to reconstruct the route geometry.
Search and discovery
Tool
Description
discover
Primary place-search tool. Searches globally by natural-language query when area is omitted, or restricts results to a supplied area or route.
Traffic
Tool
Description
real-time-traffic
Retrieves real-time traffic flow data for a circle, bounding box, corridor, segment reference, or cached route corridor.
Isolines
Tool
Description
isoline-route
Calculates reachable isoline polygons from an origin or toward a destination and returns a cached isoline ID for follow-up tools.
Map rendering
Tool
Description
data-visualization
Renders an interactive map from inline GeoJSON or cached route, traffic, or isoline IDs.
Experimental
📘
Important
Experimental tools are under active development. Their inputs, outputs, and behavior can change without notice, and they might be changed or removed in a future release.
Resources are exposed to provide optional dictionaries for those tools categories://here-places and spatials://here-lg.
Resources are optional and tools can be used without them.
Tool
Description
find-places-near
Finds places of one category near places of another category or near a mapped feature, for example coffee shops near EV charging or cafes inside a park.
find-places-far-from
Finds places of one category kept at least a given distance from places of other categories or from mapped features, for example hotels far from airports. Bounding-box areas only.
Request optional response fields
calculate-route and get-route-from-polyline accept a return array that adds optional fields on top of the route id and sections that every response includes. Request only the fields you need, because some are expensive to compute. When you omit return, it defaults to ["summary"].
Total distance and travel time for the route. Included by default.
instructions
Turn-by-turn maneuver text. Request this most expensive field only when you need the written guidance.
turnByTurnActions
Structured per-maneuver actions to build your own navigation UI.
tolls
Toll fares and their cost along the route.
elevation
Elevation values along the route geometry.
routeHandle
An opaque route handle token that encodes the route. Pass it to the HERE SDK or HERE Routing API to rebuild the same route without recalculating it. Use this token to hand off a route computed by HERE Location Reasoning to a HERE SDK app.
Retrieve current tool schemas
After you establish an MCP session, send a tools/list request with the HTTP header Authorization: Bearer <HERE_ACCESS_TOKEN>. For information about creating an access token, see Connect with OAuth credentials.