HERE Location Reasoning tools reference

Beta availability
HERE Location Reasoning is currently available to beta participants. For information about joining the beta, visit HERE Location Reasoning.

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 an address or place name 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 of interest in an area or along a route	`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	`traffic-flow`
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.

Tool that returns an ID	Cached ID	Follow-up tools that use the ID
`calculate-route`	Route ID	`find-route-stops`, `traffic-flow`, `data-visualization`
`get-route-from-polyline`	Route ID	`find-route-stops`, `traffic-flow`, `data-visualization`
`public-transit-route`	Public-transit route ID	`data-visualization`
`isoline-route`	Isoline ID	`data-visualization`

Available tools

Geocoding

Tool	Description
`geocode`	Converts an address or place name 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. Availability is limited by the deployment's `MATRIX_ROUTING_TIER`.

Matrix routing tiers

The MATRIX_ROUTING_TIER of the deployment determines the matrix-routing limits:

Tier	Limits
`base` (default)	Profile mode only. `profile` and `regionDefinition: {"type":"world"}` are required. `transportMode`, `routingMode`, `departureTime`, and `arrivalTime` are rejected. Supports matrices up to 100 x 100.
`premium`	Supports the full HERE Matrix limits: flexible mode (15 x 100 or 100 x 1), region mode (500 x 500), and profile mode (500 x 500, 2,000 x 1, or 1 x 2,000).

The tools/list response reflects the active tier and its limits. Requests that exceed those limits return a validation error.

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`	Searches for places of interest by using natural-language queries, including area-based and along-route searches.

Experimental

Experimental — These tools are under active development. Their inputs, outputs, and behavior can change without notice, and they may be changed or removed in a future release. Don't rely on them in production.

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.

Traffic

Tool	Description
`traffic-flow`	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.

Retrieve current tool schemas

Send a tools/list request after you establish an MCP session:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list",
  "params": {}
}

Next steps

Connect to and authenticate with HERE Location Reasoning: Create a bearer token and establish an MCP session.
Integrate with HERE Location Reasoning: Run Python and TypeScript integration examples.