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 :
- Vous avez besoin d'une carte 3D dans une application Android. Utilisez plutôt le SDK Maps 3D pour Android.
- Vous avez besoin d'une carte 3D sur une page Web. Utilisez plutôt l'API Maps JavaScript.
- Vous avez besoin d'une carte 2D standard dans une application iOS. Utilisez plutôt le SDK Maps pour iOS.
SDK Maps 3D pour iOS : configuration
- Service à activer :
mapsios.googleapis.com - Authentification : clé API
- Premiers pas : Configurer le SDK Maps 3D pour iOS
- Référence : Référence du SDK Maps 3D pour iOS
- Tarifs : Utilisation et facturation du SDK Maps 3D pour iOS
- Règles : Règles du SDK Maps 3D pour iOS
- Notes de version : Notes de version du SDK Maps 3D pour iOS
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 : produits associés
- Souvent utilisé avec : SDK Places pour iOS
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 exempleMap(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 :
CameraaltitudeModeest ignoré en dehors des animations de la caméra. Il ne s'applique qu'àflyCameraToetflyCameraAround. Correction : UtilisezflyCameraToouflyCameraAroundlorsque vous dépendez deCameraaltitudeMode. 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 : UtilisezplaceInformationEnabled(false)ou renvoyez.nonedepuisonPlaceTap(_:)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.
- Ajoutez une carte 3D photoréaliste interactive à une page Web.
- Ajouter un repère à une carte 3D photoréaliste
- Personnaliser un repère sur une carte 3D photoréaliste
- Ajouter un modèle 3D à une carte 3D photoréaliste
- Ajouter une polyligne 3D à une carte 3D photoréaliste
- Ajoutez un polygone 3D à une carte 3D photoréaliste.
- Répondez aux interactions et aux événements des utilisateurs sur une carte 3D photoréaliste.
- Personnalisez les commandes qui s'affichent sur une carte 3D photoréaliste.
- Contrôlez la trajectoire de la caméra et les animations sur une carte 3D photoréaliste.
- Contrôlez les restrictions de la caméra sur une carte 3D photoréaliste.