Calculate Isoline
The calculate_isoline MCP tool calculates the areas reachable from one origin within travel-time or travel-distance limits. A time limit gives an isochrone, and a distance limit gives an isodistance.
Use this tool when an AI assistant needs to draw a service area, compare how far you can get in 10, 20, or 30 minutes, or pass a reachable area to a geometry tool. To find places inside a reachable area, use Search Reachable Places. To check your own list of locations, use Filter Reachable Places.
Tool name
calculate_isoline
Request URL
https://api.geoapify.com/v1/mcp?apiKey=YOUR_API_KEY
Input parameters
| Name | Type | Required | Description |
|---|---|---|---|
origin |
object | Yes | Starting point with lat and lon. Latitude range: -90 to 90; longitude range: -180 to 180. |
type |
string | Yes | time for an isochrone or distance for an isodistance. |
ranges |
array of numbers | Yes | One to ten travel limits. Time limits are in seconds; distance limits are in meters with metric units or miles with imperial units. Each value must be at least 1. |
mode |
string | No | Travel or vehicle mode. Default: drive. See supported modes below. |
units |
string | No | metric or imperial. Default: metric. |
route_type |
string | No | Route preference: balanced, short, or less_maneuvers. Default: balanced. |
traffic |
string | No | Traffic model for motorized modes: free_flow or approximated. Default: free_flow. |
avoid |
array of strings | No | Up to three unique features to avoid: tolls, ferries, and highways. |
max_speed |
number | No | Maximum vehicle speed: 10 to 252 km/h with metric units, or 6.5 to 155 mph with imperial units. |
Duplicate ranges are removed, and the results are sorted by increasing range. The transit and approximated_transit modes support only type: "time". The maximum range depends on your account limits; see the Isoline API for details. The input schema does not allow additional properties.
Supported modes are drive, light_truck, medium_truck, truck, heavy_truck, truck_dangerous_goods, long_truck, bus, scooter, motorcycle, bicycle, mountain_bike, road_bike, walk, hike, transit, and approximated_transit.
Example request
This request calculates the areas reachable on foot within 10 and 20 minutes from Alexanderplatz in Berlin:
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "calculate_isoline",
"arguments": {
"origin": { "lat": 52.5219, "lon": 13.4132 },
"type": "time",
"mode": "walk",
"ranges": [600, 1200]
}
}
}
Response
The tool returns a GeoJSON FeatureCollection with one Polygon or MultiPolygon feature per requested range, sorted by range. Each feature's properties contain the isoline id, the origin, mode, type, range, and the applied routing options. The collection properties contain the id of the whole result. When no area is reachable, features is empty.
The polygons use GeoJSON [longitude, latitude] coordinate order, so you can pass a feature's geometry to Measure Geometry, Combine Geometries, or Evaluate Spatial Relation.
Example response
Shortened structuredContent; the polygon coordinates are cut:
{
"jsonrpc": "2.0",
"id": 2,
"result": {
"content": [
{
"type": "text",
"text": "{ ... }"
}
],
"structuredContent": {
"type": "FeatureCollection",
"properties": { "id": "c6ff686f53e4c7a22033681640cd9c32" },
"features": [
{
"type": "Feature",
"properties": {
"id": "f1bb84b4703bb9a2c4be7b0b3816b8a0",
"lat": 52.5219,
"lon": 13.4132,
"mode": "walk",
"type": "time",
"range": 600,
"route_type": "balanced",
"units": "metric",
"traffic": "free_flow"
},
"geometry": {
"type": "MultiPolygon",
"coordinates": [[[[13.4172, 52.524988], [13.417129, 52.52497], "..."]]]
}
},
{
"type": "Feature",
"properties": {
"id": "dae6f1d15dd8c0fc1689f4bb6ee7557e",
"lat": 52.5219,
"lon": 13.4132,
"mode": "walk",
"type": "time",
"range": 1200,
"route_type": "balanced",
"units": "metric",
"traffic": "free_flow"
},
"geometry": {
"type": "MultiPolygon",
"coordinates": [[[[13.4102, 52.529906], [13.410195, 52.529904], "..."]]]
}
}
]
},
"isError": false
}
}
An isoline shows which area is reachable. It does not give the travel time to a particular destination. For travel times and distances to specific locations, use Calculate Route Matrix.
Related tools
- Search Reachable Places - find places of a category inside a reachable area.
- Filter Reachable Places - keep only the supplied locations that lie inside a reachable area.
- Geocode Address - convert an address into origin coordinates.
Related API
For direct HTTP API integration, see Isoline API.