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 i 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 wysłać zapytanie do punktu końcowego, 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.

Ten przepływ pracy przedstawia poniższy diagram:

Wykres przedstawiający opisany powyżej przepływ pracy

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.