Publicado por: ccm em: Setembro 18, 2008
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=s:hW&chs=250x100&chl=Hello|World
Pressione a tecla Enter ou Return e pronto! Você deve ver a página abaixo:
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.
O uso da API do Google Chart está sujeito a um limite de 50.000 consultas por usuário por dia. Se você ultrapassar esse limite de 24 horas, a API do Google Chart pode parar de funcionar temporariamente. Seu acesso à API do Google Chart poderá ser bloqueado se você continuar abusando desse limite.
A API do Google Chart retorna uma imagem em formato PNG em resposta a um URL. É possível gerar diversos tipos de imagens: gráficos de linha, de barras e setores, por exemplo. 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:
View image ou Properties.Properties.Este documento descreve o formato necessário dos URLs da API do Google Chart e os parâmetros disponíveis.
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:
http://chart.apis.google.com/chart?
chs=200x125
&chd=s:helloWorld
&cht=lc
&chxt=x,y
&chxl=0:|Mar|Apr|May|June|July|1:||50+Kb
Onde:
http://chart.apis.google.com/chart? é a localização da API do Google Chart.& separa os parâmetros.chs=200x125 é o tamanho do gráfico em pixels.chd=s:helloWorld são os dados do gráfico.cht=lc é o tipo de gráfico.chxt=x,y indica que os rótulos dos eixos x e y são obrigatórios.chxl=0:|Mar|Apr|May|June|July|1:||50+Kb são os rótulos dos eixos x e y.Você pode estar pensando em como o helloWorld é mapeado em relação aos valores dos dados? Este é um exemplo de codificação simples, no qual os caracteres alfanuméricos são mapeados para valores que variam de 0 a 61. Não é necessário se preocupar com este mapeamento agora. Tudo será explicado mais adiante neste documento.
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=200x125
&chd=s:helloWorld
&cht=lc
&chxt=x,y
&chxl=0:|Mar|Apr|May|June|July|1:||50+Kb"
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 & no lugar de um E comercial (&).
É 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.
| Parâmetro | Gráfico de linhas | Diagrama de dispersão | Gráfico de barras | Diagrama de Venn | Gráfico de setores |
|---|---|---|---|---|---|
| Título do gráfico | Sim | Sim | Sim | Sim | Sim |
| Legenda do gráfico | Sim | Sim | Sim | Sim | |
| Cores | Sim | Sim | Sim | Sim | Sim |
| Preenchimento do gráfico e do fundo | Sim | Sim | Sim | Sim | Sim |
| Rótulos de diversos eixos | Sim | Sim | Sim | ||
| Linhas de grade | Sim | Sim | |||
| Marcadores de forma | Sim | Sim | |||
| Marcadores de intervalo horizontal | Sim | Sim | |||
| Marcadores de intervalo vertical | Sim | Sim | |||
| Estilos de linha | Sim | ||||
| Área de preenchimento | Sim | ||||
| Largura e espaçamento das barras | Sim | ||||
| Rótulos de gráficos de setores | Sim |
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 um gráfico é 300.000 pixels. Como a altura ou largura máxima é 1.000 pixels, alguns exemplos de tamanho máximo são 1000×300, 300×1000, 600×500, 500×600, 800×375 e 375×800.
Antes de criar um gráfico, é necessário codificar os dados em um formato compreendido pela API do Google Chart. Devido às restrições de comprimento de URL, em geral não é possível usar qualquer número. Em vez disso, seus dados reais devem ser mapeados para um dos formatos abaixo:
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. A codificação simples é adequada para todos os outros tipos de gráficos, não importando o tamanho. Este tipo de codificação gera o menor URL.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. Esta é a alternativa mais adequada para grandes gráficos com um intervalo de dados grande.Observação: 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.
Depois que você decidir que tipo de codificação usar, é necessário mapear os dados para se ajustarem ao intervalo disponível. Em seguida, traduza os números resultantes para a codificação apropriada. Por exemplo, para usar codificação simples, mapeie os dados para um intervalo de 0 a 61 e traduza os números resultantes para os caracteres alfanuméricos (A a Z, a a z e 0 a 9).
Seja qual for o tipo de codificação escolhida, no caso dos gráficos de linha, a API do Google Chart desenha pontos com valor zero na parte de baixo do gráfico, pontos com valor máximo (61, 100,0 ou 4095, dependendo do tipo de codificação) no alto e distribui todos os outros valores de maneira uniforme ao longo do eixo y.
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 (,).
Observação:
A = 0, B = 1 e assim por diante até Z = 25.a = 26, b = 27 e assim por diante até z = 51.0) = 52 e assim por diante até 9 = 61._).,).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.
Especifique a codificação de texto com
chd=t:<chart data string>
Onde <chart data string> consiste em números com ponto flutuante de zero (0.0) a 100.0, menos um (-1) e o caractere de barra vertical (|).
Observação:
0.0) = 0, 1.0 = 1 e assim por diante até 100.0 = 100.-1).|).Por exemplo: chd=t:10.0,58.0,95.0|30.0,8.0,63.0
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 (,).
Observação:
AA = 0, AZ = 25, Aa = 26, Az = 51, A0 = 52, A9 = 61, A- = 62, A. = 63BA = 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.__).,).Observação: Consulte Valores de caracteres de codificação estendida para obter instruções sobre como gerar uma lista completa.
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);
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):
40 pontos de dados (5 pixels por ponto de dados):
80 pontos de dados (somente 2,5 pixels por ponto de dados):
Estão disponíveis os tipos de gráficos abaixo:
Especifique um gráfico de linhas com
cht=<line chart type>
Onde <line chart type> é lc ou lxy, conforme descrito na tabela a seguir.
lc, são desenhadas diversas linhas para diversos conjuntos de dados.lxy, um par de conjuntos de dados é necessário para cada linha.| 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. | 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.
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 Especifique a forma do ponto de dados com o parâmetro Especifique as cores das linhas como descrito na seção Cores. |
cht=lxy |
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.
| Parâmetro | Descrição | Exemplo |
|---|---|---|
cht=bhs“>
|
Gráficos de barras horizontal e vertical, respectivamente.
Os diversos conjuntos de dados são empilhados. Portanto, você deve especificar uma cor para cada conjunto de dados, conforme descrito na seção Cores. |
cht=bhs
|
cht=bhg“>cht=bvg“> |
Gráficos de barras horizontal e vertical, respectivamente, nas cores especificadas. Os diversos conjuntos de dados estão agrupados. | cht=bhgcht=bvg |
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 Devido a isto, especifique a largura e espaçamento das barras com 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. |
skip> chbh omitidacht=bhs
|
Especifique um gráfico de setores com
cht=<pie chart type>
Onde <pie chart type> é p ou p3, conforme descrito na tabela a seguir.
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.
| 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 outras cores como descrito na seção Cores. Especifique os rótulos usando |
|
cht=p3 |
Gráfico de setores tridimensional.
Especifique os rótulos usando |
|
Especifique um diagrama de Venn com
cht=v
Forneça um conjunto de dados no qual:
| 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. |
cht=v |
Especifique um diagrama de dispersão com
cht=s
| 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 A cor padrão do ponto de dados é azul. Especifique outras cores como descrito na seção 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 |
cht=s |
Especifique uma cor usando uma cadeia de valores hexadecimais com pelo menos 6 letras no formato RRGGBB. Por exemplo:
FF0000 = vermelho00FF00 = verde0000FF = azul000000 = pretoFFFFFF = brancoComo opção, você pode especificar a transparência, anexando um valor entre 00 e FF, onde 00 é completamente transparente e FF completamente opaco. Por exemplo:
0000FFFF = azul sólido0000FF00 = azul transparenteEstão disponíveis as opções de cores abaixo:
Especifique as cores das linhas, barras, diagramas de Venn 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. |
|
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 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. |
|
|
| Aqui está o mesmo gráfico com três cores especificadas. |
|
|
| 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. |
|
|
| 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. | |
Especifique o preenchimento do fundo ou da área do gráfico com
chf=
<bg or c><type of fill>
Onde:
<bg or c> é bg para preenchimento de plano de fundo ou c para preenchimento da área do gráfico.<type of fill> é uma das opções abaixo:
|) separa as definições de preenchimento. Não é necessário um caractere de barra vertical no final de uma definição de preenchimento.Especifique o preenchimento sólido com
chf=
<bg or c>,s,<color>|
<bg or c>,s,<color>
Onde:
<bg or c> é bg para preenchimento de plano de fundo ou c para preenchimento da área do gráfico.<s> indica preenchimento sólido.<color> é um número hexadecimal em formato RRGGBB.|) separa as definições de preenchimento. Não é necessário um caractere de barra vertical após a segunda definição.| Parâmetro | Descrição | Exemplo |
|---|---|---|
chf |
Este exemplo preenche a imagem de plano de fundo com cinza claro (efefef). |
|
Este exemplo preenche o fundo com cinza claro (efefef) e a área do gráfico com preto (000000). Nos gráficos de linha e diagramas de dispersão, você pode especificar o preenchimento do fundo e da área do gráfico. |
|
|
| No caso dos gráficos de barra e setores e diagramas de Venn, somente o preenchimento do fundo está disponível. |
|
Especifique o gradiente linear 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 ( A segunda cor especificada é branco ( O fundo do gráfico é cinza ( |
|
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 ( A segunda cor especificada é azul ( O plano de fundo do gráfico é cinza ( |
|
|
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 ( A segunda cor especificada é branco ( O plano de fundo do gráfico é cinza ( |
|
Especifique as faixas lineares 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 A segunda cor especificada (branco As faixas são alternadas até preencher totalmente o gráfico. O plano de fundo do gráfico foi omitido. |
|
Área do gráfico com faixas horizontais especificadas com ângulo de noventa graus (90).
A primeira cor especificada (o cinza mais escuro A segunda e a terceira cores especificadas (o cinza mais claro As faixas são alternadas até preencher totalmente o gráfico. O plano de fundo do gráfico foi omitido. |
|
Estão disponíveis os tipos de rótulos abaixo:
Especifique um título de gráfico com
chtt=<chart title>
Especifique a legenda de um gráfico 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 na seção Cores.
Nestes exemplos, o primeiro conjunto de dados é vermelho, o segundo é verde e o terceiro é azul. |
chdl=First|Second|Third |
|
Especifique os rótulos com
chl=“>
<valor rótulo 1>|
...
<valor rótulo n>
Especifique um valor ausente com dois caracteres de barra vertical consecutivos (||).
| Parâmetro | Descrição | Exemplo |
|---|---|---|
chl |
Rótulos para um gráfico de setores tridimensional.
Observação: Para exibir rótulos: |
|
| É claro que isto depende do comprimento dos rótulos! Aqui, os rótulos são exibidos parcialmente, pois o gráfico não é largo o suficiente. |
|
|
| Para exibir completamente os rótulos, este gráfico precisa ter 280 pixels de largura. |
|
Os rótulos de diversos eixos estão disponíveis para gráficos de linhas, de barras e diagramas de dispersão:
Especifique diversos eixos com
chxt=
<axis 1>,
...
<axis n>
Os eixos disponíveis são:
x = eixo x inferiort = eixo x superiory = eixo y esquerdor = eixo y direitoOs 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 |
Este exemplo mostra 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).
Observação: Como os rótulos dos eixos foram omitidos, a API do Google Chart supõe um intervalo de 0 a 100 para todos os eixos. |
“>
|
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 |
Este exemplo mostra os eixos y esquerdo e direito (y e r), além de dois conjuntos de valores para o eixo x (x).
Observação: Não é necessário um caractere de barra vertical ( |
chxt=x,y,r,x |
O mesmo que acima, exceto pelos rótulos do eixo y esquerdo (y) não estarem especificados (o índice 1: não foi incluído no parâmetro chxl).
Observação: Não é necessário um caractere de barra vertical ( |
chxt=x,y,r,x(eixo y omitido) 2:|A|B|C| |
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 índice do eixo x (índice O eixo y esquerdo ( O eixo y direito ( |
“>chxt=x,y,r |
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. Observação: A direção do eixo y esquerdo ( |
chxt=x,y,r |
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. |
chxl=0:|200|300|400 |
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. | |
| O tamanho da fonte, cor e alinhamento são especificados para ambos os eixos x. | chxt=x,y,r,x |
Estão disponíveis os estilos abaixo:
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. |
cht=bhg
|
Especifique os estilos do gráfico de linhas 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. |
chls=3,6,3|1,1,0 |
Especifique uma grade para gráficos de linha 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. |
chg=20,50 |
Aqui, o tamanho do passo (20,50), o segmento de linha (1) e o segmento em branco (5) foram definidos. |
|
|
Especifique segmento em branco zero (0) para obter uma grade sólida. |
chg=20,50,1,0 |
Somente nos gráficos de linha e diagramas de dispersão, especifique a forma dos marcadores para os pontos e os marcadores de intervalo horizontal e vertical, usando chm.
Especifique os marcadores de forma para os pontos dos gráficos de linha e diagramas de dispersão com:
chm=
<marker type>,<color>,<data set index>,<data point>,<size>|
...
<marker type>,<color>,<data set index>,<data point>,<size>
Onde:
<marker type> é um dos caracteres abaixo:a representa uma seta.c representa uma cruz.d representa um losango.o representa um círculo.s representa um quadrado.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. Este valor é 1 para o primeiro conjunto de dados, 2 para o segundo e assim por diante. Especifique uma fração para interpolar um marcador entre dois pontos.<size> é o tamanho do marcador em pixels.Separe os diversos marcadores usando caracteres de barra vertical (|).
| Parâmetro | Descrição | Exemplo |
|---|---|---|
chm
|
Aqui está um exemplo do conjunto completo de marcadores.
O último marcador da lista, |
x,FFCC33,0,8.0,20.0|h,3399CC,0,7.0,1.0 |
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. |
chm=
|
|
| 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.
|
chm= |
Para os gráficos de linhas 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:0.00 é a parte inferior e 1.00 é a parte superior.0.00 é a esquerda e 1.00 é a direita.<end point> para:0.00 é a parte inferior e 1.00 é a parte superior.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). |
r,E5ECF9,0,0.75,0.25| |
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). |
R,ff0000,0,0.1,0.11| |
chm= |
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. | R,ff0000,0,0.1,0.11||r,E5ECF9,0,0.75,0.25| |
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 ( Para preencher da última linha até a parte inferior do gráfico, inclua um conjunto de dados apenas com o menor valor de dados ( As linhas são desenhadas em preto, usando
|
chd=s:99,QSSVXXdkfZUMRTUQ,HJJMOOUbVPKDHKLH,AA
|
Como contraste, o primeiro e o último conjuntos de dados (99 e AA) foram removidos deste gráfico.
Além disso, |
chd=s:cefhjkqwrlgYcfgc,QSSVXXdkfZUMRTUQ,HJJMOOUbVPKDHKLH,
|
|
chm=B |
Para uma única série de dados, é mais simples usar chm=B. Neste caso, toda a área sob a linha é preenchida. |
chm=B,76A4FB,0,0,0 |
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 |
É 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:
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 (.).Para ler a tabela, encontre primeiro a coluna e depois a linha. Por exemplo:
7 = AH133 = CF3975 = -H4037 = .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 |