Configurar controles da câmera

Os usuários podem controlar o zoom, a inclinação, a posição e a rotação da câmera usando gestos no mapa. Também é possível configurar a câmera de forma programática.

A posição da câmera

A visualização do mapa é modelada como uma câmera apontada para um ponto específico no espaço. A posição e a orientação da câmera são definidas por coordenadas de latitude/longitude/altitude, rumo, inclinação, alcance e rotação.

Latitude, longitude, altitude

A posição inicial da câmera é definida com a configuração de latitude, longitude e altitude. Esses valores se combinam para determinar onde a câmera está posicionada, não para onde ela está apontando ou centralizada.

A latitude pode variar entre -90 e 90 graus, inclusive. A longitude varia entre -180 e 180 graus. A altitude é especificada em metros acima do nível do mar.

Valores acima ou abaixo desse intervalo são fixados para o valor mais próximo dentro dele. Por exemplo, uma latitude especificada como 100 terá o valor de 90.

Título

A direção especifica a direção da bússola do mapa, medida em graus no sentido horário a partir do norte verdadeiro. O norte corresponde a 0 grau, o leste a 90 graus, o sul a 180 graus e o oeste a 270 graus.

Inclinar

A inclinação especifica o ângulo da câmera em relação ao eixo vertical, medido em graus. Uma inclinação de 0 grau significa que a câmera está apontando diretamente para baixo, em direção à Terra (nadir). Uma inclinação de 90 graus significa que a câmera está apontada horizontalmente na direção especificada pelo rumo.

Intervalo

O intervalo define a distância em metros entre a posição da câmera e o centro do mapa. O intervalo pode variar de zero metros (muito perto) até 63 milhões de metros, permitindo visualizações de muito perto até uma perspectiva verdadeiramente global. Isso controla efetivamente o nível de zoom do mapa.

Rolo

A rotação define o ângulo da câmera em relação ao horizonte, medido em graus. Esse parâmetro pode ser usado para criar efeitos como inclinação durante simulações de voo ou até mesmo um giro completo, girando a câmera em torno do eixo de visualização.

Como controlar a câmera

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)