Référence JSON pour les styles de cartes basés dans le cloud

Le schéma JSON pour les styles de cartes basés dans le cloud vous permet d'utiliser JSON pour personnaliser les cartes comme vous le feriez avec l'interface de l'éditeur de style. Ce document décrit le schéma JSON et explique comment effectuer des déclarations de style JSON.

downloadTélécharger le schéma JSON

Pour savoir comment modifier un style de carte à l'aide de JSON dans l'éditeur de style, ou comment importer et exporter un style de carte, consultez Utiliser JSON avec les styles de cartes basés dans le cloud.

{
  "variant": "light",
  "styles": [
    {
      "id": "natural.land",
      "geometry": {
        "fillColor": "#f7e3f7"
      }
    },
    {
      "id": "natural.water",
      "geometry": {
        "fillColor": "#d4b2ff"
      },
      "label": {
        "textFillColor": "#3d2163",
        "textStrokeColor": "#f0e1ff"
      }
    },
    {
      "id": "pointOfInterest",
      "label": {
        "pinFillColor": "#e0349a",
        "textFillColor": "#a11e6e",
        "textStrokeColor": "#ffd9f0"
      }
    },
    {
      "id": "pointOfInterest.emergency.hospital",
      "geometry": {
        "fillColor": "#ffe3e3"
      }
    },
    {
      "id": "pointOfInterest.foodAndDrink",
      "label": {
        "visible": false
      }
    },
    {
      "id": "pointOfInterest.recreation.park",
      "geometry": {
        "fillColor": "#f9b9d2"
      }
    }
  ]
}

L'objet JSON

Une déclaration de style JSON se compose d'un objet de niveau supérieur et d'un tableau de règles de style.

• Propriétés de premier niveau (facultatif) : paramètres de style globaux tels que backgroundColor et variant.
• styles : tableau d'objets de règles de style, qui peuvent se composer des éléments suivants :
  • id : élément cartographique à sélectionner pour cette modification de style (par exemple, pointOfInterest.recreation.park).
  • geometry (facultatif) : éléments géométriques de l'élément cartographique et règles de style à appliquer (par exemple, fillColor).
  • label (facultatif) : libellé du texte ou du repère de l'élément cartographique et règles de style à appliquer (par exemple, textStrokeColor).

Propriétés de niveau supérieur

Les propriétés du tableau suivant s'appliquent à l'ensemble du style de carte.

Objets de règle de style

Cette section décrit les propriétés qui définissent les objets de règle de style dans le tableau styles pour personnaliser les éléments de la carte. Chaque objet de règle de style doit se composer des éléments suivants :

• Propriété id.
• Élément geometry ou label avec les propriétés de styleur associées définies.

id (élément cartographique)

La propriété id spécifie l'élément cartographique à styliser. Les noms de propriétés sont des versions en camelcase des noms d'éléments cartographiques dans l'éditeur de style.

Les éléments cartographiques forment une arborescence de catégories. Si vous spécifiez un type d'élément parent, comme pointOfInterest, les styles que vous spécifiez pour le parent s'appliquent à tous ses enfants, comme pointOfInterest.retail et pointOfInterest.lodging. Pour en savoir plus, consultez Hiérarchie des éléments cartographiques.

Éléments

Les éléments sont des subdivisions d'un élément cartographique. Par exemple, une route se compose d'une ligne graphique (la geometry) sur la carte et du texte qui indique son nom (le label).

Les éléments suivants sont disponibles, mais notez qu'il est possible qu'un élément cartographique spécifique prenne en charge tous, certains ou aucun des éléments suivants :

• geometry : sélectionne tous les éléments géométriques (par exemple, polygone ou polyligne) de l'élément cartographique spécifié.
• label : sélectionne tous les éléments de libellé (par exemple, le texte et l'épingle) de l'élément cartographique spécifié.

Stylers

Les stylers vous permettent de définir vos règles de style pour chaque élément d'un élément cartographique.

Par exemple, pour une emprise au sol, vous pouvez définir le style de chaque élément comme suit :

Cette section décrit les différentes options de style disponibles pour les éléments geometry et label.

Stylers geometry

Le tableau suivant liste tous les stylers géométriques disponibles.

Pour en savoir plus, consultez Polygones et polylignes.

Stylers label

Le tableau suivant répertorie tous les stylers de libellés disponibles.

Pour en savoir plus, consultez Icônes et libellés de texte.

Keyzooms

Vous pouvez définir un style unique pour une caractéristique pour tous les niveaux de keyzoom ou spécifier différents styles pour différents niveaux de keyzoom. Si vous ne fournissez qu'un seul style, il sera utilisé pour tous les niveaux de zoom clés à partir de z0. Si vous fournissez des styles pour différents niveaux de zoom, le style s'appliquera à partir de ce niveau de zoom jusqu'au prochain que vous avez défini.

Pour définir un niveau de zoom clé pour un style, définissez le niveau de zoom clé de z0 à z22 dans la propriété de style, puis personnalisez le style.

Dans l'exemple suivant, la couleur de l'eau est noire pour les niveaux de zoom clés 0 à 5, gris foncé pour les niveaux de zoom clés 6 à 11 et gris clair à partir du niveau de zoom clé 12.

{
  "id": "natural.water",
  "geometry": {
    "fillColor": {
      "z0": "#000000",
      "z6": "#666666",
      "z12": "#cccccc"
    }
  }
}

Pour en savoir plus, consultez Appliquer un style aux niveaux de zoom.

Limites

Vous pouvez utiliser JSON pour styliser presque tous les éléments de la console Google Cloud, à l'exception des options suivantes du menu Paramètres de la carte :

• Contrôlez la densité des points d'intérêt.
• Modifiez l'affichage des bâtiments (empreintes ou 3D).
• Modifiez l'affichage (illustré ou standard) des points de repère.

Ces options au niveau de la carte nécessitent une nouvelle récupération des données des tuiles pour s'afficher correctement, ce qui peut être indésirable pour certains cas d'utilisation.

Pour ces options, vous devez sélectionner votre préférence dans le menu settings Paramètres de la carte.

Étant donné que ces options ne sont pas incluses dans les styles exportés, elles doivent être resélectionnées dans la console Google Cloud lors de l'importation d'un style.