# Places and map

Source: https://frameleaf.app/docs/using/places/

Frameleaf turns the location in each photo into a place name, so you can browse by country, region and city, search for a place, and see all your travels on a map. Place names are worked out privately on your own server.

## Place names stay on your server

Place names are worked out on your own server from a built-in copy of the GeoNames database of world places. Looking up a location never sends it to an outside service. The only exception is the optional [Identify photo locations](#name-the-businesses-and-venues-in-your-photos) job, which you start and pay for yourself.

When Frameleaf reads a photo's metadata, any photo with a latitude and longitude gets a city, a state or region, and a country. The database is refreshed with each minor Frameleaf upgrade.

The place names appear in a photo's info panel, power **Places** in search, and help smart search.

## Places

**Places**, under Explore in the sidebar, shows region and city cards for everywhere your photos were taken, together on one page. The line under the title says how many places and located items you have, and how many items have no location. With **Group by country** on, the default, cards are grouped by country and each region's card maps its cities; turn it off for one grid of every place. Frameleaf remembers your choice on each device. Type in **Find a place** to jump to one, open a card to see its photos, or choose **Show on map** on a card to see that place on the [map](#the-map).

## Landmarks and attractions

**Landmarks & attractions** shows places where your library has located photos, such as a park, museum or viewpoint. Browse the cards in Explore or under their region in Places, or search for a landmark by name. Open a card to see your photos from that place. The map can show visited landmarks too.

When Frameleaf suggests an album for a visit, review the photos and choose to create the album or dismiss the suggestion. The album is private to you, like any album you make. Landmarks are matched from photo locations, so photos with a location are matched automatically, and Locked photos stay hidden until you unlock your session.

Photos without a location can join a landmark too. Frameleaf looks at photos you took with the same camera around the same time, and at what the photo shows compared with your own located photos of the landmark. The photo's info panel then says **Inferred at** or **Likely showing** the landmark, so you can tell it from a recorded location. An inferred landmark is never written into the file, its sidecar or its recorded location, and memory titles and exact map pins still use recorded locations only. Removing a photo's location turns inference off for it. How often a match is found depends on how many located photos of the place your library already has.

If a photo lands at the wrong landmark, correct its location in the photo's info panel.

## Name the businesses and venues in your photos

Place names tell you the city. **Identify photo locations** goes further and names the café, park or venue where a photo was taken. It's an optional job on Frameleaf Cloud, paid from your [AI credit](https://frameleaf.app/docs/cloud/cloud-gpu/), and it only runs when you start it.

1. Open **Library care** and find **Identify photo locations**.
2. Check the estimate. It shows how many of your photos have a map location and what checking all of them would cost, beside the cost of the job you're about to run.
3. Choose a limit, by number of photos or by amount to spend.
4. Agree to send these photos' map locations to Frameleaf Cloud and Google, and start the scan.

It costs **$5 per 1,000 photos checked**, whether or not a place was found. Skipped and failed photos aren't charged. The limit you chose is held from your AI credit while the scan runs, and whatever isn't used goes back to your credit when it settles. Your AI spending permissions and monthly limits apply, and a Cloud plan doesn't include this usage. Cancel at any time; photos already checked are still charged and keep their results. Later scans cover new, changed or failed photos.

Only the GPS coordinates of your selected photos, and their accuracy where known, are sent. No photos are uploaded, and the list of which photo is which stays on your server.

Results appear in a photo's info panel as a **Suggested location**, such as "Taken at" or "Near" a place, marked **From Google Maps** with a link to open it in Google Maps. A suggestion is inferred from today's map data, so a place may have changed since the photo was taken. Choose **Dismiss suggestion** to remove one. Suggestions never change the photo's recorded location, and Locked photos keep their usual protection.

## Search by place

- Type `place:` and a city in the search box: `place:Banff sunset`. Use quotes for names with spaces: `place:"Lake Louise"`. See [Search syntax](https://frameleaf.app/docs/using/search-syntax/#place).
- On the Search page, ask in plain words in **Ask about your photos**: `photos in Banff last summer`. Use a real city name; Frameleaf lets you know when it skips a phrase such as "my hometown" and shows results without a place filter.
- In the filter panel, the **Places** section filters by country, state and city.

## The map

**Map**, under Explore, shows your photos as clusters that grow with the number of photos they hold. Hover over a cluster to preview it, and click it to zoom in. Keep clicking until it splits into single photos, then click a photo to open it.

In a large library the server groups the map for you one view at a time, so it opens quickly however many photos you have. Open a photo from the list and you can keep going with the arrow keys through everything in view, including photos the list hasn't loaded yet.

If the map can't load, or you're offline, your located items are still listed under **In view**.

- **Show list** lists the photos in view, which is the easiest way to open photos taken at the same spot.
- **Search this area** finds photos in the part of the map you're looking at.
- **Show all items** zooms back out to everything with a location.
- **Map settings** set a **Date range** (**All time**, **Last 30 days**, **This year** or **Custom**), choose whether to include **Archived items** and **Shared spaces** or show **Only favorites**, and turn on **Asset panel on map**, the same list as **Show list**. They also count how many photos are **Located**, how many are **In view** and how many have **No location**. On an album's map you can also include **Partner items**.
- **Load every item at once**, in **Map settings**, downloads the whole map in one go instead of a view at a time. It isn't offered on an album's map.
- A legend in the corner shows the three marker sizes, for 1, 2 to 9 and 10 or more items, and how many photos and videos are on the map.
- On a keyboard, drag or use the arrow keys to pan, plus and minus to zoom, Home to show everything, and Tab to move between markers.
- Albums have their own map, showing only that album's photos.
- Search results can be shown on a map too.
- On a shared link, the map ignores every filter, so a viewer never sees your favourites or your partners' photos.

:::note[Where map tiles come from]
The map background is loaded from Frameleaf's tile server, `tiles.frameleaf.cloud`, in a light and a dark style. The tile server sees which areas of the map you look at, not your photos. An administrator can use a different tile server; see below.
:::

## Fix a location

Open a photo's info panel and choose **Edit location** to move the pin, or **Add a location** when it has none. Click or drag on the map to place the pin, or type the **Latitude** and **Longitude**. You can also type the **City**, **State or region** and **Country** yourself:

- Names you type stay, even when Frameleaf reads the file's metadata again.
- Emptying a field clears it.
- If you move the pin without touching the names, Frameleaf works the names out again for the new spot.
- To take a location off a photo, choose **Remove location** and confirm. This clears its coordinates and place names, in its metadata file too, and from its Live Photo video if it has one. The photo leaves the map and place searches.

To change the location of many photos at once, select them, open **More** in the selection bar and choose **Change location**. Each photo gets the coordinates you enter, and the place name is looked up from them.

## Locked photos

[Locked](https://frameleaf.app/docs/using/private-content/) photos are left off the map and out of Places until you unlock your session.

## For administrators

Map and place settings are in **Settings**, then **Server & updates**, then **Maps & places**:

| Section | Setting | Default |
| --- | --- | --- |
| **The map** | **Show photos on a map**. Off, the Map page and the small maps beside photos are hidden for everyone. | On |
| **The map** | **Map look**: **Standard**, Frameleaf's own map in a light and a dark version, or **Custom** | Standard |
| **Places** | **Name the places in your photos**. Off, new photos get no place names, and names already found are kept. | On |

The standard map's styles are `https://tiles.frameleaf.cloud/v1/style/light.json` and `https://tiles.frameleaf.cloud/v1/style/dark.json`.

### Use your own map style

A map style is a `style.json` file that sets how the map looks and which tile server it loads from. You can change the colours, show or hide layers, or move to another tile provider. The default [light](https://tiles.frameleaf.cloud/v1/style/light.json) and [dark](https://tiles.frameleaf.cloud/v1/style/dark.json) styles make a good starting point, and there are ready-made styles and online editors too.

1. Go to **Settings**, then **Server & updates**, then **Maps & places**, and set **Map look** to **Custom**.
2. Under **Advanced: map style addresses**, paste the link to your style into **Light map style address**, **Dark map style address**, or both. Using two styles lets the map match whether Frameleaf is in light or dark mode.
3. Save, then reload the map.

**Use the standard map** puts both addresses back to Frameleaf's own map.

### Build a style with MapTiler

If you'd rather not write a style by hand, MapTiler has a visual editor:

1. Create a free account at `cloud.maptiler.com`.
2. Click **New Map**, choose a starter map and click **Customize**, or pick a **Standard Map** and customise that.
3. In the editor, change colours, hide layers, or add optional layers such as administrative, topographic or water.
4. Click **Save** at the top right and give the map a unique name.
5. Click **Publish** at the top right. MapTiler shows your changes side by side with the original first. It warns that publishing changes the map for every app using it; since nothing uses it yet, that's fine.
6. Click the map's name at the top left to open its details page, and copy the link under **Use vector style**. The link includes your personal MapTiler key.
7. Paste that link into **Light map style address** or **Dark map style address** in Frameleaf, as above.
