Créer et utiliser des styles de carte

Sélectionnez une plate-forme : Android iOS JavaScript Services Web

Les fonctionnalités de ce document marquées de l'icône scientifique  sont en version preview (pré-DG).

Un style de carte est un ensemble de personnalisations visuelles d'éléments cartographiques que vous associez à un ID de carte. Vous référencez ensuite l'ID de carte dans le code de votre application pour afficher la carte personnalisée.

Vous pouvez créer un style de carte avant d'avoir un ID de carte. Toutefois, pour utiliser ce style, vous devez l'associer à un ID de carte. Pour utiliser un style de carte, vous devez suivre l'ensemble des étapes ci-dessous :

1. Créer et publier un style de carte (pour en savoir plus, consultez Créer un style et Publier un style)

2. Créer un ID de carte (pour en savoir plus, consultez Créer un ID de carte)

3. Associer le style de carte à un ID de carte (pour en savoir plus, consultez Associer un ID de carte à un style de carte)

4. Ajouter l'ID de carte à votre application pour afficher votre style (pour en savoir plus, consultez Ajouter l'ID de carte à votre application)

Astuce : Une fois que l'ID de carte figure dans le code de votre application, vous pouvez modifier le style de carte sans modifier le code, et vos utilisateurs finaux n'ont pas besoin d'effectuer de mise à niveau pour voir les styles de carte mis à jour. Il vous suffit de modifier le style de carte associé à l'ID de carte, et les modifications s'afficheront dans les cartes de votre application.

Ce document explique comment créer, modifier et publier des styles de carte, et comment les associer à un ID de carte.

Créer un style de carte

Pour créer un style de carte, vous pouvez :

• créer un style en partant de zéro à l'aide du style de carte Google par défaut ;

• copier et modifier un style personnalisé existant.

• Importez un style de carte JSON à utiliser comme style personnalisé.

Créer un style en partant de zéro

1. Dans la console Google Cloud, accédez à Styles de carte et sélectionnez un projet si nécessaire.

2. Dans Styles de carte, cliquez sur Créer un style.

3. Dans la boîte de dialogue, sous l'onglet Styles Google, sélectionnez un mode.

   • Clair : crée un style clair, idéal pour les environnements lumineux ou extérieurs.
   •  Le style Sombre crée un thème sombre, idéal pour les environnements peu éclairés.

   Pour en savoir plus sur les styles des modes clair et sombre, consultez À propos des modes et des types de cartes.

4. (Facultatif) Pour appliquer la variante monochrome à votre style de carte, sélectionnez Monochrome.

   Vous pouvez également cliquer sur l'onglet JSON pour importer un style de carte JSON.

   

5. Sélectionnez Personnaliser pour créer un style sans titre.

6. Sélectionnez des éléments cartographiques et modifiez leur style pour créer le style de carte souhaité.

   Les éléments cartographiques dont le style est personnalisé sont indiqués par un point bleu. Si vous personnalisez un style enfant, un cercle bleu s'affiche dans le style parent. Pour en savoir plus sur la hiérarchie des styles de carte, consultez Comprendre l'héritage et la hiérarchie des styles de carte.

   Remarque : Il est possible qu'un style ne s'affiche pas pour certains niveaux de zoom. Pour en savoir plus, consultez Appliquer un style aux niveaux de zoom.

7. Cliquez sur Enregistrer.

8. Dans la boîte de dialogue Enregistrer et publier le style de carte, saisissez le nom de votre style et une description (facultative), puis cliquez sur Enregistrer.

Le style est publié automatiquement et la page de détails de votre nouveau style s'affiche.

Avertissement : Si vous apportez des modifications à un style, mais que vous ne les enregistrez pas explicitement, vous créez des modifications non enregistrées dans l'historique des versions de votre style de carte. Ces versions seront perdues si vous fermez l'onglet du navigateur ou à la fin de votre session de la console Cloud.

Copier un style

1. Accédez à Styles de carte et sélectionnez un projet si nécessaire.

2. Sélectionnez l'un de vos styles existants.

3. Sur la page du style, cliquez sur Créer une copie.

4. Dans la boîte de dialogue Créer une copie, saisissez un nouveau nom de style de carte et éventuellement une description.

5. (Facultatif) Pour créer la version complémentaire en mode clair ou sombre du style copié, cochez la case dans la section Options du mode Style.

6. Cliquez sur Enregistrer.

   Le style est publié automatiquement et la page principale de votre nouveau style s'affiche. Associez-le à un ID de carte pour l'utiliser avec vos cartes. Pour en savoir plus, consultez Associer un ID de carte à un style de carte.

7. Pour modifier le style, cliquez sur Personnaliser, apportez les modifications souhaitées, puis cliquez sur Enregistrer.

Publier un style

Lorsque vous créez un style de carte, la première instance du nouveau style de carte est publiée automatiquement. Vous pouvez ensuite enregistrer les modifications en tant que brouillon, puis publier le style une fois que vous êtes satisfait des modifications.

1. Modifiez le style de carte ou le style de carte dupliqué. Pour en savoir plus, consultez Modifier un style.

2. Cliquez sur Enregistrer pour enregistrer les modifications en tant que brouillon.

3. Lorsque vous êtes prêt à publier le style et à appliquer vos modifications à tous les ID de carte qui utilisent ce style de carte, cliquez sur Publier.

Styles de carte publiés et brouillons

Publié : un style de carte s'applique lorsqu'il est publié. Toutes les cartes qui utilisent le style de carte affichent sa version publiée.

Remarque : Il peut s'écouler quelques heures avant que les modifications d'un style se reflètent dans vos applications et sites Web. Le délai pour les applications peut être plus long si les appareils ne sont pas connectés à Internet. Si vous ne voyez toujours pas les modifications de votre style au bout de quelques heures, consultez Mes changements de style ne sont pas mis à jour.

Brouillon : les versions brouillon d'un style de carte sont des ébauches et ne s'affichent pas dans les cartes tant que vous ne les avez pas publiées.

Modifier un style

Si vous voulez modifier votre style de carte, vous pouvez le faire directement dans l'éditeur de style. Lorsque vous mettez à jour un style, deux possibilités s'offrent à vous :

• Si vous voulez appliquer vos modifications dès que vous êtes prêt : cliquez sur Personnaliser et apportez les modifications souhaitées. Cliquez sur Enregistrer pour enregistrer vos modifications en tant que brouillon, puis sur Publier lorsque vous êtes prêt.

• Si vous souhaitez d'abord tester vos modifications dans un environnement de test : au lieu d'apporter les modifications directement dans le style de carte, commencez par dupliquer le style. Pour en savoir plus, consultez Copier un style et Tester les mises à jour du style de carte.

Une fois que vous avez créé un style de carte, vous pouvez le modifier sur sa page d'informations de l'une des façons suivantes :

• Modifier : cliquez sur Personnaliser.

• Créer une copie : pour en savoir plus, consultez Copier un style.

• Renommer : renommez le style de carte.

• Supprimer : supprimez le style de carte.

Associer votre style à un ID de carte

Associez votre style à un ID de carte pour l'afficher sur votre site Web et dans votre application. Un ID de carte ne peut être associé qu'à un seul style en mode clair et à un seul style en mode sombre .

Pour modifier les styles associés à un ID de carte, procédez comme suit dans la console Google Cloud :

1. Accédez à Gestion des cartes, puis sélectionnez un ID de carte.

2. Dans la section Styles de carte, cliquez sur Modifier pour le mode clair ou sur pour le mode sombre.

3. Dans le panneau, sélectionnez un style à associer à cet ID de carte.

   Remarque : Le panneau n'affiche que les styles de type clair pour le mode clair et uniquement les styles de type sombre pour le mode sombre.

4. Cliquez sur OK.

5. (Facultatif) Appliquez votre style à différents types de cartes.

   Par défaut, votre style est appliqué à tous les types de cartes disponibles (roadmap, terrain, hybrid, navigation). Pour appliquer votre style à des types de cartes spécifiques, cliquez sur Afficher plus, puis cochez la case de chaque type de carte listé pour les modes clair et sombre. Pour appliquer le style de carte Google par défaut pour ce mode, décochez la case correspondant à un type de carte.

   Pour en savoir plus sur les types de cartes, consultez En savoir plus sur les modes et les types de cartes.

6. Cliquez sur Enregistrer pour appliquer toutes les modifications.

Pour utiliser votre style de carte basé dans le cloud, ajoutez l'ID de carte à votre application.