datasets_starbucks_stores_nearby
Find nearby stored Starbucks stores. Returns stored Starbucks stores within a radius of a point, nearest first, from dataset id starbucks-stores. lat, lon, and radius_m are required.
Instructions
Find nearby stored Starbucks stores. Returns stored Starbucks stores within a radius of a point, nearest first, from dataset id starbucks-stores. lat, lon, and radius_m are required. Unlike the live /starbucks/stores endpoint (which caps at 50 near a point), this queries the full grid-tiled directory, so it can return every store in the radius. Billing: this endpoint costs 1 credit per record returned, with a minimum of 2 (an empty result costs 2, a full page of 100 costs 100).
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": {
"lat": "<lat>",
"lon": "<lon>",
"radius_m": "<radius_m>"
},
"name": "datasets_starbucks_stores_nearby"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lat | Yes | Center latitude, from -90 through 90 | |
| lon | Yes | Center longitude, from -180 through 180 | |
| page | No | Page number, defaults to 1 | |
| amenity | No | Amenity code filter, e.g. DT | |
| country | No | ISO-3166-1 alpha-2 country filter | |
| radius_m | Yes | Search radius in meters, 1 through 50000 | |
| page_size | No | Page size, defaults to 20 and maxes at 100 |