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 que observa um ponto específico em um espaço 3D. A posição e a orientação da câmera (e, consequentemente, a renderização do mapa) são especificadas pelas seguintes propriedades: centro (um local de latitude/longitude/altitude que a câmera está olhando), direção, inclinação, alcance e rolagem.
Centro (latitude/longitude/altitude)
O centro define o ponto específico no espaço 3D que a câmera está observando. Isso é especificado usando valores de latitude, longitude e altitude. Isso permite o posicionamento preciso do ponto focal da câmera em três dimensões.
A latitude pode variar entre -90 e 90 graus, inclusive. Valores acima ou abaixo desse intervalo são fixados para o valor mais próximo dentro desse intervalo. Por exemplo, especificar uma latitude de 100 vai definir o valor como 90. A longitude varia entre -180 e 180 graus. A altitude é especificada em metros acima do nível do mar.
Título
O Rumo da câmera especifica a direção para onde a câmera vai apontar, 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. Isso determina a orientação da câmera em torno do eixo vertical do ponto central.
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á apontada diretamente para a Terra (nadir). Uma inclinação de 90 graus significa que a câmera está apontada horizontalmente na direção especificada pelo heading.
Intervalo
O alcance define a distância em metros entre a posição da câmera e o ponto central que ela está olhando. O alcance pode variar de zero metros (muito próximo) até 63 milhões de metros, permitindo visualizações muito próximas até uma perspectiva verdadeiramente global. Isso controla efetivamente como o mapa aparece com zoom in ou zoom out.
Giro
O inclinaçã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
O exemplo de código abaixo demonstra como controlar a câmera de maneira 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)