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 sprawdzić jego stan.

Proces generowania i pobierania filmów

Aby wygenerować lub pobrać film z widokiem z lotu:

1. Sprawdź, czy Google wygenerowało już film dotyczący tej lokalizacji za pomocą lookupVideoMetadata.
2. Jeśli nie ma żadnego filmu (lookupVideoMetadata zwrócił błąd 404), wywołaj funkcję renderVideo, aby wygenerować nowy film.
   1. Wywołaj lookupVideoMetadata za pomocą videoId lub adresu, aby sprawdzać stan urządzenia końcowego, dopóki stan filmu nie będzie wynosił ACTIVE. Przetwarzanie może potrwać kilka godzin, dlatego stosuj wygładzanie wykładnicze, aby rozłożyć wywołania w czasie.

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

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

Ten proces jest przedstawiony na diagramie poniżej:

Zapisywanie identyfikatorów filmów na potrzeby późniejszego użycia

Zgodnie z Warunkami korzystania z usługi Aerial View API identyfikatory filmów w tym interfejsie nie podlegają ograniczeniom dotyczącym przechowywania w pamięci podręcznej określonym w sekcji 3.2.3(b)(Brak przechowywania w pamięci podręcznej) Warunków korzystania z usługi Google Maps Platform. Możesz więc zapisać wartości identyfikatorów filmów do późniejszego wykorzystania.