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 de mapa é modelada como uma câmera apontada para um ponto específico em um espaço 3D. A posição e a orientação da câmera (e, portanto, a renderização do mapa) são especificadas pelas seguintes propriedades: centro (uma localização de latitude/longitude/altitude para onde a câmera está apontando), direção, inclinação, alcance e rotação.
Centro (latitude/longitude/altitude)
O centro define o ponto específico no espaço 3D que a câmera está observando.
Isso é especificado usando a classe LatLngAltitude, que combina 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. A longitude varia entre -180 e 180 graus. A altitude é especificada em metros acima do nível do mar.
Título
A orientação da câmera especifica a direção em que ela 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á 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 cabeçalho.
Intervalo
O alcance define a distância em metros entre a posição da câmera e o ponto central para onde ela está apontando. O alcance pode variar de zero metro (muito perto) a 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.
Giro
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
O exemplo de código a seguir demonstra como controlar a câmera
de maneira programática chamando o método
setCamera.
Para usar este exemplo de código, siga as instruções em
Configuração e
Adicionar um mapa 3D ao seu app para configurar
seu projeto do Android Studio com um mapa 3D básico. Em seguida, adicione o seguinte código ao arquivo MainActivity.kt:
// Add imports import com.google.android.gms.maps3d.model.latLngAltitude ... // Add to the onMap3DViewReady method, after the googleMap3D object has been initialized googleMap3D.setCamera( camera { center = latLngAltitude { latitude = 38.743502 longitude = -109.499374 altitude = 1467.0 } heading = 350.0 tilt = 58.1 range = 138.2 roll = 0.0 } )