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. Pozycja i orientacja kamery są określone przez współrzędne geograficzne (szerokość, długość i wysokość) zdefiniowane jako „środek” (punkt, na który jest skierowana kamera), kierunek, pochylenie, zakres i obrót.

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

Ś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 do globalnych. Umożliwia to efektywne sterowanie powiększeniem i pomniejszeniem mapy.

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