Search Reachable Places
The search_reachable_places MCP tool finds places of one category inside the area reachable from an origin within a travel-time or travel-distance limit.
Use this tool for questions like "Which pharmacies can I walk to in 10 minutes?" or "Which supermarkets are within a 15-minute drive?". The tool calculates the reachable area and searches for places inside it in one call, so an AI assistant does not need to pass a large polygon between tools.
Tool name
search_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. |
category |
string | Yes | One supported place category, for example healthcare.pharmacy. Call list_place_categories to get the supported values. |
limit |
integer | No | Maximum number of places to return. Supported range: 1 to 100. Default: 20. |
lang |
string | No | Result language as a supported two-letter language code. Default: en. |
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 finds pharmacies within a 10-minute walk of Alexanderplatz in Berlin:
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "search_reachable_places",
"arguments": {
"origin": { "lat": 52.5219, "lon": 13.4132 },
"type": "time",
"mode": "walk",
"range": 600,
"category": "healthcare.pharmacy",
"limit": 5
}
}
}
Response
The tool returns:
reachability- the applied origin,type,range,range_units(seconds,meters, ormiles),mode, and routing options.categoryandcount- the searched category and the number of returned places.results- places inside the reachable area with the same fields as Search Places: name, address, coordinates,distancein meters from the origin, categories, data source, and details such as opening hours when they are available.isoline- the reachable area as a GeoJSONFeatureCollection, only wheninclude_geometryistrue.
Results are ordered by proximity and relevance, not by travel time, and the limit applies after the area filter. When no area is reachable, results is empty.
Example response
Shortened structuredContent:
{
"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"
},
"category": "healthcare.pharmacy",
"count": 3,
"results": [
{
"name": "Panorama Apotheke",
"formatted": "Panorama Apotheke, Panoramastraße 1, 10178 Berlin, Germany",
"lat": 52.521847,
"lon": 13.4098188,
"distance": 230,
"opening_hours": "Mo-Fr 09:00-19:00; Sa 09:00-14:00",
"categories": ["commercial.health_and_beauty", "commercial.health_and_beauty.pharmacy", "healthcare", "healthcare.pharmacy"],
"datasource": { "sourcename": "openstreetmap", "license": "Open Database License" }
},
{ "name": "Bezirksapotheke am Roten Rathaus", "formatted": "Bezirksapotheke am Roten Rathaus, Rathausstraße 5, 10178 Berlin, Germany", "distance": 283 },
{ "name": "Alexa Apotheke", "formatted": "Alexa Apotheke, Grunerstraße 20, 10179 Berlin, Germany", "distance": 361 }
]
},
"isError": false
}
}
The results show which places are inside the reachable area. They don't include the travel time to each place; use Calculate Route Matrix to compare travel times. Place data comes from OpenStreetMap and changes as the map is updated.
Related tools
- List Place Categories - get the supported
categoryvalues. - Calculate Isoline - calculate reachable areas for one to ten ranges.
- Filter Reachable Places - check your own list of locations instead of searching for places.
- Search Places - search places around coordinates by straight-line radius.
Related API
For direct HTTP API integration, see Isoline API and Places API.