Emplacement

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

Remarque : La récupération de la position géographique des utilisateurs nécessite le champ d'application https://www.googleapis.com/auth/glass.location supplémentaire.

Récupération de la dernière position connue

Pour récupérer le dernier emplacement connu 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}

Abonnement aux mises à jour de la position

Comme pour l'abonnement aux mises à jour de la chronologie, vous pouvez vous abonner aux mises à jour du lieu en vous abonnant à la collection locations.

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

Remarque : Pour le moment, les notifications de position sont envoyées toutes les 10 minutes.

Afficher des cartes sur des cartes chronologiques

L'API Google Mirror peut afficher des cartes pour vous et superposer des repères et des lignes pour indiquer des lieux et des chemins importants. Utilisez l'URI glass://map pour demander un mappage. 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"/>

Remarque : Spécifiez toujours la largeur et la hauteur de l'image dans le tag <img>. Cela empêche les reflows lors du rendu de l'image de carte.

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

Seul un des éléments de la liste suivante est également requis, mais vous pouvez tous les spécifier:

• center et zoom : centre (latitude,longitude) de la carte à afficher et au niveau de zoom. Pour en savoir plus, consultez Niveaux de zoom.
• marker : spécifiez les repères à tracer aux coordonnées spécifiées. Le paramètre de repère utilise un type de repère (0 indique un pin et un 1, l'emplacement actuel), les coordonnées de latitude et de longitude. Si vous ne spécifiez pas explicitement center et zoom, la carte se centre automatiquement sur les repères que vous avez créés et zoome dessus.
• polyline : spécifiez les coordonnées de la polyligne pour représenter un trajet 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). Le plan est automatiquement centré et zoomé sur la polyligne si vous ne spécifiez pas explicitement center et zoom.

L'exemple suivant montre 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>

Remarque : Vous pouvez omettre la couleur et la largeur de la polyligne, comme dans cet exemple. Dans ce cas, le rendu de la carte est effectué avec la couleur et la largeur par défaut.