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.

Diagram ilustrujący model kamery 3D

Pozycja kamery

Widok mapy jest modelowany jako kamera skierowana na określony punkt w przestrzeni. Pozycja i orientacja kamery są określane przez współrzędne szerokości, długości i wysokości geograficznej, kierunek, pochylenie, zakres i obrót.

Szerokość, długość i wysokość geograficzna

Początkowa pozycja kamery jest określana przez ustawienie szerokości, długości i wysokości geograficznej. Te wartości określają, gdzie znajduje się kamera, a nie gdzie jest skierowana ani na czym jest wyśrodkowana.

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 podawana w metrach nad poziomem morza.

Wartości spoza tego zakresu są zmieniane na najbliższą wartość w tym zakresie. Na przykład ustawienie szerokości geograficznej na 100 spowoduje ustawienie wartości na 90.

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ą. Pozwala to skutecznie kontrolować, 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 przechylenie podczas symulacji lotu lub nawet pełny obrót, obracając kamerę wokół osi widzenia.

Sterowanie kamerą

Poniższy przykładowy kod pokazuje, jak sterować kamerą programowo.

Swift 


public static var sanFrancisco: Camera = .init(
  center: .init(
    latitude: 37.7845812,
    longitude: -122.3660241,
    altitude: 585),
  fieldOfView: .init(degrees: 100),
  altitudeMode: .relativeToGround,
  heading: 288.0,
  tilt: 75.0,
  roll: 0.0,
  range: 100)