항공 보기 API 사용 방법

Aerial View API는 두 가지 일반적인 워크플로를 지원합니다. 요청하는 동영상이 있는지 여부에 따라 접근 방식이 달라집니다. 동영상이 있는지 확실하지 않은 경우 lookupVideoMetadata를 사용하여 동영상 상태를 확인해야 합니다.

동영상 생성 또는 검색 워크플로

다음 워크플로에 따라 공중 촬영 동영상을 생성하거나 검색하세요.

  1. lookupVideoMetadata를 사용하여 Google에서 해당 위치의 동영상을 이미 생성했는지 확인합니다.
  2. 동영상이 없는 경우 (lookupVideoMetadata가 404를 반환함) renderVideo를 호출하여 새 동영상을 생성합니다.
    1. videoId 또는 주소를 사용하여 lookupVideoMetadata를 호출하여 동영상 상태가 ACTIVE가 될 때까지 엔드포인트를 폴링합니다. 렌더링하는 데 몇 시간이 걸릴 수 있으므로 지수 백오프를 사용하여 호출 간격을 둡니다.
  3. 동영상이 활성 상태인 경우 (lookupVideoMetadataACTIVE 상태를 반환함) lookupVideo를 호출하여 동영상의 URI를 가져옵니다.

이 워크플로는 아래 다이어그램에 나와 있습니다.

위에 설명된 워크플로를 보여주는 차트

나중에 사용하기 위해 동영상 ID 저장

Aerial View API의 서비스별 약관에 따라 Aerial View API 동영상 ID에는 Google Maps Platform 서비스 약관의 3.2.3(b)(캐싱 불가)항에 명시된 캐싱 제한사항이 적용되지 않습니다. 따라서 나중에 사용하기 위해 동영상 ID 값을 저장할 수 있습니다.