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

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

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

Для создания или получения видеоролика с видом сверху используйте следующий алгоритм действий:

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

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

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

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

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

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