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ę programowo.

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ść, długość i wysokość geograficzna) zdefiniowane jako „środek” (punkt, na który jest skierowana kamera), kierunek, pochylenie, zakres i obrót.

Środek (szerokość, długość i wysokość geograficzna)

Środek określa konkretny punkt w przestrzeni 3D, który obserwuje kamera. Jest on określany 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 3 wymiarach.

Szerokość geograficzna może się zawierać w zakresie od –90 do 90 stopni. Długość geograficzna może się zawierać w zakresie od –180 do 180 stopni. Wysokość geograficzna jest określana w metrach nad poziomem morza.

Kierunek

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

Pochylenie określa kąt kamery względem osi pionowej, mierzony w stopniach. Pochylenie 0 stopni oznacza, że kamera jest skierowana prosto w dół na Ziemię (nadir). Pochylenie 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ę zmieniać od zera metrów (bardzo blisko) do 63 milionów metrów, co pozwala na wyświetlanie widoków od bardzo bliskich aż po perspektywę globalną. Umożliwia to efektywne sterowanie tym, jak „przybliżona” lub „oddalona” jest mapa.

Obrót

Obrót 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łny obrót, czyli obracanie kamery wokół osi widzenia.

Sterowanie kamerą

Poniższy przykładowy kod pokazuje, jak sterować kamerą programowo, wywołując setCamera metodę. Aby użyć tego przykładowego kodu, postępuj zgodnie z instrukcjami w Konfigurowanie 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.Map3DMode
import com.google.android.gms.maps3d.model.latLngAltitude

...

// Add to the onMap3DViewReady method, after the googleMap3D object has been initialized
googleMap3D.setMapMode(Map3DMode.HYBRID)
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
    }
)