Puedes usar la API de duplicación de Google para observar la ubicación del usuario en los elementos de cronograma, solicitar su última ubicación conocida directamente y suscribirse a actualizaciones periódicas de ubicación. También puedes enviar imágenes de mapa procesadas previamente en tarjetas de cronograma si proporcionas a la API de Mirror las coordenadas para dibujar.
Recuperando la ubicación más reciente
Si quieres recuperar la ubicación más reciente del usuario actual, envía una solicitud GET
al extremo de REST:
HTTP sin procesar
GET /mirror/v1/locations/ HTTP/1.1
Authorization: Bearer {auth token}
Suscribirse a las actualizaciones de ubicación
De manera similar a la suscripción a las actualizaciones de cronograma, 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 las tarjetas de cronograma
La API de Google Mirror puede representarte 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"/>
Esta es una descripción de los parámetros obligatorios:
w
: El ancho en píxeles de la imagen del mapa que se muestrah
: es la altura en píxeles de la imagen del mapa que se muestra.
Además, solo se requiere uno de los elementos de la siguiente lista, pero puedes especificarlos todos:
center
yzoom
: El centro (latitud y longitud) del mapa para 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
indicapin
y1
, la ubicación actual), la coordenada de latitud y la coordenada de longitud. El mapa se centra y acerca de forma automática alrededor de los marcadores que creas si no especificascenter
yzoom
de forma explícita.polyline
: Especifica las coordenadas de la polilínea para representar una ruta en el mapa. Cada polilínea consiste en un ancho y un color seguidos por 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 ajusta automáticamente para que se ajuste a la polilínea si no especificas explícitamentecenter
yzoom
.
En el siguiente ejemplo, se muestra una práctica recomendada para mostrar una imagen de mapa con texto y su aspecto:
<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>