Konfigurowanie ustawień aparatu

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” (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 to 0 stopni, wschód – 90 stopni, południe – 180 stopni, a zachód – 270 stopni.

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

Zasięg 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ą. Określa to, 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 czy nawet pełny beczkowy obrót kamery wokół osi widoku.

Sterowanie kamerą

// 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
    }
)