위치

Google Mirror API를 사용하여 타임라인 항목에서 사용자의 위치를 관찰하고 마지막으로 알려진 위치를 직접 요청하며 정기 위치 업데이트를 구독할 수 있습니다. 또한 Mirror API에 그릴 좌표를 제공하여 사전 렌더링된 지도 이미지를 타임라인 카드에 제공할 수도 있습니다.

알려진 최신 위치 가져오기

현재 사용자의 알려진 최신 위치를 검색하려면 REST 엔드포인트에 GET 요청을 보냅니다.

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

타임라인 카드에서 지도 렌더링

Google Mirror API는 지도를 렌더링하고 마커와 선을 오버레이하여 중요한 장소와 경로를 나타낼 수 있습니다. glass://map URI를 사용하여 지도를 요청합니다. 예를 들면 다음과 같습니다.

<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 - 지정된 좌표에 그릴 핀 마커를 지정합니다. 마커 매개변수는 마커 유형(0는 pin 및 1, 현재 위치), 위도 좌표, 경도 좌표를 나타냅니다. center 및 zoom를 명시적으로 지정하지 않으면 지도는 개발자가 만든 마커를 중심으로 하고 확대/축소합니다.
  • polyline - 지도에서 경로를 나타내는 다중선 좌표를 지정합니다. 각 다중선은 너비와 색상, 그리고 다중선의 꼭짓점으로 구성됩니다. 예를 들어 polyline=8,ffff0000;47.6,-122.34,47.62,-122.40는 (47.6,-122.34)과 (47.62,-122.40) 사이의 8픽셀 너비의 빨간색 선을 지정합니다. 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>

타임라인 카드의 사전 렌더링된 지도