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 (definidas como o "centro", 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 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

// 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
    }
)