Bei einer gültigen Adresse oder Video-ID gibt die Methode lookupVideoMetadata Metadaten zurück, die mit einem bestimmten Video verknüpft sind. Anhand der Metadaten im Antworttext können Sie die Aktualität der Bilder und die Länge des Videos ermitteln. Darüber hinaus bieten sie einen kostenlosen Workflow, um die Existenz von Videos zu bestätigen.
Verwendung der API
Rufen Sie diesen Endpunkt auf, indem Sie ihm 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 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
Mit dem folgenden Codebeispiel wird ein Video aus der Vogelperspektive für die Transamerica Pyramid in 600 Montgomery St, San Francisco, CA 94111 angefordert.
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 veranschaulichen 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 er noch nicht gerendert wurde oder sich der Standort in einer Region befindet, die nicht unterstützt wird.
Befindet sich der Standort in einem unterstützten Gebiet, können Sie mit renderVideo eine Renderinganfrage initiieren.
{
"error": {
"code": 404,
"message": "Video not found.",
"status": "NOT_FOUND"
}
}