Faro
Tools/maps
Maps

Maps

Active

Your agent can't geocode or route; this turns addresses into coordinates, finds nearby places, and gives directions.

4 tools

Location tools: turn an address into coordinates and back, search for places and points of interest near a location, and get driving, walking, or cycling directions between points.

Maps & Weathermapsgeocodingplacesdirectionsrouting

Tools (4)

▶reverse_geocode

Convert geographic coordinates into the nearest address or place.

0.1 credits/call ($0.0001) · 0.1 credit per call

Example prompts

  • “What address is at 40.7128, -74.0060?”
  • “Reverse geocode these coordinates”
  • “Which city is at latitude 35.68, longitude 139.69?”

Parameters

latnumberrequired

Latitude in decimal degrees.

lonnumberrequired

Longitude in decimal degrees.

langstringoptional

2-letter language code for result names (e.g. "en").

typestringoptional

Restrict to a result level.

limitintegeroptionaldefault: 1

Number of nearby results (1-20).

API Usage

curl -X POST "https://skill.askfaro.com/skills/maps/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "What address is at 40.7128, -74.0060?"
  }
}'

CLI Usage

askfaro describe maps/reverse_geocode

Install pip install askfaro-cli, then askfaro auth login.

▶directions

Driving, walking, or cycling directions between points, with distance and time.

0.1 credits/call ($0.0001) · 0.1 credit per call

Example prompts

  • “Driving directions from the Eiffel Tower to the Louvre”
  • “How long to walk between these two points?”
  • “Cycling route across these coordinates”
  • “Travel time by car between these locations”

Parameters

langstringoptional

2-letter language code for turn instructions (e.g. "en").

modestringoptionaldefault: "drive"

Travel mode.

unitsstringoptionaldefault: "metric"

Distance units.

detailsstringoptional

Optional extra detail, e.g. "instruction_details".

waypointsstringrequired

Pipe-separated "lat,lon" waypoints (2 or more), e.g. "48.85,2.29|48.86,2.34".

API Usage

curl -X POST "https://skill.askfaro.com/skills/maps/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "Driving directions from the Eiffel Tower to the Louvre"
  }
}'

CLI Usage

askfaro describe maps/directions

Install pip install askfaro-cli, then askfaro auth login.

▶search_places

Find places and points of interest of a category near a location.

0.1 credits/call ($0.0001) · 0.1 credit per call

Example prompts

  • “Find cafes within 500m of these coordinates”
  • “List supermarkets near downtown Berlin”
  • “Show hotels around this point”
  • “What restaurants are nearby?”

Parameters

biasstringoptional

Rank results toward a location, e.g. "proximity:lon,lat".

langstringoptional

2-letter language code for result names (e.g. "en").

limitintegeroptionaldefault: 20

Number of results (1-100).

filterstringoptional

Area to search within, e.g. "circle:lon,lat,meters" or "rect:lon1,lat1,lon2,lat2".

categoriesstringrequired

Comma-separated category IDs, e.g. "catering.cafe,catering.restaurant", "commercial.supermarket", "accommodation.hotel".

API Usage

curl -X POST "https://skill.askfaro.com/skills/maps/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "Find cafes within 500m of these coordinates"
  }
}'

CLI Usage

askfaro describe maps/search_places

Install pip install askfaro-cli, then askfaro auth login.

▶geocode

Convert an address or place name into geographic coordinates.

0.1 credits/call ($0.0001) · 0.1 credit per call

Example prompts

  • “Geocode 1600 Pennsylvania Ave, Washington DC”
  • “What are the coordinates of the Eiffel Tower?”
  • “Find the latitude and longitude for Shibuya, Tokyo”
  • “Convert this address to coordinates”

Parameters

biasstringoptional

Bias ranking toward a location, e.g. "proximity:lon,lat".

langstringoptional

2-letter language code for result names (e.g. "en").

textstringrequired

Address or place name to geocode.

typestringoptional

Restrict to a result level.

limitintegeroptionaldefault: 5

Number of candidate results (1-20).

filterstringoptional

Restrict results, e.g. "countrycode:us,ca" or "rect:lon1,lat1,lon2,lat2" or "circle:lon,lat,meters".

API Usage

curl -X POST "https://skill.askfaro.com/skills/maps/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "Geocode 1600 Pennsylvania Ave, Washington DC"
  }
}'

CLI Usage

askfaro describe maps/geocode

Install pip install askfaro-cli, then askfaro auth login.

▶README

Maps

Geocoding, place search, and routing over OpenStreetMap data.

Attribution

Results are derived from OpenStreetMap and must be credited as © OpenStreetMap contributors; the underlying responses carry this in their datasource field. Maps tiles/results are also Powered by Geoapify.