Skip to content
Eagle Eyes Eagle Eyes Mirada

Connecting Eagle Eyes Mirada to CalTopo

Eagle Eyes Mirada connects to CalTopo so your case and the team’s shared CalTopo map stay in sync. Once connected, your bookmarks push up to the map as CalTopo markers, and the map’s markers, shapes and folders come back into Mirada.

This page walks through connecting Mirada to a CalTopo map.

Before you start

Section titled “Before you start”

You can connect read-only to any public or URL-shared CalTopo map with no setup. To get two-way sync — where Mirada also writes markers back to the map — you need a CalTopo service account (covered below).

Connect to a map

Section titled “Connect to a map”

Click the CalTopo button on the map to open External Sync Services, then click Add CalTopo Map. The dialog walks top to bottom:

  1. Service account (optional). The top of the dialog shows your service account status. Without one it reads “No CalTopo service account configured” — you can still connect read-only to public/URL maps. Click Configure to add credentials for two-way sync (see below).
  2. Pick the map. Choose a source tab:
    • Team Maps — maps on your CalTopo account (requires a service account).
    • URL — paste a CalTopo map URL or ID (for example https://caltopo.com/m/QN6EKG4).
    • QR Code — scan a map’s QR code.
    • Livestreams — use the CalTopo map shared by a livestream you’re viewing.
    • Recent — a map you connected to before.
  3. Choose the access level. Toggle between Read Only (view synced markers and shapes) and Read & Update (two-way sync, requires a service account).
  4. Test. Mirada tests the connection automatically. On success it shows “Connected successfully” with the map name and how many objects it found.
  5. Connect. Click Connect to Map. Mirada runs a first sync and zooms the map to the synced features.

Configure a service account

Section titled “Configure a service account”

A CalTopo service account lets Mirada reach your team’s maps and write markers back for two-way sync. You set one up once, then reuse it across cases.

To add or edit a service account, click Configure (or Edit) next to the service account line in the Add CalTopo Map dialog. The CalTopo Service Account dialog offers three ways to load credentials:

  • File — load a service-account JSON file you were given.
  • QR Code — scan a service-account QR code.
  • Manual — type in the Account ID, Credential ID, and Secret Key.

Mirada verifies the credentials as you enter them and shows your team name when they check out. Click Save to store the service account.

Setting up the service account itself happens in CalTopo (you’ll need admin access to your CalTopo Teams account), and the steps are easiest to follow in a short video:

Watch: setting up a CalTopo service account

After connecting

Section titled “After connecting”

The CalTopo button on the map shows the current state — read-only, read & update, syncing, or an error — and the map’s contents appear in the sidebar under Map Objects, where you can toggle their visibility and click any feature to zoom to it.