항공 보기 API 사용 방법

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

동영상을 생성하거나 검색하는 워크플로

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

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

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

   참고: Google에서 특정 주소의 동영상을 생성하면 누구나 해당 동영상을 볼 수 있습니다. 즉, 동영상이 특정 사용자 또는 계정과 연결되지 않습니다.

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

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

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