Esta página descreve como criar um mapa colorido usando a API de gráficos do Google. Ele é uma versão nova e aprimorada que oferece suporte a um mapa maior e mais recursos do que o gráfico de mapa mais antigo (cht=t
).
Sumário
Recursos específicos para gráficos |
Recursos padrão
|
Visão geral
Você pode criar um mapa com vários países ou estados destacados em cores personalizadas. Você pode permitir que o mapa aumente ou diminua o zoom até o nível adequado para mostrar os países selecionados corretamente ou pode aumentar ou diminuir o zoom até um nível personalizado usando valores de latitude e longitude.
Parâmetros aceitos
Os gráficos de mapa suportam os seguintes parâmetros:
Parâmetro | Obrigatório ou opcional | Descrição |
---|---|---|
cht=map<opt_zoom_and_center> |
Obrigatório | Especifica um gráfico de mapa. opt_zoom_and_center: uma string opcional que permite aplicar zoom ou centralizar o gráfico em uma região específica. Veja detalhes. |
chs |
Obrigatório | Tamanho do mapa. As dimensões máximas de um mapa são 600 pixels de largura, 600 pixels de altura ou 300.000 pixels no total. |
chd= |
Opcional | Se usado, o valor dos dados vai indicar a cor do país
correspondente, junto do gradiente de cor especificado por chco . |
chld= |
Obrigatório | Uma lista separada por barras verticais de países ou estados que serão destacados
nas cores especificadas por |
|
Opcional | Cores do gráfico. O formato dessa string depende de você usar ou não
|
chtt, chts |
Opcional | Título e estilo do gráfico |
chm |
Opcional | Marcadores de gráfico |
chma |
Opcional | Margens do gráfico |
chf=bg... |
Opcional | Preenchimentos sólidos (somente plano de fundo) |
chdl |
Opcional | Legendas do gráfico |
Exemplos
Descrição | Exemplo | |||
---|---|---|---|---|
Neste exemplo:
|
|
|||
Mapa mostrando a França, com duas regiões destacadas:
|
chld=FR-D|FR-B|FR |
|||
Este mapa demonstra como usar os gradientes de cor.
|
chd=t:0,50,100 |
|||
O mapa pode ser cortado dentro do tamanho de gráfico especificado. Isso ocorre porque não distorcemos um mapa para que ele caiba em um tamanho de gráfico especificado, mas limitamos o mapa às regiões que você especifica em chld. Portanto, para evitar regiões cortadas dentro dos limites do gráfico, talvez seja necessário ajustar o tamanho do mapa manualmente. |
|
Zoom e centralização
Por padrão, o gráfico será ampliado e centralizado para centralizar as regiões selecionadas, fazendo com que se ajustem o máximo possível à área renderizada, dentro do tamanho do mapa definido. No entanto, você pode personalizar o nível de centralização e zoom do gráfico de duas maneiras:
Por pixel
Para ajustar as bordas pelo tamanho em pixels, use este formato:
cht=map:auto=<left_border>,<right_border>,<top_border>,<bottom_border>
Nela, o tamanho de cada borda é a borda adicional a ser exibida, em pixels, além do nível de zoom calculado automaticamente.
Você só pode diminuir o zoom (valores positivos), e não aumentar o zoom (valores negativos) mais perto do nível de zoom padrão usando o zoom por pixels.
Exemplos:
Todos estes exemplos mostram Londres (latitude)
Sem zoom (padrão) | Com zoom diminuído em 30 pixels por lado | Com zoom diminuído e ajustado para a direita |
---|---|---|
|
cht=map:auto=30,30,30,30 |
cht=map:auto=50,0,80,0 |
Por latitude e longitude
Você pode especificar as bordas exatas das partes superior, inferior, esquerda e direita do mapa renderizado por latitude e longitude usando a sintaxe mostrada a seguir:
cht=map:fixed=<bottom_border_lat>,<left_border_long>,<top_border_lat>,<right_border_long>
Em que <bottom_border_lat> e <top_border_lat> especificam a latitude das bordas inferior e superior, e <left_border_long> e <right_border_long> especificam a longitude das bordas esquerda e direita.
Observação: devido à distorção da projeção de Mercator (basicamente, projetar um mapa curvo em uma imagem plana), o foco em uma faixa alta e estreita pode causar algumas diferenças inesperadas de tamanho no mapa.
Exemplos:
Os exemplos a seguir mostram Londres (destacada em azul), que está a 0,1° de longitude e 51,5° de latitude. O mapa é cortado porque está tentando exibir apenas a Grã-Bretanha (conforme especificado) e preencher o gráfico designado sem distorção.
Centralizado | Latitudes alteradas em mais de 10* | Zoom aumentado pela redução de todos os valores |
---|---|---|
cht=map:fixed=40,-10,60,10 |
|
cht=map:fixed=48,-3,54,3 |
Observe como o tamanho da imagem do meio é um pouco menor que a primeira, mesmo que tenhamos movido o mesmo número de graus para cima. Isso acontece porque estamos projetando uma esfera 3D em uma imagem 2D. Você precisa aumentar a largura do segundo gráfico para que ele tenha o mesmo tamanho do primeiro.
Recursos padrão
Os demais recursos nesta página são recursos de gráficos padrão.
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 |
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 |
|
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. |
|
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. |
|
Marcadores de forma chm
[barra, linha, radar, dispersão]
É possível especificar marcadores gráficos para todos ou pontos de dados individuais em um gráfico. Se dois ou mais marcadores ocuparem o mesmo ponto, eles serão desenhados na ordem em que aparecem no parâmetro chm
.
Você também pode criar marcadores de texto em pontos de dados. Isso é abordado em Marcadores de ponto de dados.
Você pode combinar marcadores de forma com qualquer outro parâmetro chm
usando uma barra vertical ( |
) para separar os parâmetros chm
.
Sintaxe
Especifique um conjunto dos parâmetros a seguir para cada série a ser marcada. Para marcar diversas séries, crie outros conjuntos de parâmetros, delimitados por barra vertical. Não é necessário marcar todas as séries. Quando uma série de dados não é atribuída, nenhum marcador é atribuído a ela.
Os marcadores de forma se comportam de maneira um pouco diferente nos gráficos de dispersão. Consulte a respectiva documentação para mais informações.
chm= [@]<marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_offset> |...| [@]<marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_offset>
- @
- [Opcional] Se você colocar o caractere @ opcional antes do tipo de marcador, <opt_which_points>, usar o formato x:y.
- <marker_type>
- O tipo de marcador a ser usado. Especifique um dos tipos
a seguir:
a
: setac
- CruzC
: retângulo. Se um marcador de retângulo é usado, é preciso ter pelo menos duas séries de dados, em que a série 0 especifica a borda de baixo e a série 1 especifica a borda de cima. <size> especifica a largura do retângulo, em pixels.d
: diamanteE
: marcador de barra de erro ( ). Esse marcador precisa de duas séries de dados para criar, um valor para a parte inferior e o ponto correspondente na segunda série para a parte superior. Ele também expõe uma sintaxe <size> estendida: line_thickness[:top_and_bottom_width], em que top_and_bottom_width é opcional. Veja os exemplos a seguir.h
: linha horizontal no gráfico com uma altura especificada. O único formato válido para o parâmetro <opt_which_points> é n.d.H
: linha horizontal pelo marcador de dados especificado. É compatível com uma sintaxe <size> estendida, que permite especificar um comprimento de linha exato: line_thickness[:length], em que :length é opcional e o padrão é a largura completa da área do gráfico.o
: círculos
: quadradov
: linha vertical do eixo x até o ponto de dadosV
: linha vertical de comprimento ajustável. É compatível com uma sintaxe de valor <size> estendida que permite especificar um comprimento de linha exato: line_thickness[:length], em que :length é opcional e o padrão é a altura completa da área do gráfico. O marcador é centralizado no ponto de dados.x
: um X
- <color>
- A cor dos marcadores desta série, no formato hexadecimal RRGGBB.
- <series_index>.
- : o índice da série de dados em que os marcadores vão ser desenhados, com base em zero. Ignorado para marcadores
h
e que especificam a localização pela posição x/y (começa com o caractere @). Você pode usar séries de dados ocultas como uma fonte para marcadores. Consulte Gráficos compostos para mais informações. Os gráficos de barras verticais agrupadas são compatíveis com uma sintaxe estendida especial para alinhar marcadores com barras específicas. - <opt_which_points> (em inglês)
- [Opcional] Em quais pontos desenhar marcadores. O padrão é todos os marcadores. Use um destes valores:
n.d
: onde desenhar o marcador. O significado depende do tipo de marcador:- Todos os tipos, exceto h: em qual ponto de dados o marcador será desenhado, em que n.d é o índice da série a partir de zero. Se você especificar um valor não inteiro, a fração indicará um ponto intermediário calculado. Por exemplo, 3,5 significa metade do caminho entre os pontos 3 e 4.
h
: um número de 0,0 a 1,0, em que 0,0 é a parte inferior do gráfico e 1,0 é a parte superior dele.
-1
: desenha um marcador em todos os pontos de dados. Você também pode deixar esse parâmetro vazio para desenhar em todos os pontos de dados.-n
: desenhe um marcador em cada no ponto de dados. Valor de ponto flutuante: se n for menor que 1, o gráfico calculará pontos intermediários adicionais para você. Por exemplo, -0,5 coloca o dobro de marcadores que pontos de dados.start:end:n
: desenha um marcador em cada no ponto de dados de um intervalo, incluindo os valores de índice start e end. Todos os parâmetros são opcionais (podem estar ausentes), portanto, 3::1 seria do quarto elemento para o último, etapa 1, e a omissão desse parâmetro inteiramente usaria first:last:1. Todos os valores podem ser números de ponto flutuante, ou seja, start e end podem ser negativos, para contar de maneira retroativa a partir do último valor. Se start e end forem negativos, verifique se estão listados em valor crescente (por exemplo, -6:-1:1). Se o valor da etapa n for menor que 1, ele calculará pontos de dados adicionais, interpolando os valores de dados fornecidos. Os valores padrão são first:last:1x:y
: desenhe um marcador em um ponto X/y específico do gráfico. Este ponto não precisa estar em uma linha. Adicione o caractere @ antes do tipo de marcador para usar essa opção. Especifique as coordenadas como valores de ponto flutuante, em que0:0
é o canto inferior esquerdo do gráfico e1:1
é o canto superior direito dele. Por exemplo, para adicionar um losango vermelho de 15 pixels ao centro de um gráfico, use@d,FF0000,0,0.5:0.5,15
.
- <size>
- O tamanho do marcador, em pixels. A maioria usa um único valor numérico para esse parâmetro. Os marcadores V, H e S são compatíveis com a sintaxe <size>[:width], em que a segunda parte opcional especifica o comprimento da linha ou do marcador.
- <opt_z_order>
- [Opcional] A camada em que o marcador será desenhado, em comparação com outros marcadores e com todos os outros elementos do gráfico. Esse é um número de ponto flutuante de -1,0 a 1,0, inclusive, em que -1,0 é a parte inferior e 1,0 é a parte superior. Os elementos do gráfico (linhas e barras) ficam logo abaixo de zero. Se dois marcadores tiverem o mesmo valor, eles serão desenhados na ordem informada pelo URL. O valor padrão é 0,0 (logo acima dos elementos do gráfico).
- <opt_offset>
- [Opcional] Permite especificar deslocamentos horizontais e verticais a partir do local especificado. Esta é a sintaxe, que usa um delimitador : (
reserved:<horizontal_offset>:<vertical_offset>
): Se especificado, você pode incluir um valor vazio ,, na string de parâmetrochm
para <opt_z_order>. Exemplos:o,FF9900,0,4,12,,:10 o,FF9900,0,4,12.0,,:-10:20 o,FF9900,0,4,12,1,::20
- reservado: deixe em branco.
<horizontal_offset>
: um número positivo ou negativo que especifica o deslocamento horizontal, em pixels. Opcional. Deixe em branco se não for usado.<vertical_offset>
: um número positivo ou negativo que especifica o deslocamento vertical, em pixels. Opcional. Deixe em branco se não for usado.
Exemplos
Descrição | Exemplo |
---|---|
Veja um exemplo de vários marcadores de forma e linha.
|
chm= |
Este é um exemplo que usa losangos para uma série de dados e círculos para a outra. Se dois ou mais marcadores ocuparem o mesmo ponto, eles serão desenhados na ordem em que aparecem no parâmetro |
chm= |
Este é um gráfico de linhas com um marcador a cada dois pontos de dados (-2 significa a cada dois pontos). |
chd=t: |
Este é um gráfico de linhas com o dobro de marcadores que os pontos de dados (-0,5 significa a cada meio ponto). | chd=t: |
Este exemplo mostra como usar os marcadores h e v para criar linhas de grade com cores e espessura personalizadas. O valor da ordem z (o último valor) é definido como -1 para que as linhas da grade sejam desenhadas abaixo da linha de dados. |
chm= |
Este gráfico adiciona linhas de preenchimento verticais a um gráfico de linhas:
|
chm= |
Neste exemplo, uma seta e um marcador de texto são adicionados ao gráfico usando coordenadas exatas. O primeiro marcador D é a linha traçada abaixo das barras. O segundo marcador é a seta, e o terceiro é o texto da seta. | chm= |
Uma linha horizontal fixada a um ponto de dados específico (H ) pode ser útil para mostrar valores relativos ou enfatizar a altura de um valor de dados em um gráfico. |
chm=H,FF0000,0,18,1 |
Este gráfico demonstra os marcadores que podem especificar a espessura e o comprimento da linha no parâmetro <size>.
|
title="cht=lc&chd=s:2gounjqLaCf,jqLaCf2goun&chco=008000,00008033&chls=2.0,4.0,1.0&chs=250x150&chm=H,990066,1,2,5:50%chm=
|
Marcadores de texto e valor de dados chm
[barra, linha, radar, dispersão]
Você pode rotular pontos específicos no gráfico com texto personalizado ou com versões formatadas dos dados.
É possível combinar qualquer marcador chm
usando uma barra vertical ( |
) para separar os conjuntos de parâmetros chm
.
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
Especifique um conjunto dos parâmetros a seguir para cada série a ser marcada. Para marcar diversas séries, crie outros conjuntos de parâmetros, delimitados por barra vertical. Não é necessário marcar todas as séries. Se você não atribuir marcadores a uma série de dados, ela não receberá marcadores.
chm= <marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_placement> |...| <marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_placement>
- <marker_type>
- O tipo de marcador a ser usado. Você pode escolher um dos seguintes tipos:
f<text>
: uma sinalização contendo texto. Especifique o caractere "f", seguido de texto personalizado codificado para URL. Para adicionar vírgulas em marcadores de texto, coloque um sinal de \ antes da vírgula. Exemplo:fHello\,+World!
t<text>
: um marcador de texto simples. Especifique o caractere "t" seguido de texto personalizado codificado para URL. Para adicionar vírgulas em marcadores de texto, coloque um sinal de \ antes da vírgula. Exemplo:tHello\,+World!
A<text>
: um marcador de anotação. Ele é semelhante a um marcador de sinalização, mas os marcadores coordenam a própria posição para que não se sobreponham. O único formato válido para <opt_which_points> é n.d para indicar o índice de um ponto da série.N<formatting_string>
: o valor dos dados nesse ponto, com formatação opcional. Se você não usar o parâmetrochds
(escalonamento personalizado), ele fornecerá o valor codificado exato. Se você usar esse parâmetro com qualquer tipo de formato, o valor será dimensionado para o intervalo que você especificar. Veja um exemplo dechds
com marcadores numéricos abaixo. Com esse tipo de marcador em um gráfico de barras empilhadas, se você especificar -1 para <series_index>, receberá um marcador que mostra a soma de todos os valores nessa barra empilhada. A sintaxe da string de formatação é a seguinte:
<preceding_text>*<number_type><decimal_places>zs<x or y>*<following_text>
.
Todos esses elementos são opcionais. Veja o significado de cada elemento:<preceding_text>
: texto que precede 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 a ser seguido de cada valor.
- <color>
- A cor dos marcadores deste conjunto, no formato hexadecimal RRGGBB.
- <series_index>.
- : o índice da série de dados em que os marcadores vão ser desenhados, com base em zero. Se for um gráfico de barras empilhadas e o tipo de marcador for N (valores de pontos de dados), você poderá especificar -1 para criar um marcador de valor somado para cada pilha de barras. Veja abaixo um exemplo.
- <opt_which_points> (em inglês)
- [Opcional] Em quais pontos desenhar marcadores. O padrão é todos os marcadores. Use
um dos seguintes valores:
n.d
: em qual ponto de dados desenhar o marcador, em que n.d é o índice da série, começando com zero. Se você especificar um valor não inteiro, a fração vai indicar um ponto intermediário calculado. Por exemplo, 3,5 significa metade do caminho entre os pontos 3 e 4.-1
: desenha um marcador em todos os pontos de dados. Você também pode deixar esse parâmetro vazio para desenhar em todos os pontos de dados.-n
: desenhe um marcador em cada no ponto de dados.start:end:n
: desenha um marcador em cada n-ésimo ponto de dados de um intervalo, incluindo os valores de índice start e end. Todos os parâmetros são opcionais (podem estar ausentes), portanto, 3::1 seria do quarto elemento para o último, etapa 1, e a omissão desse parâmetro inteiramente usaria first:last:1. Todos os valores podem ser números de ponto flutuante, ou seja, start e end podem ser negativos, para contar de maneira retroativa a partir do último valor. Se start e end forem negativos, verifique se estão listados em valor crescente (por exemplo, -6:-1:1). Se o valor de grau n for menor que 1, ele calculará pontos de dados adicionais, interpolando os valores de dados fornecidos. Os valores padrão são first:last:1x:y
: [incompatível com marcadores do tipo N] desenhe um marcador em um ponto x/y específico no gráfico. Esse ponto não precisa estar em uma linha. Adicione o caractere arroba (@
) antes do tipo de marcador para usar essa opção. Especifique as coordenadas como valores de ponto flutuante, em que0:0
é o canto inferior esquerdo,0.5:0.5
é o centro e1:1
é o canto superior direito. Por exemplo, para adicionar um losango vermelho de 15 pixels ao centro de um gráfico, use@d,FF0000,0,0.5:0.5,15
.
- <size>
- : o tamanho do marcador em pixels. Se for um gráfico de dispersão com uma terceira série de dados (usada para especificar tamanhos de pontos), esse valor será dimensionado pelo intervalo de dados. Portanto, se o intervalo de dados for de 0 a 100 e <size> for 30, um valor de dados de 100 teria 30 pixels de largura, um valor de dados de 50 teria 15 pixels de largura e assim por diante.
- <opt_z_order>
- [Opcional] A camada em que o marcador será desenhado, em comparação com outros marcadores e com todos os outros elementos do gráfico. Esse é um número de ponto flutuante de -1,0 a 1,0, inclusive, em que -1,0 é a parte inferior e 1,0 é a parte superior. Os elementos do gráfico (linhas e barras) ficam logo abaixo de zero. Se dois marcadores tiverem o mesmo valor, eles serão desenhados na ordem informada pelo URL. O valor padrão é 0,0 (logo acima dos elementos do gráfico).
- <opt_placement>
- [Opcional] São detalhes adicionais do canal que descrevem onde colocar este marcador em relação ao ponto de dados. É possível especificar o posicionamento relativo horizontal e/ou vertical, bem como deslocamentos. A sintaxe de posicionamento é uma string com delimitadores :, conforme mostrado aqui. Todos os elementos são opcionais:
<horizontal_and_vertical_justification>:<horizontal_offset>:<vertical_offset>
. Se especificado, é possível incluir um valor vazio ,, na string de parâmetrochm
para <opt_z_order>. Exemplos:N,000000,0,1,10,,b
,N,000000,0,1,10,,lv
eN,000000,0,1,10,,r::10
.- horizontal_and_vertical_justification
- O ponto de fixação do marcador. Esse comportamento é oposto à justificativa. Portanto, uma âncora à esquerda coloca o marcador à direita do ponto de dados. É possível escolher um justificador horizontal
e/ou vertical da seguinte lista:
- Posicionamento horizontal: "l", "h" ou "r": ancorado à esquerda, no centro ou à direita, horizontalmente. O padrão é "l".
- Posicionamento vertical: "b", "v", "t": ancorado na parte de baixo, no meio ou na parte de cima da tela, verticalmente. O padrão é "b".
- Posicionamento relativo à barra [somente gráficos de barras]: "s", "c", "e": base, centro ou parte de cima de uma barra. Para gráficos empilhados, isso está relacionado à seção da barra de cada série, não à barra inteira. Se o índice de série fornecido for -1 (total da pilha), isso está em relação à barra inteira. Pode ser combinado com valores de posicionamento verticais, por exemplo, "be" ou "vs". O valor padrão é "e".
- horizontal_offset
- Um deslocamento horizontal para o marcador, em pixels. O padrão é 0.
- vertical_offset
- Um deslocamento vertical para o marcador, em pixels. Padrão do gráfico que não é de barras: 15. Padrão do gráfico de barras: 2.
Descrição | Exemplo | |
---|---|---|
Veja um exemplo de rótulos de valor em um gráfico de barras. O primeiro gráfico ( O segundo gráfico ( |
|
|
É possível usar o parâmetro Este exemplo mostra um gráfico com valores de codificação simples de 46, 39, 29, 30, 43, 41. O intervalo da codificação simples é de 0 a 61.
. O parâmetro |
chd=s:underp |
|
Veja um exemplo de gráfico com um rótulo de texto no ponto mínimo e um rótulo de sinalização no ponto máximo. |
|
|
Este exemplo mostra um gráfico empilhado com valores para séries individuais, além do total da série. Para mostrar os valores das séries empilhadas, é preciso usar a opção de posicionamento "c". Caso contrário, o valor da barra superior se sobrepõe ao valor da soma no topo de cada barra. | chm= |
|
Mais algumas demonstrações de como o posicionamento vertical e horizontal funcionam. Este exemplo demonstra várias combinações de valores de âncora para gráficos de barras (que usam s, c e e para posicionamento vertical). Observe como uma âncora à direita move um marcador para a esquerda, uma âncora superior move um marcador para baixo e vice-versa. Os pontos em vermelho mostram a base, centro e topo de cada barra. O número é o valor dos dados, fixado com diferentes valores de âncora para cada barra. | chm= |
|
Os marcadores de anotação ajustam automaticamente a posição dos rótulos para que eles não se sobreponham. O primeiro valor de chm é para o preenchimento da linha. Os valores a seguir são todos marcadores de anotação. |
chm=B,C5D4B5BB,0,0,0 |
|
Outro exemplo de marcador de anotação demonstra as altitudes das cidades da Suíça. |