Location

Mit der Google Mirror API können Sie den Standort des Nutzers in Zeitachsenelementen beobachten, seinen letzten bekannten Standort direkt anfordern und periodische Standortaktualisierungen abonnieren. Sie können auch vorgerenderte Kartenbilder in Zeitachsenkarten bereitstellen, indem Sie der Mirror API die Koordinaten für die Darstellung übergeben.

erforderlich.

Letzten bekannten Standort abrufen

Wenn Sie den letzten bekannten Standort des aktuellen Nutzers abrufen möchten, senden Sie eine GET-Anfrage an den REST-Endpunkt:

Roh-HTTP

GET /mirror/v1/locations/ HTTP/1.1
Authorization: Bearer {auth token}

Standortaktualisierungen abonnieren

Ähnlich wie beim Abonnieren von Zeitachsen-Updates können Sie Standortupdates abonnieren, indem Sie die Sammlung locations abonnieren.

Roh-HTTP

POST /mirror/v1/subscriptions HTTP/1.1
Authorization: Bearer {auth token}
Content-Type: application/json
Content-Length: {length}

{
  "collection": "locations",
  "userToken": "harold_penguin",
  "verifyToken": "random_hash_to_verify_referer",
  "callbackUrl": "https://example.com/notify/callback"
}

Karten auf Zeitachsekarten rendern

Mit der Google Mirror API können Karten gerendert und Markierungen und Linien eingeblendet werden, um wichtige Orte und Pfade zu kennzeichnen. Verwenden Sie den URI glass://map, um eine Karte anzufordern. Beispiel:

<img src="glass://map?w=width&h=height&marker=0;latitude,longitude&marker=1;latitude,longitude&polyline=;latitude,longitude,latitude,longitude"
  width="width"
  height="height"/>

Hier finden Sie eine Beschreibung der erforderlichen Parameter:

  • w – Die Breite des zurückgegebenen Kartenbilds in Pixeln
  • h – Die Höhe des zurückgegebenen Kartenbilds in Pixeln

Es ist nur eines der Elemente in der folgenden Liste zusätzlich erforderlich, Sie können aber alle angeben:

  • center und zoom: Der Mittelpunkt (Breiten- und Längengrad) der Karte, die gerendert werden soll, und die Zoomstufe. Weitere Informationen finden Sie unter Zoomstufen.
  • marker: Gibt die Markierungen an, die an den angegebenen Koordinaten gezeichnet werden sollen. Der Parameter „marker“ akzeptiert einen Markertyp (0 gibt einen pin und 1 an, den aktuellen Standort), die Breitengradkoordinate und die Längengradkoordinate. Die Karte wird automatisch zentriert und auf die von Ihnen erstellten Markierungen gezoomt, wenn Sie center und zoom nicht explizit angeben.
  • polyline: Geben Sie die Polylinienkoordinaten an, um einen Pfad auf der Karte darzustellen. Jeder Linienzug besteht aus einer Breite und einer Farbe, gefolgt von den Eckpunkten des Linienzugs. Beispiel: polyline=8,ffff0000;47.6,-122.34,47.62,-122.40 gibt eine 8 Pixel breite rote Linie zwischen (47.6,-122.34) und (47.62,-122.40) an. Die Karte wird automatisch zentriert und gezoomt, um die Polylinie darzustellen, wenn Sie center und zoom nicht explizit angeben.

Das folgende Beispiel zeigt eine Best Practice für die Darstellung eines Kartenbilds mit etwas Text und wie das Ergebnis aussieht:

<article>
  <figure>
    <img src="glass://map?w=240&h=360&marker=0;42.369590,
      -71.107132&marker=1;42.36254,-71.08726&polyline=;42.36254,
      -71.08726,42.36297,-71.09364,42.36579,-71.09208,42.3697,
      -71.102,42.37105,-71.10104,42.37067,-71.1001,42.36561,
      -71.10406,42.36838,-71.10878,42.36968,-71.10703"
      height="360" width="240">
  </figure>
  <section>
    <div class="text-auto-size">
      <p class="yellow">12 minutes to home</p><p>Medium traffic on Broadway</p>
    </div>
  </section>
</article>

Vorgerenderte Karte auf einer Zeitachsenkarte