항공 보기 API 사용 방법

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

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

다음 워크플로를 사용하여 항공 뷰 동영상을 생성하거나 가져옵니다.

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

3. 동영상이 활성 상태이면 (lookupVideoMetadata에서 ACTIVE 상태를 반환함) lookupVideo를 호출하여 동영상의 URI를 가져옵니다.

   참고: Google에서 특정 주소의 동영상을 생성하면 모든 사용자가 이 동영상을 사용할 수 있습니다. 즉, 동영상은 특정 사용자 또는 계정과 연결되지 않습니다.

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

나중에 사용할 수 있도록 동영상 ID 저장

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