Add a location to a panorama and show a map in your tour

The short version

A panorama can have a location, a latitude and a longitude. You set it on the Panoramrs tab by typing the numbers, by choosing a spot on a map, or in one click if the photo carries its own GPS position. A tour shows a map to visitors only after you switch the map icon on under Top Nav Bar - Dropdown on the Design tab.

Set a panorama's location

1. Open the tour, click the Panoramrs tab and select the panorama in Panorama List.
2. Under the description, find Latitude and Longitude (in the Advanced view: click Advanced at the right end of the tab row if you are in Basic). Type decimal degrees: latitude from -90 to 90, longitude from -180 to 180. The page saves when you leave the field and says Saved automatically.
3. Or click the map-pin button beside the two fields (its tooltip reads Open Map to Set Location). The window Pinpoint Location opens. Type an address in Search address... and click a result, or click the map to drop the pin. On Google's map, Road and Satellite change the map. Click Save Coordinates, or Cancel to leave the location as it was.

You can also set it from the Asset Library: click a panorama in the list, click Edit, and use Search Location, Latitude and Longitude there.

Use the photo's own position

If your photo has a GPS position, Panoramr reads it when you add the photo and keeps it for you alone. It does not become the panorama's location by itself. When the position differs from the location, Use where the photo was taken appears under the fields, with the note Only you can see where it was taken. The map location is shown in the tour. One click fills in the two fields and saves.

This works for photos that are yours, and only for JPEG files: the upload panel reads the position from a JPEG, and a TIFF gives none. If a JPEG gave no position, the Create Post page says so and, on a phone, what to switch on. The camera facts shown on the Panoramrs tab never include the GPS position, the artist, the copyright or the description.

Show the map in your tour

1. Open the Design tab and the Top Nav Bar - Dropdown panel.
2. Click Arrange & Toggle Top Icons to open the list, and tick Map Hook Modal. It is off by default. The top bar must be showing (Show Title Bar is on by default), or, with the bar off, Just Icons ticked: the icon then floats at the top right.
3. For phones: click Advanced above the list of panels, open Mobile Navigation, and tick Map Button under Top Bar Features (or under Bottom Bar Features for the bottom bar); click a heading to open its list. It is off by default, and a visitor on a phone does not see the map icon until it is on.
4. Click Save & Render.

The same icon can be switched on in the Icon Bar panel (Map Button Hook) and in the icon list of the Top Nav Bar - Multi Menu panel (Map Hook Modal).

The icon, with the tooltip View Map, appears in a tour page only when at least one scene has both a latitude and a longitude. While the icon is switched on and no scene has a location, the Design and Preview tabs show it faded, with the tooltip No geographic coordinates set; a page that visitors open does not show it at all.

What visitors see

The icon opens the tour's information window on its Map tab. Each scene that has a location has a marker, and its name shows when you point at it. Clicking a marker goes to that scene and closes the window. The map loads only when the window opens, and which map it is depends on how many maps Panoramr has shown this month:

• While Panoramr's monthly allowance of Google's maps lasts, it is Google Maps, which you can drag and zoom. Road and Satellite switch between the street map and satellite pictures.
• After that it can be a fixed picture from Google Maps: it cannot be dragged or zoomed, and the markers still go to their scenes.
• Otherwise it comes from OpenFreeMap, which is built on OpenStreetMap data, with its credit in the corner and no satellite view. On a device that cannot draw that map, OpenStreetMap's own map is shown instead. In a tour you downloaded and host yourself, the map is always the OpenFreeMap one.

The map icon is part of a theme. On a Free plan a tour in a Pro theme that has never been hosted shows the free Default look on its public page and in embeds, and a free download is the Standard design: neither has a map icon. The Design and Preview tabs show your own design. A tour in a free theme, the Default Theme, shows your own design, and so does a tour that is, or was, in a Vault or in plan hosting (the Hosting pane of the Publish tab), or whose owner is on a paid plan.

Who can see what

• The photo's own GPS position stays private. Only you are offered it, and it is never shown in a page.
• The location you set is part of the tour's data. It is sent to visitors with the tour, whether or not you switch the map icon on. Choose a spot you are happy to make public.
• The picker window shows Google Maps, with Road and Satellite, while Panoramr's monthly allowance of Google's maps lasts, and the map from OpenFreeMap after that. Its address search is run by Panoramr's server through Photon: it starts from the second letter, once you stop typing for half a second, and the list credits OpenStreetMap contributors.

Troubleshooting

There is no map icon in the tour. Check, in order: Map Hook Modal is ticked and you clicked Save & Render; on a phone, Map Button is ticked in Mobile Navigation; at least one scene has both a latitude and a longitude; the public page is not showing the free Default look, which visitors get of a tour in a Pro theme on a Free plan unless the tour has been hosted; and, if the tour uses Draft Workflows, you clicked Publish Changes. A latitude or longitude of exactly 0 counts as empty on the map.

The icon is faded on the Design or Preview tab. No scene has a location yet: the tooltip says No geographic coordinates set.

A scene is missing from the map. That scene needs both numbers.

Use where the photo was taken does not appear. The panorama is not yours, the file was not a JPEG, the photo had no GPS position, or the location already equals the photo's position.

The address search shows nothing. The search needs at least two characters. If the search service does not answer, the list stays empty and no message appears. Click the map or type the numbers instead.

The map in the picker stays blank. Type the latitude and longitude into the fields instead.

The number is refused. Latitude must be between -90 and 90, and longitude between -180 and 180.