Wenn eine gültige Adresse oder Video-ID angegeben ist, gibt die Methode lookupVideoMetadata Metadaten zurück, die mit einem bestimmten Video verknüpft sind. 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
Übergeben Sie zum Aufrufen dieses Endpunkts eine URL-codierte US-Postadresse oder einen videoId.
curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideoMetadata?key=YOUR_API_KEY&address=POSTAL_ADDRESS "
Die API gibt dann eine der folgenden zwei Antworten zurück:
- Wenn das Video vorhanden ist, gibt
lookupVideoMetadatadie Metadaten des Videos zurück. - Falls das Video nicht vorhanden ist, gibt die API einen 404-Fehlercode zurück.
Beispielanfrage
Das folgende Codebeispiel fordert ein Video aus der Vogelperspektive für die Transamerica Pyramid an, 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"
Beispielantwort
Die folgenden JSON-Beispiele zeigen alle möglichen Antworten auf die Anfrage lookupVideoMetadata.
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 könnte daran liegen, dass sie entweder noch nicht gerendert wurde oder sich der Standort in einem nicht unterstützten Gebiet befindet.
Befindet sich der Standort in einer unterstützten Region, können Sie mit renderVideo eine Renderinganfrage initiieren.
{
"error": {
"code": 404,
"message": "Video not found.",
"status": "NOT_FOUND"
}
}