Location

Vous pouvez utiliser l'API Google Mirror pour observer la position de l'utilisateur dans les éléments de la timeline, demander directement sa dernière position connue et vous abonner aux mises à jour périodiques de sa position. Vous pouvez également fournir des images de carte pré-rendues dans les cartes de la timeline en indiquant à l'API Mirror les coordonnées à dessiner.

Récupérer la dernière position connue

Pour récupérer la dernière position connue de l'utilisateur actuel, envoyez une requête GET au point de terminaison REST :

HTTP brut

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

S'abonner aux mises à jour de la position

Comme pour les mises à jour de la timeline, vous pouvez vous abonner aux mises à jour de la position en vous abonnant à la locations collection.

HTTP brut

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"
}

Afficher des cartes sur les cartes de la timeline

L'API Google Mirror peut afficher des cartes et superposer des repères et des lignes pour indiquer des lieux et des chemins importants. Utilisez l'URI glass://map pour demander une carte. Exemple :

<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"/>

Voici une description des paramètres obligatoires :

  • w : largeur en pixels de l'image de carte renvoyée.
  • h : hauteur en pixels de l'image de carte renvoyée.

Un seul des éléments de la liste suivante est requis, mais vous pouvez tous les spécifier :

  • center et zoom : centre (latitude,longitude) de la carte à afficher et niveau de zoom. Pour en savoir plus, consultez Niveaux de zoom.
  • marker : spécifiez les repères à dessiner aux coordonnées indiquées. Le paramètre de repère accepte un type de repère (0 indique un pin et 1, la position actuelle), la coordonnée de latitude et la coordonnée de longitude. La carte se centre et effectue un zoom automatiquement autour des repères que vous créez si vous ne spécifiez pas explicitement center et zoom.
  • polyline : spécifiez les coordonnées de la polyligne pour représenter un chemin sur la carte. Chaque polyligne se compose d'une largeur et d'une couleur, suivies des sommets de la polyligne. Par exemple, polyline=8,ffff0000;47.6,-122.34,47.62,-122.40 spécifie une ligne rouge de 8 pixels de large entre (47.6,-122.34) et (47.62,-122.40). La carte est automatiquement centrée et zoomée pour s'adapter à la polyligne si vous ne spécifiez pas explicitement center et zoom.

L'exemple suivant illustre une bonne pratique pour afficher une image de carte avec du texte et son apparence :

<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>

Carte prérendue sur une fiche de timeline