Este documento descreve como criar um gráfico do tipo mostrador chamado Googleômetro.
Sumário
Recursos específicos para gráficos
|
Recursos padrão
|
Visão geral
O Googleômetro é um medidor que aponta para um único valor em um intervalo.
O intervalo possui uma gradação de cor que você tem a opção de configurar. Também é possível especificar um texto personalizado acima do ponteiro. O intervalo do mostrador vai do valor mínimo ao valor máximo do formato de dados. Especifique um valor de dados no parâmetro chd
para que a seta aponte.
Você pode especificar várias setas no mesmo gráfico e estilizar o corpo da seta e o tamanho do ponto de forma diferente para cada uma. Se você quiser o mesmo estilo para todas as setas, especifique os pontos de dados como valores da mesma série. Se você quiser aplicar estilos diferentes para cada seta, agrupe todas as setas com o mesmo estilo na mesma série.
Especifique um gráfico Googleômetro com a seguinte sintaxe:
Sintaxe
cht=gom
Exemplos
Descrição | Exemplo |
---|---|
Isso demonstra o uso do |
|
Você pode especificar diversos ponteiros com vários pontos de dados. | chd=t:20,40,60 |
Para aplicar um estilo às setas, use o parâmetro
Vamos analisar o valor de
|
chd=t:20,40|60 |
Cores da série chco
Também é possível especificar as cores do mostrador usando o parâmetro chco
.
Se não especificar, será usado um gradiente padrão.
Sintaxe
chco=<color_1>,...,<color_n>
- <color>
- Especifique duas ou mais cores no formato hexadecimal RRGGBB. As cores são aplicadas em um gradiente da esquerda para a direita, com a primeira cor à esquerda e a última à direita.
Descrição | Exemplo |
---|---|
Este gráfico mostra um gradiente simples, de branco (FFFFFF) a preto (000000). | chco=FFFFFF,000000 |
Este gráfico mostra as diversas cores atribuídas para o mostrador. | chco=FF0000,FF8040,FFFF00, |
Rótulos do Googleômetro chl
Você tem a opção de especificar um rótulo personalizado para ser exibido acima da seta.
Observação sobre valores de string:são permitidos somente caracteres seguros para URL nas strings de rótulo. Por questões de segurança, codifique para uso
em URL todas as strings que contenham caracteres que não façam parte do conjunto de caracteres 0-9a-zA-Z
.
Veja um codificador de URL aqui.
Sintaxe
chl=<label>
- <rótulo>
- Texto do rótulo.
Exemplo
Descrição | Exemplo |
---|---|
Veja um exemplo de Googleômetro com rótulo. |
|
Recursos padrão
Os demais recursos nesta página são recursos de gráficos padrão.
Especifique cores usando uma string de valores hexadecimais de seis caracteres, mais dois valores de transparência opcionais, no formato RRGGBB[AA]
.
Exemplo:
FF0000
= vermelho00FF00
= verde0000FF
= azul000000
= pretoFFFFFF
= branco
AA
é um valor de transparência opcional, em que 00
é completamente transparente, e FF
é completamente opaco. Exemplo:
0000FFFF
= azul contínuo0000FF66
= azul transparente
Título do gráfico chtt
, chts
[Todos os
gráficos]
É possível especificar o texto, a cor e o tamanho da fonte do título de um gráfico.
Sintaxe
chtt=<chart_title> chts=<color>,<font_size>,<opt_alignment>
chtt
: especifica o título do gráfico.
- <chart_title>
- Título a ser exibido no gráfico. Não é possível especificar onde ele aparece, mas
é possível definir o tamanho e a cor da fonte. Use um sinal de + para indicar espaços e uma barra vertical (
|
) para indicar quebras de linha.
chts
[opcional]: cores e tamanho da fonte para o parâmetro chtt
.
- <color>
- A cor do título, no formato hexadecimal RRGGBB. A cor padrão é preto.
- <font_size>
- Tamanho da fonte do título, em pontos.
- <opt_alignment>
- [Opcional] Alinhamento do título. Escolha um dos seguintes valores de string, diferenciando maiúsculas de minúsculas: "l" (esquerda), "c" (centralizado) "r" (direita). O padrão é "c".
Exemplos
Descrição | Exemplo |
---|---|
Gráfico com título, que usa a cor e o tamanho da fonte padrão. Especifique um espaço com um sinal de adição ( Use uma barra vertical (
|
chtt=Site+visitors+by+month| |
Gráfico com título azul, alinhado à direita e de 20 pontos. |
chtt=Site+visitors |
Texto e estilo da legenda do gráfico chdl
, chdlp
, chdls
[Todos os gráficos]
A legenda é uma seção lateral do gráfico que fornece uma pequena descrição textual de cada série. Você pode especificar o texto associado a cada série nessa legenda e especificar onde ela deve aparecer no gráfico.
Consulte também chma
para aprender a definir as margens ao redor da legenda.
Observação sobre os valores de string:somente caracteres seguros de URL são permitidos nas strings de rótulo. Por questões de segurança, codifique para uso
em URL todas as strings que contenham caracteres que não façam parte do conjunto de caracteres 0-9a-zA-Z
.
Você encontra um codificador de URL na documentação de visualização do Google.
Sintaxe
chdl=<data_series_1_label>|...|<data_series_n_label> chdlp=<opt_position>|<opt_label_order> chdls=<color>,<size>
chdl
: o texto de cada série a ser exibido na legenda.
- <data_series_label>
- O texto das entradas de legenda. Cada rótulo se aplica à série correspondente
na matriz
chd
. Use um sinal de adição (+) no espaço. Se você não especificar esse parâmetro, o gráfico não receberá uma legenda. Não há como especificar uma quebra de linha em um rótulo. A legenda normalmente se expande para conter o texto da legenda, e a área do gráfico será reduzida para acomodar a legenda.
chdlp
: [opcional] a posição da
legenda e a ordem das entradas de legenda. É possível especificar <position> e/ou <label_order>. Se você especificar ambos, separe-os com um caractere de barra. Adicione um "s" a qualquer valor se quiser que entradas de legenda vazias em chdl
sejam ignoradas na legenda. Exemplos: chdlp=bv
, chdlp=r
, chdlp=bv|r
e chdlp=bvs|r
.
- <opt_position>
- [Opcional] Especifica a posição da legenda no gráfico. Para especificar mais padding entre a legenda e a área do gráfico ou a borda da imagem, use o parâmetro
chma
. Escolha um destes valores:b
: legenda na parte inferior do gráfico, entradas de legenda em uma linha horizontal.bv
: legenda na parte inferior do gráfico, entradas de legenda em uma coluna vertical.t
: legenda na parte superior do gráfico, entradas de legenda em uma linha horizontal.tv
: legenda na parte superior do gráfico, entradas de legenda em uma coluna vertical.r
- [Padrão] legenda à direita do gráfico, entradas de legenda em uma coluna vertical.l
: legenda à esquerda do gráfico, entradas de legenda em uma coluna vertical.
- <opt_label_order>
- [opcional]
A ordem em que os rótulos são mostrados na legenda.
Escolha um destes valores:
l
- [Padrão para legendas verticais] Exibe rótulos na ordem informada parachdl
.r
: mostra rótulos na ordem inversa, conforme fornecido parachdl
. Isso é útil em gráficos de barras empilhadas para mostrar a legenda
na mesma ordem em que as barras aparecem.a
- [Padrão para legendas horizontais] Ordem automática: aproximadamente, significa classificar por comprimento, mais curto primeiro, conforme medido em blocos de 10 pixels. Quando dois elementos tiverem o mesmo comprimento (divididos em blocos de 10 pixels), o que estiver listado primeiro aparecerá primeiro.0,1,2...
: ordem dos rótulos personalizados. Esta é uma lista de índices de rótulos baseados em zero dochdl
, separados por vírgulas.
chdls
: [opcional] especifica a cor e o tamanho da fonte do texto da legenda.
- <color>
- A cor do texto da legenda, no formato hexadecimal RRGGBB.
- <size>
- O tamanho do ponto do texto da legenda.
Exemplos
Descrição | Exemplo |
---|---|
Dois exemplos de legendas. Especifique o texto da legenda na mesma ordem que sua série de dados. |
chdl=NASDAQ|FTSE100|DOW
chdl=First|Second|Third |
O primeiro gráfico demonstra entradas de legenda horizontais ( |
|
Este exemplo demonstra a mudança do tamanho da fonte. |
|
Margens do gráfico chma
[Todos os gráficos]
Você pode especificar o tamanho das margens do gráfico em pixels. As margens são calculadas
internamente a partir do tamanho especificado do gráfico (chs
). Aumentar o tamanho
da margem não aumenta o tamanho total do gráfico, mas reduz a área do gráfico,
se necessário.
As margens são, por padrão, o espaço que sobra depois que o tamanho do gráfico é calculado. Seu valor padrão varia de acordo com o tipo de gráfico. As margens especificadas são um valor mínimo. Se a área do gráfico deixar espaço para margens, o tamanho delas será o que sobrar. Você não pode apertar as margens menores do que o necessário para legendas e rótulos. Veja um diagrama que mostra as partes básicas de um gráfico:
As margens do gráfico incluem os rótulos do eixo e a área da legenda. A área da legenda é redimensionada automaticamente para ajustar o texto exatamente, a menos que você especifique uma largura maior usando Dica:em um gráfico de barras, se as barras tiverem um tamanho fixo (o padrão), a largura da área do gráfico não poderá ser reduzida. Especifique um tamanho de barra menor ou redimensionável
usando |
Sintaxe
chma= <left_margin>,<right_margin>,<top_margin>,<bottom_margin>|<opt_legend_width>,<opt_legend_height>
- <left_margin>, <right_margin>, <top_margin>, <bottom_margin>
- Tamanho mínimo da margem ao redor da área do gráfico, em pixels. Aumente esse valor para incluir padding para evitar que os rótulos dos eixos encostem nas bordas do gráfico.
- <opt_legend_width>, <opt_legend_height>
- [Opcional] Largura da margem ao redor da legenda, em pixels. Use esse método para evitar que a legenda fique perto da área do gráfico ou das bordas da imagem.
Exemplos
Descrição | Exemplo |
---|---|
Nesse exemplo, o gráfico tem uma margem mínima de 30 pixels em cada lado. Como a legenda do gráfico tem mais de 30 pixels de largura, a margem do lado direito é definida como a largura da legenda do gráfico e é diferente das outras margens. Os rótulos dos eixos estão fora da área do gráfico e, portanto, são desenhados no espaço da margem. |
|
Para adicionar uma margem ao redor da legenda, defina um valor para os parâmetros Neste exemplo, a legenda tem largura de aproximadamente 60 pixels. Se você definir |
|
Estilos e rótulos de eixos [linhas, barras, Googleômetro, radar, dispersão]
Você pode especificar quais eixos exibir no gráfico e atribuir rótulos, posições, intervalos e estilos personalizados.
Nem todos os gráficos exibem linhas de eixos por padrão. Você pode especificar exatamente quais eixos seu gráfico deve exibir usando o parâmetro chxt
. As linhas de eixo padrão não mostram números. É necessário especificar um eixo no parâmetro chxt
para que os números sejam exibidos.
Os eixos podem exibir números que refletem os valores de dados ou especificar eixos personalizados.
O padrão é exibir valores numéricos, com valores dimensionados para um intervalo de 0 a 100.
No entanto, é possível alterar esse intervalo usando chxr
para exibir qualquer intervalo, e você pode definir o estilo dos valores (por exemplo, para mostrar símbolos de moeda ou casas decimais) usando chxs
.
Se você optar por usar valores personalizados, como "Seg, Ter, Qua", poderá usar o parâmetro chxl
.
Para colocar esses rótulos em locais específicos do eixo, use o parâmetro chxp
.
Por fim, use os parâmetros chxs
e chxtc
para especificar cor, tamanho, alinhamento e outras propriedades de rótulos de eixos personalizados e numéricos.
Observação sobre os valores de string:somente caracteres seguros de URL são permitidos nas strings de rótulo. Por questões de segurança, codifique para uso
em URL todas as strings que contenham caracteres que não façam parte do conjunto de caracteres 0-9a-zA-Z
.
Você encontra um codificador de URL na documentação de visualização do Google.
Esta seção aborda os seguintes tópicos:
- Eixos visíveis (
chxt
): quais eixos exibir. - Intervalo do eixo (
chxr
): intervalo de valores para cada eixo. - Rótulos de eixos personalizados (
chxl
): valores personalizados a serem exibidos no eixo. - Posições dos rótulos dos eixos (
chxp
): colocam os rótulos personalizados ao longo de cada eixo. - Estilos dos rótulos dos eixos (
chxs
): cor, tamanho, alinhamento e formatação dos rótulos dos eixos. - Estilos de marcação do eixo (
chxtc
): tamanho das marcas de seleção para um eixo específico.
Eixos visíveis chxt
Os gráficos de barras, linhas, radar e dispersão mostram uma ou duas linhas de eixo por padrão, mas elas não incluem valores.
Para exibir valores nas linhas de eixo ou para alterar quais eixos são exibidos, você precisa
usar o parâmetro chxt
.
Por padrão, os valores dos eixos variam de 0 a 100, a menos que você os dimensione explicitamente
usando a propriedade chxr
. Para ocultar todas as linhas dos eixos em um gráfico de linhas, especifique :nda
depois do valor do tipo de gráfico no parâmetro cht
(por exemplo: cht=lc:nda
).
Por padrão, os eixos superior e inferior não exibem marcas de seleção pelos valores, enquanto os eixos esquerdo e direito as exibem. É possível mudar esse comportamento usando o parâmetro chxs
.
Sintaxe
chxt= <axis_1> ,..., <axis_n>
- <axis>
- Um eixo a ser exibido no gráfico. Os eixos
disponíveis são:
x
: Eixo x de baixot
: eixo X superior [não compatível com o Google-Meter]y
: eixo y à esquerdar
: eixo y à direita [não compatível com o Google-o-Meter]
É possível especificar vários eixos do mesmo tipo,
por exemplo: cht=x,x,y
. Com isso, dois conjuntos de eixos x serão empilhados na parte inferior do gráfico. Isso é útil ao adicionar rótulos personalizados ao longo de um eixo que mostra valores numéricos (veja o exemplo abaixo). Os eixos são desenhados de dentro para fora. Portanto, se você tiver x,x
, o primeiro x vai se referir à cópia mais interna, o próximo x vai se referir à próxima cópia externa e assim por diante.
Exemplos
Descrição | Exemplo |
---|---|
Este exemplo mostra um gráfico de linhas com um eixo x, um eixo y, um eixo superior (t) e um eixo direito (r). Como nenhum rótulo é especificado, o gráfico assume um intervalo de 0 a 100 para todos os eixos. Por padrão, os eixos superior e inferior não mostram marcas de seleção ao lado dos rótulos. |
|
Você pode incluir vários conjuntos de rótulos para cada eixo incluindo
o mesmo valor mais de uma vez. Este exemplo mostra dois conjuntos de eixos x e dois conjuntos de eixos y. Isso não é particularmente útil ao usar apenas os rótulos de eixo padrão, como mostrado aqui. Mas é possível especificar rótulos personalizados para cada cópia
de cada eixo, usando o parâmetro chxl . |
<img <code="" dir="ltr" src="/static/chart/image/images/chart_41.png" title="chxt=x,x,y,y&cht=lc&chd=s:cEAELFJHHHKUju9uuXUc&chco=76A4FB&chls=2.0&chs=200x125,translateyx125 <img <code="" dir="ltr" src="/static/chart/image/images/chart_42.png" title="chxt=x,x,y,y&cht=lc&chd=s:cEAELFJHHUju9uuXUc&chco=76A4FB&chls=2.0&chs=200x125 |
Este exemplo mostra um gráfico de barras horizontais com um eixo x, um eixo y, um eixo t superior e um eixo r direito. Os rótulos dos eixos são omitidos. Portanto, a API Chart exibe um intervalo de 0 a 100 para os eixos x e t. O intervalo para o eixo y e o eixo r é determinado pelo número de barras. Nesse caso, há cinco barras, então a API Chart exibe um intervalo de 0 a 4. O primeiro rótulo é centralizado na base da primeira barra, o segundo é centralizado na base da segunda barra e assim por diante. |
|
Você pode suprimir os eixos padrão em um gráfico de linhas especificando :nda depois do tipo de gráfico. |
cht=lc:nda |
Intervalo do eixo chxr
Você pode especificar o intervalo de valores que aparecem em cada eixo de maneira independente, usando o parâmetro chxr. Isso não altera a escala dos elementos do gráfico, apenas a escala dos rótulos dos eixos. Para que os números dos eixos descrevam os valores reais dos dados, defina <start_val> e <end_val> como os valores máximo e mínimo do intervalo do formato de dados, respectivamente. Consulte Escalonamento de eixos para mais informações.
Se você quiser especificar o intervalo de um eixo, torne-o visível usando o parâmetro chxt
.
Para especificar valores de eixo personalizados, use o parâmetro chxl
.
Sintaxe
Separe vários intervalos de rótulos dos eixos usando
o caractere de barra vertical ( |
).
chxr= <axis_index>,<start_val>,<end_val>,<opt_step> |...| <axis_index>,<start_val>,<end_val>,<opt_step>
- <índice_do_eixo>
- Em qual eixo aplicar os rótulos. Esse
é um índice baseado em zero na matriz de eixo especificada por
chxt
. Por exemplo, o eixo r seria 1 emchxt=x,r,y
. - <start_val>
- Um número, que define o valor mínimo do eixo.
- <end_val>
- Um número, que define o valor mais alto do eixo.
- <opt_step>
- [Opcional] É a contagem entre as marcações no eixo. Não há valor padrão. A etapa é calculada para tentar mostrar um conjunto de rótulos bem espaçados.
Exemplos
Descrição | Exemplo |
---|---|
Este exemplo mostra os eixos y à esquerda e à direita ( Cada eixo possui um intervalo definido. Como nenhum rótulo ou posição é especificado, os valores são retirados do intervalo especificado e são espaçados uniformemente dentro desse intervalo. No gráfico de linhas, os valores são uniformemente distribuídos ao longo do eixo x. A direção do eixo r é invertida para o eixo r (índice |
|
Neste exemplo, são especificados valores para o eixo x. Os rótulos dos eixos são espaçados uniformemente ao longo dos eixos. Um valor cinco ( |
|
Rótulos de eixos personalizados chxl
Você pode especificar rótulos personalizados para qualquer eixo usando o parâmetro chxl
. Você pode especificar quantos rótulos quiser. Se você exibir um eixo (usando o parâmetro chxt
) e não especificar rótulos personalizados, os rótulos numéricos padrão serão aplicados.
Para especificar um intervalo numérico personalizado, use o parâmetro chxr
.
Para definir locais específicos ao longo do eixo para os rótulos, use o parâmetro chxp
.
Sintaxe
Especifique um parâmetro definido para cada eixo a ser rotulado. Separe vários conjuntos de rótulos usando o caractere de barra vertical
(|
).
chxl= <axis_index>:|<label_1>|...|<label_n> |...| <axis_index>:|<label_1>|...|<label_n>
- <índice_do_eixo>
- Em que eixo aplicar rótulos. Esse
é um índice na matriz de parâmetros
chxt
. Por exemplo, parachxt=x,x,y,y
, o índice 0 é o primeiro eixo x e 1 é o segundo. - <label_1>| ... |<label_n>
- Um ou mais rótulos a serem colocados ao longo desse
eixo. Podem ser valores de string ou numéricos, e as strings não precisam estar entre aspas. label_1 é exibido na posição mais baixa do eixo, e label_n é exibido na posição mais alta. Os outros rótulos são espaçados uniformemente entre eles.
Indique os espaços com um sinal de +. Não há como especificar uma quebra de linha em um rótulo. Separe os rótulos com uma barra vertical. Observação : não
coloque uma barra vertical depois do rótulo final no parâmetro
chxl
.
Exemplos
Descrição | Exemplo |
---|---|
Este gráfico mostra como adicionar rótulos personalizados aos dois eixos. Observe como os valores são espaçados uniformemente e como o último valor |
chxt=x,y |
Este exemplo inclui rótulos nos eixos y à esquerda e à direita ( |
|
Este exemplo inclui rótulos nos eixos y esquerdo e direito
( Este exemplo usa valores padrão para os rótulos do eixo y da esquerda. |
|
Se você quiser adicionar um rótulo genérico para descrever um eixo
inteiro (por exemplo, para rotular um eixo
como "custo" e outro "estudante"), use a propriedade |
chxt=x,x,y,y |
Posições dos rótulos dos eixos chxp
Você pode especificar quais rótulos de eixos serão exibidos, usando os rótulos padrão ou personalizados especificados com chxl
. Se você não especificar posições exatas usando esse parâmetro, os rótulos serão espaçados uniformemente e com um valor de taxa padrão ao longo dos eixos. Se você não especificar chxl
, os rótulos das marcas de seleção serão os valores padrão (geralmente valores de dados ou números de barras em gráficos de barras).
Sintaxe
Separe vários conjuntos de posicionamento usando o caractere de barra vertical (|
).
chxp= <axis_1_index>,<label_1_position>,...,<label_n_position> |...| <axis_m_index>,<label_1_position>,...,<label_n_position>
- <índice_do_eixo>
- O eixo para as quais
as posições são especificadas. É um índice na matriz de parâmetros
chxt
. Por exemplo, parachxt=x,x,y,y
, o índice 0 é o primeiro eixo x, 1 é o segundo e assim por diante. - <label_1_position>,...,<label_n_position>
- A posição do rótulo ao longo do eixo. Essa é uma lista de valores numéricos separados por vírgulas, em que cada valor define a posição do rótulo correspondente na matriz
chxl
: a primeira entrada se aplica ao primeiro rótulo e assim por diante. A posição é um valor no intervalo do eixo. O valor sempre vai ser de 0 a 100, a menos que você tenha especificado um intervalo personalizado usandochxr
. O número de posições precisa ser igual ao número de rótulos do eixo.
Exemplos
Descrição | Exemplo |
---|---|
Este exemplo inclui rótulos para o eixo r em posições especificadas no gráfico. O texto do rótulo é especificado usando o parâmetro Os rótulos com uma posição especificada de Os rótulos com uma posição especificada de |
|
Neste exemplo, mostramos os valores de rótulo padrão, mas apenas em locais especificados.
|
chxt=x,y
chxt=x,y chxp não especificado |
Estilos dos rótulos dos eixos chxs
Você pode especificar o tamanho, a cor e o alinhamento da fonte dos rótulos de eixo, tanto os rótulos personalizados quanto os valores padrão. Todos os rótulos no mesmo eixo têm o mesmo formato. Se um eixo tem várias cópias, é possível formatar cada uma de maneira diferente. Também é possível especificar o formato de uma string de rótulo, por exemplo, para mostrar símbolos de moeda ou zeros à direita.
Por padrão, os eixos superior e inferior não exibem marcas de seleção pelos valores, enquanto os eixos esquerdo e direito as exibem.
Sintaxe
Os valores de eixos diferentes devem ser separados
por uma barra vertical (|
).
chxs= <axis_index><opt_format_string>,<opt_label_color>,<opt_font_size>,<opt_alignment>,<opt_axis_or_tick>,<opt_tick_color>,<opt_axis_color> |...| <axis_index><opt_format_string>,<opt_label_color>,<opt_font_size>,<opt_alignment>,<opt_axis_or_tick>,<opt_tick_color>,<opt_axis_color>
- <axis_index>
- O eixo a que isso se aplica. Esse
é um índice baseado em zero para o parâmetro
chxt
. - <opt_format_string>
- [Opcional] Esta é uma string de formato opcional que, se usada, fica logo após o número de índice do eixo, sem uma vírgula intermediária. Ela começa
com uma letra N, seguida pelos
seguintes valores, todos opcionais:
N<preceding_text>*<number_type><decimal_places>zs<x or y>*<following_text>
Veja o significado de cada elemento:<preceding_text>
: texto literal antes de cada valor.*...*
: um bloco opcional entre asteriscos literais, em que você pode especificar detalhes de formatação para números. Os valores a seguir são aceitos e são opcionais:<number_type>
: o formato de número, para valores numéricos. Escolha uma das seguintes opções:f
: [padrão] formato de ponto flutuante. Especifique também a precisão com o valor <decimal_places>.p
: formato de porcentagem. O sinal de % é acrescentado automaticamente. Observação:ao usar esse formato, os valores de dados de 0,0 a 1,0 são mapeados para 0 a 100%. Por exemplo, 0,43 será mostrado como 43%.e
: formato de notação científica.c<CUR>
: formata o número na moeda especificada com o marcador de moeda apropriado. Substitua<CUR>
por um código de moeda de três letras. Exemplo:cEUR
para euros. Você pode encontrar uma lista de códigos no site da ISO, embora nem todos os símbolos sejam compatíveis.
<decimal_places>
: um número inteiro que especifica quantas casas decimais devem ser exibidas. O valor é arredondado (não truncado) para esse comprimento. O padrão é 2.z
: mostra zeros à direita. O padrão é não.s
: exibe separadores de grupos. O padrão é não.x
ouy
: mostra os dados da coordenada x ou y, conforme especificado. O significado dos dados x varia de acordo com o tipo de gráfico: experimente com o gráfico para determinar o que significa. O padrão é "y".
<following_text>
: texto literal a ser seguido de cada valor.
- <opt_label_color>
- A cor a ser aplicada ao texto do eixo (mas não à linha do eixo), no formato hexadecimal RRGGBB. A cor da linha do eixo é especificada separadamente usando opt_axis_color. O padrão é cinza.
- <opt_font_size>
- [Opcional] especifica o tamanho da fonte em pixels. Este parâmetro é opcional.
- <opt_alignment>
- [Opcional] Alinhamento do rótulo. Para os eixos superior ou inferior, isso descreve como o rótulo se alinha à marca de seleção acima ou abaixo dele. Para os eixos esquerdo ou direito, isso descreve como o alinhamento é dentro da caixa delimitadora, que toca no eixo. Especifique um destes números:
-1
: superior ou inferior: as etiquetas ficam à direita das marcas. Esquerda ou direita: as etiquetas são alinhadas à esquerda na área. Padrão para rótulos do eixo r.0
: superior ou inferior: os rótulos são centralizados nas marcações. Esquerda ou direita: os rótulos são centralizados na área. Padrão para rótulos dos eixos x e t.1
: superior ou inferior: as etiquetas ficam à esquerda das marcas. Esquerda ou direita: as etiquetas são alinhadas à direita na área. Padrão para rótulos do eixo y.
- <opt_axis_or_tick>
- [Opcional; não compatível com o Googleômetro] Define se marcas de seleção e/ou linhas de eixo serão exibidas no eixo. As marcas de seleção e as linhas de eixo só
estão disponíveis para os eixos mais internos (por exemplo, não são aceitas para
dois eixos x externos). Use um destes valores:
l
("L" minúsculo): desenha apenas a linha do eixo.t
: desenhe apenas as marcas de seleção. As marcas de seleção são as pequenas linhas ao lado dos rótulos dos eixos.lt
: [Padrão] desenhe uma linha do eixo e marcas de seleção para todos os rótulos._
: (Sublinhado) não desenha a linha do eixo nem marcas de seleção. Se quiser ocultar uma linha de eixo, use este valor.
- <tick_color>
- [Opcional; não compatível com o Googleômetro] A cor da marca de seleção, no formato hexadecimal RRGGBB. O padrão é cinza.
- <opt_axis_color>
- [Opcional] A cor dessa linha do eixo, no formato hexadecimal RRGGBB. O padrão é cinza.
Exemplos
Descrição | Exemplo |
---|---|
O tamanho e a cor da fonte são especificados para o segundo eixo x (janeiro, fevereiro, março). |
|
O tamanho da fonte, a cor e o alinhamento são especificados para o eixo y da direita. Esse eixo possui marcas de escala, mas não a linha de eixo. |
|
Este gráfico inclui três conjuntos de dados e mostra três conjuntos de rótulos de eixo, um por série. Cada conjunto de rótulos é formatado usando uma string de formatação personalizada, conforme descrito abaixo:
Os intervalos dos rótulos dos eixos são definidos usando o parâmetro |
chd=s: |
Estilos das marcas de seleção dos eixos chxtc
Você pode especificar marcas de escala longas para eixos específicos. Normalmente, isso é usado para estender uma marca de seleção ao longo do comprimento de um gráfico. Use o parâmetro chxs
para
mudar a cor da marcação.
Os valores de vários eixos devem ser separados
por uma barra vertical (|
). Os valores de uma série precisam ser separados
por uma vírgula.
Sintaxe
chxtc= <axis_index_1>,<tick_length_1>,...,<tick_length_n> |...| <axis_index_m>,<tick_length_1>,...,<tick_length_n>
- <axis_index>
- O eixo a que isso se aplica. Esse é um índice baseado em zero para o parâmetro
chxt
. Separe os valores para eixos diferentes usando um delimitador de barra. - <tick_length_1>,...,<tick_length_n>
- Comprimento das marcas de seleção no eixo, em pixels. Se um único valor for informado, ele vai ser aplicado a todos os valores. Se mais de um valor for informado, as marcas do eixo vão percorrer a lista de valores do eixo em questão. Os valores positivos são desenhados para fora da área do gráfico e cortados pelas bordas do gráfico. O valor positivo máximo é 25. Valores negativos são desenhados para dentro da área do gráfico e cortados pelas bordas da área do gráfico.
Exemplos
Descrição | Exemplo |
---|---|
Exemplo de como usar
|
|
Este gráfico demonstra como alternar o comprimento das marcas de escala. chxtc especifica dois valores de comprimento de marcação para o eixo y (5 e 15), e as marcas desenhadas no gráfico alternam entre os dois valores. |
chxt=x,y |
Estilos de linha chls
[linha, radar]
Você pode especificar a espessura da linha e o estilo sólida/pontilhada com o parâmetro chls
. Esse parâmetro só pode ser usado para estilizar linhas em gráficos de linhas ou de radar. Ele não pode ser usado para estilizar as linhas de um gráfico composto, a menos que o tipo base do gráfico seja de linhas.
Sintaxe
Separe vários estilos de linha com o caractere de
barra vertical ( |
). O primeiro estilo se aplica à primeira linha, o
segundo à próxima e assim por diante. Se você tiver menos estilos que linhas, o estilo padrão será aplicado a todas as linhas não especificadas.
chls= <line_1_thickness>,<opt_dash_length>,<opt_space_length> |...| <line_n_thickness>,<opt_dash_length>,<opt_space_length>
- <line_1_thickness>
- Espessura da linha, em pixels.
- <opt_dash_length>, <opt_space_length>
- [Opcional] Usado para definir linhas de grade tracejadas. O primeiro parâmetro é o comprimento de cada traço da linha de grade, em pixels. O segundo parâmetro é o espaçamento entre os traços, em pixels. Para uma linha sólida, não especifique nenhum valor. Se você especificar somente <opt_dash_length>, <opt_space_length> será definido como <opt_dash_length>. O padrão é 1,0 (uma linha sólida).
Exemplos
Descrição | Exemplo |
---|---|
Aqui, a linha tracejada é especificada por |
chls=3,6,3|5 |
Preenchimento de plano de fundo chf
[Todos os
gráficos]
Você pode especificar cores e estilos de preenchimento para a área de dados do gráfico e/ou para todo o plano de fundo do gráfico. Os tipos de preenchimento incluem uniforme, listrado e gradiente.
É possível especificar diferentes preenchimentos para diferentes áreas (por exemplo, toda a área do gráfico ou apenas a área de dados). O preenchimento da área do gráfico
substitui o preenchimento do plano de fundo. Todos os preenchimentos são especificados usando o parâmetro chf
, e você pode misturar diferentes tipos de preenchimento (sólidos, listras, gradientes) no mesmo gráfico, separando valores com barra vertical ( | ). Os preenchimentos da área do gráfico substituem os preenchimentos do plano de fundo do gráfico.
Preenchimento sólido chf
[Todos os
gráficos]
Especifique um preenchimento sólido para o plano de fundo e/ou a área do gráfico ou atribua um valor de transparência ao gráfico inteiro. Você pode especificar vários preenchimentos usando o caractere de barra vertical (|
). (Maps: apenas para plano de fundo).
Sintaxe
chf=<fill_type>,s,<color>|...
- <fill_type>
- A parte do gráfico que está sendo preenchida. Especifique um destes valores:
bg
: preenchimento do plano de fundoc
: preenchimento da área do gráfico. Incompatível com gráficos de mapa.a
: deixa o gráfico inteiro transparente, incluindo o plano de fundo. Os seis primeiros dígitos de<color>
são ignorados, e apenas os dois últimos (o valor de transparência) são aplicados ao gráfico inteiro e aos preenchimentos.b<index>
: preenchimento sólido de barras (somente para gráficos de barras). Substitua <index> pelo índice da série de barras a ser preenchida com uma cor sólida. O efeito é semelhante à especificação dechco
em um gráfico de barras. Consulte Cores da série do gráfico de barras para conferir um exemplo.
- s
- Indica um preenchimento sólido ou transparente.
- <color>
- A cor de preenchimento, no formato hexadecimal RRGGBB. Para transparências, os seis primeiros dígitos são ignorados, mas precisam ser incluídos mesmo assim.
Exemplos
Descrição | Exemplo |
---|---|
Neste exemplo, o plano de fundo do gráfico é preenchido com cinza claro ( |
|
Este exemplo preenche o plano de fundo do gráfico com cinza claro ( |
|
Esse exemplo aplica uma transparência de 50% ao gráfico inteiro (80 em hexadecimal é 128, ou cerca de 50% de transparência). Observe o plano de fundo das células da tabela aparecendo no gráfico. |
|
Preenchimento gradiente chf
[linha, barras, Googleômetro, radar, dispersão,Venn]
Você pode aplicar um ou mais preenchimentos gradientes à área do gráfico ou plano de fundo. Os preenchimentos em gradiente são esmaecimentos de uma cor para outra. Gráficos de pizza e Googleômetro: somente para segundo plano.
Cada preenchimento de gradiente especifica um ângulo e, em seguida, duas ou mais cores ancoradas em um local especificado. A cor varia à medida que se move de uma âncora para outra. Você precisa ter pelo menos duas cores com valores <color_centerpoint> diferentes, para que uma delas possa aparecer gradualmente. Cada gradiente adicional é especificado por um par <color>,<color_centerpoint>.
Sintaxe
chf=<fill_type>,lg,<angle>,<color_1>,<color_centerpoint_1> ,..., <color_n>,<color_centerpoint_n>
- <fill_type>
- A área do gráfico a ser preenchida. Opções:
bg
: preenchimento do plano de fundoc
: preenchimento da área do gráfico.b<index>
: preenchimento de gradiente de barras (somente gráficos de barras). Substitua <index> pelo índice da série de barras a ser preenchida com um gradiente. Consulte Cores da série do gráfico de barras para conferir um exemplo.
- lg
- Especifica um preenchimento de gradiente.
- <ângulo>
- Um número que especifica o ângulo do gradiente de 0 (horizontal) a 90 (vertical).
- <color>
- A cor do preenchimento, no formato hexadecimal RRGGBB.
- <color_centerpoint>
- Especifica o ponto de fixação da cor. A cor vai começar a esmaecer a partir desse ponto à medida que se aproximar de outra âncora. O intervalo de valor é de 0,0 (borda de baixo ou esquerda) a 1,0 (borda superior ou direita), inclinado no ângulo especificado por <angle>.
Exemplos
Descrição | Exemplo |
---|---|
A área do gráfico tem um gradiente linear horizontal, especificado com um ângulo de zero grau ( As cores são pêssego ( O plano de fundo do gráfico é desenhado em cinza ( |
|
A área do gráfico tem um gradiente linear diagonal (do canto inferior esquerdo ao canto superior direito), especificado com um ângulo de 45 graus ( Pêssego ( Azul ( O plano de fundo do gráfico é desenhado em cinza ( |
|
A área do gráfico tem um gradiente linear vertical (de cima para baixo), especificado com um ângulo de 90 graus ( Azul ( Pêssego ( O plano de fundo do gráfico é desenhado em cinza ( |
|
Preenchimento listrado chf
[linha, barra, Googleômetro, radar, dispersão, Venn]
Você pode especificar um preenchimento listrado para a área do gráfico ou para o gráfico inteiro Gráficos de pizza e Googleômetro: somente para segundo plano.
Sintaxe
chf= <fill_type>,ls,<angle>,<color_1>,<width_1> ,..., <color_n>,<width_n>
- <fill_type>
- A área do gráfico a ser preenchida. Opções:
bg
: preenchimento do plano de fundoc
: preenchimento da área do gráficob<index>
: preenchimento listrado de barras (somente gráficos de barras). Substitua <index> pelo índice da série de barras a ser preenchida com listras. Consulte Cores da série do gráfico de barras para conferir um exemplo.
- ls
- Especifica o preenchimento de listras lineares.
- <ângulo>
- O ângulo de todas as listras em relação ao eixo Y. Use
0
para listras verticais ou90
para faixas horizontais. - <color>
- A cor da listra, no formato hexadecimal RRGGBB. Repita <color> e <width> para cada faixa adicional. Você precisa usar pelo menos duas listras. As listras se alternam até que o gráfico seja preenchido.
- <width>
- A largura da listra, de
0
a1
, em que1
é a largura total do gráfico. As listras se repetem até que o gráfico seja todo preenchido. Repita <color> e <width> para cada listra adicional. Você precisa usar pelo menos duas listras. As listras se alternam até que o gráfico seja preenchido.
Exemplos
Descrição | Exemplo |
---|---|
|
chf= |
|
chf= |