Graphique géographique (version obsolète)

 

Alerte de remplacement: ce graphique a été remplacé par une version plus récente.

Cette page explique comment créer une carte colorée à l'aide de l'API Charts.

Sommaire

Fonctionnalités spécifiques aux graphiques

  1. Présentation
  2. Codes des États des États-Unis

Fonctionnalités standards

  1. Titre du graphique (chtt, chts)
  2. Marges du graphique (chma)
  3. Remplissage de l'arrière-plan
    1. Remplissages solides (chf)

Présentation

Vous pouvez créer une carte avec différents pays ou États mis en surbrillance dans des couleurs personnalisées. Pour spécifier une carte, vous devez indiquer la région du monde sur laquelle la carte doit effectuer un zoom. Vous allez également spécifier une liste de régions devant être colorées sur la carte, ainsi qu'une liste de données parallèle qui attribue une valeur numérique à chaque pays correspondant. Chaque pays est coloré le long d'un dégradé, en fonction de la valeur qui lui est attribuée. Vous pouvez éventuellement spécifier un dégradé de couleurs personnalisé pour les valeurs des données.

Les graphiques cartographiques sont compatibles avec les paramètres suivants:

Paramètres Obligatoire ou facultatif Description
cht=t Obligatoire Spécifie un graphique de carte.
chs Obligatoire Taille de la carte. La taille maximale d'une carte est de 440 x 220.
chtm=<zoom_area> Obligatoire

Zone géographique affichée dans le graphique.

  • zoom_area : l'une des valeurs suivantes
    • africa
    • asia
    • europe
    • middle_east
    • south_america
    • usa
    • world
chld=<country_or_state_codes> Obligatoire

Liste des pays ou des États auxquels vous appliquez des valeurs.

Exemple : chld=DZEGMG
chd=<country_values> Obligatoire

Liste de valeurs parallèle à la liste des régions, où la valeur s'applique à la région correspondante. Les valeurs sont des valeurs de données mises en forme standards. Une couleur sera attribuée à chaque région selon l'échelle spécifiée dans chco, où la valeur la plus basse de la plage s'applique à la couleur la plus basse et la valeur la plus élevée de cette plage à la dernière couleur.

  • country_values : liste dans la chaîne de format appropriée. Exemples: t:10,20,30, s:aU2Ff et e:BaPoqM-A.
chco=<default_color>,<start_of_gradient>,...,<end_of_gradient> Facultatif

Plage de couleurs correspondant aux valeurs basse et élevée de la plage de format de données. Les valeurs des données sont converties en valeurs de couleur le long de ce dégradé et appliquées aux pays correspondants.

  • default_color : [facultatif] couleur des régions pour lesquelles aucune donnée n'est attribuée. La valeur par défaut est BEBEBE (gris moyen). Nombre hexadécimal au format RRVVBB.
  • start_of_gradient : [facultatif] couleur correspondant à la valeur minimale dans la plage de formats de données. La valeur par défaut est 0000FF (bleu). Nombre hexadécimal au format RRVVBB.
  • ... - [Facultatif] Vous pouvez avoir autant de couleurs intermédiaires que vous le souhaitez.
  • end_of_gradient : [facultatif] couleur correspondant à la valeur maximale dans la plage de formats de données. La valeur par défaut est FF0000 (rouge). Nombre hexadécimal au format RRVVBB
chtt, chts Facultatif Titre et style du graphique
chma Facultatif Marges du graphique
chf=bg Facultatif Remplissages unis (arrière-plan uniquement)

 

Exemples

Description Exemple

Dans cet exemple :

  • La zone de zoom du graphique correspond à l'Afrique (chtm=africa).
  • Des valeurs vont être attribuées aux trois pays: Algérie, Égypte et Madagascar (chld=DZEGMG)
  • Les trois valeurs attribuées à ces pays sont respectivement 0, 100 et 50 (chd=t:0,100,50). Il s'agit des valeurs minimale, maximale et moyenne des données au format texte.
  • La gamme de couleurs est le rouge pour 0, le vert pour 100 et le blanc pour les pays non attribués (chco=FFFFFF,FF0000,00FF00).
  • L'arrière-plan du graphique est également rempli de bleu clair (chf=bg,s,EAF7FE).

Carte de l&#39;Afrique
cht=t
chtm=africa
chld=DZEGMG
chd=t:0,100,50
chco=FFFFFF,FF0000,00FF00
chf=bg,s,EAF7FE

Ce graphique est semblable au précédent, mais avec plus de détails.

 Carte de l&#39;Afrique
chtm=africa
chld=DZEGMGAOBWNGCFKECGCVSNDJTZGHMZZM
chco=FFFFFF,FF0000,FFFF00,00FF00
chd=t:0,100,50,32,60,40,43,12,14,54,98,17,70,76,18,29
chf=bg,s,EAF7FE

Ce graphique indique qu'aucun pays n'est mis en évidence en spécifiant une seule valeur non définie (chd=t:-1).

 Carte du monde
chs=440x220
chd=t:-1
cht=t
chtm=world

Haut de page

Codes des États des États-Unis

Voici les codes d'État acceptés lorsque l'utilisateur zoome sur les États-Unis (chld=usa) sur la carte.

AL Alabama LA Louisiane OH Ohio
AK Alaska ME Maine OK Oklahoma
AZ Arizona MD Maryland OU Oregon
AR Arkansas MA Massachusetts PA Pennsylvanie
CA Californie MI Michigan RI Rhode Island
CO Colorado MN Minnesota SC Caroline du Sud
CT Connecticut MS Mississippi SD Dakota du Sud
DE Delaware MO Missouri VN Tennessee
FL Floride MT Montana TX Texas
GA Géorgie NE Nebraska UT Utah
HI Hawaï NV Nevada VT Vermont
ID Idaho NH New Hampshire VA Nord
IL Illinois NJ New Jersey WA Washington
IN Indiana NM Nouveau-Mexique WV Virginie-Occidentale
IA Iowa NY New York WI Wisconsin
KS Kansas NC Caroline du Nord WY Wyoming
KY Kentucky ND Dakota du Nord

Haut de page

Fonctionnalités standards

Les autres fonctionnalités figurant sur cette page sont des éléments de graphiques standards.

Titre du graphique chtt, chts [Tous les graphiques]

Vous pouvez spécifier le texte du titre, la couleur et la taille de la police de votre graphique.

Syntaxe

chtt=<chart_title>
chts=<color>,<font_size>,<opt_alignment>

 

chtt : spécifie le titre du graphique.

<chart_title>
Titre à afficher pour le graphique. Vous ne pouvez pas spécifier l'emplacement de cet attribut, mais vous avez la possibilité d'indiquer la taille et la couleur de la police. Utilisez un signe + pour indiquer des espaces et une barre verticale ( |) pour indiquer un saut de ligne.

 

chts [Facultatif] : couleurs et taille de la police pour le paramètre chtt.

<color>
Couleur du titre, au format hexadécimal RRVVBB. La couleur par défaut est le noir.
<font_size>
Taille de police du titre, en points.
<opt_alignment>
[Facultatif] Alignement du titre. Choisissez l'une des valeurs de chaîne sensibles à la casse suivantes: "l" (gauche), "c" (centrée) "r" (droite). La valeur par défaut est "c".

 

Exemples

Description Exemple

Graphique avec un titre, utilisant la couleur et la taille de police par défaut.

Indiquez un espace avec un signe plus (+).

Utilisez une barre verticale (|) pour forcer un saut de ligne.

chts n'est pas spécifié ici.

 Graphique à barres verticales avec titre
chtt=Site+visitors+by+month|
January+to+July

Graphique avec un titre bleu aligné à droite composé de 20 points.

 Graphique à barres verticales avec bleu, 20 pixels, titre
chtt=Site+visitors
chts=FF0000,20,r

Haut de page

Marges du graphique chma [Tous les graphiques]

Vous pouvez spécifier la taille des marges du graphique, en pixels. Les marges sont calculées vers l'intérieur à partir de la taille de graphique spécifiée (chs). L'augmentation de la taille des marges n'augmente pas la taille totale du graphique, mais réduit la taille de la zone, si nécessaire.

Par défaut, les marges correspondent à ce qui reste après le calcul de la taille du graphique. Cette valeur par défaut varie selon le type de graphique. Les marges que vous spécifiez sont une valeur minimale. Si la zone du graphique laisse de la place aux marges, la taille des marges reste la même. Vous ne pouvez pas réduire les marges à une taille inférieure à celle requise pour les légendes et les libellés. Voici un diagramme illustrant les éléments de base d'un graphique:

Marge, zone de légende et zone du graphique

Les marges du graphique incluent les libellés de l'axe et la zone de la légende. La zone de la légende est automatiquement redimensionnée pour s'adapter exactement au texte, sauf si vous spécifiez une largeur plus grande à l'aide de chma. Dans ce cas, elle étend la taille de la marge et réduit la taille de la zone du graphique. Vous ne pouvez pas recadrer une légende en spécifiant une taille trop petite, mais vous pouvez faire en sorte qu'elle occupe plus d'espace que nécessaire.

Conseil:Dans un graphique à barres, si les barres ont une taille fixe (par défaut), la largeur de la zone du graphique ne peut pas être réduite. Vous devez spécifier une taille de barre plus petite ou redimensionnable à l'aide de chbh.

 

Syntaxe

chma=
  <left_margin>,<right_margin>,<top_margin>,<bottom_margin>|<opt_legend_width>,<opt_legend_height>
<left_margin>, <right_margin>, <top_margin>, <bottom_margin>
Taille minimale des marges autour de la zone du graphique (en pixels). Augmentez cette valeur pour inclure une marge intérieure et éviter que les libellés de l'axe ne se heurtent aux bords du graphique.
<opt_legend_width> et <opt_legend_height>
[Facultatif] Largeur de la marge autour de la légende, en pixels. Utilisez-le pour éviter que la légende ne heurte la zone du graphique ou les bords de l'image.

 

Exemples

Description Exemple

Dans cet exemple, la marge minimale du graphique est de 30 pixels de chaque côté. Comme la légende du graphique fait plus de 30 pixels de large, la marge de droite est définie sur la largeur de la légende du graphique et est différente des autres marges.

Les libellés de l'axe se trouvent en dehors de la zone de tracé. Ils sont donc dessinés dans les marges.

Graphique en courbes avec un arrière-plan gris et des marges de chaque côté.
chma=30,30,30,30

Pour ajouter une marge autour de la légende, définissez une valeur pour les paramètres <opt_legend_width> et <opt_legend_height>.

Dans cet exemple, la légende fait environ 60 pixels de large. Si vous définissez <opt_legend_width> sur 80 pixels, la marge s'étend jusqu'à 20 pixels en dehors de la légende.

Graphique en courbes avec un arrière-plan gris et des marges de chaque côté.
chma=20,20,20,30|80,20

Haut de page

Remplissage de l'arrière-plan chf [Tous les graphiques]

Vous pouvez spécifier des couleurs et des styles de remplissage pour la zone de données du graphique et/ou pour l'ensemble de l'arrière-plan du graphique. Les types de remplissage incluent les remplissages unis, les remplissages à rayures et les dégradés. Vous pouvez spécifier différents remplissages pour différentes zones (par exemple, l'ensemble de la zone du graphique ou uniquement la zone de données). Le remplissage de la zone de graphique écrase le remplissage de l'arrière-plan. Tous les remplissages sont spécifiés à l'aide du paramètre chf. Vous pouvez combiner différents types de remplissage (pleins, bandes, dégradés) dans le même graphique en séparant les valeurs par une barre verticale ( | ). Les remplissages des zones de graphique remplacent les remplissages de l'arrière-plan du graphique.

Remplissage continu chf [Tous les graphiques]

Vous pouvez spécifier un remplissage plein pour l'arrière-plan et/ou la zone de graphique, ou attribuer une valeur de transparence à l'ensemble du graphique. Vous pouvez spécifier plusieurs remplissages à l'aide de la barre verticale (|) (Maps: arrière-plan uniquement).

Syntaxe

chf=<fill_type>,s,<color>|...
<fill_type>
Partie du graphique remplie. Spécifiez l'une des valeurs suivantes :
  • bg – Remplissage de l'arrière-plan
  • c : remplissage des zones de graphique. Non compatible avec les graphiques à carte.
  • a : permet de rendre l'ensemble du graphique (arrière-plans compris) transparent. Les six premiers chiffres de <color> sont ignorés, et seuls les deux derniers (la valeur de transparence) sont appliqués à l'ensemble du graphique et à tous les remplissages.
  • b<index> : remplissages pleins de barres (graphiques à barres uniquement). Remplacez <index> par l'index de série des barres à remplir avec une couleur unie. L'effet est semblable à la spécification de chco dans un graphique à barres. Pour obtenir un exemple, consultez la section Couleurs de série du graphique à barres.
s
Indique un remplissage plein ou transparent.
<color>
Couleur de remplissage, au format hexadécimal RRVVBB. Pour les transparences, les six premiers chiffres sont ignorés, mais doivent quand même être inclus.

 

Exemples

Description Exemple

Cet exemple remplit l'arrière-plan du graphique en gris pâle (EFEFEF).

Graphique en courbes rouges avec remplissage des zones noires

chf=bg,s,EFEFEF

Cet exemple remplit l'arrière-plan du graphique en gris pâle (EFEFEF) et remplit la zone du graphique en noir (000000).

Graphique en courbes rouges avec une zone noire sur fond gris pâle.

chf=c,s,000000|
bg,s,EFEFEF
Cet exemple applique une transparence de 50% à l'ensemble du graphique (80 au format hexadécimal équivaut à 128, soit une transparence d'environ 50 %). Notez l'arrière-plan des cellules du tableau affiché à travers le graphique.

Graphique à nuage de points avec des points en bleu et une transparence de 50 %.

chf=a,s,00000080

Haut de page

Format de couleur

Spécifiez les couleurs à l'aide d'une chaîne de valeurs hexadécimales (6 caractères), plus deux valeurs de transparence facultatives, au format RRGGBB[AA]. Exemple :

  • FF0000 = Rouge
  • 00FF00 = vert
  • 0000FF = Bleu
  • 000000 = Noir
  • FFFFFF = Blanc

AA est une valeur de transparence facultative, où 00 est totalement transparent et FF est complètement opaque. Exemple :

  • 0000FFFF = Bleu fixe
  • 0000FF66 = Bleu transparent

Haut de page