# Maps

> Skill `maps` on Faro. 4 sub-skills.

Looks up locations, converts addresses to coordinates and back, finds places nearby, and calculates routes with distance and travel time. Covers the core mapping operations without requiring a map display: geocoding, reverse geocoding, nearby-place search, and driving, walking, or cycling directions between any points.

**Category:** Maps & Weather  
**Tags:** maps, geocoding, places, directions, routing  
**Use when:** You need to resolve a location, label a coordinate, find places near a point, or get travel distance and time.  
**Not for:** Live traffic or transit schedules, map images or embeddable maps, device GPS or tracking, postal address validation, or bulk geocoding of large lists.  
**Returns:** information — Returns structured location data (coordinates, addresses, place listings, or a route with distance and time), credited to OpenStreetMap contributors. Not a map image or an embeddable map.

## How to run
Skills run through one gateway with your Faro token. Hand it an `intent` in plain language; Faro routes to the right sub-skill, runs it, and bills per call. Raw tools are internal plumbing and are not directly callable.

```
POST https://skill.askfaro.com/skills/maps/run
Authorization: Bearer faro_<your_key>
Content-Type: application/json

{"intent":{"prompt":"What are the coordinates of 221B Baker Street, London?"}}
```

Or from the CLI:

```bash
pip install askfaro-cli && askfaro auth login
askfaro run maps "What are the coordinates of 221B Baker Street, London?"
```

Full run reference: https://askfaro.com/llms/run.md — Agent recipe: https://askfaro.com/llms/skill.md

## Example requests

- What are the coordinates of 221B Baker Street, London?
- What address is at 48.8584, 2.2945?
- Find coffee shops near the Eiffel Tower
- How long does it take to drive from Paris to Lyon?

## Sub-skills

### Address to coordinates

Resolves an address or place name to coordinates and ranked candidates.

**Cost:** ~1 credits / lookup (up to 2)

**Use when:** You have a free-text address or place name and need its coordinates or structured components.

**Details:** https://askfaro.com/llms/skills/maps/geocode.md

---

### Coordinates to address

Resolves a coordinate point to the nearest address, or to its city or region.

**Cost:** ~1 credits / lookup (up to 2)

**Use when:** You have a latitude and longitude and want the address, or which city or region it falls in.

**Details:** https://askfaro.com/llms/skills/maps/reverse_geocode.md

---

### Find nearby places

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

**Cost:** ~1 credits / search (up to 3) — Resolving a named location to a search center first can add a lookup.

**Use when:** You want a list of a kind of place (cafes, hotels, shops, parks) around a point or area.

**Details:** https://askfaro.com/llms/skills/maps/search_places.md

---

### Directions and travel time

Computes distance and travel time between points by car, foot, bike, or truck.

**Cost:** ~1 credits / route (up to 3) — Resolving named endpoints to coordinates first can add a lookup per endpoint.

**Use when:** You want how far or how long between two or more places, or a route, by a travel mode.

**Details:** https://askfaro.com/llms/skills/maps/directions.md

---

---
On the web: https://askfaro.com/search/maps