Pobieranie metadanych filmu

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. Być może nie został jeszcze zostały wyrenderowane lub 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"
  }
}