> ## Documentation Index
> Fetch the complete documentation index at: https://pomeroy.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Maps

> Your AI assistant can find places and route between them using Apple Maps. Both tools take place names, never your location.

Both Maps tools take **place names**, never coordinates and never your
location. That is what lets them work whether or not you have switched Location
on.

<Columns cols={2}>
  <div>
    **Can**

    * Find places near a named place, with addresses and, where Maps has them,
      phone numbers and websites
    * Route between two named places, driving or walking, with the distance and
      the expected time
  </div>

  <div>
    **Cannot**

    * Route public transport. Apple does not offer it on a Mac
    * Use your location. The maps actions take place names only
    * Book or buy anything
  </div>
</Columns>

## Tools

| Tool                 | What it does                                                                                                                                            | Kind |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | ---- |
| `maps_search_places` | Finds places near a named place, such as "coffee" near "Borough Market". Results carry coordinates, address and, where Maps has them, phone and website | Read |
| `maps_directions`    | Routes between two named places: distance in metres, expected travel time in seconds, and the turn list. Modes are driving (the default) and walking    | Read |

## Try it

```text theme={null}
How long will it take to drive to Bristol?
Find a coffee shop near Borough Market.
Walking directions from King's Cross to the British Museum.
What's the address of the Tate Modern?
```

## Worth knowing

<AccordionGroup>
  <Accordion title="Place names, not coordinates" icon="location-crosshairs">
    Both tools take names on purpose. It keeps them working with Location
    switched off, and it means the only thing sent anywhere is the place you
    named, not where you are.
  </Accordion>

  <Accordion title="No public transport" icon="train-subway">
    Apple does not offer transit routing on a Mac. Driving and walking are what
    MapKit answers, so they are what Pomeroy serves.
  </Accordion>

  <Accordion title="Maps has no permission prompt" icon="toggle-on">
    MapKit answers any app that asks, so macOS never prompts for it. The toggle
    in Pomeroy is the entire gate, which is why it still starts off.
  </Accordion>
</AccordionGroup>