Local

Você pode usar a API Google Mirror para observar a localização do usuário em itens da linha do tempo, solicitar o último local conhecido diretamente e se inscrever para receber atualizações periódicas de localização. Você também pode exibir imagens de mapas pré-renderizadas em cartões de linha do tempo, fornecendo à API Mirror as coordenadas para desenho.

Observação: para recuperar a localização dos usuários, é necessário o escopo adicional https://www.googleapis.com/auth/glass.location.

Como acessar a última localização conhecida

Para recuperar a última localização conhecida do usuário atual, envie uma solicitação GET ao endpoint REST:

HTTP bruto

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

Inscrever-se para receber atualizações de local

Assim como se inscrever para receber atualizações da Linha do tempo, você pode se inscrever para receber atualizações de local ao se inscrever na coleção locations.

HTTP bruto

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

Observação: no momento, as notificações de local são enviadas a cada 10 minutos.

Renderização de mapas em cards da linha do tempo

A API Google Mirror pode renderizar mapas para você e sobrepor marcadores e linhas para indicar lugares e caminhos importantes. Use o URI glass://map para solicitar um mapa. Veja um exemplo:

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

Observação: sempre especifique a largura e a altura da imagem também na tag <img>. Isso evita reflows enquanto a imagem do mapa está sendo renderizada.

Confira a descrição dos parâmetros obrigatórios:

• w: a largura em pixels da imagem do mapa retornada.
• h: a altura em pixels da imagem do mapa retornada.

Apenas um dos itens na lista a seguir é obrigatório, mas você pode especificar todos eles:

• center e zoom: o centro (latitude,longitude) do mapa a ser renderizado e o nível de zoom. Consulte Níveis de zoom para mais informações.
• marker: especifique os marcadores de alfinete a serem desenhados nas coordenadas especificadas. O parâmetro "marker" usa um tipo de marcador (0 indica um pin e 1, o local atual), a coordenada de latitude e a coordenada de longitude. O mapa é centralizado e aumenta automaticamente ao redor dos marcadores criados se você não especificar explicitamente center e zoom.
• polyline: especifique as coordenadas da polilinha para representar um caminho no mapa. Cada polilinha consiste em uma largura e uma cor seguidas pelos vértices na polilinha. Por exemplo, polyline=8,ffff0000;47.6,-122.34,47.62,-122.40 especifica uma linha vermelha de 8 pixels de largura entre (47.6,-122.34) e (47.62,-122.40). O mapa é automaticamente centralizado e ampliado para ajustar a polilinha se você não especificar center e zoom.

O exemplo a seguir mostra uma prática recomendada de como exibir uma imagem do mapa com algum texto e como ela aparece:

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

Observação: é possível omitir a cor e a largura da polilinha, como neste exemplo. O mapa é renderizado usando a cor e a largura padrão nessa situação.