Utiliser JSON avec les styles de cartes basés dans le cloud

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

Ce document explique comment utiliser JSON pour créer, modifier et exporter des styles de carte. Pour savoir ce que vous pouvez styliser à l'aide de JSON, consultez la documentation de référence JSON pour les styles de cartes basés dans le cloud.

Importer un style de carte JSON

Pour créer un style de carte à l'aide de JSON, procédez comme suit :

Dans la console Google Cloud, accédez à Styles de carte et sélectionnez un projet si nécessaire.
Dans Styles de carte, cliquez sur Créer un style.
Dans la boîte de dialogue, sélectionnez l'onglet JSON.
Vous pouvez importer votre style JSON de deux manières :
- Collez votre code de style JSON valide dans le champ.
- Cliquez sur Importer un fichier JSON , puis sélectionnez un fichier JSON local à utiliser. Le code de style JSON s'affiche dans le champ.
Remarque : Lorsque vous importez un fichier JSON hérité, un avertissement s’affiche et le style est converti au format JSON le plus récent. La conversion est approximative, mais elle vous permet de bénéficier d'une expérience plus riche et plus personnalisable. Pour n'utiliser que le format JSON hérité, consultez Utiliser des déclarations de style JSON intégrées.
Vérifiez si votre fichier JSON contient des erreurs.
- Si votre fichier JSON contient des erreurs, l'avertissement "Votre fichier JSON contient N erreurs" s'affiche. Vous pouvez le développer pour en savoir plus.
- Si votre fichier JSON est valide, l'aperçu de la carte affiche votre style personnalisé et le bouton bleu Personnaliser est disponible.
Cliquez sur Personnaliser pour créer un style de carte.
Dans votre nouveau style de carte, sélectionnez des éléments cartographiques, puis examinez ou modifiez leur style si nécessaire. Les éléments cartographiques dont le style est personnalisé sont indiqués par un point bleu.

**Remarque** : Il est possible qu'un style ne s'affiche pas pour certains niveaux de zoom.
Cliquez sur Enregistrer.
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 principale de votre nouveau style s'affiche.

Pour ajouter votre style de carte à un ID de carte, consultez Associer votre style à un ID de carte.

Modifier un style de carte avec JSON

Vous pouvez modifier les styles de carte à l'aide de l'onglet JSON de l'éditeur de style.

Pour modifier un style de carte à l'aide de JSON, procédez comme suit :

Dans la console Google Cloud, accédez à Styles de carte et sélectionnez un projet si nécessaire.
Dans Styles de carte, sélectionnez un style existant dans la liste des styles.
Sur la page principale du style, sélectionnez Personnaliser.
Sélectionnez l'onglet JSON pour ouvrir l'éditeur de style JSON.
Apportez vos modifications dans l'éditeur. Vous pouvez également importer un fichier JSON.
Cliquez sur Valider pour mettre à jour le panneau de style et l'aperçu de la carte.

**Remarque** : Lorsque vous modifiez un élément cartographique dans le panneau de style, le code JSON est automatiquement mis à jour.
Une fois toutes vos modifications effectuées, cliquez sur Enregistrer. Si vous créez un style, les modifications sont automatiquement appliquées. Si vous modifiez un style existant, les modifications sont enregistrées en tant que brouillon. Vous devez cliquer sur Publier pour appliquer vos modifications à tous les ID de carte qui utilisent ce style de carte.

Exporter un style de carte au format JSON

Pour exporter un style de carte au format JSON, procédez comme suit :

Dans la console Google Cloud, accédez à Styles de carte et sélectionnez un projet si nécessaire.
Dans Styles de carte, sélectionnez un style existant dans la liste des styles.
Sur la page principale du style, sélectionnez Personnaliser.
Sélectionnez l'onglet JSON pour ouvrir l'éditeur de style JSON.
Sélectionnez Exporter.