Jak korzystać z interfejsu Aerial View API

Interfejs Aerial View API obsługuje 2 ogólne przepływy pracy. Podejście zależy od tego, czy film, o który prosisz, istnieje. Jeśli nie masz pewności, czy film istnieje, użyj parametru lookupVideoMetadata, aby określić jego stan.

Proces generowania lub pobierania filmów

Aby wygenerować lub pobrać film ze zdjęciami z lotu ptaka, skorzystaj z poniższego przepływu pracy:

1. Sprawdź za pomocą pola lookupVideoMetadata, czy Google nie wygenerował już filmu dla danej lokalizacji.
2. Jeśli film nie istnieje (lookupVideoMetadata zwrócił błąd 404), wywołaj renderVideo, aby wygenerować nowy film.
   1. Wywołaj metodę lookupVideoMetadata, używając videoId lub adresu, aby odpytywać punkt końcowy, dopóki stan filmu nie zmieni się na ACTIVE. Renderowanie może potrwać kilka godzin, dlatego do oddzielania wywołań do odstępów między wywołaniami użyj wykładniczego ponowienia.

3. Jeśli film jest aktywny (lookupVideoMetadata zwrócił stan ACTIVE), wywołaj lookupVideo, aby pobrać identyfikatory URI filmu.

   Uwaga: gdy Google wygeneruje film dla określonego adresu, stanie się on dostępny dla wszystkich. Oznacza to, że film nie jest powiązany z konkretnym użytkownikiem ani kontem.

Przepływ pracy przedstawiliśmy na tym diagramie:

Zapisywanie identyfikatorów filmów do użycia w przyszłości

Zgodnie ze Szczegółowymi warunkami korzystania z interfejsu Aerial View API identyfikatory filmów z Aerial View API są zwolnione z ograniczeń buforowania opisanych w artykule 3.2.3(b) Warunków korzystania z usługi Google Maps Platform. Możesz więc zapisywać wartości identyfikatorów do wykorzystania w przyszłości.