Aide-mémoire du SDK Maps 3D pour iOS

Le SDK Maps 3D pour iOS vous permet de créer des expériences de cartes 3D dans les applications iOS à l'aide des images 3D de Google. Elle fournit des API SwiftUI pour les repères, les popovers, les polylignes, les polygones, les modèles 3D (glTF), les animations de trajectoire de la caméra, ainsi que les commandes de la caméra et d'interaction.

SDK Maps 3D pour iOS : informations clés

  • Produit : SDK Maps 3D pour iOS
  • Catégorie : Maps
  • Plate-forme : iOS
  • Exécution sur : client (code de l'application ou du navigateur)
  • Étape de lancement : GA
  • Cycle de vie : Actif
  • Présentation : Présentation du SDK Maps 3D pour iOS

SDK Maps 3D pour iOS : quand l'utiliser

Utilisez le SDK Maps 3D pour iOS dans les cas suivants :

  • Vous avez besoin d'une carte 3D photoréaliste interactive dans une application iOS native (SwiftUI).
  • Vous devez placer des repères, des popovers, des polylignes, des polygones ou des modèles 3D glTF sur une carte 3D dans iOS.
  • Vous avez besoin d'animations de caméra de type "survol" ou "rotation", ou de restrictions de caméra, sur une carte 3D dans iOS.
  • Vous souhaitez que les utilisateurs puissent appuyer sur des points d'intérêt de la carte 3D et afficher les détails des lieux via le widget intégré du Kit UI pour Places.

Ne pas utiliser le SDK Maps 3D pour iOS dans les cas suivants :

SDK Maps 3D pour iOS : configuration

Packages officiels du SDK Maps 3D pour 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 Maps 3D pour iOS : erreurs courantes

  • Problème : Si aucun mode de carte n'est défini lors du chargement de la carte, celle-ci ne se charge pas. Correction : Transmettez toujours un mode lors de la création de Map, par exemple Map(mode: .hybrid). Consultez /maps/documentation/maps-3d/ios-sdk/map-modes.
  • Problème : Définir la clé API à la fois dans le point d'entrée de l'application et dans les vues de carte individuelles génère une erreur de console. Correction : Définissez Map.apiKey à un seul endroit : le point d'entrée de l'application ou chaque vue de carte. Consultez /maps/documentation/maps-3d/ios-sdk/setup.
  • Problème : Camera altitudeMode est ignoré en dehors des animations de la caméra. Il ne s'applique qu'à flyCameraTo et flyCameraAround. Correction : Utilisez flyCameraTo ou flyCameraAround lorsque vous dépendez de Camera altitudeMode. Consultez /maps/documentation/maps-3d/ios-sdk/custom-camera-paths.
  • Problème : Dans GoogleMaps3DKit, le widget d'interface utilisateur Places s'affiche par défaut lorsqu'un utilisateur appuie sur un point d'intérêt. Correction : Utilisez placeInformationEnabled(false) ou renvoyez .none depuis onPlaceTap(_:) pour supprimer le widget. Consultez /maps/documentation/maps-3d/ios-sdk/points-of-interest.

Ce que vous pouvez faire avec le SDK Maps 3D pour iOS

Consultez les guides associés ci-dessous pour chaque tâche ou comparez les produits dans l'explorateur de fonctionnalités.