Gráfico do mapa (versão descontinuada)

 

Alerta de substituição: este gráfico de mapa foi substituído por uma versão mais recente.

Esta página descreve como criar um mapa colorido usando a API de gráficos do Google.

Sumário

Recursos específicos para gráficos

  1. Visão geral
  2. Códigos dos Estados Unidos

Recursos padrão

  1. Título do gráfico (chtt, chts)
  2. Margens do gráfico (chma)
  3. Preenchimento do plano de fundo
    1. Preenchimentos sólidos (chf)

Visão geral

Você pode criar um mapa com vários países ou estados destacados em cores personalizadas. Para especificar um mapa, você precisa especificar em qual região do mundo ele deve ampliar. Especifique também uma lista de regiões que vão ser coloridas no mapa e uma lista de dados paralela que atribui um valor numérico a cada país correspondente. Cada país é colorido com um gradiente, de acordo com o valor atribuído a ele. Também é possível especificar um gradiente de cor personalizado para os valores de dados.

Os gráficos de mapa suportam os seguintes parâmetros:

Parâmetro Obrigatório ou opcional Descrição
cht=t Obrigatório Especifica um gráfico de mapa.
chs Obrigatório Tamanho do mapa. O tamanho máximo para um mapa é 440 x 220.
chtm=<zoom_area> Obrigatório

Área geográfica mostrada no gráfico.

  • zoom_area: um dos seguintes valores
    • africa
    • asia
    • europe
    • middle_east
    • south_america
    • usa
    • world
chld=<country_or_state_codes> Obrigatório

Uma lista de países ou estados aos quais você está aplicando valores.

Exemplo: chld=DZEGMG.
chd=<country_values> Obrigatório

Uma lista de valores paralelos à lista de regiões, em que o valor se aplica à região correspondente. Os valores são valores de dados formatados padrão. Cada região receberá uma cor ao longo da escala especificada em chco, em que o valor mais baixo do intervalo se aplica à cor mais baixa e o valor mais alto desse intervalo à última cor.

  • country_values: uma lista na string de formato apropriada. Exemplos: t:10,20,30, s:aU2Ff e e:BaPoqM-A.
chco=<default_color>,<start_of_gradient>,...,<end_of_gradient> Opcional

Um intervalo de cores correspondente aos valores de dados baixos e altos para o intervalo de formato de dados. Os valores dos dados são convertidos em valores de cor com esse gradiente e aplicados aos países correspondentes.

  • default_color: [opcional] cor das regiões que não têm dados atribuídos. O padrão é BEBEBE (cinza médio). Um número hexadecimal no formato RRGGBB.
  • start_of_gradient: [opcional] da cor correspondente ao valor mínimo no intervalo de formato de dados. O valor padrão é 0000FF (azul). Um número hexadecimal no formato RRGGBB.
  • ... - [Opcional] Você pode ter quantas cores intermediárias quiser.
  • end_of_gradient: [opcional] é a cor correspondente ao valor máximo no intervalo de formato de dados. O padrão é FF0000 (vermelho). Um número hexadecimal no formato RRGGBB
chtt, chts Opcional Título e estilo do gráfico
chma Opcional Margens do gráfico
chf=bg Opcional Preenchimentos sólidos (somente plano de fundo)

 

Exemplos

Descrição Exemplo

Neste exemplo:

  • A área com zoom do gráfico é a África (chtm=africa).
  • Os três países vão receber valores: Argélia, Egito e Madagascar (chld=DZEGMG)
  • Os três valores atribuídos a esses países são 0, 100 e 50, respectivamente (chd=t:0,100,50), que são os valores mínimo, máximo e meio para dados de formato de texto.
  • O intervalo de cores é vermelho para 0, verde para 100 e branco para países não atribuídos (chco=FFFFFF,FF0000,00FF00).
  • O gráfico também tem um preenchimento de fundo azul-claro (chf=bg,s,EAF7FE).

Mapa da África
cht=t
chtm=africa
chld=DZEGMG
chd=t:0,100,50
chco=FFFFFF,FF0000,00FF00
chf=bg,s,EAF7FE

Esse gráfico é semelhante ao anterior, mas com mais detalhes.

 Mapa da África
chtm=africa
chld=DZEGMGAOBWNGCFKECGCVSNDJTZGHMZZM
chco=FFFFFF,FF0000,FFFF00,00FF00
chd=t:0,100,50,32,60,40,43,12,14,54,98,17,70,76,18,29
chf=bg,s,EAF7FE

Este gráfico especifica que nenhum país está destacado especificando um valor único e indefinido (chd=t:-1).

 Mapa-múndi
chs=440x220
chd=t:-1
cht=t
chtm=world

Voltar ao início

Códigos dos Estados Unidos

Estes são os códigos de estado aceitos quando o zoom do mapa é ampliado nos Estados Unidos (chld=usa).

AL Alabama LA Luisiana OH Ohio
AK Alasca ME Maine OK Oklahoma
AZ Arizona MD Maryland OU Oregon
AR Arkansas MA Massachusetts PA Pensilvânia
CA Califórnia MI Michigan RI Rhode Island
CO Colorado MN Minnesota SC Carolina do Sul
CT Connecticut MS Mississippi SD Dakota do Sul
DE Delaware MO Missouri VN Tennessee
FL Flórida MT Montana TX Texas
GA Geórgia NE Nebraska UT Utah
HI Havaí NV Nevada VT Vermont
ID Idaho NH New Hampshire VA Virgínia
IL Illinois NJ Nova Jersey WA Washington
Índia Indiana NM Novo México WV West Virginia
IA Iowa NY Nova York WI Wisconsin
KS Kansas NC Carolina do Norte WY Wyoming
KY Kentucky ND Dakota do Norte

Voltar ao início

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 (|) para forçar uma quebra de linha.

chts não está especificado aqui.

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

Gráfico com título azul, alinhado à direita e de 20 pontos.

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

Voltar ao início

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:

Margem do gráfico, área da legenda e área do 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 chma. Nesse caso, a margem vai aumentar mais, apertando a área do gráfico. Não é possível cortar uma legenda especificando um tamanho muito pequeno, mas você pode fazer com que ela ocupe mais espaço do que o necessário.

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

 

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.

Gráfico de linhas com plano de fundo em cinza e margens dos dois lados.
chma=30,30,30,30

Para adicionar uma margem ao redor da legenda, defina um valor para os parâmetros <opt_legend_width> e <opt_legend_height>.

Neste exemplo, a legenda tem largura de aproximadamente 60 pixels. Se você definir <opt_legend_width> como 80 pixels, a margem se estenderá por 20 pixels fora da legenda.

Gráfico de linhas com plano de fundo em cinza e margens dos dois lados.
chma=20,20,20,30|80,20

Voltar ao início

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 fundo
  • c: 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 de chco 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 (EFEFEF).

Gráfico de linha vermelha com preenchimento da área do gráfico em preto.

chf=bg,s,EFEFEF

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

Gráfico de linha vermelha com área do gráfico em preto e plano de fundo em cinza claro.

chf=c,s,000000|
bg,s,EFEFEF
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.

Gráfico de dispersão com pontos em azul e transparência de 50%.

chf=a,s,00000080

Voltar ao início

Formato de cor

Especifique cores usando uma string de valores hexadecimais de seis caracteres, mais dois valores de transparência opcionais, no formato RRGGBB[AA]. Exemplo:

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

AA é um valor de transparência opcional, em que 00 é completamente transparente, e FF é completamente opaco. Exemplo:

  • 0000FFFF = azul contínuo
  • 0000FF66 = azul transparente

Voltar ao início