Skip to content

Connect maps

Maps draws the route of a run on a map: its stops, its hotels and how you travel between them. It uses Mapbox, a map service, with your workspace’s own Mapbox token. Without a token, a run shows its route as a list, and everything else works the same.

  • You need Full access. Other levels see a note that someone with Full access adds the token.
  • You need your own account at Mapbox. OPERO holds no Mapbox account for you.
  1. Select the name of your workspace at the top of the sidebar, then Settings, then Integrations.

  2. Select Maps, then Connect. The Connect maps window opens. You can also start from a run: on the map view, select Add Mapbox token.

  3. Open Mapbox access tokens through the link in the window, and sign in or create an account.

  4. Create a token with the public scopes only, and restrict it to your workspace’s address.

  5. Paste it in Public token. It starts with pk.. A secret token (sk.) is refused: “Paste a Mapbox public token: it starts with pk. A secret token (sk.) must never go here.”

  6. Select Save.

The token is stored encrypted and is not shown again. A public token is made for browsers: every browser that opens a map receives it. That is why you restrict it to your workspace’s address in Mapbox.

To place a venue, a city or a hotel on the map, OPERO looks up its address at Mapbox once and keeps the result. The Maps row shows how many lookups were made today, for example “12 of 500 lookups today”.

  • Daily lookup limit starts at 500. Enter 0 for no limit, for example on a paid Mapbox plan, and select Save.
  • At the limit, OPERO stops looking up places until the next day. Places found earlier stay on the map.
  • A venue Mapbox could not find is looked up again after 7 days, or at once when you change its address. Until then it shows at its city. Coordinates typed in by hand are never replaced.
  • If Mapbox stops answering for your account (usage limit, billing or a removed token), the row says so. OPERO tries again once an hour and clears the message by itself. Check connection tries at once.

Only place names and addresses (venues, cities and hotels), from your workspace’s server to Mapbox, to find where they are. The map itself loads in your browser from Mapbox. No names of people, bookings or money leave OPERO.

Mapbox is a service your workspace connects itself, under its own terms and costs.

On the Maps row, select Replace token to paste a new one, or Remove token. OPERO asks “Remove the map token?”: run maps then show the route as a list. Nothing else changes.