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ślone 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 włącznie. Długość geograficzna może się zawierać w zakresie od –180 do 180 stopni włącznie. 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ę wahać od zera metrów (bardzo blisko) do 63 milionów metrów, co pozwala na wyświetlanie widoków od bardzo bliskich do globalnych. 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 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.

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)