Metoda renderVideo
wymaga wygenerowania filmu z widokiem z lotu dla podanego adresu pocztowego w Stanach Zjednoczonych. Jeśli film jest już dostępny pod podanym adresem, ta metoda zwróci metadane filmu.
Jak korzystać z interfejsu API
Wygeneruj nowy film z lotu, wysyłając żądanie HTTPS POST do punktu końcowego renderVideo
, podając klucz interfejsu API i adres pocztowy w Stanach Zjednoczonych, jak pokazano w tym przykładzie. Proces renderowania może potrwać od godziny do kilku godzin.
curl -X POST -d '{ "address": "POSTAL_ADDRESS" }' \ -H 'Content-Type: application/json' \ "https://aerialview.googleapis.com/v1/videos:renderVideo?key=YOUR_API_KEY"
Przykładowe żądanie
Poniższy przykładowy kod wymaga wygenerowania filmu widokowego z lotu ptaka dla 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"
Przykładowa odpowiedź
Poniższe przykłady kodu JSON pokazują możliwe odpowiedzi na przykładowe żądanie dotyczące filmu.
Nieprawidłowa odpowiedź dotycząca adresu
Adres jest nieprawidłowy lub nie znajduje się w Stanach Zjednoczonych.
{
"error": {
"code": 400,
"message": "Address not supported.",
"status": "INVALID_ARGUMENT"
}
}
Odpowiedź na żądanie przetwarzania
Aerial View API renderuje teraz Twój film. Odpowiedź zawiera tag videoId
, który umożliwia pobranie filmu.
{
"state": "PROCESSING",
"metadata": {
"videoId": "x89iJAJi1wzs7DIAFQF7Va"
}
}
Proces renderowania może potrwać od godziny do kilku godzin. Jeśli film jest nadal przetwarzany, za pomocą narzędzia lookupVideo
możesz przeprowadzać sondowanie jego stanu, dopóki nie zwróci on stanu ACTIVE
.
Aby przeprowadzić ankietę, wyślij żądanie do lookupVideo
, przekazując parametr videoId
. Przetwarzanie może potrwać kilka godzin, dlatego użyj wykładniczego zmniejszania wartości, aby rozłożyć wywołania w czasie.
Aktywna odpowiedź
Gdy funkcja renderVideo
zwraca wartość state
o wartości ACTIVE
, oznacza to, że renderowanie filmu zostało zakończone i możesz go pobrać, wywołując lookupVideo
przy użyciu metody videoId
.
{
"state": "ACTIVE",
"metadata": {
"videoId": "x89iJAJi1wzs7DIAFQF7Va"
}
}