Wenn eine gültige Adresse oder Video-ID angegeben wird, gibt die Methode lookupVideoMetadata die mit einem bestimmten Video verknüpften Metadaten zurück. Anhand der Metadaten im Antworttext können Sie die Aktualität der Bilder, die Länge des Videos und auch einen kostenlosen Workflow zur Bestätigung der Existenz von Videos ermitteln.
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 ist nicht in der Datenbank von Google enthalten. 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"
}
}