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

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

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

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

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

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

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

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

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

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