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.
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 mediante coordenadas de latitud, longitud y altitud (definidas como el "centro", hacia donde apunta la cámara), rumbo, inclinación, rango y giro.
Centro (latitud, longitud, altitud)
El centro define el punto específico en el espacio 3D que observa la cámara.
Se especifica con la clase LatLngAltitude, que combina valores de latitud, longitud y altitud. Esto permite un posicionamiento preciso del punto focal de la cámara en tres dimensiones.
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.
Encabezado
La orientación especifica la dirección de la brújula del mapa, medida en grados en el sentido de las manecillas del reloj desde el norte geográfico. 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 la orientación.
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 qué tan "acercado" o "alejado" aparece el mapa.
Giro
El giro 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 llamando alsetCamera método.
Para usar esta muestra de código, sigue las instrucciones que se indican en
Configura y
agrega un mapa 3D a tu app para configurar
tu proyecto de Android Studio con un mapa 3D básico. Luego, agrega el siguiente código al archivo 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
}
)