Wenn eine gültige Adresse oder Video-ID angegeben wird, gibt die Methode lookupVideoMetadata die mit einem bestimmten Video verknüpften Metadaten zurück. Mit den Metadaten im Antworttext können Sie die Aktualität der Bilder und die Länge des Videos bestimmen. Außerdem steht Ihnen ein kostenloser Workflow zur Verfügung, mit dem Sie die Existenz von Videos bestätigen können.
Verwendung der API
Rufen Sie diesen Endpunkt auf, indem Sie eine URL-codierte US-Postanschrift oder eine videoId übergeben.
curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideoMetadata?key=YOUR_API_KEY&address=POSTAL_ADDRESS "
Die API gibt dann eine der folgenden beiden Antworten zurück:
- Wenn das Video vorhanden ist, gibt
lookupVideoMetadatadie Metadaten des Videos zurück. - Wenn das Video nicht vorhanden ist, gibt die API den Fehlercode 404 zurück.
Beispielanfrage
Im folgenden Codebeispiel wird ein Luftaufnahmevideo für die Transamerica Pyramide angefordert, die sich in 600 Montgomery St., San Francisco, CA 94111, befindet.
curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideoMetadata?key=YOUR_API_KEY&address=600%20Montgomery%20St%2C%20San%20Francisco%2C%20CA%2094111"
Beispielantwort
Die folgenden JSON-Beispiele zeigen alle möglichen Antworten auf die lookupVideoMetadata-Anfrage.
Video gefunden
Das Video wurde bereits gerendert.
{
"videoId": "Ul1naoFmqo69U1zUVrQRkc",
"captureDate": {
"year": 2022,
"month": 4,
"day": 1
},
"duration": "40s",
"state": "ACTIVE"
}
Video wird gerendert
Das Video wird gerendert.
{
"videoId": "Ul1naoFmqo69U1zUVrQRkc",
"state": "PROCESSING"
}
Video nicht gefunden
Das Video befindet sich nicht in der Datenbank von Google. Das kann daran liegen, dass die Karte noch nicht gerendert wurde oder dass sich der Standort in einer Region befindet, die nicht unterstützt wird.
Wenn sich der Standort in einem unterstützten Gebiet befindet, können Sie mit renderVideo eine Renderanfrage starten.
{
"error": {
"code": 404,
"message": "Video not found.",
"status": "NOT_FOUND"
}
}