Premiers pas

Sélectionnez une plate-forme : Android iOS JavaScript

Suivez ces étapes pour configurer le style basé sur les données pour les limites.

Activer le nouveau moteur de rendu de cartes

Un moteur de rendu de carte amélioré est disponible à partir de la version 18.0.0 du SDK Maps pour Android. Ce moteur de rendu ajoute de nombreuses améliorations au SDK Maps pour Android, y compris la compatibilité avec les styles de cartes basés dans le cloud.

En publiant la version 18.2.0 du SDK Maps pour Android, Google a remplacé l'ancien moteur de rendu par défaut par le moteur de rendu de carte amélioré. Par conséquent, celui-ci est désormais utilisé par défaut dans votre application lorsque vous créez une application ou que vous la recompilez.

Avertissement :Pour pouvoir utiliser un style basé sur les données pour les limites dans votre application, vous devez l'avoir créée à l'aide du moteur de rendu de carte amélioré. Si vous ajoutez un style basé sur les données pour les limites à une application existante, assurez-vous de la recompiler pour qu'elle utilise le moteur de rendu de carte mis à niveau. Pour en savoir plus, consultez Nouveau moteur de rendu de carte.

Créer un ID de carte

Pour créer un ID de carte, suivez les étapes décrites dans Créer un ID de carte. Assurez-vous de définir le type de carte sur Android.

Créer un style de carte

Pour créer un style de carte, suivez la procédure décrite dans Gérer les styles de carte, puis associez le style à l'ID de carte que vous venez de créer.

Sélectionner les calques d'éléments géographiques de votre nouveau style de carte

Dans la console Google APIs, vous pouvez sélectionner les calques d'éléments à afficher pour votre nouveau style de carte. Le calque d'éléments cartographiques détermine les types de limites qui s'affichent sur la carte (par exemple, les localités, les États, etc.).

Important : Pour des performances optimales, sélectionnez uniquement les calques dont vous avez besoin.

1. Dans la console Google APIs, accédez à la page Styles de carte.
2. Sélectionnez un projet si vous y êtes invité.
3. Sélectionnez un style de carte.
4. Cliquez sur le menu déroulant Calques d'éléments pour ajouter ou supprimer des calques.
5. Cliquez sur Enregistrer pour enregistrer vos modifications et les appliquer à vos cartes.

Modifier le code d'initialisation de la carte

Cette étape nécessite l'ID de carte que vous venez de créer. Il se trouve sur votre page Gestion des cartes.

Pour ajouter l'ID de carte à votre code d'initialisation, consultez Ajouter l'ID de carte à votre application.

Accéder à un calque d'éléments d'une carte

Vous utilisez un objet FeatureLayer pour représenter chaque calque d'éléments d'une carte, comme un calque d'éléments de code postal ou de localité. Pour accéder à un objet de calque d'éléments, appelez GoogleMap.getFeatureLayer() lorsque la carte s'initialise:

Java

private FeatureLayer postalCodeLayer;

@Override
public void onMapReady(GoogleMap map) {
  // Get the POSTAL_CODE feature layer.
  postalCodeLayer = map.getFeatureLayer(new FeatureLayerOptions.Builder()
    .featureType(FeatureType.POSTAL_CODE)
    .build());
  ...
}

Kotlin

private var postalCodeLayer: FeatureLayer? = null

override fun onMapReady(googleMap: GoogleMap) {
  // Get the POSTAL_CODE feature layer.
  postalCodeLayer = googleMap.getFeatureLayer(new FeatureLayerOptions.Builder()
    .featureType(FeatureType.POSTAL_CODE)
    .build())
  ...
}

Transmettez un objet FeatureLayerOptions à getFeatureLayer() pour spécifier le type de la couche d'éléments géographiques. Dans cet exemple, vous souhaitez accéder à la couche POSTAL_CODE. Créez un objet FeatureLayer différent pour chaque calque que vous souhaitez styliser.

Une fois que vous disposez de l'objet FeatureLayer, vous pouvez appliquer un style aux polygones de limite de cette fonctionnalité.

Remarque :Si un FeatureLayer du type spécifié n'existe pas pour la carte ou si le style basé sur les données pour les limites n'est pas activé, car vous n'avez pas spécifié l'ID de carte, cet appel renvoie une erreur, mais la consigne est enregistrée. Utilisez la méthode FeatureLayer.isAvailable() pour déterminer si un FeatureLayer est disponible.

Vérifier les fonctionnalités de la carte (obligatoire)

Le style basé sur les données pour les limites nécessite un ID de carte. Si l'ID de carte est manquant ou si un ID de carte non valide est transmis, le style basé sur les données pour les limites ne peut pas être chargé. Pour résoudre un problème, vous pouvez utiliser MapCapabilities pour vérifier si le style basé sur les données pour les limites est compatible.

Avertissement :Il est possible que certains appareils n'acceptent pas le nouveau moteur de rendu de carte (dans ce cas, ils n'afficheront pas le style basé sur les données pour les limites). Vous devez utiliser MapCapabilities pour vérifier la compatibilité lors de l'exécution. Si le style basé sur les données pour les limites n'est pas compatible, définissez une option de remplacement. Pour connaître les exigences du nouveau moteur de rendu de carte concernant les appareils, consultez Appareils compatibles.

Kotlin

val capabilities: MapCapabilities = googleMap.getMapCapabilities()
System.out.println("Data-driven Styling is available: " + capabilities.isDataDrivenStylingAvailable())

Java

MapCapabilities capabilities = googleMap.getMapCapabilities();
System.out.println("Data-driven Styling is available: " + capabilities.isDataDrivenStylingAvailable());