Grafico a mappa (versione deprecata)

 

Avviso di sostituzione: questo grafico della mappa è stato sostituito da una versione più recente.

In questa pagina viene descritto come creare una mappa colorata utilizzando l'API modifichi.

Indice

Funzionalità specifiche del grafico

  1. Panoramica
  2. Codici degli stati degli Stati Uniti

Funzionalità standard

  1. Titolo grafico (chtt, chts)
  2. Margini del grafico (chma)
  3. Riempimento sfondo
    1. Riempimenti solidi (chf)

Panoramica

Puoi creare una mappa con vari paesi o stati evidenziati con colori personalizzati. Per specificare una mappa, devi specificare in quale regione del mondo deve essere ingrandita la mappa. Dovrai specificare anche un elenco di regioni che devono essere colorate nella mappa e un elenco di dati paralleli che assegna un valore numerico a ogni paese corrispondente. Ogni paese viene colorato lungo un gradiente, in base al valore assegnato. Facoltativamente, puoi specificare un gradiente di colore personalizzato per i valori dei dati.

I grafici della mappa supportano i seguenti parametri:

Parametro Obbligatorio o facoltativo Descrizione
cht=t Obbligatorio Specifica un grafico mappa.
chs Obbligatorio Dimensioni della mappa. La dimensione massima di una mappa è 440 x 220.
chtm=<zoom_area> Obbligatorio

Area geografica mostrata nel grafico.

  • zoom_area: uno dei seguenti valori:
    • africa
    • asia
    • europe
    • middle_east
    • south_america
    • usa
    • world
chld=<country_or_state_codes> Obbligatorio

Un elenco di paesi o stati a cui applichi valori.

Esempio: chld=DZEGMG
chd=<country_values> Obbligatorio

Un elenco di valori paralleli all'elenco di regioni, in cui il valore si applica alla regione corrispondente. I valori sono valori dei dati formattati standard. A ogni regione verrà assegnato un colore lungo la scala specificata in chco, dove il valore più basso dell'intervallo si applica al colore più basso, mentre il valore più alto in quell'intervallo si applica all'ultimo colore.

  • country_values: un elenco nella stringa di formato appropriata. Esempi: t:10,20,30, s:aU2Ff e e:BaPoqM-A.
chco=<default_color>,<start_of_gradient>,...,<end_of_gradient> Facoltativo

Un intervallo di colori corrispondente ai valori dei dati bassi e alti per l'intervallo del formato dei dati. I valori dei dati vengono convertiti in valori di colore lungo questo gradiente e applicati ai paesi corrispondenti.

  • default_color - [Facoltativo] Il colore delle regioni a cui non sono assegnati dati. Il valore predefinito è BEBEBE (grigio medio). Un numero esadecimale in formato RRGGBB.
  • start_of_gradient - [Facoltativo] Il colore corrispondente al valore minimo nell'intervallo del formato dei dati. Il valore predefinito è 0000FF (blu). Un numero esadecimale in formato RRGGBB.
  • ... - [Facoltativo] Puoi avere tutti i colori intermedi che vuoi.
  • end_of_gradient - [Facoltativo] Il colore corrispondente al valore massimo nell'intervallo del formato dei dati. Il valore predefinito è FF0000 (rosso). Un numero esadecimale in formato RRGGBB
chtt, chts Facoltativo Titolo e stile del grafico
chma Facoltativo Margini del grafico
chf=bg Facoltativo Riempimenti a tinta unita (solo sfondo)

 

Esempi

Descrizione Esempio

In questo esempio:

  • L'area zoom del grafico è Africa (chtm=africa).
  • Ai tre paesi verranno assegnati valori: Algeria, Egitto e Madagascar (chld=DZEGMG)
  • I tre valori assegnati a questi paesi sono rispettivamente 0, 100 e 50 (chd=t:0,100,50), che corrispondono ai valori minimo, massimo e medio per i dati in formato di testo.
  • La gamma di colori è rosso per 0, verde per 100 e bianco per i paesi non assegnati (chco=FFFFFF,FF0000,00FF00).
  • Il grafico ha anche un riempimento di sfondo azzurro (chf=bg,s,EAF7FE).

Mappa dell&#39;Africa
cht=t
chtm=africa
chld=DZEGMG
chd=t:0,100,50
chco=FFFFFF,FF0000,00FF00
chf=bg,s,EAF7FE

Questo grafico è simile al precedente, ma con maggiori dettagli.

 Mappa dell&#39;Africa
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

Questo grafico indica che nessun paese viene evidenziato specificando un singolo valore non definito (chd=t:-1).

 Mappa del mondo
chs=440x220
chd=t:-1
cht=t
chtm=world

Torna all'inizio

Codici degli stati degli Stati Uniti

Di seguito sono riportati i codici di stato supportati quando la mappa viene ingrandita sugli Stati Uniti (chld=usa).

AL Alabama LA Louisiana OH Ohio
AK Alaska ME Maine Ok Oklahoma
AZ Arizona MD Maryland OPPURE Oregon
AR Arkansas MA Massachusetts PA Pennsylvania
CA California MI Michigan RI Rhode Island
CO Colorado MN Minnesota SC Carolina del Sud
CT Connecticut MS Mississippi SD Dakota del Sud
DE Delaware MO Missouri VN Tennessee
FL Florida MT Montana TX Texas
GA Georgia NE Nebraska UT Utah
HI Hawaii NV Nevada VT Vermont
ID Idaho NH New Hampshire VA Virginia
IL Illinois NJ New Jersey WA Washington
IN Indiana NM Nuovo Messico WV West Virginia
IA Iowa NY New York WI Wisconsin
KS Kansas NC Carolina del Nord WY Wyoming
KY Kentucky ND Dakota del Nord

Torna all'inizio

Funzionalità standard

Le altre funzionalità in questa pagina sono funzionalità standard dei grafici.

Titolo grafico chtt, chts [Tutti i grafici]

Puoi specificare il testo del titolo, il colore e la dimensione dei caratteri del grafico.

Sintassi

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

 

chtt - Specifica il titolo del grafico.

<chart_title>
Titolo da mostrare per il grafico. Non puoi specificare dove viene visualizzata, ma puoi facoltativamente specificare le dimensioni e il colore del carattere. Utilizza un segno + per indicare gli spazi e una barra verticale ( |) per indicare le interruzioni di riga.

 

chts [Facoltativo] - Colori e dimensioni del carattere per il parametro chtt.

<color>
Il colore del titolo, in formato esadecimale RRGGBB. Il colore predefinito è nero.
<font_size>
Dimensione del carattere del titolo, in punti.
<opt_alignment>
[Facoltativo] Allineamento del titolo. Scegli uno dei seguenti valori stringa sensibili alle maiuscole: "l" (sinistra), "c" (centrata) "r" (destra). Il valore predefinito è "c".

 

Esempi

Descrizione Esempio

Un grafico con un titolo, che utilizza colori e dimensioni del carattere predefiniti.

Specifica uno spazio con un segno più (+).

Utilizza una barra verticale (|) per forzare un'interruzione di riga.

chts non è specificato qui.

 Grafico a barre verticali con titolo
chtt=Site+visitors+by+month|
January+to+July

Un grafico con un titolo blu a 20 punti allineato a destra.

 Grafico a barre verticali con blu, 20 pixel, titolo
chtt=Site+visitors
chts=FF0000,20,r

Torna all'inizio

Margini del grafico chma [Tutti i grafici]

Puoi specificare la dimensione dei margini del grafico, in pixel. I margini vengono calcolati verso l'interno rispetto alla dimensione del grafico specificata (chs); l'aumento della dimensione del margine non aumenta la dimensione totale del grafico, ma piuttosto riduce l'area del grafico, se necessario.

Per impostazione predefinita, i margini sono l'importo rimasto dopo il calcolo delle dimensioni del grafico. Questo valore predefinito varia in base al tipo di grafico. I margini specificati sono un valore minimo. Se l'area del grafico lascia spazio per i margini, la dimensione del margine sarà quella restante. Non puoi ridurre i margini più piccoli del necessario per legende ed etichette. Ecco un diagramma che mostra le parti di base di un grafico:

Margine, area della legenda e area del grafico

I margini del grafico includono le etichette dell'asse e l'area legenda. L'area della legenda si ridimensiona automaticamente per adattarsi esattamente al testo, a meno che non specifichi una larghezza maggiore utilizzando chma, nel qual caso la dimensione del margine verrà ampliata di più, restringendo l'area del grafico. Non puoi ritagliare una legenda specificando una dimensione troppo piccola, ma puoi fare in modo che occupi più spazio del necessario.

Suggerimento:in un grafico a barre, se le barre hanno una dimensione fissa (impostazione predefinita), non è possibile ridurre la larghezza dell'area del grafico. Devi specificare una dimensione della barra più piccola o ridimensionabile utilizzando chbh.

 

Sintassi

chma=
  <left_margin>,<right_margin>,<top_margin>,<bottom_margin>|<opt_legend_width>,<opt_legend_height>
<left_margin>, <left_margin>, <left_margin>, <left_margin>
Dimensioni minime del margine intorno all'area del grafico, in pixel. Aumenta questo valore per includere una spaziatura interna in modo da evitare che le etichette dell'asse tocchino i bordi del grafico.
<opt_legend_width>, <opt_legend_height>
[Facoltativo] Larghezza del margine intorno alla legenda, in pixel. Utilizzalo per evitare che la legenda si trovi in corrispondenza dell'area del grafico o dei bordi dell'immagine.

 

Esempi

Descrizione Esempio

In questo esempio, il grafico ha un margine minimo di 30 pixel su ogni lato. Poiché la legenda del grafico ha una larghezza superiore a 30 pixel, il margine sul lato destro è impostato sulla stessa larghezza della legenda del grafico e differisce dagli altri margini.

Le etichette dell'asse si trovano al di fuori dell'area del grafico e sono pertanto tracciate all'interno dello spazio a margine.

Grafico a linee con sfondo grigio e margini su ogni lato.
chma=30,30,30,30

Per aggiungere un margine intorno alla legenda, imposta un valore per i parametri <opt_legend_width> e <opt_legend_height>.

In questo esempio, la legenda ha una larghezza di circa 60 pixel. Se imposti <opt_legend_width> su 80 pixel, il margine si estende a 20 pixel al di fuori della legenda.

Grafico a linee con sfondo grigio e margini su ogni lato.
chma=20,20,20,30|80,20

Torna all'inizio

Riempimento sfondo chf [Tutti i grafici]

Puoi specificare i colori e gli stili di riempimento per l'area dei dati del grafico e/o per l'intero sfondo del grafico. I tipi di riempimento includono riempimenti a tinta unita, riempimenti a strisce e gradienti. Puoi specificare riempimenti diversi per aree diverse (ad esempio, l'intera area del grafico o solo l'area dei dati). Il riempimento dell'area del grafico sovrascrive il riempimento dello sfondo. Tutti i riempimenti vengono specificati utilizzando il parametro chf e puoi mescolare diversi tipi di riempimento (solidi, strisce, gradienti) nello stesso grafico separando i valori con una barra verticale ( | ). I riempimenti delle aree del grafico sovrascriveranno i riempimenti dello sfondo del grafico.

Riempimento continuo chf [Tutti i grafici]

Puoi specificare un riempimento in tinta unita per l'area dello sfondo e/o del grafico oppure assegnare un valore di trasparenza all'intero grafico. Puoi specificare più riempimenti utilizzando il carattere barra verticale (|). (Maps: solo sfondo).

Sintassi

chf=<fill_type>,s,<color>|...
<fill_type>
La parte del grafico che viene riempita. Specifica uno dei seguenti valori:
  • bg - Riempimento sfondo
  • c: riempimento dell'area del grafico. Non supportato per i grafici a mappa.
  • a: rendi l'intero grafico (sfondi inclusi) trasparente. Le prime sei cifre di <color> vengono ignorate e solo le ultime due (il valore di trasparenza) vengono applicate all'intero grafico e a tutti i riempimenti.
  • b<index>: riempimenti solidi a barre (solo grafici a barre). Sostituisci <index> con l'indice della serie delle barre da riempire con un colore a tinta unita. L'effetto è simile a specificare chco in un grafico a barre. Per un esempio, consulta Colori delle serie con grafico a barre.
s
Indica un riempimento in tinta unita o con trasparenza.
<color>
Il colore di riempimento, in formato esadecimale RRGGBB. Per le lucidi, le prime sei cifre vengono ignorate, ma devono essere comunque incluse.

 

Esempi

Descrizione Esempio

Questo esempio riempie lo sfondo del grafico con il grigio chiaro (EFEFEF).

Grafico a linee rosse con riempimento dell&#39;area nera.

chf=bg,s,EFEFEF

Questo esempio riempie lo sfondo del grafico con il grigio chiaro (EFEFEF) e riempie l'area del grafico in nero (000000).

Grafico a linee rosse con area grafico nera e sfondo grigio chiaro.

chf=c,s,000000|
bg,s,EFEFEF
Questo esempio applica una trasparenza del 50% all'intero grafico (80 in esadecimale corrisponde a 128, ovvero circa il 50% di trasparenza). Nota che lo sfondo della cella della tabella viene mostrato attraverso il grafico.

Grafico a dispersione con punti in blu e trasparenza al 50%.

chf=a,s,00000080

Torna all'inizio

Formato colore

Specifica i colori utilizzando una stringa di 6 caratteri di valori esadecimali, oltre a due valori di trasparenza facoltativi, nel formato RRGGBB[AA]. Ad esempio:

  • FF0000 = rosso
  • 00FF00 = verde
  • 0000FF = blu
  • 000000 = nero
  • FFFFFF = bianco

AA è un valore di trasparenza facoltativo, dove 00 è completamente trasparente e FF è completamente opaco. Ad esempio:

  • 0000FFFF = blu fisso
  • 0000FF66 = blu trasparente

Torna all'inizio