overture_spatial_join
Relate features across Overture themes within a bounding box using spatial relations like intersects, within, contains, or within_distance. Count, list, or group matched pairs.
Instructions
Relate features across themes/types in one release and bounded area.
Relation is left-to-right: places within division_area, or areas containing places.
Both datasets are scoped to bounds; <=5000 candidates each or fail without partial
analysis. pairs paginates pairs with properties/provenance; count returns total pairs;
group_left returns every left ID with match count, including zero. within_distance
needs distance_m and uses a local projected minimum geometry distance in meters.
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": {
"left": "<left>",
"right": "<right>",
"bounds": "<bounds>"
},
"name": "overture_spatial_join"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| left | Yes | ||
| mode | No | pairs | |
| limit | No | ||
| right | Yes | ||
| bounds | Yes | ||
| cursor | No | ||
| release | No | ||
| relation | No | intersects | |
| distance_m | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | ||
| scope | No | ||
| theme | No | ||
| source | Yes | ||
| license | Yes | ||
| release | Yes | ||
| warnings | No | ||
| next_cursor | No | ||
| feature_type | No | ||
| attribution_url | No | https://docs.overturemaps.org/attribution/ |