Użytkownicy mogą sterować powiększeniem, pochyleniem, pozycją i obrotem kamery za pomocą gestów na mapie. Możesz też skonfigurować kamerę automatycznie.
Pozycja kamery
Widok mapy jest modelowany jako kamera skierowana na określony punkt w przestrzeni 3D. Położenie i orientacja kamery (a tym samym renderowanie mapy) są określone przez te właściwości: środek (lokalizacja określona przez szerokość, długość i wysokość geograficzną, na którą jest skierowana kamera), kierunek, nachylenie, zasięg i obrót.
Środek (szerokość/długość geograficzna/wysokość)
Środek określa konkretny punkt w przestrzeni 3D, który obserwuje kamera. Jest ona określana za pomocą wartości szerokości, długości i wysokości geograficznej. Umożliwia to precyzyjne ustawienie punktu ogniskowego kamery w trzech wymiarach.
Szerokość geograficzna może mieścić się w zakresie od -90 do 90 stopni. 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. Długość geograficzna mieści się w zakresie od -180 do 180 stopni włącznie. Wysokość jest podawana w metrach nad poziomem morza.
Nagłówek
Kierunek kamery określa kierunek, w którym będzie ona skierowana. Jest on mierzony w stopniach zgodnie z ruchem wskazówek zegara od północy geograficznej. Północ to 0 stopni, wschód – 90 stopni, południe – 180 stopni, a zachód – 270 stopni. Określa to orientację kamery wokół osi pionowej punktu środkowego.
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 kierunku Ziemi (nadir). Pochylenie o 90 stopni oznacza, że kamera jest skierowana poziomo w kierunku określonym przez kierunek.
Zakres
Zasięg określa odległość w metrach między pozycją kamery a punktem środkowym, na który jest ona skierowana. Zakres może się wahać od zera (bardzo bliskie ujęcie) do 63 milionów metrów, co pozwala na uzyskanie widoku od bardzo bliskiego ujęcia aż po perspektywę globalną. Określa to, jak bardzo „przybliżona” lub „oddalona” będzie mapa.
Obrót
Parametr roll 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łna beczka, czyli obracanie kamery wokół osi widoku.
Sterowanie kamerą
Poniższy przykładowy kod pokazuje, jak programowo sterować aparatem.
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)