My favorites | Português | Sign in

Guia do desenvolvedor

A API do Google Chart permite gerar gráficos dinamicamente. Para ver a API do Google Chart funcionando, abra uma janela do navegador e copie o URL abaixo:

http://chart.apis.google.com/chart?cht=p3&chd=t:60,40&chs=250x100&chl=Hello|World

Pressione a tecla Enter ou Return e pronto! Você deve ver a página abaixo:

Gráfico amarelo de setores

Sumário

  1. Público
  2. Política de uso
  3. Introdução
  4. Formato de URL
  5. Parâmetros obrigatórios e opcionais
  6. Tamanho do gráfico
  7. Dados do gráfico
    1. Codificação de texto
    2. Codificação de texto com dimensionamento de dados
    3. Codificação simples
    4. Codificação estendida
    5. Como codificar dados com JavaScript
    6. Diretrizes para granularidade
  8. Tipo de gráfico
    1. Gráficos de linha
    2. Sparklines
    3. Gráficos de barras
    4. Gráficos de setores
    5. Diagramas de Venn
    6. Diagramas de dispersão
    7. Gráficos de radar
    8. Mapas
    9. Google-o-meter
    10. Códigos QR Novo!
  1. Cores
    1. Cores dos gráficos
    2. Preenchimento sólido
    3. Gradiente linear
    4. Faixas lineares
    5. Área de preenchimento
  2. Rótulos
    1. Título do gráfico
    2. Legenda do gráfico Ampliado!
    3. Rótulos de gráficos de setores e Google-o-meters
    4. Rótulos de diversos eixos
  3. Estilos
    1. Largura e espaçamento das barras
    2. Linha zero do gráfico de barras
    3. Estilos de linha
    4. Linhas de grade
    5. Marcadores de forma e intervalo
  4. Mapeamento de caracteres
    1. Valores de caracteres de codificação simples
    2. Valores de caracteres de codificação estendida
  5. Códigos de estados dos EUA
  6. Códigos de país ISO 3166

Voltar ao início

Público

Este documento é destinado aos programadores que desejam incluir imagens da API do Google Chart em uma página da web. Ele fornece uma introdução ao uso da API e material de referência sobre os parâmetros disponíveis.

Política de uso

Não há um limite para o número de chamadas à API do Google Chart que podem ser feitas por dia. Entretanto, nos reservamos o direito de bloquear qualquer uso que considerarmos abusivo, como por exemplo uma tentativa aparente de recusa do serviço. Se você achar que seu serviço fará mais de 250.000 chamadas à API por dia, envie uma estimativa para nós no endereço chart-api-notifications@google.com.

Introdução

A API do Google Chart retorna uma imagem em formato PNG em resposta a um URL. É possível gerar diversos tipos de imagens, incluindo gráficos de linha, de barras e de setores. Você pode especificar atributos como tamanho, cores e rótulos para cada tipo de imagem.

Para incluir uma imagem da API do Google Chart em uma página da web, coloque um URL dentro de uma tag <img>. Quando a página for exibida em um navegador, a API do Google Chart gerará a imagem dentro da página.

Todas as imagens deste documento foram geradas com a API do Google Chart. Para exibir o URL de uma imagem:

  • Se estiver usando o Firefox, clique com o botão direito do mouse e selecione View image ou Properties.
  • Se estiver usando o Internet Explorer, clique com o botão direito do mouse e selecione Properties.

Este documento descreve o formato necessário dos URLs da API do Google Chart e os parâmetros disponíveis.

Voltar ao início

Formato de URL

Os URLs da API do Google Chart devem estar no formato abaixo:

http://chart.apis.google.com/chart?<parameter 1>&<parameter 2>&<parameter n>

Observação: Cada URL deve estar completo em uma linha.

Os parâmetros são separados por um caractere de E comercial (&). Você pode especificar quantos parâmetros quiser, em qualquer ordem. Por exemplo, a API do Google Chart retorna o gráfico a seguir em resposta ao URL abaixo:

Gráfico amarelo de setores

http://chart.apis.google.com/chart?
chs=250x100
&chd=t:60,40
&cht=p3
&chl=Hello|World

Onde:

  • http://chart.apis.google.com/chart? é a localização da API do Google Chart.
  • & separa os parâmetros.
  • chs=250x100 é o tamanho do gráfico em pixels.
  • chd=t:60,40 são os dados do gráfico.
  • cht=p3 é o tipo de gráfico.
  • chl=Hello|World é o rótulo do gráfico.

Para incluir uma imagem da API do Google Chart em um documento HTML, coloque um URL dentro de uma tag <img>. Por exemplo, a tag <img> a seguir resulta na mesma imagem acima:

<img src="http://chart.apis.google.com/chart?
chs=250x100
&amp;chd=t:60,40
&amp;cht=p3
&amp;chl=Hello|World
"
alt="Sample chart" />

Observação: Ao incorporar um URL em uma tag HTML <img>, tenha cuidado ao usar a referência de entidade de caractere &amp; no lugar de um E comercial (&).

Voltar ao início

Parâmetros obrigatórios e opcionais

É necessário fornecer pelo menos os parâmetros abaixo:

Todos os outros parâmetros são opcionais. Os parâmetros opcionais por tipo de gráfico são listados na tabela abaixo. Observe que os Códigos QR foram omitidos, já que não têm parâmetros opcionais.

Parâmetro Gráfico de barras Gráfico de linhas e sparklines Gráfico de radar Diagrama de dispersão Diagrama de Venn Gráfico de setores Google-
o-meter
Mapas
Cores dos gráficos Sim Sim Sim Sim Sim Sim Sim Sim
Preenchimento sólido Sim Sim Sim Sim Sim Sim Apenas plano de fundo Apenas plano de fundo
Dimensionamento de dados Sim Sim Sim Sim Sim Sim Sim  
Gradiente linear Sim Sim Sim Sim Sim Apenas plano de fundo    
Faixas lineares Sim Sim Sim Sim Sim Apenas plano de fundo    
Título do gráfico Sim Sim Sim Sim Sim Sim    
Legenda do gráfico Sim Sim Sim Sim Sim      
Rótulos de diversos eixos Sim Sim Sim Sim        
Linhas de grade Sim Sim Sim Sim        
Marcadores de forma Sim Sim Sim Sim        
Marcadores de intervalo horizontal Sim Sim Sim Sim        
Marcadores de intervalo vertical Sim Sim Sim Sim        
Estilos de linha Sim Sim Sim          
Área de preenchimento Sim Sim Sim          
Largura e espaçamento das barras Sim              
Linha zero do gráfico de barras Sim              
Rótulos de gráficos de setores e Google-o-meters           Sim Sim  

Voltar ao início

Tamanho do gráfico

Especifique o tamanho do gráfico com chs=<width in pixels>x<height in pixels>

Por exemplo, chs=300x200 gera um gráfico de 300 pixels de largura por 200 pixels de altura.

A maior área possível para todos os gráficos, exceto os mapas, é 300.000 pixels. Como a altura ou largura máxima é 1.000 pixels, alguns exemplos de tamanho máximo são 1000x300, 300x1000, 600x500, 500x600, 800x375 e 375x800.

No caso dos mapas, o tamanho máximo é 440 pixels de largura por 220 pixels de altura.

Se o tamanho especificado for pequeno demais, o gráfico de setores é cortado (fica apenas parcialmente visível). As diretrizes gerais de tamanho de gráficos de setores são:

  • um gráfico bidimensional precisa ter largura aproximadamente duas vezes maior que a altura;
  • um gráfico tridimensional precisa ter largura aproximadamente duas vezes e meia maior que a altura.

Voltar ao início

Dados do gráfico

Antes de criar um gráfico, é necessário codificar os dados em um formato compreendido pela API do Google Chart. Use um dos formatos abaixo:

  • A codificação de texto usa uma string de números positivos com ponto flutuante de zero a cem.
    A codificação de texto com dimensionamento de dados usa uma string de qualquer número positivo ou negativo com ponto flutuante em conjunto com um parâmetro de dimensionamento. Esse recurso não está disponível para mapas.
    Considerando cinco pixels por ponto de dados, os inteiros (1,0, 2,0 e assim por diante) são suficientes para gráficos de linha e barras de até 500 pixels. Caso uma resolução mais alta seja necessária, inclua uma única casa decimal (por exemplo, 35,7). A codificação de texto é adequada para todos os tipos de gráficos, não importando o tamanho. Esse tipo de codificação geralmente resulta nos URLs mais longos para um determinado conjunto de dados.
  • A codificação simples utiliza os caracteres alfanuméricos (A a Z, a a z e 0 a 9), onde A representa 0, B representa 1 e assim por diante até 9, representando 61 para fornecer uma resolução de 62 valores diferentes.
    Considerando cinco pixels por ponto de dados, isto é suficiente para gráficos de linha e barras de até 300 pixels. Esse tipo de codificação geralmente resulta nos URLs mais curtos para um determinado conjunto de dados.
  • A codificação estendida utiliza pares de caracteres alfanuméricos (além de alguns outros que serão discutidos mais tarde), onde AA representa 0, AB representa 1 e assim por diante, até dois pontos (..) representando 4095, para fornecer uma resolução de 4.096 valores diferentes.
    A codificação estendida é a alternativa mais adequada para grandes gráficos com um intervalo de dados grande. Esse tipo de codificação resulta em um URL com duas vezes o tamanho da codificação simples para um determinado conjunto de dados.

Observação: Para a codificação simples e estendida, você provavelmente codificará seus dados de maneira programática. Consulte o código JavaScript para codificação de dados para obter um ponto de partida. Além disso, diversos membros do grupo do Google Chart contribuíram com bibliotecas de API. Pesquise no grupo ou visite a postagem Links úteis para bibliotecas de API.

Voltar ao início

Codificação de texto

Especifique a codificação de texto com

chd=t:<chart data string>

Onde <chart data string> consiste em números positivos com ponto flutuante de zero (0.0) a cem (100.0), menos um (-1) e o caractere de barra vertical (|) como separador.

Observação:

  • Você pode especificar um valor ausente com menos um (-1).
  • Se tiver mais de um conjunto de dados, separe-os usando um caractere de barra vertical (|).

Por exemplo: chd=t:10.0,58.0,95.0|30.0,8.0,63.0

Observação: Para a codificação de texto, dimensione os dados convertendo-os em porcentagens do maior valor do conjunto de dados.

Voltar ao início

Codificação de texto com dimensionamento de dados

Especifique a codificação de texto com dimensionamento de dados usando dois parâmetros

chd=t:<chart data string>
chds=<data set 1 minimum value>,<data set 1 maximum value>,<data set n minimum value>,<data set n maximum value>

Onde:

  • <chart data string> consiste em qualquer número positivo ou negativo com ponto flutuante
  • <data set 1 minimum value> é o menor numero aplicável ao primeiro conjunto de dados
  • <data set 1 maximum value> é o maior número aplicável ao primeiro conjunto de dados; omita para especificar 100
  • <data set n minimum value> é o menor numero aplicável ao enésimo conjunto de dados
  • <data set n maximum value> é o maior número aplicável ao enésimo conjunto de dados; omita para especificar 100

Se você fornecer uma quantidade menor de parâmetros de dimensionamento de dados que os conjuntos de dados, o parâmetro de dimensionamento é aplicado aos conjuntos de dados restantes. Forneça apenas um par de parâmetros de dimensionamento para aplicar um único intervalo a um gráfico.

Observação:

  • Esse recurso não está disponível para mapas.
  • Você pode especificar um valor ausente com um número fora do intervalo.
  • Se tiver mais de um conjunto de dados, separe-os usando um caractere de barra vertical (|).

Por exemplo: chd=t:30,-60,50,120,80&chds=-80,140

Voltar ao início

Codificação simples

Especifique a codificação simples com

chd=s:<chart data string>

Onde <chart data string> contém os caracteres: A a Z, a a z, 0 a 9, sublinhado (_) e vírgula (,) como separador.

Observação:

  • As maiúsculas são A = 0, B = 1 e assim por diante até Z = 25.
  • As minúsculas são a = 26, b = 27 e assim por diante até z = 51.
  • Zero (0) = 52 e assim por diante até 9 = 61.
  • Você pode especificar um valor ausente com um sublinhado (_).
  • Se você tiver mais de um conjunto de dados, separe-os usando vírgulas (,).

Por exemplo, dois conjuntos de dados: chd=s:ATb19,Mn5tz, onde, no primeiro conjunto de dados, A representa 0, T representa 19, b representa 27, 1 representa 53 e 9 representa 61.

Observação: Consulte Valores de caracteres de codificação simples para obter uma lista completa.

Voltar ao início

Codificação estendida

Especifique a codificação estendida com

chd=e:<chart data string>

Onde <chart data string> contém pares dos caracteres: A a Z, a a z, 0 a 9, hífen (-), ponto (.), sublinhado (_) e vírgula (,) como separador.

Observação:

  • AA = 0, AZ = 25, Aa = 26, Az = 51, A0 = 52, A9 = 61, A- = 62, A. = 63
    BA = 64, BZ = 89, Ba = 90, Bz = 115, B0 = 116, B9 = 125, B- = 126, B. = 127
    .A = 4032, .Z = 4057, .a = 4058, .z = 4083, .0 = 4084, .9 = 4093, .- = 4094, .. = 4095.
  • Você pode especificar um valor ausente com dois caracteres de sublinhado (__).
  • Se você tiver mais de um conjunto de dados, separe-os usando vírgulas (,).

Observação: Consulte Valores de caracteres de codificação estendida para obter instruções sobre como gerar uma lista completa.

Voltar ao início

Como codificar dados com JavaScript

Talvez seja mais fácil traduzir dados reais em dados da API do Google Chart de forma programática em vez de manualmente.

O código JavaScript a seguir converte um conjunto de dados em Codificação simples. Os dados devem ser fornecidos como uma matriz de números positivos. Um valor de conjunto de dados que não seja um número positivo será codificado como valor ausente, com o caractere de sublinhado (_).

var simpleEncoding = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
 
function simpleEncode(valueArray,maxValue) {

var chartData = ['s:'];
  for (var i = 0; i < valueArray.length; i++) {
    var currentValue = valueArray[i];
    if (!isNaN(currentValue) && currentValue >= 0) {
    chartData.push(simpleEncoding.charAt(Math.round((simpleEncoding.length-1) * currentValue / maxValue)));
    }
      else {
      chartData.push('_');
      }
  }
return chartData.join('');
}

Chame a função simpleEncode passando a matriz (valueArray) e o valor máximo (maxValue) dentro desta matriz. No exemplo a seguir, maxValue é definido como maior que o número mais alto da matriz, para criar algum espaço entre o valor mais alto e o alto do gráfico:

var valueArray = new Array(0,1,4,4,6,11,14,17,23,28,33,36,43,59,65);
var maxValue = 70; 
simpleEncode(valueArray,maxValue);

Voltar ao início

Diretrizes para granularidade

Tenha cuidado para não superestimar o número de pontos de dados necessários para um gráfico. Por exemplo, para mostrar a popularidade de Britney Spears durante os últimos dez anos, agregar consultas de pesquisa para cada dia resultará em mais de 3.600 valores. Isto resultaria em um excesso de dados a serem passados em um URL. Além disso, não faria sentido gerar um gráfico com esta granularidade: em uma tela com largura de 1.024 pixels, um ponto de dados seria cerca de um quarto de pixel na tela. Os exemplos a seguir ilustram este ponto.

Gráfico de 200 por 100 com 20 pontos de dados (10 pixels por ponto de dados):

Gráfico de linha amarela: fácil leitura, pois os pontos de dados estão bem distribuídos ao longo do eixo x

40 pontos de dados (5 pixels por ponto de dados):

Gráfico de linha amarela: leitura menos fácil, pois os pontos de dados estão menos distribuídos ao longo do eixo x

80 pontos de dados (somente 2,5 pixels por ponto de dados):

Gráfico de linha amarela: difícil leitura, pois os pontos de dados estão muito comprimidos ao longo do eixo x

Voltar ao início

Tipo de gráfico

Estão disponíveis os tipos de gráficos abaixo:

Gráficos de linha

Especifique um gráfico de linhas com

cht=<line chart type>

Onde <line chart type> é lc ou lxy, conforme descrito na tabela a seguir.

  • Para gráficos do tipo lc, são desenhadas diversas linhas para diversos conjuntos de dados.
  • Para gráficos do tipo lxy, um par de conjuntos de dados é necessário para cada linha.
  • Para obter informações sobre como especificar diversos conjuntos de dados, consulte Dados do gráfico.
  • Para obter informações sobre os parâmetros disponíveis, consulte Parâmetros opcionais por tipo de gráfico.
Parâmetro Descrição Exemplo

cht=lc

Um gráfico de linhas, com pontos de dados distribuídos de maneira uniforme ao longo do eixo x.

Gráfico com linha amarela
cht=lc

cht=lxy

Forneça um par de conjunto de dados para cada linha que deseja desenhar. O primeiro conjunto de dados de cada par especifica as coordenadas do eixo x, o segundo, as coordenadas do eixo y. Se você fornecer um número ímpar de conjuntos de dados, o último conjunto será ignorado.

Forneça um único valor indefinido para distribuir os pontos de dados de maneira uniforme ao longo do eixo x. O gráfico do exemplo utiliza Codificação de texto, portanto o valor indefinido é representado por -1. Para os valores indefinidos ou ausentes, a Codificação simples utiliza um caractere de sublinhado (_) e a Codificação estendida, dois caracteres de sublinhado (__).

Especifique marcadores de forma do ponto de dados com o parâmetro chm, conforme descrito na seção Marcadores de forma.

Especifique as cores das linhas como descrito em Cores.

Gráfico de linhas com pontos de dados distribuídos irregularmente e linhas em vermelho, verde e azul tracejado
cht=lxy
chd=t:0,30,60,70,90,95,100|
20,30,40,50,60,70,80|
10,30,40,45,52|
100,90,40,20,10|
-1|
5,33,50,55,7

Sparklines

Especifique uma sparkline com

cht=ls

Um gráfico de sparkline possui exatamente os mesmos parâmetros de um gráfico de linhas. A única diferença é que, por padrão, as linhas dos eixos não são desenhadas para os gráficos de sparkline. Você pode adicionar rótulos nos eixos. Se desejar, consulte Rótulos de diversos eixos para obter mais informações.

Sparkline

Voltar ao início

Gráficos de barras

Especifique um gráfico de barras com

cht=<bar chart type>

Onde <bar chart type> é bhs, bhg, bvs ou bvg, conforme descrito na tabela a seguir.

  • Dependendo do tipo de gráfico de barras, diversos conjuntos de dados são desenhados em barras empilhadas ou agrupadas.
  • Para obter informações sobre como especificar diversos conjuntos de dados, consulte Dados do gráfico.
  • Para obter informações sobre os parâmetros disponíveis, consulte Parâmetros opcionais por tipo de gráfico.
Parâmetro Descrição Exemplo

cht=bhs
cht=bvs

Gráficos de barras horizontais e verticais, respectivamente.

O primeiro exemplo (todas as barras em azul escuro) tem um único conjunto de dados.

O segundo exemplo (barras em azul escuro e claro) tem dois conjuntos de dados.

Os diversos conjuntos de dados são empilhados. Portanto, você deve especificar uma cor para cada conjunto de dados. Você também pode especificar uma cor para cada ponto de dados dentro de um único conjunto de dados. Consulte Cores para obter detalhes.

O segundo exemplo não usa dimensionamento de dados. Portanto, os pontos de dados com valor combinado acima de 100 estão fora da escala.

O terceiro exemplo usa dimensionamento de dados, portanto as barras estão dimensionadas corretamente.

Gráfico de barras horizontais com dois conjuntos de dados: ambos estão em azul
cht=bhs
chco=4d89f9

Gráfico de barras verticais com dois conjuntos de dados: um dos conjuntos tem cor azul escuro e o segundo está empilhado em azul claro
cht=bvs
chco=4d89f9,c6d9fd
chd=t:10,50,60,80,40|
50,60,100,40,20

Gráfico de barras verticais com dois conjuntos de dados: um dos conjuntos tem cor azul escuro e o segundo está empilhado em azul clarocht=bvs
chco=4d89f9,c6d9fd
chd=t:10,50,60,80,40|
50,60,100,40,20
chds=0,160

cht=bhg
cht=bvg

Gráficos de barras horizontais e verticais, respectivamente, nas cores especificadas. Os diversos conjuntos de dados estão agrupados.

Gráfico de barras horizontais com dois conjuntos de dados: um dos conjuntos tem cor azul escuro e o segundo está adjacente, em azul claro
cht=bhg
chco=4d89f9,c6d9fd

Gráfico de barras verticais com dois conjuntos de dados: um dos conjuntos tem cor azul escuro e o segundo está adjacente, em azul claro
cht=bvg
chco=4d89f9,c6d9fd

chbh

O tamanho do gráfico de barras é tratado de maneira diferente dos outros tipos de gráfico.

Nos gráficos de barras horizontais dos tipos bhs e bhg e nos gráficos de barras verticais dos tipos bvs e bvg, o tamanho do gráfico é determinado pelo parâmetro chs. Se o tamanho especificado (por chs) é pequeno demais, o gráfico é cortado (fica apenas parcialmente visível).

Devido a isso, especifique a largura e o espaçamento das barras com
chbh=
<bar width in pixels>,
<optional space between bars in a group>,
<optional space between groups>

Observação: Se o terceiro parâmetro (espaço entre as barras) não for fornecido, o padrão será a metade do valor do espaço entre os grupos.

Gráfico de barras horizontais em amarelo, as barras têm a largura padrão
chbh omitida
cht=bhs

Gráfico de barras horizontais em azul, as barras têm dez pixels de largura
chbh=10
cht=bhs

Voltar ao início

Gráficos de setores

Especifique um gráfico de setores com

cht=<pie chart type>

Onde <pie chart type> é p ou p3, conforme descrito na tabela a seguir.

Observação: A API do Google Chart calcula o raio do círculo a partir da largura e altura mínimas especificadas no parâmetro de tamanho do gráfico (chs). Se o tamanho especificado é pequeno demais, o gráfico é cortado. Se você for incluir rótulos, será necessário especificar a largura para duas vezes a altura.

Parâmetro Descrição Exemplo

cht=p

Gráfico de setores bidimensional.

A menos que seja especificado de outra maneira, as cores dos segmentos de setores são interpoladas desde o laranja escuro até o amarelo claro. Especifique as outras cores como descrito em Cores.

Especifique os rótulos usando chl, conforme descrito em Rótulos de gráficos de setores.

Gráfico de setores bidimensional com quatro segmentos, onde as cores dos segmentos são interpoladas desde o laranja escuro até o claro.

cht=p
chs=200x100

cht=p3

Gráfico de setores tridimensional.

Especifique os rótulos usando chl, conforme descrito em Rótulos de gráficos de setores.

Gráfico de setores tridimensional com quatro segmentos, onde as cores dos segmentos são interpoladas desde o laranja escuro até o claro.

cht=p3
chs=250x100

Voltar ao início

Diagramas de Venn

Especifique um diagrama de Venn com

cht=v

Forneça um conjunto de dados no qual:

  • os primeiros três valores especificam os tamanhos relativos de três círculos, A, B e C
  • o quarto valor especifica a área de interseção entre A e B
  • o quinto valor especifica a área de interseção entre A e C
  • o sexto valor especifica a área de interseção entre B e C
  • o sétimo valor especifica a área de interseção entre A, B e C
Parâmetro Descrição Exemplo

cht=v

Neste exemplo, o primeiro círculo é especificado com 100, o segundo com 80 e o terceiro com 60. A interseção de todos os círculos é especificada com 30.

Para obter informações sobre os parâmetros disponíveis para diagramas de Venn, consulte Parâmetros opcionais por tipo de gráfico.

Diagrama de Venn com interseção de três círculos
cht=v
chd=t:100,80,60,30,30,30,10

Voltar ao início

Diagramas de dispersão

Especifique um diagrama de dispersão com

cht=s

  • Diagramas de dispersão usam diversos conjuntos de dados de forma diferente dos outros tipos de gráficos. Você pode mostrar apenas um conjunto de dados em um diagrama de dispersão. Embora use três conjuntos de dados para especificar a posição x, posição y e, opcionalmente, o tamanho, de cada ponto. Para obter informações sobre como especificar diversos conjuntos de dados, consulte Dados do gráfico.
  • Para obter informações sobre os parâmetros disponíveis, consulte Parâmetros opcionais por tipo de gráfico.
Parâmetro Descrição Exemplo

cht=s

Forneça dois conjuntos de dados. O primeiro conjunto especifica as coordenadas de x, o segundo especifica as coordenadas de y.

O formato padrão dos pontos de dados é um círculo. Especifique um formato diferente para o ponto de dados com o parâmetro chm, conforme descrito na seção Marcadores de forma.

A cor padrão do ponto de dados é azul. Especifique as outras cores como descrito em Cores.

No exemplo, os pontos de dados variam de tamanho. Para fazer isto, especifique um terceiro conjunto de dados. Qualquer tamanho especificado com o parâmetro chm determina o tamanho máximo para qualquer ponto de dados. O tamanho usado para desenhar cada ponto de dados é dimensionado com o terceiro conjunto de dados opcional. Portanto, por exemplo, se você usar chm para especificar um tamanho de 20 pixels e o valor mais alto possível do tipo de codificação sendo usada (9, 100.0 ou ..) no terceiro conjunto de dados, o resultado será um ponto de dados de 20 pixels.

Diagrama de dispersão com pontos de dados padrão circulares e azuis, em tamanhos diferentes definidos por um terceiro conjunto de dados
cht=s

Voltar ao início

Gráficos de radar

Especifique um gráfico de radar com

cht=r ou cht=rs

Para um gráfico do tipo r, os pontos são conectados por linhas retas.

Para um gráfico do tipo rs, os pontos são conectados por linhas raiadas para formar uma linha curva.

Parâmetro Descrição Exemplo

cht=r

Em um gráfico de radar, os pontos de dados são desenhados entre o centro do gráfico e o perímetro. Pontos de valor zero (0, A ou AA dependendo do tipo de codificação) são desenhados no centro, enquanto aqueles com o valor máximo da codificação usada (100, 9 ou ..) são desenhados no perímetro. Os valores intermediários são inseridos entre ambos.

Os pontos que representam o primeiro e o último valor do conjunto de dados são desenhados entre o centro e a parte superior do gráfico. Os pontos restantes são espaçados igualmente em sentido horário ao redor do gráfico e, nesse tipo de gráfico de radar, uma linha reta é desenhada entre cada par de pontos.

Este exemplo mostra um gráfico de radar simples, com um único conjunto de dados.

Gráfico de radar
cht=r
chd=t:10,20,30,40,50,60,70,80,90

Você pode adicionar outras informações em um gráfico de radar adicionando cores, estilos de linha e rótulos de eixos.

Este exemplo mostra um gráfico de radar mais complexo, com dois conjuntos de dados. A cor de cada conjunto de dados é especificada com chco, como descrito em Cores do gráfico.

Estilos de linha são especificados com chls, como descrito em Estilos de linha.

Finalmente, rótulos de eixos são especificados com chxt, chxl e chxr. Consulte Rótulos de diversos eixos para obter mais informações. Nos gráficos de radar, o eixo x é desenhado em um círculo, enquanto os eixos y e r vão do centro para a parte superior do gráfico. O eixo t é ignorado.

Observação: quando são incluídos rótulos, o espaçamento dos pontos de dados ao redor do gráfico é determinado pelo número de rótulos ou pelo número de pontos de dados menos um, o que for maior.

Gráfico de radar
chco=FF0000,FF9900
chls=2.0,4.0,0.0|2.0,4.0,0.0
chxt=x
chxl=0:|0|45|90|135|180|225|270|315
chxr=0,0.0,360.0

Este exemplo usa os mesmos parâmetros que o exemplo anterior, mas tem uma Área de preenchimento especificada para os dois conjuntos de dados.

Foi também adicionada uma grade. Para obter mais informações, consulte Linhas de grade.


Gráfico de radar
chg=25.0,25.0,4.0,4.0
chm=
B,FF000080,0,1.0,5.0|
B,FF990080,1,1.0,5.0

O exemplo final mostra o exemplo anterior com a adição de Marcadores de forma. Observe que o marcador de forma da linha horizontal (especificado com chm=h) produz um círculo em um gráfico de radar, enquanto que as linhas verticais (chm=v e chm=V) são desenhadas do centro do gráfico para o perímetro.

  • o círculo azul externo é especificado com chm=h,0000FF,...
  • o círculo azul interno parcialmente transparente é especificado com chm=h,3366CC80,...
  • a linha verde parcialmente transparente (entre 1 e 2 horas) é especificada com chm=V,00FF0080,...
  • a linha verde escura (às 8 horas) é especificada com chm=V,008000,...
  • a linha verde (às 10 horas) é especificada com chm=v,00A000,...

Para obter informações, consulte Marcadores de forma e Cores.

Você pode também especificar marcadores de intervalo. Consulte Marcadores de intervalo para obter mais informações.

Gráfico de radar
chm=
h,0000FF,0,1.0,4.0|
h,3366CC80,0,0.5,5.0|
V,00FF0080,0,1.0,5.0|
V,008000,0,5.5,5.0|
v,00A000,0,6.5,4

Voltar ao início

Mapas

Especifique um mapa com

cht=t e chtm=<geographical area>

Onde <geographical area> é uma das opções abaixo:

  • africa
  • asia
  • europe
  • middle_east
  • south_america
  • usa
  • world

Por exemplo:

Mapa do mundo
chs=440x220
chd=s:_
cht=t
chtm=world

Observação: A codificação de texto com dimensionamento de dados não está disponível para mapas. Em vez disso, use codificação de texto, codificação simples ou codificação estendida.

Este é o mapa-múndi padrão. O tamanho usado no exemplo (440 x 200 pixels) é o máximo disponível para todos os mapas. O conjunto de dados contém apenas um caractere, um sublinhado (_). Isso especifica um valor ausente em codificação simples e nos fornece o mapa mais simples possível. Você pode tornar seu mapa mais informativo e interessante que o exemplo acima, usando cores para um ou mais países do mapa.

Especifique as cores de um mapa e como são aplicadas a cada país ou estado dentro do mapa, combinando três parâmetros:

chco=<default color><colors for gradient>
chld=<list of codes for each country or state to be colored>
chd=<list of values for each country or state to be colored>

Onde:

  • <default color>, <colors for gradient> são números hexadecimais em formato RRGGBB. A cor padrão é aplicada aos países ou estados não listados no parâmetro chld. As outras cores especificam os extremos de um gradiente de cor usado para colorir todos os países listados no parâmetro chld. A cor aplicada depende do valor do país no parâmetro chd.
  • <list of codes for each country or state to be colored> é uma lista de:
  • <list of values for each country or state to be colored> são valores de codificação simples, de texto ou estendida. O primeiro valor é usado para o primeiro país listado no parâmetro chld, o segundo valor para o segundo e assim por diante. O menor valor de dados; A, 0 ou AA, dependendo do tipo de codificação usado, é desenhado na cor especificada por <color for start of gradient> em chco. O valor mais alto; 9, 100 ou .. é desenhado na cor especificada por <color for end of gradient>. Os valores intermediários recebem cores intermediárias.

Por exemplo:

Mapa da África
chtm=africa
chco=ffffff,edf0d4,13390a
chld=MGKETN
chd=s:Af9
chf=bg,s,EAF7FE

Neste exemplo:

  • a primeira cor (ffffff, que especifica o branco) é usada para qualquer país que não esteja listado no parâmetro chld
  • a segunda e a terceira cor especificam um gradiente que vai do verde claro (edf0d4) ao verde escuro (13390a)
  • os países coloridos são Madagascar (MG), Quênia (KE) e Tunísia (TN)
  • Madagascar tem valor A, o valor mínimo possível em codificação simples, e equivale a zero.
    Madagascar, portanto, é desenhado em verde claro (edf0d4)
  • Quênia tem valor f, que equivale a 31. Assim, o Quênia é desenhado em um tom intermediário entre verde claro e verde escuro.
  • A Tunísia tem valor 9, o valor máximo possível em codificação simples, e equivale a 61.
    Portanto, a Tunísia é desenhada em verde escuro (13390a)
  • as massas de água tem cor azul claro (EAF7FE), pois são consideradas o plano de fundo do mapa. Consulte o parâmetro chf descrito em Preenchimento da área e do plano de fundo do gráfico.

Aqui está um exemplo mais colorido:

Mapa dos EUA
chco=
f5f5f5,
edf0d4,
6c9642,
13390a

Aqui, a cor padrão é f5f5f5. O gradiente de cor é especificado com edf0d4, 6c9642 e 13390a. É mais fácil explicar como isso é aplicado usando a codificação de texto:

  • o valor zero é desenhado em verde bem claro (edf0d4)
  • o valor 50 é desenhado em verde médio (6c9642)
  • o valor 100 é desenhado em verde bem escuro (13390a)
  • um valor entre esses números é intercalado entre as cores mais próximas. Assim, por exemplo, o valor 75 está a meio caminho entre o verde médio (6c9642) e o verde bem escuro (13390a).

Voltar ao início

Google-o-meter

Especifique o Google-o-meter com

cht=gom

Para obter informações sobre os parâmetros disponíveis, consulte Parâmetros opcionais por tipo de gráfico.

Parâmetro Descrição Exemplo

cht=gom

Aqui está um exemplo de Google-o-meter usando as cores padrão (vermelho no sombreado da esquerda, passando pelo laranja e amarelo até o verde, à direita). Consulte a seção Cores do gráfico para obter mais informações sobre como especificar outras cores.

Consulte a seção Rótulos de gráficos de setores e Google-o-meters para obter mais informações sobre o texto que aparece no final da seta.

Google-o-meter com cores do vermelho até o verde padrão
cht=gom
chd=t:70

Voltar ao início

Códigos QR

Os códigos QR são um tipo popular de código de barras bidimensional, também conhecido como hardlinks ou hiperlinks do mundo físico. Códigos QR armazenam texto que podem ser um hiperlink, informação de contato, número de telefone e até mesmo versos inteiros de poemas!

Aos olhos humanos, os códigos QR parecem hieroglifos, mas eles podem ser lidos por qualquer dispositivo que tenha o software adequado instalado. Esses dispositivos podem ser desde leitores dedicados até telefones celulares. Portanto, uma pessoa com um dispositivo móvel adequado pode escanear um código QR, digamos em uma revista, e fazer com que o navegador do telefone abra o URL que está no código QR.

Especifique um código QR com

cht=qr
chl=<text to encode>
choe=<output encoding>

onde:

  • <text to encode> é texto do código QR. Ele deve ser ter URL codificado em UTF8. Observe que o espaço entre hello e world é escrito como %20 no exemplo a seguir.
  • <output encoding> especifica opcionalmente como a saída será codificada. Se não estiver especificado, o padrão de UTF-8 será usado. As opções disponíveis são: Shift_JIS, UTF-8 ou ISO-8859-1.

Por exemplo:
código QR
cht=qr
chl=hello%20world
choe=UTF-8

Com 21 linhas por 21 colunas, o exemplo de código QR acima é o mais simples possível e é conhecido como versão 1:

  • A versão 1 tem 21 linhas e colunas e pode codificar até 25 caracteres alfanuméricos
  • A versão 2 tem 25 linhas e colunas e pode codificar até 47 caracteres alfanuméricos
  • A versão 3 tem 29 linhas e colunas e pode codificar até 77 caracteres alfanuméricos
  • ...
  • A versão 40 tem 177 linhas e colunas e pode codificar até 4,296 caracteres alfanuméricos

A API do gráfico gera a versão do código QR apropriada dependendo do número de caracteres fornecidos. Por exemplo, se você fornecer 55 caracteres alfanuméricos, a API do gráfico gerará uma versão 3 do código QR. Isso será modificado de acordo com o nível de correção de erro (EC) que você optar por usar. Mais informações sobre níveis de EC na seção a seguir.

Observação: aqui, é fácil confundir o número de linha e colunas com o tamanho do código QR. O número de caracteres fornecido determina o número de linhas e colunas. O tamanho do gráfico em pixels é determinado com chs, como sempre (consulte Tamanho do gráfico).

Correção de erros e margens

Estão disponíveis quatro níveis de EC. O nível padrão (L) permite que o código QR seja lido se até 7% do código for confundido, estiver ausente ou obscuro. Outros níveis fornecem maiores níveis de EC. O número de caracteres que pode ser codificado diminui com o aumento do nível de EC. Consulte Versões, correção de erros e máximo de caracteres para obter detalhes.

A margem padrão é de 4 módulos. Isso significa que um espaço em branco equivalente a quatro linhas acima e abaixo e quatro colunas à esquerda e à direita são colocados ao redor do código QR. Esse é o mínimo exigido pelos leitores de QR.

Você pode também especificar um nível de EC e margem com

chld=<EC level>|<margin>

Onde:

  • <EC level> é uma das seguintes opções
    - L permite que 7% de um código QR seja restaurado
    - M permite que 15% de um código QR seja restaurado
    - Q permite que 25% de um código QR seja restaurado
    - H permite que 30% de um código QR seja restaurado
    (ou as minúsculas equivalentes l, m, q ou h).
  • <margin> define a margem (ou o espaço em branco) ao redor do código QR. A imagem padrão tem uma margem equivalente a 4 linhas / colunas do gráfico.

Versões, correção de erros e máximo de caracteres

Antes de gerar o código QR, considere o tipo de dispositivo a ser usado para a leitura do código. Os melhores leitores de código QR conseguem ler códigos versão 40, dispositivos móveis podem ler somente até a versão 4.

Recomendamos manter a versão 4, que equivale a cerca de 100 caracteres alfanuméricos no nível de EC padrão.

Consulte a tabela a seguir para obter informações sobre o máximo de caracteres para cada versão e nível de EC.

Versão Linhas por colunas Nível de EC Máximo de caracteres por nível de EC e tipo de caractere
Dígitos: 0 a 9 Alfanumérico:
0 a 9, A a Z,
espaço, $ % * + - . / :
Binário Kanji
1 21x21 L 41 25 17 10
M 34 20 14 8
Q 27 16 11 7
H 17 10 7 4
2 25x25 L 77 47 32 20
M 63 38 26 16
Q 48 29 20 12
H 34 20 14 8
3 29x29 L 127 77 53 32
M 101 61 42 26
Q 77 47 32 20
H 58 35 24 15
4 33x33 L 187 114 78 48
M 149 90 62 38
Q 111 67 46 28
H 82 50 34 21
10 57x57 L 652 395 271 167
M 513 311 213 131
Q 364 221 151 93
H 288 174 119 74
40 177x177 L 7,089 4,296 2,953 1,817
M 5,596 3,391 2,331 1,435
Q 3,993 2,420 1,663 1,024
H 3,057 1,852 1,273 784

Mais informações e padrões

Código QR é marca comercial da Denso Wave, inc. Como era de se esperar, o site da Denso Wave inclui muitas informações úteis sobre códigos QR.

O código QR foi aprovado como:

  • Padrão AIM International (Automatic Identification Manufacturers International) (ISS - código QR) em outubro de 1997.
  • Padrão JEIDA (Japanese Electronic Industry Development Association) (JEIDA-55) em março de 1998.
  • Padrão JIS (Japanese Industrial Standards) (JIS X 0510) em janeiro de 1999.
  • Padrão internacional ISO (ISO/IEC18004) em junho de 2000.

O software leitor de código QR está disponível em muitas fontes. O Google oferece uma biblioteca de leitores de código QR, Zebra Crossing (ZXing), gratuitamente. Consulte http://code.google.com/p/zxing/ para obter detalhes.

Consulte Conteúdo de código de barras para obter um guia básico de codificação padrão de informações em código de barras.

Voltar ao início

Cores

Especifique uma cor usando uma cadeia de valores hexadecimais com pelo menos 6 letras no formato RRGGBB. Por exemplo:

  • FF0000 = vermelho
  • 00FF00 = verde
  • 0000FF = azul
  • 000000 = preto
  • FFFFFF = branco

Como opção, você pode especificar a transparência, anexando um valor hexadecimal entre 00 e FF, onde 00 é completamente transparente e FF completamente opaco. Por exemplo:

  • 0000FFFF = azul sólido
  • 0000FF00 = transparent blue

Estão disponíveis as opções de cores abaixo:

Voltar ao início

Cores dos gráficos

Especifique as cores das linhas, barras, diagramas de Venn, Google-o-meters e segmentos de setores com

chco=
<color1>,
...
<colorn>

Onde <color1> e todos os valores subseqüentes de cores são números hexadecimais no formato RRGGBB.

Parâmetro Descrição Exemplo

chco

Este exemplo mostra três conjuntos de dados e três cores especificadas.

Gráfico de linhas com uma linha vermelha, uma linha azul e uma linha verde

chco=ff0000,00ff00,0000ff

Este exemplo também mostra três conjuntos de dados, mas apenas duas cores são especificadas. Devido a isto, as duas últimas linhas são desenhadas na última cor (vermelho ff0000).

Gráfico de linhas com duas linha vermelhas e uma linha azul

chco=ff0000,0000ff

Nos gráficos de barras, se o número de cores especificadas for menor que o número de conjuntos de dados, as cores serão alternadas. No gráfico abaixo, o terceiro conjunto de dados, Bar, é desenhado com a primeira cor. Se for especificada apenas uma cor, todos os conjuntos de dados serão desenhados com esta cor.

Gráfico de barras horizontais com um conjunto de dados em vermelho, um segundo em verde e o terceiro em vermelho

chco=ff0000,00ff00
chd=s:FOE,THE,Bar

Aqui está o mesmo gráfico com três cores especificadas.

Gráfico de barras horizontais com um conjunto de dados em vermelho, o segundo empilhado em verde e o terceiro em azul

chco=ff0000,00ff00,0000ff
chd=s:FOE,THE,Bar

Especifique uma cor para cada ponto de um único conjunto de dados separando parâmetros de cor chco com o caractere de barra vertical (|) .

Gráfico de barras horizontais com um ponto de dados em vermelho, o segundo em verde e o terceiro em azul

chco=ff0000|00ff00|0000ff
chd=s:elo

Nos gráficos de setores, se o número de cores especificadas for menor que o número de setores, as cores serão interpoladas.

Gráfico de setores tridimensional com segmentos interpolados do azul escuro para o claro

chco=0000ff

Nos diagramas de Venn, se o número de cores especificadas for menor que o número de círculos, a última cor especificada será repetida.

Diagrama de Venn com interseção de três círculos, um círculo é azul e os outros são verdes
chco=00ff00,0000ff

  Para Google-o-meters, especifique pelo menos duas cores. Use mais cores se desejar especificar o gradiente intermediário. Google-o-meter com cores do branco até o vermelho
chco=ffffff,ffaaaa,ff0000

Voltar ao início

Área de preenchimento

Especifique uma área de preenchimento com

chm=
b,<color>,<start line index>,<end line index>,<any value>|
...
b,<color>,<start line index>,<end line index>
,<any value>

Onde:

  • <color> é um número hexadecimal em formato RRGGBB.
  • <start line index> é o índice da linha onde começa o preenchimento. Ele é determinado pela ordem de especificação dos conjuntos de dados usando chd. O índice do primeiro conjunto de dados especificado é 0, o índice do segundo é 1 e assim por diante.
  • <end line index> é o índice da linha onde termina o preenchimento. Ele é determinado pela ordem de especificação dos conjuntos de dados usando chd. O índice do primeiro conjunto de dados especificado é 0, o índice do segundo é 1 e assim por diante.
  • <any value> é ignorado.

Separe as diversas áreas de preenchimento usando caracteres de barra vertical (|).

Parâmetro Descrição Exemplo

chm=b

Tenha o cuidado de especificar o conjunto de dados com os valores maiores primeiro:

Para preencher do alto do gráfico até a primeira linha, inclua um conjunto de dados apenas com o valor mais alto (9, 100.0 ou .., dependendo do tipo de codificação sendo usada).

Para preencher da última linha até a parte inferior do gráfico, inclua um conjunto de dados apenas com o menor valor de dados (A, 0 ou AA, dependendo do tipo de codificação usado).

As linhas são desenhadas em preto, usando chco como descrito em Cores.

 

Gráfico com três linhas. O gráfico é sombreado em verde da parte inferior até a primeira linha, vermelho da primeira à segunda linha, azul escuro da segunda à terceira linha e azul claro da terceira linha à parte superior do gráfico
chd=s:
99,
cefhjkqwrlgYcfgc,

QSSVXXdkfZUMRTUQ,
HJJMOOUbVPKDHKLH,
AA

chm=
b,76A4FB,0,1,0| (azul claro)
b,224499,1,2,0| (azul)
b,FF0000,2,3,0| (vermelho)
b,80C65A,3,4,0 (verde)

chco=000000,000000,000000,
000000,000000

Como contraste, o primeiro e o último conjuntos de dados (99 e AA) foram removidos deste gráfico.

Além disso, chco foi omitido para que as linhas sejam desenhadas de acordo com o parâmetro do tipo de gráfico. Aqui, o parâmetro é cht=lc, portanto foi usada a cor de linha padrão, que é amarelo.

Gráfico com três linhas. Nenhum sombreado da parte inferior à primeira linha, vermelho da primeira à segunda linha, azul escuro da segunda à terceira linha e nenhum preenchimento da terceira linha à parte superior do gráfico. As linhas foram desenhadas em amarelo padrão
chd=s:
cefhjkqwrlgYcfgc,
QSSVXXdkfZUMRTUQ,
HJJMOOUbVPKDHKLH,

chm=
b,224499,0,1,0| (azul)
b,FF0000,1,2,0| (vermelho)
b,80C65A,2,3,0 (verde)

chm=B

Para um único conjunto de dados, é mais simples usar chm=B. Neste caso, toda a área sob a linha é preenchida. Observe que chm=b não funciona em um gráfico de radar, embora você possa usar chm=B.

Gráfico com uma linha, com preenchimento azul da parte inferior até a linha
chm=B,76A4FB,0,0,0
chd=s:ATSTaVd21981uocA

Voltar ao início

Preenchimento sólido

Especifique o preenchimento sólido com

chf=
<bg or c or a>,s,<color>|
<bg or c or a>,s,<color>

Onde:

  • <bg or c or a> é:
    - bg para preenchimento de plano de fundo
    - c para preenchimento da área do gráfico
    - a para aplicar transparência ao gráfico inteiro.
  • <s> indica preenchimento sólido.
  • <color> é um número hexadecimal em formato RRGGBB.
  • O caractere de barra vertical (|) separa as definições de preenchimento. Não é necessário um caractere de barra vertical após a segunda definição.

Você pode especificar:

  • preenchimento do plano de fundo e da área do gráfico e transparência para gráficos de linha, sparklines e diagramas de dispersão.
  • preenchimento do plano de fundo para gráficos de barras e setores e diagramas de Venn.
  • preenchimento do plano de fundo para mapas e gráficos de radar.
Parâmetro Descrição Exemplo

chf

Este exemplo preenche a imagem de plano de fundo com cinza claro (efefef).

Gráfico de linha vermelha com fundo cinza claro

chf=bg,s,efefef

Este exemplo preenche o fundo com cinza claro (efefef) e a área do gráfico com preto (000000).

Diagrama de dispersão com pontos em azul, área do gráfico em preto e fundo cinza claro

chf=bg,s,efefef|
c,s,000000

Observe o efeito de especificar transparência usando os valores hexadecimais 20 para o plano de fundo e 80 para a área do gráfico.

Diagrama de dispersão com pontos em azul, área do gráfico em cinza escuro e fundo em cinza bem claro

chf=bg,s,efefef20|
c,s,00000080

Este exemplo aplica transparência ao gráfico inteiro.

Diagrama de dispersão com pontos em azul, área do gráfico e fundo em branco

chf=a,s,efefeff0

Voltar ao início

Gradiente linear

Especifique o gradiente linear para gráficos de linha, sparklines, gráficos de barras, diagramas de Venn, gráficos de radar e diagramas de dispersão com

chf=<bg or c>,lg,<angle>,<color 1>,<offset 1>,<color n>,<offset n>

Onde:

  • <bg or c> é bg para preenchimento de plano de fundo ou c para preenchimento da área do gráfico.
  • lg especifica o gradiente linear.
  • <angle> especifica o ângulo do gradiente, entre 0 (horizontal) e 90 (vertical).
  • <color x> são números hexadecimais em formato RRGGBB.
  • <offset x> especifica o ponto no qual a cor é pura, onde: 0 especifica a extremidade direita do gráfico e 1 a extremidade esquerda.
Parâmetro Descrição Exemplo

chf

A área do gráfico possui um gradiente linear horizontal (da esquerda para a direita), especificado com um ângulo de zero grau (0).

A primeira cor especificada é azul (76A4FB). Esta é pura na extremidade direita do gráfico.

A segunda cor especificada é branco (ffffff). Esta é pura na extremidade esquerda do gráfico.

O fundo do gráfico é cinza (EFEFEF).

Gráfico de linha cinza escuro com fundo cinza claro e área do gráfico em gradiente linear de branco para azul, da esquerda para a direita

chf=
c,lg,0,76A4FB,1,ffffff,0|
bg,s,EFEFEF

A área do gráfico possui um gradiente linear diagonal (do canto inferior esquerdo para o superior direito), especificado com um ângulo de quarenta e cinco graus (45).

A primeira cor especificada é branco (ffffff). Esta é pura no canto inferior esquerdo do gráfico.

A segunda cor especificada é azul (6A4FB). Esta é pura no canto superior direito do gráfico.

O plano de fundo do gráfico é cinza (EFEFEF) novamente.

Gráfico de linha cinza escuro com plano de fundo cinza claro e área do gráfico em gradiente linear diagonal de branco para azul, do canto inferior esquerdo para o canto superior direito

chf=
c,lg,45,ffffff,0,76A4FB,0.75|
bg,s,EFEFEF

A área do gráfico possui um gradiente linear vertical (do alto para baixo), especificado com um ângulo de noventa graus (90).

A primeira cor especificada é azul (76A4FB). Esta é pura no alto do gráfico.

A segunda cor especificada é branco (ffffff). Esta é pura na parte inferior do gráfico.

O plano de fundo do gráfico é cinza (EFEFEF) novamente.

Gráfico de linha cinza escuro com fundo cinza claro e área do gráfico em gradiente linear vertical de branco para azul, de baixo para cima

chf=
c,lg,90,76A4FB,0.5,ffffff,0|
bg,s,EFEFEF

Voltar ao início

Faixas lineares

Especifique faixas lineares para gráficos de linha, sparklines, gráficos de barras, diagramas de Venn, gráficos de radar e diagramas de dispersão com

chf=<bg or c>,ls,<angle>,<color 1>,<width 1>,<color n>,<width n>

Onde:

  • <bg or c> é bg para preenchimento de plano de fundo ou c para preenchimento da área do gráfico.
  • ls especifica faixas lineares.
  • <angle> especifica o ângulo do gradiente, entre 0 (vertical) e 90 (horizontal).
  • <color> é um número hexadecimal em formato RRGGBB.
  • <width> deve estar entre 0 e 1, onde 1 é a largura total do gráfico. As faixas são repetidas até preencher totalmente o gráfico.
Parâmetro Descrição Exemplo

chf

Área do gráfico com faixas verticais especificadas com ângulo zero (0).

A primeira cor especificada (cinza escuro CCCCCC) é a primeira faixa desenhada a uma largura de 20% da largura do gráfico.

A segunda cor especificada (branco ffffff) também é desenhada a uma largura de 20%.

As faixas são alternadas até preencher totalmente o gráfico.

O plano de fundo do gráfico foi omitido.

Gráfico de linha azul com faixas alternadas em cinza e branco da esquerda para a direita

chf=c,ls,0,CCCCCC,0.2,
FFFFFF,0.2

Área do gráfico com faixas horizontais especificadas com ângulo de noventa graus (90).

A primeira cor especificada (o cinza mais escuro 999999) é a primeira faixa desenhada a uma largura de 25% da largura do gráfico.

A segunda e a terceira cores especificadas (o cinza mais claro CCCCCC e branco FFFFFF) também são desenhadas a uma largura de 25%.

As faixas são alternadas até preencher totalmente o gráfico.

O plano de fundo do gráfico foi omitido.

Gráfico de linha azul com faixas cinza escuro, cinza claro e branco de baixo para cima.

chf=
c,ls,90,
999999,0.25,
CCCCCC,0.25,
FFFFFF,0.25

Voltar ao início

Rótulos

Estão disponíveis os tipos de rótulos abaixo:

Título do gráfico

Especifique um título de gráfico com

chtt=<chart title>

Parâmetro Descrição Exemplo

chtt

Especifique um espaço usando o sinal de mais (+).

Use um caractere de barra vertical (|) para forçar a quebra de linha.

 

Gráfico de barras com título
chtt=Site+visitors+by+month|
January+to+July

Como opção, você também pode definir a cor e o tamanho do título com

chts=<color>,<fontsize>

Se o tamanho especificado (por chs) for pequeno demais, o gráfico será cortado (ficará apenas parcialmente visível).

Gráfico de barras verticais com título azul de 20 pixels
chtt=Site+visitors
chts=FF0000,20

Voltar ao início

Legenda

Especifique uma legenda com

chdl=<first data set label>|<n data set label>

Parâmetro Descrição Exemplo

chdl

Use chdl juntamente com as cores das linhas como descrito em Cores.

Nestes exemplos, o primeiro conjunto de dados é vermelho, o segundo é verde e o terceiro é azul.

Gráfico de linhas em vermelho, azul e verde com legendas correspondentes
chdl=NASDAQ|FTSE100|DOW
chco=ff0000,00ff00,0000ff
Diagrama de Venn com dois círculos menores dentro de um círculo maior
chdl=First|Second|Third
chco=ff0000,00ff00,0000ff
chdl e chdlp

Use chdl juntamente com o parâmetro chdlp para especificar a posição da legenda, como segue:

  • chdlp=b coloca a legenda na parte inferior
  • chdlp=t coloca a legenda na parte superior
  • chdlp=r coloca a legenda à direita
  • chdlp=l coloca a legenda à esquerda
Diagrama de Venn com dois círculos menores dentro de um círculo maior
chdl=First|Second|Third
chco=ff0000,00ff00,0000ff
chdlp=l

Voltar ao início

Rótulos de gráficos de setores e Google-o-meters

Para um gráfico de setores, especifique os rótulos com

chl=
<label 1 value>|
...
<label n value>

Você pode especificar um valor ausente com dois caracteres de barra vertical consecutivos (||).

Observação: Para exibir rótulos:
- Um gráfico bidimensional precisa ter largura aproximadamente duas vezes maior que a altura.
- Um gráfico tridimensional precisa ter largura aproximadamente duas vezes e meia maior que a altura.

Para um Google-o-meter, especifique o texto exibido acima da seta com

chl=<label>

Parâmetro Descrição Exemplo
chl

Rótulos para um gráfico de setores tridimensional.

Gráfico de setores tridimensional com os rótulos maio, junho, julho, agosto, setembro e outubro para cada segmento

chl=May|Jun|Jul|Aug|Sep|Oct
chs=220x100

Uma boa regra prática é fornecida acima para determinar a largura necessária para que o gráfico de setores inclua rótulos, entretanto, não se esqueça de que é também preciso considerar o comprimento dos rótulos. Aqui, os rótulos são exibidos parcialmente, pois o gráfico não é largo o suficiente.

Gráfico de setores tridimensional com os rótulos maio, junho, julho, agosto, setembro e outubro para cada segmento

chl=May|June|July|August|
September|October
chs=220x100

Para exibir completamente os rótulos, este gráfico precisa ter 280 pixels de largura.

Gráfico de setores tridimensional com os rótulos maio, junho, julho, agosto, setembro e outubro para cada segmento

chl=May|June|July|August|
September|October
chs=280x100

Aqui está o exemplo de um Google-o-meter com rótulo.

Google-o-meter com cores do vermelho até o verde padrão
chl=Hello

Voltar ao início

Rótulos de diversos eixos

Os rótulos de diversos eixos estão disponíveis para gráficos de linhas, de barras, de radar e diagramas de dispersão:

Tipo de eixo

Especifique diversos eixos com

chxt=
<axis 1>,
...
<axis n>

Os eixos disponíveis são:

  • x = eixo x inferior
  • t = eixo x superior
  • y = eixo y esquerdo
  • r = eixo y direito

Os eixos são especificados pelo índice que tiverem na especificação do parâmetro chxt. O índice do primeiro eixo é 0, o índice do segundo eixo é 1 e assim por diante. Você pode especificar diversos eixos incluindo x, t, y ou r diversas vezes.

Para criar diversos eixos, é necessário ao menos o parâmetro chxt. Na ausência de outros parâmetros, a API do Google Chart utiliza os padrões descritos nas seções abaixo.

Parâmetro Descrição Exemplo

chxt

Estes exemplos mostram dois eixos x inferiores (x é incluído duas vezes), eixos y da esquerda e da direita (y e r), além de um eixo superior (t).

Como os rótulos dos eixos são omitidos, a API do gráfico assume um intervalo de

  • 0 a 100 para todos os eixos do gráfico de linha.
  • 0 a 100 para os eixos y e r no gráfico de barras verticais, mas centraliza os rótulos dos eixos x e t sob cada uma das barras e as rotula de 0 a 4.
  • 0 a 100 para os eixos x e t no gráfico de barras horizontais, mas centraliza os rótulos dos eixos y e r ao lado de cada uma das barras e as rotula com o índice do eixo (0 a 4). Além disso, a altura do gráfico horizontal precisa ser aumentada ou o gráfico será cortado.

Observação: para não nos estendermos demais, gráficos de barras verticais, não horizontais, são discutidos no restante desta seção. O comportamentos dos eixos y e r em um gráfico de barras horizontais é o mesmo que o dos eixos x e t em um gráfico de barras vertical.

Line chart with the labels: 0, 20, 40, 60, 80, and 100 on the left and right and labels: 0, 25, 50, 75, and 100 twice on the x-axis one set below the other

Bar chart with the labels: 0, 20, 40, 60, 80, and 100 on the left and right and labels: 0, 1, 2, 3, and 4 twice on the x-axis one set below the other and once on the top axis

Bar chart with the labels: 0, 20, 40, 60, 80, and 100 on the left and right and labels: 0, 1, 2, 3, and 4 twice on the x-axis one set below the other and once on the top axis
chxt=x,y,r,x,t

Voltar ao início

Rótulos de eixo

Especifique os rótulos com

chxl=
<axis index>:|<label 1>|<label n>|
...
<axis index>:|<label 1>|<label n>

O parâmetro index especifica o índice do eixo ao qual se aplicam os rótulos.
Todos os rótulos são separados por caracteres de barra vertical (|).

Observação: Os rótulos de eixo devem ser especificados em seqüência (0, seguido de 1, seguido de 2 e assim por diante).

O primeiro rótulo é colocado no início, o último no fim e os outros são distribuídos uniformemente no meio.

Parâmetro Descrição Exemplo

chxt e chxl

Estes exemplos mostram os eixos y esquerdo e direito (y e r), além de dois conjuntos de valores para o eixo x (x).

Observação: rótulos do eixo x do gráfico de barras são centralizados abaixo de cada barra. Por isso, ao contrário do gráfico de linha, o ano é especificado em cada barra do gráfico de barras.

Gráfico de linhas com 0 e 100 à esquerda, A, B e C à direita, Jan, Jul, Jan, Jul e Jan no eixo x e 2005, 2006 e 2007 abaixo
chxt=x,y,r,x
chxl=
0:|Jan|July|Jan|July|Jan|
1:|0|100|
2:|A|B|C|
3:|2005|2006|2007

Gráfico de barras com 0 e 100 à esquerda, A, B e C à direita, Jan, Jul, Jan, Jul e Jan no eixo x e 2005, 2006 e 2007 abaixo

Assim como acima, para o gráfico de linha, exceto:
3:|2005|2005|2006|2006|2007

Assim como acima, exceto os rótulos do eixo y (índice 1) não são especificados

Gráfico de linha com 0 a 100 à esquerda, A, B e C à direita, Jan, Jul, Jan, Jul e Jan no eixo x e 2005, 2006 e 2007 abaixo
chxt=x,y,r,x
chxl=
0:|Jan|July|Jan|July|Jan|

(eixo y omitido)
2:|A|B|C|
3:|2005|2006|2007

Gráfico de barras com 0 a 100 à esquerda, A, B e C à direita, Jan, Jul, Jan, Jul e Jan no eixo x e 2005, 2006 e 2007 abaixo
Assim como acima para o gráfico de linha, exceto:
3:|2005|2005|2006|2006|2007

Voltar ao início

Posições dos rótulos de eixo

Especifique as posições dos rótulos com

chxp=
<axis index>,<label 1 position>,<label n position>|

...
<axis index>,<label 1 position>,<label n position>

Use números com pontos flutuantes para os valores de posição. Separe os dados de um eixo diferente usando um caractere de barra vertical (|). Se os rótulos (chxl) forem omitidos, o valor da posição será usado como texto do rótulo.

Parâmetro Descrição Exemplo

chxp

Este exemplo mostra os eixos y esquerdo e direito (y e r) e um eixo x (x).

O eixo x (índice 0) não tem posições ou rótulos, portanto, a API do Chart supõe um intervalo de 0 a 100 e distribui os valores em espaços regulares.

O eixo y esquerdo (índice 1) possui rótulos (máx., média e mín.) e posições (10,35,75).

O eixo r (índice 2) tem apenas posições (0,1,2,4), portanto a API do Chart usa as posições como rótulos. Um intervalo é especificado para esse eixo, chxr=2,0,4. Consulte a próxima seção para obter detalhes.

Line chart with min, average, and max on the left, 0, 1, 2, and 4 on the right and 0, 25, 50, 75, and 100 along the x-axis
chxt=x,y,r
chxl=1:|min|average|max
chxp=1,10,35,75|2,0,1,2,4
chxr=2,0,4


Este exemplo mostra os eixos y esquerdo e direito (y e r) e dois eixos x (x).

De forma semelhante ao exemplo acima, exceto que a posição dos rótulos de dois eixos x é especificada. Isso ilustra que você pode substituir o posicionamento dos rótulos da API do Chart por um gráfico de barras, usando chxp.

Gráfico de barras com mín., média e máx. à esquerda, 0, 1, 2 e 4 à direita e 0, 1, 2, 3 e 4 ao longo do eixo x
chxt=x,y,r,x
chxr=2,0,4|3,0,4
chxl=1:|min|average|max
chxp=0,10,35,75
    |1,10,35,75
    |2,0,1,2,4
    |3,0,1,2,4

Voltar ao início

Intervalo do eixo

Especifique um intervalo com

chxr=
<axis index>,<start of range>,<end of range>|
...
<axis index>,<start of range>,<end of range>

Separe os intervalos de diversos eixos usando caracteres de barra vertical (|).

Parâmetro Descrição Exemplo

chxr

Este exemplo mostra os eixos y esquerdo e direito (y e r) e um eixo x (x).

Cada eixo possui um intervalo definido. Como não foram especificados rótulos nem posições, os valores dentro do intervalo definido são distribuídos a espaços regulares. No gráfico de barras, observe que, novamente, o eixo x é tratado de forma diferente, cada barra tem um rótulo.

Observação: A direção do eixo r (índice 2) é invertida, pois o primeiro valor (1000) é maior que o último valor (0).

Gráfico de linhas com 0, 50, 100, 150 e 200 à esquerda, 1000, 800, 600, 400, 200 e 0 à direita e 250 e 500 no eixo x

Gráfico de barras com 0, 50, 100, 150 e 200 à esquerda, 1000, 800, 600, 400, 200 e 0 à direita e 100, 200, 300, 400 e 500 no eixo x
chxt=x,y,r
chxr=0,100,500|
1,0,200|
2,1000,0

Aqui, somente o eixo x é definido (x). Este eixo possui intervalo, rótulos e posições, portanto os três conjuntos de valores são usados.

Gráfico de linhas com 200, 300 e 400 no eixo x

Gráfico de barras com 200, 300 e 400 no eixo x
chxt=x
chxr=0,100,500
chxl=0:|200|300|400
chxp=0,200,300,400

Voltar ao início

Estilos de eixo

Especifique o tamanho da fonte, cor e alinhamento dos rótulos de eixo com

chxs=
<axis index>,<color>,<font size>,<alignment>|
...
<axis index>,<color>,<font size>,<alignment>

onde:

  • <axis index> é o índice do eixo conforme especificado em chxt.
  • <color> é um número hexadecimal em formato RRGGBB.
  • <font size> é opcional. Se usado, especifica o tamanho da fonte em pixels.
  • <alignment> é opcional. O padrão: os rótulos do eixo x são centralizados, os rótulos do eixo y esquerdo são alinhados à direita e os rótulos do eixo y direito são alinhados à esquerda. Para especificar o alinhamento, use 0 para centralizado, -1 para alinhamento à esquerda e 1 para alinhamento à direita.

Separe os diversos valores usando caracteres de barra vertical (|).

Parâmetro Descrição Exemplo

chxs

O tamanho da fonte, cor e alinhamento são especificados para o segundo eixo x.

Gráfico de linhas com mín., média e máx. à esquerda, 0, 1, 2 e 4 à direita, 0 a 100 ao longo do eixo x e jan, fev, e março em azul abaixo

Line chart with min, average, and max on the left, 0, 1, 2, 3, and 4 on the right, 0 to 100 along the x-axis and Jan, Feb, and March in blue below
chxt=x,y,r,x
chxr=2,0,4
chxl=3:|Jan|Feb|Mar|1:|min|average|max
chxp=1,10,35,75
chxs=3,0000dd,13

O tamanho da fonte, cor e alinhamento são especificados para ambos os eixos x.

Gráfico de linhas com 1º e 15º repetidos ao longo do eixo x e fev e mar abaixo. Todos os rótulos estão em azul

Gráfico de linhas com 1º e 15º repetidos ao longo do eixo x e fev e mar abaixo. Todos os rótulos estão em azul
chxt=x,y,r,x
chxl=3:|Jan|Feb|Mar||
     0:|1st|15th|1st|15th|1st
chxs=0,0000dd,10|3,0000dd,12,1

Voltar ao início

Estilos

Estão disponíveis os estilos abaixo:

Largura e espaçamento das barras

Nos gráficos de barras, especifique a largura e o espaçamento das barras com
chbh=
<bar width in pixels>,
<optional space between bars in a group>,
<optional space between groups>

Parâmetro Descrição Exemplo

chbh

No primeiro exemplo, a largura da barra foi definida como 10 pixels, o espaço entre as barras é o padrão de 4 pixels e o espaço entre os grupos é o padrão de 8 pixels.

No segundo exemplo, a largura da barra foi definida como 10 pixels, o espaço entre as barras é de 5 pixels e o espaço entre os grupos é de 15 pixels.

Tenha cuidado ao fornecer somente dois valores. No terceiro exemplo, o espaço entre as barras é definido como 8 pixels. Como este é o valor padrão para espaço entre grupos, a distinção visual é perdida completamente. Especificar um valor maior que 8 é ainda pior: as barras erradas aparentam estar agrupadas.

Gráfico de barras horizontais com dois conjuntos de dados: um dos conjuntos tem cor vermelha e o segundo está adjacente em verde
cht=bhg
chbh=10

Gráfico de barras horizontais com dois conjuntos de dados: um dos conjuntos tem cor vermelha e o segundo está adjacente em verde
cht=bvg
chbh=10,5,15

Gráfico de barras horizontais com dois conjuntos de dados: um dos conjuntos tem cor vermelha e o segundo está adjacente em verde
cht=bhg
chbh=10,8

Gráfico de barras horizontais com dois conjuntos de dados: um dos conjuntos tem cor vermelha e o segundo está adjacente em verde
cht=bhg
chbh=10,15

Voltar ao início

Linha zero do gráfico de barras

Para os gráficos de barras, especifique uma linha zero com

chp=
<value between 0 and 1 for dataset 1>,
<value between 0 and 1 for dataset n>

Forneça apenas um valor para aplicar a mesma linha zero a todos os conjuntos de dados.

Parâmetro Descrição Exemplo

chp

Neste exemplo, o valor chp .5 coloca a linha zero no meio do gráfico. Este gráfico usa codificação de texto, portanto, um ponto de dado com valor:

  • de 0 a 49 é desenhado abaixo da linha zero
  • 50 é desenhado sobre a linha zero (que é invisível, veja o terceiro ponto de dados do exemplo)
  • de 51 a 100 é desenhado acima da linha zero

Gráfico de barras verticais com linha zero na metade do gráfico
chp=.5
chd=t:20,35,50,10,95

chds

Uma maneira alternativa de definir a linha zero é usar o parâmetro de dimensionamento de dados (chds) combinado à codificação de texto.

O exemplo tem um conjunto de dados que varia de -60 a 120 e uma escala de -80 a 140 para deixar algum espaço acima e abaixo das barras.

Consulte a seção Codificação de texto com dimensionamento de dados para obter mais informações.

Gráfico de barras horizontais com dois conjuntos de dados: ambos estão em vermelho
chd=t:30,-60,50,120,80
chds=-80,140

Voltar ao início

Estilos de linha

Você pode especificar estilos de linha para:

Estilos de linha e sparkline

Especifique os estilos de linha e sparkline com

chls=
<data set 1 line thickness>,<length of line segment>,<length of blank segment>|
...

<data set n line thickness>,<length of line segment>,<length of blank segment>

Os valores dos parâmetros são números com ponto flutuante, os diversos estilos de linha são separados com o caractere de barra vertical (|). O primeiro estilo de linha é aplicado ao primeiro conjunto de dados, o segundo estilo ao segundo conjunto de dados e assim por diante.

Parâmetro Descrição Exemplo

chls

Aqui, a linha grossa tracejada é especificada por 3,6,3 e a linha fina sólida é especificada por 1,1,0.

Consulte a seção Cores do gráfico para obter mais informações sobre como especificar outras cores de linha.

Gráfico de linhas com uma linha sólida e uma linha tracejada
chls=3,6,3|1,1,0

Voltar ao início

Estilos de linha dos gráficos de linhas, sparklines e de barras

Especifique os estilos de linha dos gráficos de linhas e barras com

chm=D,<color>,<data set index>,<data point>,<size>,<priority>

onde:

  • <color> é um número hexadecimal em formato RRGGBB.
  • <data set index> é o índice do conjunto de dados no qual a linha será desenhada. Este valor é 0 para o primeiro conjunto de dados, 1 para o segundo e assim por diante.
  • <data point> é zero.
  • <size> é o tamanho do marcador em pixels.
  • <priority> determina a ordem na qual as barras, linhas, marcadores e preenchimentos são desenhados:
    1 especifica que a linha é desenhada sobre as barras e marcadores.
    0 é o padrão e especifica que a linha é desenhada sobre as barras e sob os marcadores.
    -1 especifica que a linha é desenhada sob as barras e marcadores.
Parâmetro Descrição Exemplo
chm=D

Aqui está um exemplo de linha de dados em um gráfico de barras. A prioridade está configurada para 1, portanto a linha é desenhada sobre as barras.

Gráfico de barras com marcador de linha
chm=
D,4D89F9,0,0,5,-1

Aqui está um exemplo de gráfico de sparkline. Os gráficos de sparklines são idênticas aos gráficos de linha, exceto pelo fato de não terem eixos por padrão, e possuem exatamente a mesma funcionalidade dos gráficos de linhas.

Gráfico de linhas com duas linhas azuis
chm=
D,C6D9FD,1,0,8|
D,4D89F9,0,0,4

Voltar ao início

Linhas de grade

Especifique uma grade com

chg=
<x axis step size>,
<y axis step size>,
<length of line segment>,
<length of blank segment>

Os valores dos parâmetros podem ser números inteiros ou ter uma única casa decimal, por exemplo, 10.0 ou 10.5.

Parâmetro Descrição Exemplo

chg

Um exemplo no qual é definido somente o tamanho do passo (20,50), portanto a API do Google Chart usa como padrão uma linha de grade tracejada.

Gráfico de linhas com cinco linhas de grade tracejadas verticais e duas horizontais em cinza claro
chg=20,50

Aqui, o tamanho do passo (20,50), o segmento de linha (1) e o segmento em branco (5) foram definidos.

Gráfico de linhas com cinco linhas verticais e duas horizontais em cinza claro esmaecido, linhas de grade tracejadas
chg=20,50,1,5

Especifique segmento em branco zero (0) para obter uma grade sólida.

Gráfico de linhas com cinco linhas de grade verticais e duas horizontais sólidas em cinza claro
chg=20,50,1,0

Voltar ao início

Marcadores de forma e intervalo

Para gráficos de linhas, de radar, de barras e diagramas de dispersão, use chm para especificar marcadores de forma e de intervalo. Marcadores de intervalo podem ser horizontais ou verticais.

Marcadores de forma

Especifique os marcadores de forma com

chm=
<marker type>,<color>,<data set index>,<data point>,<size>,<priority>|
...
<marker type>,<color>,<data set index>,<data point>,<size>,<priority>

Onde:

  • <marker type> é um dos caracteres a seguir:
    a representa uma seta.
    c representa uma cruz.
    d representa um losango.
    o representa um círculo.
    s representa um quadrado.
    t representa um texto.
    v representa uma linha vertical partindo do eixo x até o ponto de dados.
    V representa uma linha vertical até o alto do gráfico.
    h representa uma linha horizontal cruzando o gráfico.
    x representa uma forma x.

  • <color> é um número hexadecimal em formato RRGGBB.
  • <data set index> é o índice na linha onde o marcador será desenhado. Este valor é 0 para o primeiro conjunto de dados, 1 para o segundo e assim por diante.
  • <data point> é um valor de ponto flutuante que especifica em qual ponto de dados o marcador será desenhado, para todos os marcadores exceto uma linha horizontal. Ele pode ser: 0 para o primeiro conjunto de dados, 1 para o segundo ou -1 para todos os pontos de dados. Especifique uma fração para intercalar um marcador entre dois pontos de dados. Para uma linha horizontal, veja o primeiro exemplo da tabela abaixo.
  • <size> é o tamanho do marcador em pixels.
  • <priority> determina a ordem na qual as barras, linhas, marcadores e preenchimentos são desenhados:
    -1 especifica que o marcador é desenhado antes de todas as outras partes do gráfico. Isso significa que o marcador será ocultado caso outro elemento do gráfico seja desenhado no mesmo lugar.
    0 é o padrão e especifica que o marcador é desenhado sobre as barras ou linhas e sob os outros marcadores.
    1 especifica que o marcador é desenhado sobre todas as outras partes do gráfico. Isso significa que ele ocultará outro elemento do gráfico caso seja desejado no mesmo lugar.

Separe os diversos marcadores usando caracteres de barra vertical (|).

Parâmetro Descrição Exemplo

chm

 

Aqui está um exemplo do conjunto completo de marcadores de forma e linha.

O último marcador da lista, h, é a linha horizontal que intercepta as linhas verticais, v e V. Para esse tipo de marcador, não especifique um ponto de dados. Em vez disso, use 0.0 para colocar a linha na parte inferior do gráfico, 1.0 para colocar a linha no alto do gráfico e um valor entre ambos para intercalar. O exemplo tem valor 0.3, portanto a linha é desenhada a cerca de um terço da parte superior do gráfico.

Gráfico de linhas com cruz vermelha de 20 pixels, losango verde de 20 pixels, seta roxa de 9 pixels, círculo laranja de 20 pixels, quadrado azul de 10 pixels, linha vertical cinza claro de 1 pixel, linha azul de 1 pixel e uma cruz amarela de 20 pixels, todos desenhados sobre os pontos de dados de uma única linha. Uma linha preta horizontal fina intercepta a linha vertical v no ponto 7
chm=
c,FF0000,0,1.0,20.0|
d,80C65A,0,2.0,20.0|
a,990066,0,3.0,9.0|
o,FF9900,0,4.0,20.0|
s,3399CC,0,5.0,10.0|
v,BBCCED,0,6.0,1.0|
V,3399CC,0,7.0,1.0|
x,FFCC33,0,8.0,20.0|
h,000000,0,0.30,0.5

Aqui está um exemplo do tipo de marcador s em um diagrama de dispersão.

Consulte a seção Diagrama de dispersão para obter mais detalhes sobre como definir o tamanho de cada ponto de dados.

Diagrama de dispersão com marcadores quadrados vermelhos de 10 pixels
chm=
s,FF0000,1,1.0,10.0

 

Aqui está um exemplo usando losangos e círculos para dois conjuntos de dados.

Se dois pontos ocuparem a mesma posição (por terem os mesmos valores de x e y), é desenhado o primeiro ponto especificado. Aqui, o círculo tem precedência sobre o losango.

Observe o uso de -1 para definir todos os pontos de dados em um único conjunto de dados com a mesma forma.

Gráfico de linhas, uma linha contém círculos de 10 pixels em cada ponto de dados e a outra linha contém losangos de 10 pixels. Um círculo ocupa o ponto comum a ambas as linhas
chm=
o,ff9900,0,-1,10.0|
d,ff9900,1,-1,10.0

Aqui está um gráfico de barras com texto como marcador. Especifique marcadores de texto na mesma ordem dos dados.

Há um quinto valor opcional para determinar a prioridade:

  • O padrão é 0, onde o texto é desenhado sobre as barras e sob os outros marcadores. Você vê isso na segunda barra de cima para baixo no gráfico do exemplo (April desktop hits).
  • 1 onde o texto é desenhado sobre as barras e os outros marcadores.
  • -1 onde o texto é desenhado sob as barras e os outros marcadores. Você vê isso na terceira barra de cima para baixo no gráfico do exemplo (May mobile hits).
Gráfico de barras com marcadores de texto
chm=
tApril+mobile+hits,000000,0,0,13|
tMay+mobile+hits,000000,0,1,13,-1|
tApril+desktop+hits,000000,1,0,13|
tMay+desktop+hits,000000,1,1,13

Voltar ao início

Marcadores de intervalo

Para gráficos de linhas, de radar, de barras e diagramas de dispersão, especifique os marcadores de intervalo horizontal e vertical com

chm=
<r or R>,<color>,<any value>,<start point>,<end point>|
...
<r or R>,<color>,<any value>,<start point>,<end point>

Onde:

  • <r or R> é r para um intervalo horizontal e R para um intervalo vertical.
  • <color> é um número hexadecimal em formato RRGGBB.
  • <any value> é ignorado.
  • <start point> para:
    
 - marcadores de intervalo horizontal
 é a posição do eixo y na qual o intervalo é iniciado, onde 0.00 é a parte inferior e 1.00 é a parte superior.
    - marcadores de intervalo vertical é a posição do eixo x na qual o intervalo é iniciado, onde 0.00 é a esquerda e 1.00 é a direita.
  • <end point> para:
    
- marcadores de intervalo horizontal
 é a posição do eixo y na qual o intervalo termina, onde 0.00 é a parte inferior e 1.00 é a parte superior.
    - os marcadores de intervalo vertical é a posição do eixo x na qual o intervalo termina, onde 0.00 é a esquerda e 1.00 é a direita.

Separe os diversos marcadores de intervalo usando caracteres de barra vertical (|).

Parâmetro Descrição Exemplo

chm=r

Os marcadores de intervalo podem ser uma linha simples ou uma faixa de cor. Aqui, o primeiro marcador é uma faixa azul claro (E5ECF9) e o segundo é uma linha preta (000000).

Gráfico de linhas com uma faixa horizontal azul claro se estendendo de 25 a 75 por cento do eixo y e uma linha fina horizontal posicionada a dez por cento do eixo y
chm=
r,E5ECF9,0,0.75,0.25|
r,000000,0,0.1,0.11
chm=R Aqui está o mesmo exemplo com marcadores de intervalo verticais. Neste caso, o primeiro marcador é uma linha vermelha (ff0000) e o segundo é uma faixa azul claro (A0BAE9). Gráfico de linhas com uma faixa vertical azul claro se estendendo de 25 a 75 por cento do eixo x e uma linha fina vertical posicionada a dez por cento do eixo x
chm=
R,ff0000,0,0.1,0.11|
R,A0BAE9,0,0.75,0.25
chm=
R...|r...
Você pode misturar marcadores de intervalo horizontais e verticais. Observe que o último marcador especificado tem precedência sobre os marcadores anteriores, em caso de sobreposição. Aqui, os marcadores horizontais foram especificados por último, portanto são desenhados sobre os marcadores verticais.

Gráfico de linhas com uma faixa vertical azul e uma faixa horizontal em azul mais claro, estendendo-se de 25% a 75% do gráfico ao longo dos eixos x e y, respectivamente. Linha vermelha fina vertical e linha preta fina horizontal a 10% ao longo dos eixos x e y, respectivamente
chm=
R,ff0000,0,0.1,0.11|
R,A0BAE9,0,0.75,0.25
|
r,E5ECF9,0,0.75,0.25|
r,000000,0,0.1,0.11

chm=r Aqui está uma sparkline combinando linhas horizontais esmaecidas com rótulos de gráfico no eixo y da direita. Sparkline com uma única linha amarela e três linhas horizontais distribuídas igualmente
chm=
r,000000,0,0.499,0.501|
r,000000,0,0.998,1.0|
r,000000,0,0.0,0.002

Voltar ao início

Mapeamento de caracteres

Valores de caracteres de codificação simples

O mapeamento de codificação simples é fornecido abaixo.

Caractere Valor
A 0
B 1
C 2
D 3
E 4
F 5
G 6
H 7
I 8
J 9
K 10
L 11
M 12
N 13
O 14
P 15
Q 16
R 17
S 18
T 19
U 20
V 21
W 22
X 23
Y 24
Z 25
a 26
b 27
c 28
d 29
e 30
f 31
g 32
h 33
i 34
j 35
k 36
l 37
m 38
n 39
o 40
p 41
q 42
r 43
s 44
t 45
u 46
v 47
w 48
x 49
y 50
z 51
0 52
1 53
2 54
3 55
4 56
5 57
6 58
7 59
8 60
9 61

Voltar ao início

Valores de caracteres de codificação estendida

É necessária uma grade de 63 por 63 para mapear todos os 4096 valores da codificação estendida. Esta grade seria de difícil leitura em uma página HTML como esta. Sendo assim, recomendamos que você crie sua própria grade usando uma planilha. Um código com a grade necessária é fornecido abaixo.

Para configurar uma planilha para mapeamento de codificação estendida:

  1. Crie uma planilha com uma linha contendo o alfabeto em maiúsculas (A-Z), seguido pelo alfabeto em minúsculas (a-z), seguido dos algarismos de 0 a 9 inclusive, seguido por um hífen (-) e um ponto (.).
  2. Crie uma única coluna à esquerda com os mesmos valores.
  3. Digite um zero (0) na coluna A:linha A, digite um (1) na coluna A:linha B e assim por diante, até a coluna A:linha ponto (.) ter o valor 63. Veja abaixo um subconjunto das colunas necessárias.
  4. Faça a coluna B:linha A igual à coluna A:linha A mais 64. Copie a célula para o restante da coluna B.
  5. Copie a coluna B para todas as outras colunas.
  6. O último valor da tabela, coluna ponto (.).:linha ponto (.) deve ter o valor 4095.

Para ler a tabela, encontre primeiro a coluna e depois a linha. Por exemplo:

  • 7 = AH
  • 133 = CF
  • 3975 = -H
  • 4037 = .F
  A B C -> 9 hífen (-) ponto (.)
A 0 64 128 ... 3904 3968 4032
B 1 65 129 ... 3905 3969 4033
C 2 66 130 ... 3906 3970 4034
D 3 67 131 ... 3907 3971 4035
E 4 68 132 ... 3908 3972 4036
F 5 69 133 ... 3909 3973 4037
G 6 70 134 ... 3910 3974 4038
H 7 71 135 ... 3911 3975 4039
I 8 72 136 ... 3912 3976 4040
J 9 73 137 ... 3913 3977 4041
K 10 74 138 ... 3914 3978 4042
L 11 75 139 ... 3915 3979 4043
M 12 76 140 ... 3916 3980 4044
N 13 77 141 ... 3917 3981 4045
O 14 78 142 ... 3918 3982 4046
P 15 79 143 ... 3919 3983 4047
Q 16 80 144 ... 3920 3984 4048
R 17 81 145 ... 3921 3985 4049
S 18 82 146 ... 3922 3986 4050
T 19 83 147 ... 3923 3987 4051
U 20 84 148 ... 3924 3988 4052
V 21 85 149 ... 3925 3989 4053
W 22 86 150 ... 3926 3990 4054
X 23 87 151 ... 3927 3991 4055
Y 24 88 152 ... 3928 3992 4056
Z 25 89 153 ... 3929 3993 4057
a 26 90 154 ... 3930 3994 4058
b 27 91 155 ... 3931 3995 4059
c 28 92 156 ... 3932 3996 4060
d 29 93 157 ... 3933 3997 4061
e 30 94 158 ... 3934 3998 4062
f 31 95 159 ... 3935 3999 4063
g 32 96 160 ... 3936 4000 4064
h 33 97 161 ... 3937 4001 4065
i 34 98 162 ... 3938 4002 4066
j 35 99 163 ... 3939 4003 4067
k 36 100 164 ... 3940 4004 4068
l 37 101 165 ... 3941 4005 4069
m 38 102 166 ... 3942 4006 4070
n 39 103 167 ... 3943 4007 4071
o 40 104 168 ... 3944 4008 4072
p 41 105 169 ... 3945 4009 4073
q 42 106 170 ... 3946 4010 4074
r 43 107 171 ... 3947 4011 4075
s 44 108 172 ... 3948 4012 4076
t 45 109 173 ... 3949 4013 4077
u 46 110 174 ... 3950 4014 4078
v 47 111 175 ... 3951 4015 4079
w 48 112 176 ... 3952 4016 4080
x 49 113 177 ... 3953 4017 4081
y 50 114 178 ... 3954 4018 4082
z 51 115 179 ... 3955 4019 4083
0 52 116 180 ... 3956 4020 4084
1 53 117 181 ... 3957 4021 4085
2 54 118 182 ... 3958 4022 4086
3 55 119 183 ... 3959 4023 4087
4 56 120 184 ... 3960 4024 4088
5 57 121 185 ... 3961 4025 4089
6 58 122 186 ... 3962 4026 4090
7 59 123 187 ... 3963 4027 4091
8 60 124 188 ... 3964 4028 4092
9 61 125 189 ... 3965 4029 4093
hífen 62 126 190 ... 3966 4030 4094
ponto 63 127 191 ... 3967 4031 4095

Voltar ao início

Códigos de país ISO 3166

A tabela abaixo lista 246 nomes de país (nomes curtos oficiais em inglês) em ordem alfabética, conforme o padrão ISO 3166-1, e os elementos de código ISO 3166-1-alfa-2 correspondentes.

Estes códigos são usados ao desenhar um mapa com área geográfica do tipo africa, asia, europe, middle_east, south_america e world. Para obter mais informações, consulte Mapas neste documento.

Nome do país Código ISO 3166-1-alfa-2
A  
AFEGANISTÃO AF
ILHAS ÅLAND AX
ALBÂNIA AL
ARGÉLIA DZ
SAMOA AMERICANA AS
ANDORRA AD
ANGOLA AO
ANGUILA AI
ANTÁRTICA AQ
ANTÍGUA E BARBUDA AG
ARGENTINA AR
ARMÊNIA AM
ARUBA AW
AUSTRÁLIA AU
ÁUSTRIA AT
AZERBAIJÃO AZ
B  
BAHAMAS BS
BAREIN BH
BANGLADESH BD
BARBADOS BB
BELARUS BY
BÉLGICA BE
BELIZE BZ
BENIN BJ
BERMUDA BM
BUTÃO BT
BOLÍVIA BO
BÓSNIA-HERZEGOVINA BA
BOTSUANA BW
ILHA BOUVET BV
BRASIL BR
TERRITÓRIO BRITÂNICO DO OCEANO ÍNDICO IO
BRUNEI DARUSSALAM BN
BULGÁRIA BG
BURKINA FASSO BF
BURUNDI BI
C  
CAMBOJA KH
CAMARÕES CM
CANADÁ CA
CABO VERDE CV
ILHAS CAYMAN KY
REPÚBLICA CENTRO-AFRICANA CF
CHADE TD
CHILE CL
CHINA CN
ILHA CHRISTMAS CX
ILHAS COCOS (KEELING) CC
COLÔMBIA CO
COMORES KM
CONGO CG
CONGO, REPÚBLICA DEMOCRÁTICA DO CD
ILHAS COOK CK
COSTA RICA CR
COSTA DO MARFIM CI
CROÁCIA HR
CUBA CU
CHIPRE CY
REPÚBLICA TCHECA CZ
D  
DINAMARCA DK
DJIBUTI DJ
DOMINICA DM
REPÚBLICA DOMINICANA DO
E  
EQUADOR EC
EGITO EG
EL SALVADOR SV
GUINÉ EQUATORIAL GQ
ERITRÉIA ER
ESTÔNIA EE
ETIÓPIA ET
F  
ILHAS FALKLAND (MALVINAS) FK
ILHAS FAROÉ FO
ILHAS FIJI FJ
FINLÂNDIA FI
FRANÇA FR
GUIANA FRANCESA GF
POLINÉSIA FRANCESA PF
TERRITÓRIOS FRANCESES DO SUL TF
G  
GABÃO GA
GÂMBIA GM
GEÓRGIA GE
ALEMANHA DE
GANA GH
GIBRALTAR GI
GRÉCIA GR
GROENLÂNDIA GL
GRANADA GD
GUADALUPE GP
GUAM GU
GUATEMALA GT
GUERNSEY GG
GUINÉ GN
GUINÉ-BISSAU GW
GUIANA GY
H  
HAITI HT
ILHAS HEARD E ILHAS MCDONALD HM
SANTA SÉ (ESTADO-CIDADE DO VATICANO) VA
HONDURAS HN
HONG KONG HK
HUNGRIA HU
I  
ISLÂNDIA IS
ÍNDIA IN
INDONÉSIA ID
IRÃ, REPÚBLICA ISLÂMICA DO IR
IRAQUE IQ
IRLANDA IE
ILHA DE MAN IM
ISRAEL IL
ITÁLIA IT
J  
JAMAICA JM
JAPÃO JP
JERSEY JE
JORDÂNIA JO
K  
CAZAQUISTÃO KZ
QUÊNIA KE
KIRIBATI KI
CORÉIA DO NORTE KP
CORÉIA DO SUL KR
KUWAIT KW
QUIRGUISTÃO KG
L  
LAOS, REPÚBLICA POPULAR DEMOCRÁTICA DO LA
LETÔNIA LV
LÍBANO LB
LESOTO LS
LIBÉRIA LR
LÍBIA LY
LIECHTENSTEIN LI
LITUÂNIA LT
LUXEMBURGO LU
M  
MACAU MO
MACEDÔNIA, ANTIGA REPÚBLICA IUGOSLAVA DA MK
MADAGASCAR MG
MALAUÍ MW
MALÁSIA MY
MALDIVAS MV
MALI ML
MALTA MT
ILHAS MARSHALL MH
MARTINICA MQ
MAURITÂNIA MR
MAURÍCIO MU
MAYOTTE YT
MÉXICO MX
MICRONÉSIA FM
MOLDÁVIA, REPÚBLICA DA MD
MÔNACO MC
MONGÓLIA MN
MONTENEGRO ME
MONTSERRAT MS
MARROCOS MA
MOÇAMBIQUE MZ
MIANMAR MM
N  
NAMÍBIA NA
NAURU NR
NEPAL NP
HOLANDA NL
ANTILHAS HOLANDESAS AN
NOVA CALEDÔNIA NC
NOVA ZELÂNDIA NZ
NICARÁGUA NI
NÍGER NE
NIGÉRIA NG
NIUE NU
ILHA NORFOLK NF
ILHAS MARIANAS DO NORTE MP
NORUEGA NO
O  
OMÃ OM
P  
PAQUISTÃO PK
PALAU PW
TERRITÓRIO PALESTINO OCUPADO PS
PANAMÁ PA
PAPUA NOVA GUINÉ PG
PARAGUAI PY
PERU PE
FILIPINAS PH
PITCAIRN PN
POLÔNIA PL
PORTUGAL PT
PORTO RICO PR
Q  
CATAR QA
R  
REUNIÃO RE
ROMÊNIA RO
FEDERAÇÃO RUSSA RU
RUANDA RW
S  
SAINT BARTHÉLEMY BL
SANTA HELENA SH
SÃO CRISTÓVÃO E NÉVIS KN
SANTA LÚCIA LC
SAINT MARTIN MF
SAINT-PIERRE E MIQUELON PM
SÃO VICENTE E GRANADINAS VC
SAMOA WS
SÃO MARINO SM
SÃO TOMÉ E PRÍNCIPE ST
ARÁBIA SAUDITA SA
SENEGAL SN
SÉRVIA RS
SEICHELLES SC
SERRA LEOA SL
CINGAPURA SG
ESLOVÁQUIA SK
ESLOVÊNIA SI
ILHAS SALOMÃO SB
SOMÁLIA SO
ÁFRICA DO SUL ZA
ILHAS GEÓRGIA DO SUL E SANDWICH DO SUL GS
ESPANHA ES
SRI LANKA LK
SUDÃO SD
SURINAME SR
SVALBARD E JAN MAYEN SJ
SUAZILÂNDIA SZ
SUÉCIA SE
SUÍÇA CH
SÍRIA, REPÚBLICA ÁRABE DA SY
T  
TAIWAN TW
TADJIQUISTÃO TJ
TANZÂNIA, REPÚBLICA UNIDA DA TZ
TAILÂNDIA TH
TIMOR-LESTE TL
TOGO TG
TOKELAU TK
TONGA TO
TRINIDAD E TOBAGO TT
TUNÍSIA TN
TURQUIA TR
TURCOMENISTÃO TM
ILHAS TURKS E CAICOS TC
TUVALU TV
U  
UGANDA UG
UCRÂNIA UA
EMIRADOS ÁRABES UNIDOS AE
REINO UNIDO GB
ESTADOS UNIDOS EUA
ILHAS MENORES DISTANTES DOS ESTADOS UNIDOS UM
URUGUAI UY
UZBEQUISTÃO UZ
V  
VANUATU VU
CIDADE-ESTADO DO VATICANO veja SANTA SÉ
VENEZUELA VE
VIETNÃ VN
ILHAS VIRGENS BRITÂNICAS VG
ILHAS VIRGENS AMERICANAS VI
W  
WALLIS E FUTUNA WF
SAARA OCIDENTAL EH
I  
IÊMEN YE
Z  
ZÂMBIA ZM
ZIMBÁBUE ZW

Voltar ao início

Códigos de estados dos EUA

A tabela a seguir lista o código de cada estado dentro dos Estados Unidos da América. Estes códigos são usados ao desenhar um mapa com área geográfica do tipo usa. Para obter mais informações, consulte Mapas neste documento.

AL Alabama LA Louisiana OH Ohio
AK Alaska ME Maine OK Oklahoma
AZ Arizona MD Maryland OR Oregon
AR Arkansas MA Massachusetts PA Pennsylvania
CA California MI Michigan RI Rhode Island
CO Colorado MN Minnesota SC S Carolina
CT Connecticut MS Mississippi SD S Dakota
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 New Mexico WV W Virginia
IA Iowa NY New York WI Wisconsin
KS Kansas NC N Carolina WY Wyoming
KY Kentucky ND N Dakota  

Voltar ao início