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

Diagram ilustrujący model kamery 3D

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 szerokości, długości i wysokości geograficznej, kierunek, nachylenie, zasięg i przechył.

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

Początkową pozycję kamery określa się przez ustawienie szerokości i długości geograficznej oraz wysokości. Te wartości określają położenie kamery, a nie to, na co jest ona skierowana lub na czym jest wyśrodkowana.

Szerokość geograficzna może wynosić od -90 do 90 stopni (włącznie). Długość geograficzna mieści się w zakresie od -180 do 180 stopni włącznie. Wysokość jest podawana w metrach nad poziomem morza.

Wartości powyżej lub poniżej tego zakresu zostaną zmienione na najbliższą wartość w tym zakresie. Na przykład podanie szerokości geograficznej 100 spowoduje ustawienie wartości 90.

Nagłówek

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

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

Zakres 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ą. W ten sposób możesz kontrolować, 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, a nawet pełny beczkowy obrót kamery wokół osi widoku.

Sterowanie kamerą

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

Swift


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