# Maps and places

URL: https://docs.clatri.com/en/space/maps/

> How to see maps, routes and nearby places in the Clatri chat, and how to save places in guides with categories, statuses, photos and a starting point.

Clatri can show you maps right in the chat: a single place, a route between several stops, or the itinerary for each day of a trip. The map is interactive, and every route comes with a link to open it in Google Maps and navigate from there.

You don't need technical wording. Something like this is enough:

- *"Where is the restaurant for Friday's dinner?"*
- *"Show me tomorrow's route: hotel, meeting downtown, then the airport."*
- *"Map out each day of my trip to New York."*
- *"Any good coffee shops near my hotel?"*
- *"Can I make it from the 3 pm meeting to the 4 pm appointment?"*

## A place or a route

Mention one place and Clatri shows you where it is. Mention several and it builds the route in the order you gave, and shows it on the map without saving anything to your account. You can ask for walking, driving, cycling or public transit directions.

### Switching the mode without asking again

Above the map there's a selector with **Auto**, **Transit**, **Walking** and **Bike**. Tapping another mode redraws the route instantly, at no cost and without a new chat message: it only changes how the map looks. If the route has more than two stops, Transit and Bike don't show up, because a map with several stops only draws a good route by car or on foot.

When you don't ask for a mode, Clatri picks a sensible one: walking if the destination is very close, public transit in cities with a metro or urban rail, and driving everywhere else. You can always change it from the selector.

## Trips and days with several events

If your [calendar](https://docs.clatri.com/en/space/calendar/) events have a location, Clatri can build the day's itinerary from them: it starts where you're sleeping (home, the hotel or the Airbnb for those dates), goes through your appointments in order and comes back. For a multi-day trip you get a single map with one tab per day.

A flight or a long trip between cities splits the day into two routes — for example *home → airport* and *arrival airport → hotel* — because a driving route doesn't cross a flight.

## Real places near you

When you ask what's nearby (restaurants, cafés, pharmacies, things to do), Clatri looks up real places with their address, rating and whether they're open now, starting from where you are or will be on those dates. It doesn't make places up.

## Travel times and distances

Clatri can work out the real time and distance between two points — by car, with estimated traffic — and warn you, for example, when you won't make it between two back-to-back events. If it can't calculate it, it tells you instead of guessing.

## In the calendar

When an event has a location, tapping it opens Google Maps, and the event detail shows the place on a map. Days with several timed events that have a location show a shortcut to the day's route (start → end) so you can open it directly.

For the map to land on the right spot, save the location with a name and a city: *"Centro Andino, Bogotá"* rather than just *"Andino"*. An ambiguous name can end up somewhere else.

## Places

Save the places you care about and organize them however you need; see them
from the reference point you choose. **Places** is ideal for keeping your
memories or planning trips.

Places are grouped into **guides**. A guide lives inside
[Spaces](https://docs.clatri.com/en/space/spaces/) and holds the places for a
destination or a purpose: for example "New York" for a trip, or a list of
schools for your sales visits. Inside the guide you organize places into
**categories**, each with its own emoji (for example 🍺 Bars or 🏫 Schools).

Each place can have a name, address, website, phone number, email, links,
attached passes or documents, notes and a **status**. Statuses belong to each
guide and you can rename them: a trip guide comes with "To visit" and
"Visited"; a sales guide comes with "To contact," "Contacted," "Interested"
and "Discarded." You can adjust them to your process, for example renaming
"Contacted" to "Scheduled."

### The guide screen

- **Map:** one pin per place, with its category emoji on its status color. It
  can be opened full screen; tapping a pin shows a card with the place and
  its actions.
- **Starting point:** the **Starting point** card with the **Change** button
  lets you pick a typed address, a place saved in the guide, a category (its
  center) or the guide's city. It remembers points you used recently so you
  can pick them again quickly. Distances and times in the list are always
  measured from there.
- **Filters:** by category and by status, above the list.
- **List:** sorted by distance (or by time, if you asked for times). Tapping
  a place expands it, showing a small interactive map, its website, notes,
  links and attached passes, a selector to change the status, and an
  **Edit** action.
- **Times:** walking, transit or driving, measured from the starting point.
  If Google does not answer or the daily limit is reached, the list keeps
  showing the straight-line distance.
- **+** searches a place or drops a pin on the map; "Place on map" puts a
  place saved without a location where it belongs.

### Place photos

When you save a place with a name, Clatri searches the web for photos of it
once and saves them as links (it never copies the images). Photos from the
place's own website are preferred.

- The **list** shows the first photo instead of the pin.
- The **starting point picker** also shows it when you pick a saved place.
- Expanding a place shows a **gallery of up to 3 photos** above the map.
  Tapping one opens it large, with its source and a button to open the source
  page.
- If you're an editor of the guide, each photo's "…" lets you **set it as the
  main photo** or **hide it**, and the place's "…" has **Search other
  photos**, which brings a fresh set. Every photo search spends credits, the
  same as the automatic one when the place is saved (see [Pricing](https://docs.clatri.com/en/pricing/)).

### Directions

The **Directions** button opens straight into whichever maps app you have
set as default: Google Maps, Apple Maps or Waze. The ▾ next to it changes
that default app (you can also change it from **Settings**), and the change
applies the same way in the chat map and the calendar.

The route starts at the guide's starting point when that point is a specific
address, place or category. If the starting point is the city (or there
isn't one), the maps app simply starts from wherever you are at that moment.

### Privacy

Clatri only uses your phone's location when you share it from the chat, for
a time you choose (15 minutes, 1 hour or 8 hours), and never stores it. Maps
apps use their own GPS when navigating, and Clatri doesn't see it.

### With the assistant (chat)

Just ask Clatri in the chat:

- *"Create a New York guide."*
- *"Save these 9 schools in a guide"* (one at a time or all at once).
- *"Mark PS 41 as contacted."*
- *"I'm at 35-21 33rd St, Astoria"* to set the starting point.
- *"How do I get to PS 41 from the Moxy Chelsea?"* — Clatri uses the saved
  location and shows you the map with the route.

If a name matches several places, Clatri asks you which one before saving
it. Real travel times are calculated only when you ask for them. On the chat
map, the **Save to guide** action saves any place into the guide and
category you pick.

When Clatri creates a guide or adds or edits places, it can show a **guide
card** in its reply, right where it talks about it: its name, how many places and categories it has, and the
first places with their photo and status, with an **Open guide** button (or
**View in guide** for a single place). It needs app version 2.8.0 or later;
it's already available on the web.

### Where to find them

They're available on the iPhone and Android app, and on the web
([clatri.com](https://clatri.com/app/spaces)). The Spaces dashboard has a
**Places** section with your guides; you can also open a guide from its card in the
page where it's embedded.

On the web, besides that section (with **+ New guide**) and the sidebar
under Spaces, you can type `/Place guide` inside a document to create a
guide and embed it as a card. The guide page shows the map on the left and
the list on the right; on small screens, the list sits in a sheet you drag
up or down over the map.
