Ta strona zawiera informacje o kluczowych funkcjach fotorealistycznych map 3D w Mapach JavaScript, które umożliwiają tworzenie interaktywnych i immersyjnych środowisk 3D. W tej dokumentacji znajdziesz informacje o:
- Obsługa zdarzeń interfejsu użytkownika w celu zapewnienia płynnej interakcji.
- Uwzględnia elementy sterowania służące do eksploracji przestrzeni 3D.
- Korzystanie z wstępnie ustawionych ścieżek kamery na potrzeby wycieczek z przewodnikiem.
- Zastosowanie ograniczeń aparatu w celu utrzymania ostrości na określonym obszarze.
Zdarzenia interfejsu użytkownika
W tej sekcji opisano interaktywne zdarzenia i powiadomienia o zmianie stanu, które możesz przechwytywać i obsługiwać programowo podczas pracy z mapami 3D. JavaScript w przeglądarce działa w sposób oparty na zdarzeniach, co oznacza, że reaguje na interakcje użytkownika, generując zdarzenia, które program może odbierać i odpowiednio wykonywać kod.
Wyróżniamy 2 główne typy zdarzeń:
- Zdarzenia interakcji użytkownika (np. kliknięcia myszką) są propagowane z widoku mapy 3D do Twojego kodu. Te zdarzenia umożliwiają reagowanie na bezpośrednie działania użytkownika w środowisku mapy 3D. Zobacz próbkę.
- Powiadomienia o zmianie stanu odzwierciedlają aktualizacje modeli danych mapy 3D i stanu renderowania za pomocą konwencjonalnego schematu nazewnictwa
property_changed.
Każdy obiekt interfejsu API mapowania 3D udostępnia zestaw nazwanych zdarzeń, dla których program może zarejestrować odbiorców zdarzeń i wykonywać logikę podczas ich wystąpienia za pomocą wbudowanej funkcji addEventListener(). Przykład poniżej pokazuje typowe zdarzenia wywoływane, gdy użytkownik wchodzi w interakcję z mapą 3D.
Z tego przykładu dowiesz się, które zdarzenia są wywoływane, gdy użytkownik wchodzi w interakcję z mapą:
Elementy sterujące eksploracji
Mapy wyświetlane w ramach interfejsu Maps JavaScript API w postaci fotorealistycznych map 3D zawierają elementy interfejsu użytkownika, które umożliwiają interakcję z mapą. Te elementy nazywamy ustawieniami użytkownika. Domyślnie są one uwzględnione, ale możesz wyłączyć je w aplikacji.
Na ilustracji poniżej widać domyślne elementy sterujące wyświetlane przez fotorealistyczne mapy 3D w Mapach JavaScript:
Poniżej znajdziesz pełną listę elementów sterujących w fotorealistycznych mapach 3D w JavaScript w Mapach:
- Element sterujący powiększeniem zawiera przyciski „+” i „-”, które służą do zmiany poziomu powiększenia mapy.
- Regulacja pochylenia pozwala zmienić pochylenie kamery.
- Za pomocą elementu sterującego Obrót możesz zmienić kierunek kamery.
- Element sterujący „Przenieś” zawiera przyciski „←”, „→”, „↑” i „↓” umożliwiające zmianę położenia środka mapy.
Elementy sterujące kamerą i animacja
Gotowe ścieżki kamery
Fotorealistyczne mapy 3D w Maps JavaScript zawierają 2 wstępnie ustawione ścieżki kamery. Ścieżki kamery możesz dostosować, zmieniając czas trwania animacji (co spowoduje zwiększenie lub zmniejszenie prędkości) lub łącząc je, aby uzyskać bardziej filmowy efekt.
Fotorealistyczne mapy 3D w Maps JavaScript obsługują te ścieżki kamery:
- Animacja
FlyCameraToprzenosi się z poziomu środka mapy do określonego miejsca docelowego. - Animacja
FlyCameraAroundobraca się wokół punktu na mapie tyle razy, ile razy określisz.
Te dwie dostępne ścieżki można połączyć, aby przelecieć do punktu zainteresowania, obrócić się wokół niego, a potem zatrzymać się w chwilę, gdy to konieczne.
Ograniczenia dotyczące kamery
Możesz chcieć kontrolować przesuwanie kamery, maksymalną wysokość lub tworzyć granice lat/lng ograniczające ruch użytkownika na danej mapie. Możesz to zrobić, stosując ograniczenia dotyczące aparatu.
Przykład działania i wdrażania ograniczeń dotyczących kamery znajdziesz w wersji demonstracyjnej.