Ubicación

Puedes usar la API de Google Mirror para observar la ubicación del usuario en los elementos de la línea de tiempo, solicitar directamente su última ubicación conocida y suscribirte a actualizaciones periódicas de la ubicación. También puedes entregar imágenes de mapas renderizadas previamente en tarjetas de la línea de tiempo si le proporcionas a la API de Mirror las coordenadas para dibujar.

Cómo recuperar la última ubicación conocida

Para recuperar la última ubicación conocida para el usuario actual, envía una GET solicitud al extremo REST:

HTTP sin procesar

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

Cómo suscribirse a las actualizaciones de ubicación

Al igual que cuando te suscribes a las actualizaciones de la línea de tiempo, puedes suscribirte a las actualizaciones de ubicación si te suscribes a la colección.locations

HTTP sin procesar

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

Cómo renderizar mapas en tarjetas de la línea de tiempo

La API de Google Mirror puede renderizar mapas por ti y superponer marcadores y líneas para indicar lugares y rutas importantes. Usa el URI glass://map para solicitar un mapa. Por ejemplo:

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

A continuación, se incluye una descripción de los parámetros obligatorios:

  • w - El ancho en píxeles de la imagen del mapa que se muestra
  • h: La altura en píxeles de la imagen del mapa que se muestra

Solo se requiere uno de los elementos de la siguiente lista, pero puedes especificarlos todos:

  • center y zoom - El centro (latitud,longitud) del mapa que se renderizará y el nivel de zoom. Consulta Niveles de zoom para obtener más información.
  • marker - Especifica los marcadores de pin que se dibujarán en las coordenadas especificadas. El parámetro de marcador toma un tipo de marcador (0 indica un pin y 1, la ubicación actual), la coordenada de latitud y la coordenada de longitud. El mapa se centra y se acerca automáticamente alrededor de los marcadores que creas si no especificas explícitamente center y zoom.
  • polyline: Especifica las coordenadas de la polilínea para representar una ruta en el mapa. Cada polilínea consta de un ancho y un color, seguidos de los vértices de la polilínea. Por ejemplo: polyline=8,ffff0000;47.6,-122.34,47.62,-122.40 especifica una línea roja de 8 píxeles de ancho entre (47.6,-122.34) y (47.62,-122.40). El mapa se centra y se acerca automáticamente para ajustarse a la polilínea si no especificas explícitamente center y zoom.

En el siguiente ejemplo, se muestra una práctica recomendada para mostrar una imagen de mapa con texto y cómo se ve:

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

Mapa renderizado previamente en una tarjeta de la línea de tiempo