Location

You can use the Google Mirror API to observe the user's location in timeline items, request their last known location directly, and subscribe to periodic location updates. You can also deliver pre-rendered map images in timeline cards by giving the Mirror API the coordinates to draw.

Получение последнего известного местоположения

Чтобы получить последнее известное местоположение текущего пользователя, отправьте GET запрос на REST-конечную точку:

Необработанный HTTP 

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

Подписка на обновления местоположения

Аналогично подписке на обновления хронологии , вы можете подписаться на обновления местоположения, подписавшись на коллекцию locations .

Необработанный HTTP 

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

Отображение карт на карточках временной шкалы

API Google Mirror может отображать карты и накладывать на них маркеры и линии, обозначающие важные места и маршруты. Используйте URI glass://map для запроса карты. Вот пример:

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

Ниже приведено описание необходимых параметров:

  • w — ширина возвращаемого изображения карты в пикселях.
  • h - Высота возвращаемого изображения карты в пикселях

Дополнительно требуется только один из пунктов в следующем списке, но вы можете указать все:

  • center и zoom — Центр карты (широта, долгота), в котором будет отображаться карта, и уровень масштабирования. Дополнительную информацию см. в разделе «Уровни масштабирования» .
  • marker - Specify the pin markers to draw at the specified coordinates. The marker parameter takes a marker type ( 0 indicates a pin and 1 , the current location), the latitude coordinate, and the longitude coordinate. The map automatically centers and zooms around the markers you create if you don't explicitly specify center and zoom .
  • polyline — укажите координаты полилинии, представляющей путь на карте. Каждая полилиния состоит из ширины и цвета, за которыми следуют вершины полилинии. Например: polyline=8,ffff0000;47.6,-122.34,47.62,-122.40 задает красную линию шириной 8 пикселей между ( 47.6,-122.34 ) и ( 47.62,-122.40 ). Карта автоматически центрируется и масштабируется в соответствии с полилинией, если вы явно не укажете center и zoom .

В следующем примере показан лучший способ отображения изображения карты с текстом и то, как это выглядит:

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

предварительно отрисованная карта на карточке временной шкалы