Referencia rápida del SDK de Maps 3D para iOS

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:

SDK de Maps 3D para iOS: Configuración

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: 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.apiKey en 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 Camera altitudeMode fuera de las animaciones de la cámara; solo se aplica a flyCameraTo y flyCameraAround. Solución: Usa flyCameraTo o flyCameraAround cuando dependas de Camera altitudeMode. 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: Usa placeInformationEnabled(false) o muestra .none desde onPlaceTap(_:) 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.