Die
renderVideo
-Methode die Generierung eines Luftbildvideos für die angegebenen US-amerikanischen
Postanschrift. Wenn das Video für die angegebene Adresse bereits vorhanden ist, wird dies
gibt Metadaten zum Video zurück.
Verwendung der API
Generieren Sie ein neues Luftvideo, indem Sie eine HTTPS-POST-Anfrage an die
renderVideo
Endpunkt, indem du deinen API-Schlüssel und eine US-Postadresse wie unten gezeigt übergibst.
im folgenden Beispiel. Der Rendering-Prozess kann bis zu einer Stunde dauern.
auf ein paar Stunden.
curl -X POST -d '{ "address": "POSTAL_ADDRESS" }' \ -H 'Content-Type: application/json' \ "https://aerialview.googleapis.com/v1/videos:renderVideo?key=YOUR_API_KEY"
Beispielanfrage
Im folgenden Codebeispiel wird die Generierung eines Luftbildvideos für 500 W 2nd St, Austin, TX, 78701, USA.
curl -X POST -d '{ "address": "500 W 2nd St, Austin, TX 78701" }' \ -H 'Content-Type: application/json' \ "https://aerialview.googleapis.com/v1/videos:renderVideo?key=YOUR_API_KEY"
Beispielantwort
Die folgenden JSON-Codebeispiele zeigen die möglichen Antworten auf das Beispielvideo.
Ungültige Adressantwort
Die Adresse ist entweder falsch oder befindet sich nicht in den USA.
{
"error": {
"code": 400,
"message": "Address not supported.",
"status": "INVALID_ARGUMENT"
}
}
Antwort wird verarbeitet
Die Aerial View API rendert Ihr Video jetzt. Die Antwort enthält den
videoId
, mit dem du das Video abrufen kannst.
{
"state": "PROCESSING",
"metadata": {
"videoId": "x89iJAJi1wzs7DIAFQF7Va"
}
}
Der Rendering-Prozess kann zwischen einer und mehreren Stunden dauern. Wenn der Parameter
Das Video wird noch verarbeitet. Mit lookupVideo
kannst du den Videostatus abfragen.
bis sie den Status ACTIVE
zurückgibt.
Stellen Sie zum Abfragen eine Anfrage an lookupVideo
und übergeben Sie die videoId
. Das Rendern kann
die mehrere Stunden dauern. Verwenden Sie daher exponentielle
Backoff für mehr Abstände zwischen Ihren Anrufen.
Aktive Antwort
Wenn renderVideo
den state
-Wert ACTIVE
zurückgibt, wurde das Video
das Rendering abgeschlossen haben. Sie können es abrufen, indem Sie lookupVideo
mit der Methode
videoId
{
"state": "ACTIVE",
"metadata": {
"videoId": "x89iJAJi1wzs7DIAFQF7Va"
}
}