Find nearby places
~1 credits / search (up to 3)Searches for places and points of interest of a given category within a radius around a location, returning them sorted nearest-first. Works for any type of place: cafes, restaurants, hotels, supermarkets, pharmacies, parks, museums, banks, and more. Provide a location and a category and get back a ranked list with names, addresses, and coordinates.
Use when
You want a list of a kind of place (cafes, hotels, shops, parks) around a point or area.
Not for
Resolving a single address, or getting directions between points.
Cost
~1 credits / search (up to 3)
Resolving a named location to a search center first can add a lookup.
Estimated; the actual charge depends on your input and is shown in the response.
What it accepts
Set these inside the intent when you run it.
The center of the search, as a place name, address, or coordinates.
The kind of place to find, e.g. cafes, hotels, supermarkets, parks, pharmacies.
How far from the location to search, e.g. 500m or 2km. Defaults to a walkable radius.
What you get back
A list of matching places sorted by proximity, each with name, category, address, and coordinates.
Run it
Run this sub-skill directly: pin it with operation and pass its inputs in the intent. (Omit operation and the Maps skill will route from your intent instead.)
curl -X POST "https://skill.askfaro.com/skills/maps/run" \
-H "Authorization: Bearer $FARO_TOKEN" \
-H "Content-Type: application/json" \
-d '{"intent":{"operation":"search_places","location":"Times Square, New York","place_type":"coffee shops","radius":"1km"}}'Example requests
- ›Find coffee shops near the Eiffel Tower
- ›What hotels are within 1km of Times Square?
- ›Show me pharmacies near my location in Berlin