Filter Reachable Places

The filter_reachable_places MCP tool takes your list of coordinates and keeps the ones inside the area reachable from an origin within a travel-time or travel-distance limit.

Use this tool when you already have the locations, such as your stores, customers, or delivery addresses, and need to know which of them are within a 15-minute drive or a 2 km walk. The tool does not search for new places; use Search Reachable Places for that.

Tool name


filter_reachable_places


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 or distance.
range number Yes Travel limit: seconds for time, meters for distance with metric units, or miles with imperial units. Must be at least 1.
places array of objects Yes Up to 1,000 locations with lat and lon only. Keep names and other data in your application and match the results by index.
include_geometry boolean No Set to true to also return the reachable area as a GeoJSON FeatureCollection in isoline. Default: false.
mode string No Travel or vehicle mode. Default: drive. Supports the same modes as Calculate Isoline.
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.

The transit and approximated_transit modes support only type: "time". The maximum range depends on your account limits. The input schema does not allow additional properties.

Example request

This request checks which of three Berlin locations are within a 10-minute walk of Alexanderplatz:

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "filter_reachable_places",
    "arguments": {
      "origin": { "lat": 52.5219, "lon": 13.4132 },
      "type": "time",
      "mode": "walk",
      "range": 600,
      "places": [
        { "lat": 52.5208, "lon": 13.4094 },
        { "lat": 52.5163, "lon": 13.3777 },
        { "lat": 52.5251, "lon": 13.4198 }
      ]
    }
  }
}

Response

The tool returns:

  • reachability - the applied origin, type, range, range_units (seconds, meters, or miles), mode, and routing options.
  • total_count, count, and excluded_count - the number of supplied locations, matching locations, and excluded locations.
  • results - the matching locations in their input order, each with its zero-based index in places and its lat and lon.
  • isoline - the reachable area as a GeoJSON FeatureCollection, only when include_geometry is true.

The area is calculated outward from the origin: it answers "where can I get to from here?", not "who can get here?". Locations on the boundary of the reachable area count as matches. Locations inside holes of the area are excluded. Duplicate coordinates are kept, each with its own index.

Example response

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{ ... }"
      }
    ],
    "structuredContent": {
      "reachability": {
        "origin": { "lat": 52.5219, "lon": 13.4132 },
        "type": "time",
        "mode": "walk",
        "units": "metric",
        "route_type": "balanced",
        "traffic": "free_flow",
        "range": 600,
        "range_units": "seconds"
      },
      "total_count": 3,
      "count": 1,
      "excluded_count": 2,
      "results": [
        { "index": 0, "lat": 52.5208, "lon": 13.4094 }
      ]
    },
    "isError": false
  }
}

Only the first location is reachable within 10 minutes. The third location is about 600 meters away in a straight line, but it takes longer than 10 minutes to walk there. The tool reports whether each location is reachable, not the travel time to it; use Calculate Route Matrix for travel times and distances.

Related tools

Related API

For direct HTTP API integration, see Isoline API.