Commencer

Sélectionnez une plate-forme : Android iOS JavaScript

Suivez ces étapes afin de 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.

Attention :Pour utiliser le style basé sur les données pour les limites de votre application, celle-ci doit être créé à l'aide du moteur de rendu de carte mis à niveau. Si vous ajoutez style basé sur les données pour les limites d'une application existante, veillez à reconstruire le afin que votre application 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 dans votre nouveau style de carte

Dans la console Google APIs, vous pouvez sélectionner les calques d'éléments à afficher votre nouveau style de carte. Le calque d'éléments géographiques détermine les types de limites s'affichent sur la carte (par exemple, les localités, les départements, 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 Gestion Maps.

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 géographiques sur une carte

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

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 une FeatureLayerOptions à getFeatureLayer() pour spécifier le type de calque d'éléments. Dans ce Par exemple, vous souhaitez accéder à la couche POSTAL_CODE. Créer une autre FeatureLayer pour chaque calque auquel vous souhaitez appliquer un style.

Une fois que vous disposez de l'objet FeatureLayer, vous pouvez appliquer un style à des polygones de limite dans cet élément géographique.

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 un résultat, mais consigne une erreur. Utilisez le FeatureLayer.isAvailable() pour déterminer si un élément 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 un ID de carte non valide est transmis, le style basé sur les données pour les limites ne peut pas être chargé. En tant que étape de dépannage, vous pouvez utiliser MapCapabilities pour vérifier si le style basé sur les données pour les limites est compatible.

Attention :Il est possible que certains appareils ne soient pas compatibles avec le nouveau moteur de rendu de carte et donc ne peut pas afficher un 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 accepté. Définissez une option de remplacement. Pour connaître la configuration d'appareil requise pour le nouveau moteur de rendu de carte, consultez Appareils appareils Android.

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());