Konfigurowanie ustawień aparatu

Wybierz platformę: Android iOS JavaScript

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. Położenie i orientacja kamery są określone przez współrzędne geograficzne (szerokość i długość geograficzną oraz wysokość, zdefiniowane jako „środek”, czyli miejsce, na które jest skierowana kamera), kierunek, nachylenie, zasięg i obrót.

Środek (szerokość geograficzna, 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 określa kierunek mapy na kompasie, mierzony w stopniach zgodnie z ruchem wskazówek zegara od północy geograficznej. Północ odpowiada 0 stopniom, wschód – 90 stopniom, południe – 180 stopniom, a zachód – 270 stopniom.

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 stronę Ziemi (nadir). Pochylenie o 90 stopni oznacza, że kamera jest skierowana poziomo w kierunku określonym przez kierunek.

Zakres

Zakres określa odległość w metrach między pozycją kamery a środkiem mapy. Zakres może się wahać od zera metrów (bardzo bliskie ujęcie) do 63 milionów metrów, co pozwala na uzyskanie widoku od bardzo bliskiego ujęcia aż po perspektywę globalną. W ten sposób możesz kontrolować, jak bardzo „przybliżona” lub „oddalona” będzie mapa.

Obrót

Parametr roll określa kąt kamery względem horyzontu w stopniach. Ten parametr może służyć do tworzenia efektów, takich jak przechylanie podczas symulacji lotu, a nawet pełny beczkowy obrót kamery wokół osi widoku.

Sterowanie kamerą

Poniższy przykładowy kod pokazuje, jak sterować kamerą programowo, 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
    }
)