Получить метаданные видео

При наличии действительного адреса или идентификатора видео метод lookupVideoMetadata возвращает метаданные, связанные с заданным видео. Метаданные в теле ответа позволяют определить актуальность изображения, продолжительность видео, а также предоставляют удобный алгоритм для подтверждения наличия видео.

Как использовать API

Вызовите эту конечную точку, передав ей закодированный в URL-формате почтовый адрес США или videoId .

curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideoMetadata?key=YOUR_API_KEY&address=POSTAL_ADDRESS"

Затем API возвращает один из следующих двух ответов:

  • Если видео существует, lookupVideoMetadata возвращает метаданные видео.
  • Если видеофайл не существует, API возвращает код ошибки 404.

Пример запроса

Приведенный ниже пример кода запрашивает видеосъемку с высоты птичьего полета для Трансамерикской пирамиды, расположенной по адресу: 600 Montgomery St, San Francisco, CA 94111.

curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideoMetadata?key=YOUR_API_KEY&address=600%20Montgomery%20St%2C%20San%20Francisco%2C%20CA%2094111"

Пример ответа

Приведенные ниже примеры в формате JSON демонстрируют все возможные ответы на запрос lookupVideoMetadata .

Видео найдено

Видео уже обработано.

{
  "videoId": "Ul1naoFmqo69U1zUVrQRkc",
  "captureDate": {
    "year": 2022,
    "month": 4,
    "day": 1
  },
  "duration": "40s",
  "state": "ACTIVE"
}

Видео обрабатывается

Видео находится в процессе обработки.

{
  "videoId": "Ul1naoFmqo69U1zUVrQRkc",
  "state": "PROCESSING"
}

Видео не найдено

Видео отсутствует в базе данных Google. Это может быть связано с тем, что оно ещё не было обработано, или с тем, что местоположение находится в неподдерживаемом регионе.

Если местоположение находится в поддерживаемой области , вы можете использовать renderVideo для инициирования запроса на рендеринг.

{
  "error": {
    "code": 404,
    "message": "Video not found.",
    "status": "NOT_FOUND"
  }
}