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

Related API

For direct HTTP API integration, see Isoline API.