Użytkownicy mogą sterować powiększeniem, pochyleniem, pozycją i obrotem kamery za pomocą gestów na mapie. Możesz też skonfigurować kamerę automatycznie.
Pozycja kamery
Widok mapy jest modelowany jako kamera skierowana na określony punkt w przestrzeni 3D. Położenie i orientacja kamery (a tym samym renderowanie mapy) są określone przez te właściwości: środek (lokalizacja określona przez szerokość, długość i wysokość geograficzną, na którą jest skierowana kamera), kierunek, nachylenie, zasięg i obrót.
Środek (szerokość/długość geograficzna/wysokość)
Środek określa konkretny punkt w przestrzeni 3D, który obserwuje kamera.
Jest to określone za pomocą klasy LatLngAltitude, która łączy wartości szerokości, długości i wysokości geograficznej. Umożliwia to precyzyjne ustawienie punktu ogniskowego kamery w trzech wymiarach.
Szerokość geograficzna może mieścić się w zakresie od -90 do 90 stopni. Długość geograficzna mieści się w zakresie od -180 do 180 stopni włącznie. Wysokość jest podawana w metrach nad poziomem morza.
Nagłówek
Kierunek kamery określa kierunek, w którym będzie ona skierowana. Jest on mierzony w stopniach zgodnie z ruchem wskazówek zegara od północy geograficznej. Północ to 0 stopni, wschód – 90 stopni, południe – 180 stopni, a zachód – 270 stopni. Określa to orientację kamery wokół osi pionowej punktu środkowego.
Pochylenie
Parametr tilt określa kąt kamery względem osi pionowej w stopniach. Pochylenie 0 stopni oznacza, że kamera jest skierowana prosto w dół w kierunku Ziemi (nadir). Pochylenie o 90 stopni oznacza, że kamera jest skierowana poziomo w kierunku określonym przez kierunek.
Zakres
Zasięg określa odległość w metrach między pozycją kamery a punktem środkowym, na który jest ona skierowana. Zakres może się wahać od zera (bardzo bliskie ujęcie) do 63 milionów metrów, co pozwala na uzyskanie widoku od bardzo bliskiego ujęcia aż po perspektywę globalną. Określa to, jak bardzo „przybliżona” lub „oddalona” będzie mapa.
Obrót
Parametr roll określa kąt kamery względem horyzontu, mierzony w stopniach. Ten parametr może służyć do tworzenia efektów takich jak przechylanie podczas symulacji lotu, a nawet pełna beczka, czyli obracanie kamery wokół osi widoku.
Sterowanie kamerą
Poniższy przykładowy kod pokazuje, jak programowo sterować kamerą, wywołując metodę setCamera.
Aby użyć tego przykładowego kodu, postępuj zgodnie z instrukcjami w sekcjach Konfiguracja i Dodawanie mapy 3D do aplikacji, aby skonfigurować projekt Android Studio z podstawową mapą 3D. Następnie dodaj ten kod do pliku MainActivity.kt:
// Add imports import com.google.android.gms.maps3d.model.latLngAltitude ... // Add to the onMap3DViewReady method, after the googleMap3D object has been initialized googleMap3D.setCamera( camera { center = latLngAltitude { latitude = 38.743502 longitude = -109.499374 altitude = 1467.0 } heading = 350.0 tilt = 58.1 range = 138.2 roll = 0.0 } )