При наличии действительного адреса или идентификатора видео метод 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"
}
}