Les utilisateurs peuvent contrôler le zoom, l'inclinaison, la position et la rotation de la caméra à l'aide de gestes sur la carte. Vous pouvez également configurer la caméra par programmation.
Position de la caméra
La vue de la carte est modélisée comme une caméra orientée vers un point spécifique dans l'espace. La position et l'orientation de la caméra sont définies par les coordonnées de latitude, de longitude et d'altitude, ainsi que par le cap, l'inclinaison, la distance et le roulis.
Latitude, longitude, altitude
La position initiale de la caméra est définie en définissant la latitude, la longitude et l'altitude. Ces valeurs se combinent pour déterminer où la caméra est positionnée, et non où elle est pointée ou centrée.
La latitude peut être comprise entre -90 et 90 degrés, inclus. La longitude est comprise entre -180 et 180 degrés, inclus. L'altitude est spécifiée en mètres au-dessus du niveau de la mer.
Les valeurs supérieures ou inférieures à cette fourchette seront limitées à la valeur la plus proche dans cette fourchette. Par exemple, si vous spécifiez une latitude de 100, la valeur sera définie sur 90.
Titre
L'orientation indique la direction de la boussole de la carte, mesurée en degrés dans le sens horaire à partir du nord géographique. Le nord correspond à 0 degré, l'est à 90 degrés, le sud à 180 degrés et l'ouest à 270 degrés.
Inclinaison
L'inclinaison spécifie l'angle de la caméra par rapport à l'axe vertical, mesuré en degrés. Une inclinaison de 0 degré signifie que la caméra pointe directement vers le bas, en direction de la Terre (nadir). Une inclinaison de 90 degrés signifie que la caméra est orientée horizontalement dans la direction spécifiée par l'orientation.
Plage
La plage définit la distance en mètres entre la position de la caméra et le centre de la carte. La plage peut varier de zéro mètre (très près) à soixante-trois millions de mètres, ce qui permet d'obtenir des vues très rapprochées jusqu'à une perspective véritablement globale. Cela permet de contrôler le niveau de zoom de la carte.
Roulis
Le roulis définit l'angle de la caméra par rapport à l'horizon, mesuré en degrés. Ce paramètre peut être utilisé pour créer des effets tels que l'inclinaison lors de simulations de vol ou même un tonneau complet, en faisant pivoter la caméra autour de son axe de vision.
Contrôler la caméra
L'exemple de code suivant montre comment contrôler la caméra par programmation.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)