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 |
Fonctionnalités standards
|
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.
|
chld=<country_or_state_codes> |
Obligatoire | Liste des pays ou des États auxquels vous appliquez des valeurs.
Exemple : |
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.
|
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.
|
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 :
|
|
Ce graphique est semblable au précédent, mais avec plus de détails. |
chtm=africa |
Ce graphique indique qu'aucun pays n'est mis en évidence en spécifiant une seule valeur non définie ( |
chs=440x220 |
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 |
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 (
|
chtt=Site+visitors+by+month| |
Graphique avec un titre bleu aligné à droite composé de 20 points. |
chtt=Site+visitors |
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:
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 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 |
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. |
|
Pour ajouter une marge autour de la légende, définissez une valeur pour les paramètres Dans cet exemple, la légende fait environ 60 pixels de large. Si vous définissez |
|
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-planc
: 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 dechco
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 ( |
|
Cet exemple remplit l'arrière-plan du graphique en gris pâle ( |
|
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. |
|
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
= Rouge00FF00
= vert0000FF
= Bleu000000
= NoirFFFFFF
= Blanc
AA
est une valeur de transparence facultative, où 00
est totalement transparent et FF
est complètement opaque. Exemple :
0000FFFF
= Bleu fixe0000FF66
= Bleu transparent