위치

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>

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