Jeśli podasz prawidłowy adres lub identyfikator filmu, metoda lookupVideoMetadata
zwraca metadane powiązane z danym filmem. Metadane w treści odpowiedzi pozwalają określić aktualność obrazu i długość filmu, a także bezpłatnie potwierdzać istnienie filmów.
Jak korzystać z interfejsu API
Wywołaj ten punkt końcowy, przekazując mu zakodowany URL adres pocztowy w Stanach Zjednoczonych lub kod videoId
.
curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideoMetadata?key=YOUR_API_KEY&address=POSTAL_ADDRESS "
Interfejs API zwraca wówczas jedną z tych 2 odpowiedzi:
- Jeśli film istnieje,
lookupVideoMetadata
zwraca jego metadane. - Jeśli film nie istnieje, interfejs API zwraca kod błędu 404.
Przykładowe żądanie
Następujący przykładowy kod zawiera żądanie filmu z lotu ptaka przedstawiającego piramidę Transamerica Pyramid w pobliżu 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"
Przykładowa odpowiedź
Poniższe przykłady JSON pokazują wszystkie możliwe odpowiedzi na żądanie lookupVideoMetadata
.
Znaleziono film
Film został już zrenderowany.
{
"videoId": "Ul1naoFmqo69U1zUVrQRkc",
"captureDate": {
"year": 2022,
"month": 4,
"day": 1
},
"duration": "40s",
"state": "ACTIVE"
}
Film jest renderowany
Film jest renderowany.
{
"videoId": "Ul1naoFmqo69U1zUVrQRkc",
"state": "PROCESSING"
}
Nie znaleziono filmu
Film nie znajduje się w bazie danych Google. Przyczyną może być to, że nie została jeszcze wyrenderowana lub lokalizacja znajduje się na obszarze, który nie jest obsługiwany.
Jeśli lokalizacja znajduje się na obsługiwanym obszarze, możesz zainicjować żądanie renderowania za pomocą renderVideo
.
{
"error": {
"code": 404,
"message": "Video not found.",
"status": "NOT_FOUND"
}
}