Cómo configurar los controles de la cámara

Selecciona la plataforma: Android iOS JavaScript

Los usuarios pueden controlar el zoom, la inclinación, la posición y la rotación de la cámara con gestos en el mapa. También puedes configurar la cámara de forma programática.

Diagrama que ilustra el modelo de cámara 3D

La posición de la cámara

La vista del mapa se modela como una cámara que mira un punto específico en el espacio. La posición y la orientación de la cámara se definen a través de las coordenadas de latitud, longitud y altitud, el rumbo, la inclinación, el alcance y la rotación.

Latitud, longitud y altitud

La posición inicial de la cámara se define configurando la latitud, la longitud y la altitud. Estos valores se combinan para determinar dónde se posiciona la cámara, no hacia dónde apunta ni en qué se centra.

La latitud puede variar entre -90 y 90 grados, inclusive. La longitud varía entre -180 y 180 grados, inclusive. La altitud se especifica en metros sobre el nivel del mar.

Los valores superiores o inferiores a este rango se fijarán al valor más cercano dentro de este rango. Por ejemplo, si se especifica una latitud de 100, el valor se fijará en 90.

Encabezado

El parámetro heading especifica la dirección de la brújula del mapa, medida en grados en sentido horario a partir del norte verdadero. El norte corresponde a 0 grados, el este a 90 grados, el sur a 180 grados y el oeste a 270 grados.

Inclinación

La inclinación especifica el ángulo de la cámara con respecto al eje vertical, medido en grados. Una inclinación de 0 grados significa que la cámara apunta directamente hacia la Tierra (nadir). Una inclinación de 90 grados significa que la cámara apunta horizontalmente en la dirección especificada por el rumbo.

Rango

El rango define la distancia en metros entre la posición de la cámara y el centro del mapa. El rango puede variar desde cero metros (muy cerca) hasta sesenta y tres millones de metros, lo que permite vistas desde muy cerca hasta una perspectiva verdaderamente global. Esto controla de manera efectiva el nivel de acercamiento o alejamiento con el que aparece el mapa.

Giro

El ángulo de inclinación lateral establece el ángulo de la cámara con respecto al horizonte, medido en grados. Este parámetro se puede usar para crear efectos como la inclinación durante las simulaciones de vuelo o incluso un giro completo, rotando la cámara alrededor de su eje de visualización.

Cómo controlar la cámara

En el siguiente ejemplo de código, se muestra cómo controlar la cámara de forma programática.

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)