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

При наличии действительного адреса или идентификатора видео метод 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, Сан-Франциско, Калифорния, 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. Возможно, оно ещё не отрендерено или находится в зоне, не поддерживаемой Google.

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

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

При наличии действительного адреса или идентификатора видео метод 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, Сан-Франциско, Калифорния, 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. Возможно, оно ещё не отрендерено или находится в зоне, не поддерживаемой Google.

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

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