CapabilitiesGeography
Place Search
Search places, businesses and points of interest.
Page actions
Search places, businesses, establishments, and points of interest. Place Search is for discovery, not only “find the nearest coffee.”
GET https://api.roote.ai/v1/place-searchExamples include Gare Lyon Part-Dieu, Starbucks près de République, and pharmacie à Lyon.
Request
curl "https://api.roote.ai/v1/place-search?q=pharmacie%20%C3%A0%20Lyon&lat=45.7640&lon=4.8357&limit=5" \\
-H "Authorization: Bearer YOUR_API_TOKEN"| Parameter | Required | Description |
|---|---|---|
q | Yes | Place, business, establishment, or POI query. |
lat | No | Latitude used to bias results. |
lon | No | Longitude used to bias results. |
category | No | Category filter where supported. |
limit | No | Maximum number of candidates requested. |
Response
{
"results": [{
"roote_id": null,
"name": "Example Pharmacy",
"label": "Example Pharmacy, Lyon, France",
"type": "establishment",
"location": { "lat": 45.7644, "lon": 4.8361 },
"address": { "city": "Lyon", "country": "France" },
"source_id": "google",
"source_place_id": "provider-place-id"
}],
"meta": { "source": "google", "cache": "miss", "total": 1, "query": "pharmacie à Lyon" }
}Results are ordered candidates, not a conversationally selected answer. Use Bearer authentication by default. Invalid queries, incomplete geographic bias, rate limiting, and upstream provider failures return structured errors.