Graphiques des cartes

Cette page explique comment créer une carte colorée à l'aide de l'API Charts. Il s'agit d'une nouvelle version améliorée qui prend en charge une carte plus grande et plus d'éléments que l'ancien graphique de carte (cht=t).

Sommaire

Fonctionnalités spécifiques aux graphiques Présentation Paramètres acceptés Zoom et centrage

Fonctionnalités standards Titre du graphique (chtt, chts) Couleurs du graphique (chco) Marges du graphique (chma) Remplissage de l'arrière-plan Remplissages solides (chf) Légendes du graphique (chdl, Chdlp) Repères de forme (chm) Text and Data Markers (Repères de texte et de données) (chm)

Présentation

Vous pouvez créer une carte avec différents pays ou États mis en surbrillance dans des couleurs personnalisées. Vous pouvez ajuster le niveau de zoom sur la carte pour afficher correctement les pays sélectionnés, ou effectuer un zoom avant ou arrière à l'aide des valeurs de latitude et de longitude.

Paramètres acceptés

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

Paramètres	Obligatoire ou facultatif	Description
cht=map<opt_zoom_and_center>	Obligatoire	Spécifie un graphique de carte. opt_zoom_and_center : chaîne facultative permettant de zoomer ou de centrer le graphique sur une région spécifique. Afficher les détails
chs	Obligatoire	Taille de la carte. Les dimensions maximales d'une carte sont de 600 pixels de large, de 600 pixels de haut ou de 300 000 pixels au total.
chd=  <first_country_value>,  ...,  <last_country_value>	Facultatif	Si elle est utilisée, la valeur de données indique la couleur du pays correspondant, le long du dégradé de couleurs spécifié par chco.
chld=  <country_or_region_codes>|...|	Obligatoire	Liste de pays ou d'États séparés par une barre verticale qui seront mis en surbrillance dans les couleurs spécifiées par chco. La carte zoome automatiquement pour inclure tous les pays spécifiés, sauf si vous effectuez un zoom ou un centrage personnalisé. Les codes doivent être en majuscules. Ces codes sont des codes ISO 3166-1-alpha-2: deux caractères majuscules, éventuellement suivis d'un tiret et d'un second identifiant pour les régions ou les villes. Exemples : GB (Grande-Bretagne), GB-LND (Londres), US-NJ (État du New Jersey aux États-Unis)
chco Si chd n'est pas utilisé: chco=  <unselected_land_color>|  <first_region_color>|    ...|  <last_region_color> Si chd est utilisé: chco=  <unselected_land_color>,  <color_range_start>,    ...,  <color_range_end>	Facultatif	Couleurs du graphique. Le format de cette chaîne varie selon que vous utilisez ou non chd. Dans les deux syntaxes, <unselected_land_color> est la couleur de toute région non spécifiée dans chld. Notez que les séparateurs sont différents pour les différentes syntaxes (la virgule dans l'un et les barres verticales dans l'autre). Si vous n'utilisez pas les régions, elles seront encadrées, mais pas colorées. chd used : la deuxième couleur ou les couleurs suivantes décrivent une plage de couleurs. Vous devez avoir une valeur chd pour chaque pays dans la région chld. Le pays correspondant sera coloré dans une plage allant de <first_region_color> (valeur minimale de la plage de données) à <last_region_color> (valeur maximale de la plage de données). Vous trouverez des exemples dans le tableau ci-dessous. chd non utilisé : les deuxièmes couleurs et les suivantes sont appliquées aux régions correspondantes dans chld, dans l'ordre indiqué. S'il y a plus de pays que de couleurs, la dernière couleur sera appliquée à tous les pays en trop de la liste.
chtt, chts	Facultatif	Titre et style du graphique
chm	Facultatif	Repères du graphique
chma	Facultatif	Marges du graphique
chf=bg...	Facultatif	Remplissages unis (arrière-plan uniquement)
chdl	Facultatif	Légendes des graphiques

 

Exemples

Description	Exemple
Dans cet exemple : cht=map:fixed=-60,0,80,-35 : la zone de zoom du graphique est comprise entre -60 et 80 de latitude, et entre 0 et -35 de longitude chld=CA-BC|CN|IT|GR|US-UT : les régions ultravoyantes sont la Colombie-Britannique, la Chine, l'Italie, le Greeze et l'Utah. chm : repères des indicateurs dans le graphique. chma=0,110,0,0 : la bordure latérale droite a été augmentée à 110 pixels pour s'adapter correctement à la légende. chtt=Last+Five+Olympic+Hosts : titre du graphique, où les signes + sont utilisés pour indiquer des espaces.	cht=map:fixed=-60,0,80,-35 chs=600x350 chld=CA-BC|CN|IT|GR|US-UT chdl=Vancouver|Beijing|Torino|Athens|Salt+Lake+City chco=B3BCC0|5781AE|FF0000|FFC726|885E80|518274 chtt=Last+Five+Olympic+Hosts chm=f2010+Winter,000000,0,0,10 f2008+Summer,000000,0,1,10 f2008+Winter,000000,0,2,10,1,:-5:10 f2004+Summer,000000,0,3,10 f2004+Summer,000000,0,4,10 chma=0,110,0,0
Carte représentant la France, avec deux régions en surbrillance: chld=FR-D|FR-B|FR : trois régions sont spécifiées : Bourgogne (à l'est), Aquitaine (au sud-ouest) et France. chco=676767|FF4444|44FF44|4444FF : aucun paramètre chd n'est spécifié sur cette carte. Chaque valeur de couleur après la première est donc utilisée pour spécifier le pays correspondant. Rouge pour la Bourgogne, vert pour l'Aquitaine, bleu pour la France. Vous pouvez constater que les couleurs ultérieures ne masquent pas les couleurs antérieures.	chld=FR-D|FR-B|FR chco=676767|FF4444|44FF44|4444FF
Cette carte montre comment utiliser les dégradés de couleurs. chd=t:0,50,100 : le paramètre chd indique un dégradé de couleurs. Ici, l'encodage du texte est spécifié, avec une plage de 0 à 100. chco=CCCCCC,FF0000,000000 : la couleur de l'arrière-plan est gris clair (CCCCCC) et la gamme de couleurs va du rouge (FF0000) au noir (000000). Le pays central indiqué est une couleur intermédiaire pour ce dégradé.	chd=t:0,50,100 chco=CCCCCC,FF0000,000000
Notez que la carte peut être recadrée selon la taille de graphique spécifiée. En effet, nous ne déformons pas la carte afin qu'elle s'adapte à une taille de graphique spécifiée, mais nous la limitons aux régions que vous spécifiez dans chld. Par conséquent, pour éviter le recadrage de zones à l'intérieur des limites du graphique, vous devrez peut-être ajuster manuellement la taille de la carte.	cht=map chs=300x300 chld=GB L'Angleterre est naturellement longue et fine. Par conséquent, spécifier une carte carrée inclut une zone recadrée sur le côté droit: cht=map chs=180x300 chld=GB Ajustez la largeur du graphique pour supprimer l'excédent. Notez que certains éléments recadrés en bas devraient être corrigés en réduisant la hauteur de la carte. cht=map chs=180x300 chld=GB La France a une forme beaucoup plus régulière. Elle s'intègre donc plus naturellement sur une carte carrée.

Haut de page

Zoom et centrage

Par défaut, le graphique est zoomé et centré pour centrer les régions sélectionnées et les adapter à la zone rendue aussi fidèlement que possible, dans la taille de carte définie. Vous pouvez toutefois personnaliser le niveau de centrage et de zoom du graphique de deux manières différentes:

Par pixel

Pour ajuster les bordures en fonction de la taille des pixels, utilisez le format suivant:

cht=map:auto=<left_border>,<right_border>,<top_border>,<bottom_border>

Où chaque taille de bordure correspond à la bordure supplémentaire à afficher, en pixels, au-delà du niveau de zoom calculé automatiquement.

Vous ne pouvez effectuer un zoom arrière (valeurs positives) qu'au niveau du zoom par défaut. Vous ne pouvez pas effectuer de zoom avant (valeurs négatives) au niveau du pixel.

Exemples :

Ces exemples montrent tous Londres (Lat

Pas de zoom (par défaut)	Zoom arrière de 30 pixels de chaque côté	Zoom arrière et bas vers la droite
cht=map	cht=map:auto=30,30,30,30	cht=map:auto=50,0,80,0

 

Par latitude et longitude

Vous pouvez spécifier les bordures exactes (haut, bas, gauche et droite) de la carte rendue par latitude et longitude en utilisant la syntaxe ci-dessous:

cht=map:fixed=<bottom_border_lat>,<left_border_long>,<top_border_lat>,<right_border_long>

Où <bottom_border_lat> et <top_border_lat> indiquent la latitude des bordures inférieure et supérieure, et <left_border_long> et <right_border_long> indiquent la longitude des bordures gauche et droite.

Remarque: En raison de la distorsion de projection de Mercator (autrement dit, la projection d'une carte incurvée sur une image plate), le fait de se concentrer sur une grande bande étroite peut entraîner des différences de taille inattendues dans votre carte.

Exemples :

Les exemples suivants montrent Londres (en bleu) qui correspond à une longitude de 0,1° et à une latitude de 51,5°. Notez que la carte est recadrée, car elle tente d'afficher uniquement la Grande-Bretagne (comme spécifié) et de remplir le graphique désigné sans distorsion.

Centré	Latitudes décalées de +10*	Zoom effectué en réduisant toutes les valeurs
cht=map:fixed=40,-10,60,10	cht=map:fixed=50,-10,70,10	cht=map:fixed=48,-3,54,3

Notez que la taille de l'image du milieu est légèrement inférieure à celle de la première image, même si nous avons déplacé le même nombre de degrés vers le haut. En effet, nous projetons une sphère 3D sur une image 2D. Vous devez augmenter la largeur du deuxième graphique pour qu'il corresponde à la taille du premier.

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.	chtt=Site+visitors+by+month| January+to+July
Graphique avec un titre bleu aligné à droite composé de 20 points.	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:

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.	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.	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).	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).	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.	chf=a,s,00000080

Haut de page

Texte et style de la légende du graphique chdl, chdlp, chdls [Tous les graphiques]

La légende est une section latérale du graphique qui donne une courte description textuelle de chaque série. Vous pouvez spécifier le texte associé à chaque série dans cette légende, ainsi que l'emplacement où elle doit apparaître sur le graphique.

Consultez également chma pour découvrir comment définir les marges autour de votre légende.

Remarque sur les valeurs de chaîne:Seuls les caractères compatibles avec les URL sont autorisés dans les chaînes de libellés. Pour plus de sécurité, vous devez encoder en URL toutes les chaînes contenant des caractères ne figurant pas dans le jeu de caractères 0-9a-zA-Z. Vous trouverez un encodeur d'URL dans la documentation sur la visualisation Google.

Syntaxe

chdl=<data_series_1_label>|...|<data_series_n_label>
chdlp=<opt_position>|<opt_label_order>
chdls=<color>,<size>

 

chdl : texte de chaque série à afficher dans la légende.

<data_series_label>

Texte des entrées de la légende. Chaque étiquette s'applique à la série correspondante dans le tableau chd. Utilisez un signe + pour un espace. Si vous ne spécifiez pas ce paramètre, le graphique n'obtient pas de légende. Il n'est pas possible de spécifier un saut de ligne dans un libellé. La légende se développe généralement pour contenir le texte de la légende, et la zone du graphique est réduite pour l'adapter à la légende.

chdlp : [facultatif] la position de la légende et l'ordre des entrées de la légende. Vous pouvez indiquer <position> et/ou <label_order>. Si vous spécifiez les deux, séparez-les par une barre. Vous pouvez ajouter un "s" à n'importe quelle valeur si vous souhaitez que les entrées de légende vides dans chdl soient ignorées dans la légende. Exemples: chdlp=bv, chdlp=r, chdlp=bv|r, chdlp=bvs|r

<opt_position>

[Facultatif] Spécifie la position de la légende sur le graphique. Pour spécifier une marge intérieure supplémentaire entre la légende et la zone de graphique ou la bordure de l'image, utilisez le paramètre chma. Choisissez l'une des valeurs suivantes :

• b : légende en bas du graphique, entrées de légende dans une ligne horizontale.
• bv : légende en bas du graphique, entrées de légende dans une colonne verticale.
• t : légende en haut du graphique, entrées de légende sur une ligne horizontale.
• tv : légende en haut du graphique, entrées de légende dans une colonne verticale.
• r : [par défaut] : légende à droite du graphique, entrées de légende dans une colonne verticale.
• l : légende à gauche du graphique, entrées de légende dans une colonne verticale.

<opt_label_order>

[Facultatif] Ordre d'affichage des libellés dans la légende. Choisissez l'une des valeurs suivantes :

• l : [Valeur par défaut pour les légendes verticales] : affiche les libellés dans l'ordre attribué à chdl.
• r : affiche les libellés dans l'ordre inverse, comme indiqué pour chdl. Cette fonctionnalité est utile dans les graphiques à barres empilées, qui permet d'afficher la légende
  dans le même ordre que les barres.
• a : [valeur par défaut pour les légendes horizontales] Ordre automatique : tri par longueur, en commençant par le plus court, mesuré en blocs de 10 pixels. Lorsque deux éléments ont la même longueur (divisés en blocs de 10 pixels), le premier qui figure en premier apparaît en premier.
• 0,1,2... : ordre des étiquettes personnalisées. Il s'agit d'une liste d'index de libellés basés sur zéro provenant de chdl, séparés par une virgule.

chdls [facultatif] : spécifie la couleur et la taille de la police du texte de la légende.

<color>

Couleur du texte de la légende, au format hexadécimal RRVVBB.

<size>

Taille du point du texte de la légende.

 

Exemples

Description	Exemple
Deux exemples de légendes. Spécifiez le texte de la légende dans le même ordre que celui de votre série de données.	chdl=NASDAQ|FTSE100|DOW chco=FF0000,00FF00,0000FF chdl=First|Second|Third chco=ff0000,00ff00,0000ff
Le premier graphique illustre les entrées de légende horizontales (chdlp=t, la mise en page par défaut est horizontale), et le second illustre les entrées de légende verticale inférieures (chdlp=bv).	chdl=First|Second|Third chco=ff0000,00ff00,0000ff chdlp=t chdl=First|Second|Third chco=ff0000,00ff00,0000ff chdlp=bv
Cet exemple montre comment modifier la taille de la police.	chdls=0000CC,14

Haut de page

Repères de forme chm [Barre, ligne, radar, nuage de points]

Vous pouvez spécifier des repères graphiques pour tous les points de données d'un graphique ou pour certains seulement. Si deux repères ou plus occupent le même point, ils sont dessinés dans l'ordre dans lequel ils apparaissent dans le paramètre chm. Vous pouvez également créer des repères de texte sur des points de données. Cette procédure est expliquée dans la section Repères de points de données.

Vous pouvez combiner des repères de forme avec n'importe quel autre paramètre chm en utilisant une barre verticale ( | ) pour séparer les paramètres chm.

Syntaxe

Spécifiez un ensemble des paramètres suivants pour chaque série à marquer. Pour marquer plusieurs séries, créez des ensembles de paramètres supplémentaires, délimités par une barre verticale. Vous n'avez pas besoin de baliser toutes les séries. Si vous n'attribuez pas de repères à une série de données, celle-ci n'en recevra aucun.

Les repères de forme se comportent légèrement différemment dans les graphiques à nuage de points. Consultez cette documentation pour en savoir plus.

chm=
  [@]<marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_offset>
    |...|
  [@]<marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_offset>

@

[Facultatif] Si vous faites précéder le type du repère par le caractère @ facultatif, <opt_which_points> doit utiliser le format x:y.

<Marker_type>

Type de repère à utiliser. Spécifiez l'un des types suivants :

• a : flèche
• c – Croisé
• C : rectangle. S'il s'agit d'un repère rectangulaire, vous devez avoir au moins deux séries de données, la série 0 correspondant au bord inférieur et la série 1 au bord supérieur. <size> spécifie la largeur du rectangle, en pixels.
• d – Diamant
• E : repère de barre d'erreur ( ) Ce repère nécessite la création de deux séries de données, une valeur pour le bas et le point correspondant dans la deuxième série pour le haut. Il expose également une syntaxe <size> étendue: line_thickness[:top_and_bottom_width], où top_and_bottom_width est facultatif. Voir les exemples ci-dessous.
• h : ligne horizontale à une hauteur spécifiée traversant le graphique. (Le seul format valide pour le paramètre <opt_which_points> est n.d.)
• H : ligne horizontale passant par le repère de données spécifié. Ce paramètre accepte une syntaxe <size> étendue qui vous permet de spécifier une longueur de ligne exacte: line_thickness[:length] où :length est facultatif. La valeur par défaut correspond à la largeur totale de la zone du graphique.
• o – Cercle
• s – Carré
• v : ligne verticale entre l'axe des abscisses et le point de données
• V : ligne verticale de longueur ajustable. Ce paramètre accepte une syntaxe de valeur <size> étendue qui vous permet de spécifier une longueur de ligne exacte: line_thickness[:length], où :length est facultatif. Il correspond par défaut à la hauteur complète de la zone du graphique. Le repère est centré sur le point de données.
• x : An X

<color>

Couleur des repères de cette série, au format hexadécimal RRVVBB.

<series_index>

: indice base zéro de la série de données sur laquelle placer les repères. Ignoré pour les repères h et ceux spécifiant la position x/y (commence par le caractère @). Vous pouvez utiliser des séries de données masquées comme source des repères. Pour en savoir plus, consultez la section Graphiques composés. Les graphiques à barres verticales groupées utilisent une syntaxe étendue spéciale pour aligner les repères sur des barres spécifiques.

<opt_which_points>

[Facultatif] Les points sur lesquels placer des repères La valeur par défaut est "Tous les repères". Utilisez l'une des valeurs suivantes :

• n.d : emplacement du repère. La signification dépend du type de repère :
  • Tous les types sauf h : point de données sur lequel placer le repère, où n.d est l'indice de base zéro de la série. Si vous spécifiez une valeur non entière, la fraction indique un point intermédiaire calculé. Par exemple, 3,5 correspond à la moitié entre le point 3 et le point 4.
  • h : nombre compris entre 0,0 et 1,0, où 0 correspond à la partie inférieure du graphique et 1,0 à la partie supérieure.
• -1 : tracez un repère sur tous les points de données. Vous pouvez également laisser ce paramètre vide pour utiliser tous les points de données.
• -n : tracez un repère sur tous les n points de données. Valeur à virgule flottante. Si n est inférieur à 1, le graphique calcule des points intermédiaires supplémentaires. Par exemple, -0.5 place deux fois plus de repères que de points de données.
• start:end:n : trace un repère sur tous les nièmes points de données d'une plage, des valeurs d'index de début à la fin (incluses). Tous les paramètres sont facultatifs (peuvent être absents). 3::1 irait donc du quatrième élément au dernier, étape 1. Si vous omettez complètement ce paramètre, la valeur par défaut serait first:last:1. Toutes les valeurs peuvent être des nombres à virgule flottante. Les valeurs start et end peuvent être négatives pour effectuer un décompte à partir de la dernière valeur. Si les valeurs start et end sont négatives, assurez-vous qu'elles sont indiquées avec une valeur croissante (par exemple, -6:-1:1). Si la valeur de pas n est inférieure à 1, les points de données supplémentaires sont calculés en interpolant les valeurs de données fournies. Les valeurs par défaut sont first:last:1
• x:y : tracez un repère à un point x/y spécifique du graphique. Il ne doit pas nécessairement se trouver sur une ligne. Pour utiliser cette option, ajoutez le caractère @ avant le type de repère. Spécifiez les coordonnées en tant que valeurs à virgule flottante, où 0:0 est l'angle inférieur gauche du graphique et 1:1 est l'angle supérieur droit. Par exemple, pour ajouter un losange rouge de 15 pixels au centre d'un graphique, utilisez @d,FF0000,0,0.5:0.5,15.

<size>

: taille du repère, en pixels. La plupart utilisent une seule valeur numérique pour ce paramètre. Les repères V, H et S sont compatibles avec la syntaxe <size>[:width], où la deuxième partie facultative spécifie la longueur de la ligne ou du repère.

<opt_z_order>

[Facultatif] Calque sur lequel dessiner le repère, par rapport aux autres repères et à tous les autres éléments du graphique. Il s'agit d'un nombre à virgule flottante compris entre -1,0 et 1,0 inclus, où -1,0 correspond à la valeur inférieure et 1,0 à la valeur supérieure. Les éléments du graphique (lignes et barres) sont juste inférieurs à zéro. Si deux repères ont la même valeur, ils sont tracés dans l'ordre indiqué par l'URL. La valeur par défaut est 0.0 (juste au-dessus des éléments du graphique).

<opt_offset>

[Facultatif] Permet de spécifier des décalages horizontal et vertical à partir de l'emplacement spécifié. Voici la syntaxe, qui utilise un délimiteur : reserved:<horizontal_offset>:<vertical_offset>. Si elle est spécifiée, vous pouvez inclure une valeur ,, vide dans la chaîne de paramètre chm pour <opt_z_order>. Exemples: o,FF9900,0,4,12,,:10 o,FF9900,0,4,12.0,,:-10:20 o,FF9900,0,4,12,1,::20

• réservé : laissez ce champ vide.
• <horizontal_offset> : nombre positif ou négatif spécifiant le décalage horizontal, en pixels. Facultatif. Laissez ce champ vide s'il n'est pas utilisé.
• <vertical_offset> : nombre positif ou négatif spécifiant le décalage vertical, en pixels. Facultatif. Laissez ce champ vide s'il n'est pas utilisé.

 

Exemples

Description	Exemple
Voici un exemple de plusieurs repères de forme et de ligne. a,990066,0,0.0,9.0 : flèche violette, première série, premier point, taille 9. c,FF0000,0,1.0,20.0 : Croix rouge, première série, deuxième point, taille 9. d,80C65A,0,2,20.0 : losange vert, première série, troisième point, taille 9. H,000000,0,3,1:40 : ligne horizontale noire, première série, point de données 3, largeur d'un pixel, longueur de quarante pixels. o,FF9900,0,4.0,12.0 : cercle orange, première série, cinquième point, taille 12. s,3399CC,0,5.0,11.0 : carré bleu, première série, sixième point, taille 11. v,BBCCED,0,6.0,1.0 : ligne verticale jusqu'à un point, première série, septième point, largeur d'un pixel. V,3399CC,0,7.0,1.0 : ligne verticale de bas en haut du graphique, première série, huitième point, largeur d'un pixel. x,FFCC33,0,8.0,20.0 : "X" jaune, première série, neuvième point, taille 20. H,FFFF00,0,9,2 : ligne horizontale jaune correspondant à la largeur du graphique au point de données 9. h,FF0000,0,0.5,1 : ligne horizontale rouge à une hauteur désignée, première série, à mi-hauteur du graphique, d'un pixel de large.	chm=   a,990066,0,0.0,9.0|   c,FF0000,0,1.0,20|   d,80C65A,0,2.0,20.0|   H,000000,0,3,1:40|   o,FF9900,0,4.0,12.0|   s,3399CC,0,5.0,11.0|   v,BBCCED,0,6,1.0|   V,3399CC,0,7,1.0|   x,FFCC33,0,8,20|   H,FFFF00,0,9,2|   h,FF0000,0,0.5,1
Voici un exemple utilisant des losanges pour une série de données et des cercles pour l'autre. Si deux repères ou plus occupent le même point, ils sont dessinés dans l'ordre dans lequel ils apparaissent dans le paramètre chm. Ici, le cercle est le premier repère spécifié avec chm. Il est donc dessiné en premier. Le losange est spécifié et dessiné en second. Il est donc dessiné au-dessus du cercle.	chm=   o,FF9900,0,-1,15.0|   d,FF0000,1,-1,10.0
Voici un graphique en courbes avec un repère tous les deux points de données (-2 correspond à tous les deux points).	chd=t:   0,20,20,50,40,70,70,90,85,45,40,50 chm=   o,0066FF,0,-2,6
Voici un graphique en courbes contenant deux fois plus de repères que de points de données (-0,5 correspond à chaque demi-point).	chd=t:   0,20,20,50,40,70,70,90,85,45,40,50 chm=   o,0066FF,0,-.5,6
Cet exemple montre comment utiliser les repères h et v pour créer des lignes de grille avec des couleurs et une épaisseur personnalisées. La valeur de l'ordre z (la dernière valeur) est définie sur -1 afin que les lignes de la grille soient tracées sous la ligne de données.	chm=   h,76A4FB,0,0:1:.2,2,-1|   V,76A4FB,0,::2,0.5,-1
Ce graphique ajoute des lignes de remplissage verticales à un graphique en courbes: v : lignes verticales du graphique FF0000 : lignes rouges 0 : indice de la série : :.5 : spécificateur de plage : du début à la fin, tous les 0,5 point. 2 : épaisseur de 2 pixels.	chm=   v,FF0000,0,::.5,2
Cet exemple ajoute une flèche et un repère de texte au graphique à l'aide de coordonnées exactes. Le premier repère D est la ligne de trace sous les barres. Le deuxième repère est la flèche et le troisième, le texte fléché.	chm=   D,003971,1,0,3|   @a,000000,0,.25:.75,7|   @tExpected,000000,0,.35:.85,10
Une ligne horizontale fixée à un point de données spécifique (H) peut être utile pour afficher des valeurs relatives ou mettre en valeur la hauteur d'une valeur de données sur un graphique.	chm=H,FF0000,0,18,1
Ce graphique montre les repères permettant de spécifier l'épaisseur et la longueur du trait dans le paramètre <size>. E,000000,0,6,1:20 : barre d'erreur noire avec des lignes de 1 pixel de large, et des barres supérieure et inférieure d'une longueur de 20 pixels. La partie inférieure est ancrée à la série 0 point 8, tandis que la partie supérieure est ancrée aux séries 1 et point 8. H,990066,1,2,5:50 : violet, ligne horizontale de cinq pixels de largeur, cinquante pixels de long centré sur le point de données 2. V,3399CC,0,8,3:50 : ligne verticale bleue de 3 pixels de large, cinquante pixels de long, centrée sur le point de données 8.	title="cht=lc&chd=s:2gounjqLaCf,jqLaCf2goun&chco=008000,00008033&chls=2.0,4.0,1.0&chs=250x150&chm=H,990066,1,2,5,05,07C chm=   E,000000,0,6,1:20|   H,990066,1,2,5:50|   V,3399CC,0,8,3:50

Haut de page

Repères de texte et de valeur de données chm [Barre, ligne, radar, nuage de points]

Vous pouvez étiqueter des points spécifiques de votre graphique avec du texte personnalisé ou avec des versions formatées des données à ce stade.

Vous pouvez combiner n'importe quel repère chm à l'aide d'une barre verticale ( |) pour séparer les ensembles de paramètres chm.

Remarque sur les valeurs de chaîne:Seuls les caractères compatibles avec les URL sont autorisés dans les chaînes de libellés. Pour plus de sécurité, vous devez encoder en URL toutes les chaînes contenant des caractères ne figurant pas dans le jeu de caractères 0-9a-zA-Z. Vous trouverez un encodeur d'URL dans la documentation sur la visualisation Google.

Syntaxe

Spécifiez un ensemble des paramètres suivants pour chaque série à marquer. Pour marquer plusieurs séries, créez des ensembles de paramètres supplémentaires, délimités par une barre verticale. Vous n'avez pas besoin de baliser toutes les séries. Si vous n'attribuez pas de repères à une série de données, celle-ci n'en recevra aucun.

chm=
  <marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_placement>
    |...|
  <marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_placement>

<Marker_type>

Type de repère à utiliser. Vous avez le choix entre les types suivants :

• f<text> : indicateur contenant du texte. Spécifiez le caractère "f", suivi du texte encodé au format URL personnalisé. Pour échapper les virgules dans les repères de texte, faites précéder la virgule d'un signe \. Exemple : fHello\,+World!
• t<text> : repère de texte simple. Spécifiez le caractère "t" suivi d'un texte encodé au format URL personnalisé. Pour échapper les virgules dans les repères de texte, faites précéder la virgule d'un signe \. Exemple : tHello\,+World!
• A<text> : repère d'annotation. Cette méthode est semblable à celle d'un repère, à la différence que les repères se coordonnent pour leur position afin qu'ils ne se chevauchent pas. Le seul format valide pour <opt_which_points> est n.d, pour indiquer l'index d'un point de la série.
• N<formatting_string> : valeur des données à ce stade, avec mise en forme facultative. Si vous n'utilisez pas le paramètre chds (mise à l'échelle personnalisée), vous obtenez la valeur encodée exacte. Si vous utilisez ce paramètre avec n'importe quel type de format, la valeur est mise à l'échelle selon la plage que vous spécifiez. Consultez un exemple de chds avec des repères numériques ci-dessous. Avec ce type de repère dans un graphique à barres empilées, si vous spécifiez -1 pour <series_index>, vous obtenez un repère qui affiche la somme de toutes les valeurs de cette barre empilée. La syntaxe de la chaîne de mise en forme est la suivante:
         <preceding_text>*<number_type><decimal_places>zs<x or y>*<following_text>.
  Tous ces éléments sont facultatifs. Voici la signification de chaque élément :
  • <preceding_text> : texte devant chaque valeur.
  • *...* : bloc facultatif encapsulé d'astérisques littéraux, dans lequel vous pouvez spécifier des détails de mise en forme pour les nombres. Les valeurs suivantes sont acceptées et sont toutes facultatives :
    • <number_type> : format numérique, pour les valeurs numériques. Choisissez l'une des options suivantes :
      • f [Par défaut] : format à virgule flottante. Pensez également à spécifier la précision avec la valeur <decimal_places>.
      • p : format en pourcentage. Un signe % est ajouté automatiquement. Remarque:Lorsque vous utilisez ce format, les valeurs de données comprises entre 0,0 et 1,0 correspondent à 0 à 100% (par exemple, 0,43 correspond à 43%).
      • e : format de notation scientifique.
      • c<CUR> : formate le nombre dans la devise spécifiée, avec le repère de devise approprié. Remplacez <CUR> par un code de devise à trois lettres. Exemple: cEUR pour les euros. Une liste de codes est disponible sur le site Web de l'ISO. Tous les symboles ne sont toutefois pas acceptés.
    • <decimal_places> : entier spécifiant le nombre de chiffres après la virgule à afficher. La valeur est arrondie (non tronquée) à cette longueur. La valeur par défaut est 2.
    • z : affiche les zéros à la fin. La valeur par défaut est "no" (non).
    • s : affiche les séparateurs de groupes. La valeur par défaut est "no" (non).
    • x ou y : affiche les données à partir de la coordonnée x ou y, comme spécifié. La signification des données x varie selon le type de graphique: testez votre graphique pour déterminer sa signification. La valeur par défaut est "y".
  • <following_text> : texte qui suit chaque valeur.

<color>

Couleur des repères de cet ensemble, au format hexadécimal RRVVBB.

<series_index>

: indice base zéro de la série de données sur laquelle placer les repères. S'il s'agit d'un graphique à barres empilées et que le repère est de type N (valeurs de points de données), vous pouvez spécifier -1 afin de créer un repère de valeur additionnée pour chaque pile de barres. Voir l'exemple ci-dessous.

<opt_which_points>

[Facultatif] Les points sur lesquels placer des repères La valeur par défaut est "Tous les repères". Utilisez l'une des valeurs suivantes :

• n.d : point de données sur lequel placer le repère, où n.d est l'indice base zéro de la série. Si vous spécifiez une valeur non entière, la fraction indique un point intermédiaire calculé. Par exemple, la valeur 3,5 correspond à la moitié du chemin entre le point 3 et le point 4.
• -1 : tracez un repère sur tous les points de données. Vous pouvez également laisser ce paramètre vide pour utiliser tous les points de données.
• -n : tracez un repère sur tous les n points de données.
• start:end:n - Tracez un repère sur chaque n-ième point de données dans une plage, de start à endindex inclus. Tous les paramètres sont facultatifs (peuvent être absents). 3::1 irait donc du quatrième élément au dernier, étape 1. Si vous omettez complètement ce paramètre, la valeur par défaut serait first:last:1. Toutes les valeurs peuvent être des nombres à virgule flottante. Les valeurs start et end peuvent être négatives pour effectuer un décompte à partir de la dernière valeur. Si les valeurs start et end sont négatives, assurez-vous qu'elles sont indiquées avec une valeur croissante (par exemple, -6:-1:1). Si la valeur de pas n est inférieure à 1, les points de données supplémentaires sont calculés en interpolant les valeurs de données fournies. Les valeurs par défaut sont first:last:1.
• x:y - [Non compatible avec les repères de type N] Dessine un repère à un point x/y spécifique sur le graphique. Il ne doit pas nécessairement se trouver sur une ligne. Pour utiliser cette option, ajoutez le caractère arobase (@) avant le type de repère. Spécifiez les coordonnées en tant que valeurs à virgule flottante, où 0:0 est l'angle inférieur gauche du graphique, 0.5:0.5 est le centre du graphique et 1:1 est l'angle supérieur droit du graphique. Par exemple, pour ajouter un losange rouge de 15 pixels au centre d'un graphique, utilisez @d,FF0000,0,0.5:0.5,15.

<size>

: taille du repère en pixels. S'il s'agit d'un graphique à nuage de points avec une troisième série de données (utilisée pour spécifier la taille des points), cette valeur sera mise à l'échelle en fonction de la plage de données. Ainsi, si la plage de données est comprise entre 0 et 100 et que <size> est égal à 30, une valeur de données de 100 correspondra à une largeur de 30 pixels, une valeur de données de 50 à une largeur de 15 pixels, et ainsi de suite.

<opt_z_order>

[Facultatif] Calque sur lequel dessiner le repère, par rapport aux autres repères et à tous les autres éléments du graphique. Il s'agit d'un nombre à virgule flottante compris entre -1,0 et 1,0 inclus, où -1,0 correspond à la valeur inférieure et 1,0 à la valeur supérieure. Les éléments du graphique (lignes et barres) sont juste inférieurs à zéro. Si deux repères ont la même valeur, ils sont tracés dans l'ordre indiqué par l'URL. La valeur par défaut est 0.0 (juste au-dessus des éléments de graphique).

<opt_placement>

[Facultatif] Informations supplémentaires sur l'emplacement décrivant où placer ce repère par rapport au point de données. Vous pouvez spécifier un positionnement relatif horizontal et/ou vertical, ainsi que des décalages. La syntaxe de l'emplacement est une chaîne contenant les délimiteurs ":", comme indiqué ici. Tous les éléments sont facultatifs: <horizontal_and_vertical_justification>:<horizontal_offset>:<vertical_offset>. Si elle est spécifiée, vous pouvez inclure une valeur ,, vide dans la chaîne de paramètre chm pour <opt_z_order>. Exemples : N,000000,0,1,10,,b, N,000000,0,1,10,,lv et N,000000,0,1,10,,r::10.

horizontal_and_vertical_justification

Point d'ancrage du repère. Ce comportement est opposé à la justification. Par conséquent, une ancre gauche place le repère à droite du point de données. Vous pouvez choisir un justificatif horizontal et/ou vertical dans la liste suivante :

• Emplacement horizontal : "l", "h" ou "r" : à gauche, au centre ou ancré à droite, horizontalement. La valeur par défaut est "l".
• Emplacement vertical : "b", "v", "t" : ancré verticalement, en bas, au milieu ou en haut. La valeur par défaut est "b".
• Emplacement relatif [Graphiques à barres uniquement] : "s", "c", "e" : base, centre ou haut d'une barre. Pour les graphiques empilés, cette valeur dépend de la section de la barre pour chaque série, et non de la barre entière. Si l'indice de série donné est -1 (total de la pile), c'est par rapport à la barre entière. Cette valeur peut être combinée à des valeurs d'emplacement vertical (par exemple, "be" ou "vs"). La valeur par défaut est "e".

horizontal_offset

Décalage horizontal du repère, en pixels. La valeur par défaut est 0.

vertical_offset

Décalage vertical du repère, en pixels. Valeur par défaut du graphique à barres : 15 ; valeur par défaut du graphique à barres: 2.

Description	Exemple
Voici un exemple d'étiquettes de valeurs sur un graphique à barres. Le premier graphique (N*p0*) spécifie un repère de valeur de données, avec les valeurs affichées en pourcentage et arrondies à zéro décimale, en noir, pour toutes les valeurs, avec du texte à 11 points. Notez que les valeurs de données sont toutes comprises entre 0,0 et 1,0, qui, sous forme de pourcentage, sont déplacées vers le haut de deux décimales. Le deuxième graphique (N*cEUR1*) affiche les mêmes valeurs en euros (avec une décimale) en noir pour toutes les valeurs, en texte à 11 points.	chm=   N*p0*,000000,0,-1,11 chd=t:   0.4356,0.3562,0.4834,0.575,0.673,0.6091 chm=   N*cEUR1*,000000,0,-1,11
Vous pouvez utiliser le paramètre chds pour adapter la valeur numérique affichée. Vous pouvez utiliser chds pour tous les formats de données, y compris l'encodage simple et étendu. Cela n'affectera pas la taille de la barre ni les libellés de l'axe, mais uniquement la valeur du repère de données. Cet exemple montre un graphique avec des valeurs à encodage simple de 46, 39, 29, 30, 43, 41. La plage d'encodage simple est comprise entre 0 et 61. Le paramètre chds définit une échelle de repère personnalisée de 0 à 1. Les valeurs des repères sont donc mises à l'échelle en fonction de cette plage, mais la hauteur des barres ne est pas affectée (s'il s'agissait de données au format texte, les barres seraient également mises à l'échelle).	chd=s:underp chm=N,000000,0,-1,11 chds=0,1
Voici un exemple de graphique avec un libellé de texte au point minimal et un libellé d'indicateur au point maximal.	chm=   tMin,0000FF,0,1,10|   fMax,FF0000,0,3,15
Cet exemple présente un graphique empilé avec les valeurs de chaque série, plus le total de la série. Pour afficher les valeurs de séries empilées, nous devons utiliser l'option de positionnement "c". Si ce n'était pas le cas, la valeur de la barre supérieure chevaucherait la valeur de la somme en haut de chaque barre.	chm=   N,FF0000,-1,,12|   N,000000,0,,12,,c|   N,000000,1,,12,,c|   N,ffffff,2,,12,,c
Voici d'autres exemples du fonctionnement du placement vertical et horizontal. Cet exemple illustre différentes combinaisons de valeurs d'ancrage pour les graphiques à barres (qui utilisent s, c et e pour un positionnement vertical). Notez la façon dont une ancre droite déplace un repère vers la gauche et une ancre supérieure déplace un repère vers le bas, et inversement. Les points rouges indiquent la base, le centre et le haut de chaque barre. Il s'agit de la valeur des données, fixée à l'aide de valeurs d'ancrage différentes pour chaque barre.	chm=   N,000000,0,0,10,,rs   N,000000,0,1,10,,ls   N,000000,0,2,10,,c   N,000000,0,3,10,,e   N,000000,0,4,10,,e::15   N,000000,0,5,10,,e::-12
Les repères d'annotation ajustent automatiquement la position des libellés afin qu'ils ne se chevauchent pas. La première valeur chm correspond au remplissage de la ligne. Les valeurs suivantes sont toutes des repères d'annotation.	chm=B,C5D4B5BB,0,0,0   AA,666666,0,3,15   AB,666666,0,5,15   AC,666666,0,24,15   AD,666666,0,25,15   AE,666666,0,26,15   AF,666666,0,51,15   AG,666666,0,60,15   AH,666666,0,73,15   AI,666666,0,80,15   AJ,666666,0,99,15
Un autre exemple de repère d'annotation montre l'altitude d'une ville en Suisse.

Haut de page