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 Tables.

Indice

Funzionalità specifiche per i grafici

  1. Panoramica
  2. Codici di stato degli Stati Uniti

Funzionalità standard

  1. Titolo grafico (chtt, chts)
  2. Margini del grafico (chma)
  3. Riempimenti dello sfondo
    1. Riempimento continuo (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. Specificherai anche un elenco di regioni da colorare 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. Se vuoi, puoi specificare un gradiente di colore personalizzato per i valori dei dati.

I grafici a mappa supportano i seguenti parametri:

Parametro Obbligatorio o facoltativo Descrizione
cht=t Obbligatorio Specifica un grafico della mappa.
chs Obbligatorio Dimensioni mappa. Le dimensioni massime per una mappa sono 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 stai applicando valori.

Esempio: chld=DZEGMG
chd=<country_values> Obbligatorio

Un elenco di valori paralleli all'elenco delle regioni, in cui il valore si applica alla regione corrispondente. I valori sono valori di dati formattati standard. A ogni regione verrà assegnato un colore lungo la scala specificata in chco, in cui il valore più basso nell'intervallo si applica al colore più basso e 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

Una gamma di colori che corrisponde ai valori dei dati bassi e alti per l'intervallo di 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 stati assegnati dati. Il valore predefinito è BEBEBE (grigio medio). Un numero esadecimale nel 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 nel 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 nel formato RRGGBB.
chtt, chts Facoltativo Titolo e stile del grafico
chma Facoltativo Margini del grafico
chf=bg Facoltativo Riempimento continuo (solo sfondo)

 

Esempi

Descrizione Esempio

In questo esempio:

  • L'area zoom del grafico è Africa (chtm=africa).
  • Ai tre paesi verranno assegnati dei valori: Algeria, Egitto e Madagascar (chld=DZEGMG)
  • I tre valori assegnati a questi paesi sono 0, 100 e 50 rispettivamente (chd=t:0,100,50), che rappresentano il valore minimo, massimo e medio per i dati in formato di testo.
  • L'intervallo 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 dello 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 è 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 con lo zoom 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 TN 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 funzioni in questa pagina sono funzioni dei grafici standard.

Titolo del grafico chtt, chts [Tutti i grafici]

Puoi specificare il testo del titolo, il colore e la dimensione del carattere per il tuo grafico.

Sintassi

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

 

chtt: specifica il titolo del grafico.

<chart_title>
Titolo da visualizzare per il grafico. Non puoi specificare dove viene visualizzata, ma puoi facoltativamente specificare la dimensione e il colore del carattere. Utilizza il 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, nel formato esadecimale RRGGBB. Il colore predefinito è il nero.
<font_size>
La 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" (centro) "r" (destra). Il valore predefinito è "c".

 

Esempi

Descrizione Esempio

Un grafico con un titolo, che utilizza colore 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 titolo di 20 punti blu 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 specificata del grafico (chs). L'aumento della dimensione dei margini non aumenta la dimensione totale del grafico, ma restringe l'area del grafico, se necessario.

Per impostazione predefinita, i margini corrispondono a quanto rimane dopo il calcolo delle dimensioni del grafico. Questo valore predefinito varia in base al tipo di grafico. I margini specificati rappresentano un valore minimo; se l'area del grafico lascia spazio ai margini, la dimensione del margine sarà quella rimasta; non puoi ridurre i margini al di sotto di quanto richiesto per le legende e le etichette. Ecco un diagramma che mostra le parti di base di un grafico:

Margine del grafico, area della legenda e area del grafico

I margini del grafico includono le etichette dell'asse e l'area della leggenda. 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 e l'area del grafico verrà ridotta. 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), la larghezza dell'area del grafico non può essere ridotta. 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>, <right_margin>, <top_margin>, <bottom_margin>
Dimensione minima del margine intorno all'area del grafico, in pixel. Aumenta questo valore in modo da includere una spaziatura interna per evitare che le etichette dell'asse vadano contro i bordi del grafico.
<opt_legend_width>, <opt_legend_height>
[Facoltativo] Larghezza del margine intorno alla legenda, in pixel. Utilizza questa opzione per evitare che la legenda vada contro l'area del grafico o i 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 è larga più di 30 pixel, il margine sul lato destro è impostato sulla larghezza della legenda del grafico ed è diverso dagli altri margini.

Le etichette dell'asse sono esterne all'area del grafico e, pertanto, vengono disegnate all'interno dello spazio del 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 è larga circa 60 pixel. Se imposti <opt_legend_width> su 80 pixel, il margine si estende a 20 pixel all'esterno della legenda.

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

Torna all'inizio

Riempimento dello sfondo chf [Tutti i grafici]

Puoi specificare i colori e gli stili di riempimento per l'area dei dati del grafico e/o 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 dell'area del grafico sovrascrivono i riempimenti dello sfondo del grafico.

Riempimento continuo chf [Tutti i grafici]

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

Sintassi

chf=<fill_type>,s,<color>|...
<fill_type>
La parte del grafico compilata. Specifica uno dei seguenti valori:
  • bg - Riempimento sfondo
  • c: riempimento dell'area del grafico. Non supportato per i grafici a mappa.
  • a: rendi trasparente l'intero grafico (inclusi gli sfondi). 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 per riempire con un colore a tinta unita. L'effetto è simile alla specifica chco in un grafico a barre. Per un esempio, consulta Colori delle serie dei grafici a barre.
s
Indica un riempimento in tinta unita o trasparente.
<color>
Il colore di riempimento, nel formato esadecimale RRGGBB. Per le trasparenze, le prime sei cifre vengono ignorate, ma devono essere comunque incluse.

 

Esempi

Descrizione Esempio

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

Grafico a linee rosse con riempimento nero.

chf=bg,s,EFEFEF

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

Grafico a linee rosse con area 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 o una trasparenza del 50% circa). Osserva lo sfondo delle celle della tabella, mostrato attraverso il grafico.

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

chf=a,s,00000080

Torna all'inizio

Formato colore

Specifica i colori utilizzando una stringa di sei caratteri di valori esadecimali, più 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 fissa
  • 0000FF66 = Blu trasparente

Torna all'inizio