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, ormiles),mode, and routing options.total_count,count, andexcluded_count- the number of supplied locations, matching locations, and excluded locations.results- the matching locations in their input order, each with its zero-basedindexinplacesand itslatandlon.isoline- the reachable area as a GeoJSONFeatureCollection, only wheninclude_geometryistrue.
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
- Calculate Isoline - calculate reachable areas for one to ten ranges.
- Search Reachable Places - find places of a category inside a reachable area.
- Evaluate Spatial Relation - test a point against any polygon you already have.
Related API
For direct HTTP API integration, see Isoline API.