El SDK de Maps 3D para iOS te permite crear experiencias de mapas en 3D en apps para iOS con las imágenes en 3D de Google. Proporciona APIs de SwiftUI para marcadores, ventanas emergentes, polilíneas, polígonos, modelos 3D (glTF), animaciones de rutas de cámara y controles de cámara y de interacción.
SDK de Maps 3D para iOS: Datos clave
- Producto: SDK de Maps 3D para iOS
- Categoría: Maps
- Plataforma: iOS
- 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 iOS
Cuándo usar el SDK de Maps 3D para iOS
Usa el SDK de Maps 3D para iOS en los siguientes casos:
- Necesitas un mapa en 3D fotorrealista e interactivo en una app nativa para iOS (SwiftUI).
- Necesitas colocar marcadores, ventanas emergentes, polilíneas, polígonos o modelos glTF 3D en un mapa en 3D en iOS.
- Necesitas animaciones de cámara de vuelo o de vuelo alrededor, o restricciones de cámara, en un mapa 3D en iOS.
- Necesitas que los usuarios presionen los lugares de interés del mapa en 3D y vean los Place Details a través del widget integrado del kit de IU de Places.
No uses el SDK de Maps 3D para iOS en los siguientes casos:
- Necesitas un mapa en 3D en una app para Android. En su lugar, usa el SDK de Maps 3D para Android.
- Necesitas un mapa en 3D en una página web. En su lugar, usa la API de Maps JavaScript.
- Necesitas un mapa 2D estándar en una app para iOS. En su lugar, usa el SDK de Maps para iOS.
SDK de Maps 3D para iOS: Configuración
- Servicio que se habilitará:
mapsios.googleapis.com - Autenticación: Clave de API
- Comienza a usar el SDK de Maps 3D para iOS
- Referencia: Referencia del SDK de Maps 3D para iOS
- Precios: Uso y facturación del SDK de Maps 3D para iOS
- Políticas: Políticas del SDK de Maps 3D para iOS
- Notas de la versión: Notas de la versión del SDK de Maps 3D para iOS
Paquetes oficiales del SDK de Maps 3D para iOS:
- swift_package:
https://github.com/googlemaps/ios-maps-3d-sdk (product GoogleMaps3D) - swift_package:
https://github.com/googlemaps/ios-maps-3d-sdk (product GoogleMaps3DKit, for POI taps with the Places UI Kit widget)
SDK de Maps 3D para iOS: Productos relacionados
- Se suele usar con: SDK de Places para iOS
SDK de Maps 3D para iOS: Errores comunes
- Problema: Si no se establece ningún modo de mapa cuando se carga el mapa, este no se carga. Solución: Pasa siempre un modo cuando crees el
Map, por ejemplo,Map(mode: .hybrid). Consulta /maps/documentation/maps-3d/ios-sdk/map-modes. - Problema: Configurar la clave de API tanto en el punto de entrada de la app como en las vistas de mapa individuales produce un error de consola. Solución: Establece
Map.apiKeyen un solo lugar: el punto de entrada de la app o cada vista de mapa. Consulta /maps/documentation/maps-3d/ios-sdk/setup. - Problema: Se ignora
CameraaltitudeModefuera de las animaciones de la cámara; solo se aplica aflyCameraToyflyCameraAround. Solución: UsaflyCameraTooflyCameraAroundcuando dependas deCameraaltitudeMode. Consulta /maps/documentation/maps-3d/ios-sdk/custom-camera-paths. - Problema: En
GoogleMaps3DKit, el widget de la IU de Places se muestra de forma predeterminada cuando un usuario presiona un lugar de interés. Solución: UsaplaceInformationEnabled(false)o muestra.nonedesdeonPlaceTap(_:)para suprimir el widget. Consulta /maps/documentation/maps-3d/ios-sdk/points-of-interest.
Qué puedes hacer con el SDK de Maps 3D para iOS
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.