Jak korzystać z interfejsu Aerial View API

Interfejs Aerial View API obsługuje 2 ogólne przepływy pracy. Twoje podejście zależy od tego, czy film, którego dotyczy Twoje żądanie, istnieje. Jeśli nie masz pewności, czy film istnieje, użyj lookupVideoMetadata, aby określić jego stan.

Proces generowania lub pobierania filmów

Aby wygenerować lub pobrać film z widokiem z lotu ptaka, wykonaj te czynności:

1. Sprawdź, czy Google wygenerowało już film o lokalizacji, korzystając z lookupVideoMetadata.
2. Jeśli nie ma filmu (lookupVideoMetadata zwróciło błąd 404), wywołaj funkcję renderVideo, aby wygenerować nowy film.
   1. Wywołaj lookupVideoMetadata za pomocą videoId lub adresu, aby odpytywać punkt końcowy, dopóki stan filmu nie będzie ACTIVE. Renderowanie może potrwać kilka godzin, więc użyj wykładniczego wycofywania, aby rozłożyć wywołania w czasie.

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

   Uwaga: po wygenerowaniu przez Google filmu dla konkretnego adresu jest on dostępny dla wszystkich. Oznacza to, że film nie jest powiązany z konkretnym użytkownikiem ani kontem.

Ten przepływ pracy przedstawia poniższy diagram:

Zapisywanie identyfikatorów filmów do późniejszego wykorzystania

Zgodnie z Dodatkowymi warunkami korzystania z interfejsu Aerial View API identyfikatory filmów w interfejsie Aerial View API nie podlegają ograniczeniom dotyczącym buforowania określonym w sekcji 3.2.3(b)(Brak buforowania) Warunków korzystania z usługi Google Maps Platform. Dzięki temu możesz przechowywać wartości identyfikatorów filmów do wykorzystania w przyszłości.