Как использовать API-интерфейс аэрофотосъемки

API Aerial View поддерживает два основных рабочих процесса. Ваш подход зависит от того, существует ли запрашиваемое видео. Если вы не уверены, существует ли видео, используйте lookupVideoMetadata для определения его состояния.

Рабочий процесс создания или извлечения видео

Для создания или извлечения видео с высоты птичьего полета используйте следующий рабочий процесс:

1. Проверьте, сгенерировал ли Google уже видео для этого местоположения, используя lookupVideoMetadata .
2. Если видео не существует ( lookupVideoMetadata вернул ошибку 404), вызовите renderVideo для создания нового видео.
   1. Вызовите lookupVideoMetadata , используя videoId или адрес, чтобы опрашивать конечную точку, пока состояние видео не станет ACTIVE . Рендеринг может занять несколько часов, поэтому используйте экспоненциальную задержку для разнесения вызовов.

3. Если видео активно ( lookupVideoMetadata вернул состояние ACTIVE ), вызовите lookupVideo , чтобы получить URI видео.

   Примечание: После того, как Google сгенерирует видео для определённого адреса, оно становится доступно всем. То есть видео не привязано к конкретному пользователю или учётной записи.

Этот рабочий процесс представлен на диаграмме ниже:

Сохраните идентификаторы видео для дальнейшего использования.

В соответствии со Специальными условиями использования Aerial View API, идентификаторы видео Aerial View API не подпадают под ограничения по кэшированию, указанные в Разделе 3.2.3(b) (Запрет кэширования) Условий использования платформы Google Карт. Таким образом, вы можете сохранять значения идентификаторов видео для последующего использования.