Jak korzystać z interfejsu Aerial View API

Interfejs Aerial View API obsługuje 2 ogólne przepływy pracy. Sposób postępowania zależy od tego, czy film, o który prosisz, istnieje, czy nie. Jeśli nie masz pewności, czy film istnieje, użyj właściwości lookupVideoMetadata, aby określić jego stan.

Proces generowania lub pobierania filmów

Aby wygenerować lub pobrać film w widoku z lotu ptaka, użyj poniższego przepływu pracy:

1. Sprawdź, czy film dla tej lokalizacji został już wygenerowany przez Google za pomocą narzędzia lookupVideoMetadata.
2. Jeśli film nie istnieje (lookupVideoMetadata zwrócił błąd 404), wywołaj renderVideo, aby wygenerować nowy film.
   1. Wywołaj funkcję lookupVideoMetadata za pomocą parametru videoId lub adresu, aby sondować punkt końcowy, dopóki stan filmu nie zmieni się na ACTIVE. Renderowanie może potrwać kilka godzin, więc użyj wykładniczego czasu do ponowienia, aby rozłożyć wywołania.

3. Jeśli film jest aktywny (lookupVideoMetadata zwraca stan ACTIVE), wywołaj metodę lookupVideo, aby pobrać jego identyfikatory URI.

   Uwaga: gdy Google wygeneruje film dla danego adresu, będzie on dostępny dla wszystkich. Oznacza to, że film nie jest powiązany z konkretnym użytkownikiem ani kontem.

Przepływ pracy przedstawia ten schemat:

Zapisywanie identyfikatorów filmów do późniejszego użycia

Zgodnie ze Szczegółowymi warunkami korzystania z interfejsu Aerial View API identyfikatory filmów w interfejsie Aerial View API są zwolnione z ograniczeń dotyczących buforowania opisanych w Sekcji 3.2.3(b)(Brak zapisywania w pamięci podręcznej) Warunków korzystania z Google Maps Platform. Możesz więc zapisywać wartości identyfikatorów filmów do późniejszego wykorzystania.