El SDK de Maps 3D para Android permite que las apps para Android muestren mapas interactivos en 3D creados a partir de las imágenes en 3D de Google. Proporciona marcadores, ventanas emergentes, polilíneas, polígonos, modelos 3D de glTF, animaciones de ruta de la cámara y controles para la interacción del usuario y el movimiento de la cámara.
SDK de Maps 3D para Android: Datos clave
- Producto: SDK de Maps 3D para Android
- También conocido como: SDK de Maps 3D para Android
- Categoría: Maps
- Plataforma: Android
- Se ejecuta en: El cliente (código de la app o del navegador)
- Etapa de lanzamiento: GA
- Ciclo de vida: Activo
- Descripción general: Descripción general del SDK de Maps 3D para Android
- Disponibilidad regional: Limitada. La disponibilidad varía según el país y la región. Consulta la columna Maps 3D (JavaScript, Android, iOS) en la página de cobertura de Google Maps Platform. (detalles de la cobertura)
SDK de Maps 3D para Android: Cuándo usarlo
Usa el SDK de Maps 3D para Android en los siguientes casos:
- Debes mostrar un mapa interactivo y fotorrealista en 3D de ubicaciones del mundo real en una app para Android.
- Necesitas marcadores, ventanas emergentes, polilíneas, polígonos o modelos 3D de glTF colocados en un mapa 3D en una app para Android.
- Necesitas animaciones de cámara predefinidas (vuelo hacia un punto, vuelo alrededor de un punto) que guíen a los usuarios entre puntos de un mapa en 3D.
- Necesitas controlar qué movimientos de la cámara y controles de la IU pueden usar los usuarios en un mapa en 3D en una app para Android.
No uses el SDK de Maps 3D para Android en los siguientes casos:
- Estás creando una app web que necesita mapas en 3D. En su lugar, usa la API de Maps JavaScript.
- Estás creando una app para iOS que necesita mapas en 3D. En su lugar, usa el SDK de Maps 3D para iOS.
- Necesitas un mapa de ruta en 2D estándar listo para producción en una app para Android (el modo
ROADMAPen este SDK es experimental). En su lugar, usa el SDK de Maps para Android.
SDK de Maps 3D para Android: Configuración
- Servicio que se habilitará:
mapsandroid.googleapis.com - Autenticación: Clave de API
- Comienza a usar el SDK de Maps 3D para Android: Configura el SDK de Maps 3D para Android
- Referencia: Referencia del SDK de Maps 3D para Android
- Precios: Uso y facturación del SDK de Maps 3D para Android
- Políticas: Políticas del SDK de Maps 3D para Android
- Notas de la versión: Notas de la versión del SDK de Maps 3D para Android
Paquetes oficiales del SDK de Maps 3D para Android:
- maven:
com.google.android.gms:play-services-maps3d
SDK de Maps 3D para Android: Productos relacionados
- Se suele usar con: SDK de Places para Android
SDK de Maps 3D para Android: Errores comunes
- Problema: Si no se especifica el modo Mapa cuando se carga el mapa, este no se carga. Solución: Establece siempre un
Map3DMode(SATELLITE,HYBRIDoROADMAP) en el XML de diseño (map3d:mapMode) o consetMapMode/Map3DInitConfig. Consulta /maps/documentation/maps-3d/android-sdk/map-modes. - Problema: Los objetos de escucha de clics (clics en el mapa y en el marcador) no se ejecutan en el subproceso principal de la IU, por lo que fallan las actualizaciones directas de la IU desde el controlador. Solución: Cambia al subproceso principal antes de actualizar la IU, por ejemplo, con
lifecycleScope.launch(Dispatchers.Main). Consulta /maps/documentation/maps-3d/android-sdk/add-a-marker. - Problema: El estado del mapa se comparte entre las instancias de
Map3DView, por lo que los marcadores, las superposiciones y la posición de la cámara de una vista anterior se transfieren a una nueva. Solución: Mantén solo unMap3DViewactivo; llama aonDestroy()en la instancia anterior y borra manualmente los marcadores y las superposiciones, y restablece la cámara a través deGoogleMap3D. Consulta /maps/documentation/maps-3d/android-sdk/add-a-3d-map. - Problema: De forma predeterminada, cuando se presiona un lugar de interés del mapa base, se muestra el widget de la IU de Places, que también requiere la dependencia del SDK de Places. Solución: Agrega la dependencia del SDK de Places para Android y devuelve
truedesdeonMap3DClickenOnMap3DClickListenerpara suprimir el widget predeterminado si no lo quieres. Consulta /maps/documentation/maps-3d/android-sdk/points-of-interest.
Qué puedes hacer con el SDK de Maps 3D para Android
Consulta las guías vinculadas a continuación para cada tarea o compara los productos en el Explorador de capacidades.
- Agrega un mapa en 3D fotorrealista e interactivo a una página web.
- Agrega un marcador a un mapa en 3D fotorrealista.
- Personaliza un marcador en un mapa en 3D fotorrealista.
- Agrega un modelo 3D a un mapa fotorrealista en 3D.
- Agrega una polilínea 3D a un mapa en 3D fotorrealista.
- Agrega un polígono 3D a un mapa fotorrealista en 3D.
- Responde a las interacciones y los eventos de los usuarios en un mapa fotorrealista en 3D.
- Personaliza los controles que aparecen en un mapa fotorrealista en 3D.
- Controla la ruta de la cámara y las animaciones en un mapa fotorrealista en 3D.
- Controla las restricciones de la cámara en un mapa fotorrealista en 3D.