Ground Location Tool
ground_location_toolFind nearby places, neighborhood context, and travel-time reachability for a coordinate; add land, water, elevation, or traffic details as needed.
Instructions
Answer questions about what is near a location, what neighborhood a coordinate is in, or what places are within walking/driving distance. Use this when given coordinates and asked about nearby places, neighborhood context, local discovery, or area summaries. It already includes reverse geocoding, so a separate reverse_geocode_tool call is not needed for the same coordinate. Pass the place category (e.g. "restaurant", "coffee", "park") as the query parameter to get nearby POIs in the same call. Returns place name, nearby POIs matching the query, and travel-time reachability — all sourced from live Mapbox data with citations. Use include for what the spot itself is: land use (is it in a park, a national park, a building?), water (on it, or how near), elevation, and live traffic on the roads around it. So use it for "is this spot in a park?", "is this on the water?" or "how bad is traffic at this address?" too. For elevation along a path or route, use elevation_tool.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"longitude": "<longitude>",
"latitude": "<latitude>"
},
"name": "ground_location_tool"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of nearby POIs to return (1-25) | |
| query | No | Optional category or type of places to search for nearby (e.g., "restaurant", "coffee", "park"). If omitted, returns general place context only. | |
| include | No | What to report about the spot itself, each one extra request: "land" for land use (park, cemetery, school, residential...), a national park or other protected area, and the building it is in; "water" for whether it is on water and how far the nearest water is; "elevation" for height above sea level; "traffic" for live congestion on the roads around it. Pick what the question needs, e.g. ["traffic"] for "how bad is traffic at this address?". Leave out when the question is only about the area or nearby places. | |
| profile | No | Travel profile for isochrone calculation. Use "mapbox/driving-traffic" for traffic-aware driving. Defaults to "mapbox/walking". | mapbox/walking |
| language | No | IETF language tag for the response (e.g., "en", "es", "fr", "de", "ja") | |
| latitude | Yes | Latitude of the location to ground responses around | |
| longitude | Yes | Longitude of the location to ground responses around | |
| contours_minutes | No | Travel-time thresholds in minutes for the isochrone. Max 4 values, each between 1-60. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| land | No | What the ground is at the point, from Mapbox Streets (include: land) | |
| place | Yes | Human-readable place name from reverse geocoding | |
| water | No | On water, or distance to the nearest water (include: water) | |
| traffic | No | Live traffic on nearby roads, from Mapbox Traffic (include: traffic) | |
| latitude | Yes | ||
| citations | Yes | Mapbox APIs used to produce this grounded response | |
| isochrone | No | Travel-time reachability summary | |
| longitude | Yes | ||
| elevation_m | No | Ground elevation above sea level, from Mapbox Terrain-DEM (include: elevation) | |
| nearby_pois | No | Nearby points of interest matching the query | |
| full_address | No | Full address if available | |
| mapboxRender | No | Map-payload reference for `render_map_tool`. Surfaced so the LLM can chain the next call without re-emitting geometry. |