Po podaniu prawidłowego adresu lub parametru videoID
lookupVideoMetadata
zwraca metadane powiązane z danym filmem. Metadane w pliku
pozwala określić aktualność zdjęć, długość
wideo, a także bezpłatna procedura potwierdzania istnienia filmów.
Jak korzystać z interfejsu API
Wywołaj ten punkt końcowy, przekazując mu zakodowany w adresie URL kod pocztowy w Stanach Zjednoczonych
adres lub
videoId
.
curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideoMetadata?key=YOUR_API_KEY&address=POSTAL_ADDRESS "
Interfejs API zwraca 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
Poniższy przykładowy kod umożliwia utworzenie filmu w widoku z lotu ptaka dla Transameryki Pyramid, mieści się pod adresem 600 Montgomery St, San Francisco, CA 94111, USA.
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 kodu JSON pokazują wszystkie możliwe odpowiedzi na żądanie
Prośba o: lookupVideoMetadata
.
Znaleziono film
Film został już wyrenderowany.
{
"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ł jeszcze lub dlatego, że lokalizacja znajduje się na nieobsługiwanym obszarze.
Jeśli lokalizacja znajduje się w obsługiwanej lokalizacji
, możesz użyć
renderVideo
aby zainicjować żądanie renderowania.
{
"error": {
"code": 404,
"message": "Video not found.",
"status": "NOT_FOUND"
}
}