Histograma

Visão geral

Um Histograma é um gráfico que agrupa dados numéricos em agrupamentos, exibindo os agrupamentos como colunas segmentadas. Elas são usadas para representar a distribuição de um conjunto de dados: a frequência com que os valores se enquadram em intervalos.

O recurso Gráficos do Google escolhe automaticamente o número de agrupamentos que você pode usar. Todas as classes têm a mesma largura e uma altura proporcional ao número de pontos de dados na lixeira. Em outros aspectos, os histogramas são semelhantes aos gráficos de colunas.

Exemplo

Veja um histograma de tamanhos de dinossauro:

O histograma diz que o agrupamento mais comum é < 10 metros e que há apenas um dinossauro com mais de 40 metros. Podemos passar o cursor sobre a barra para descobrir que é o Seismsaurus, que pode ser um Diplodocus muito grande. Os paleontologistas não têm certeza.

O código para gerar esse histograma é mostrado abaixo. Depois de definir os dados (aqui, com google.visualization.arrayToDataTable), o gráfico é definido com uma chamada para google.visualization.Histogram e desenhado com o método draw.

<html>
  <head>
    <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script>
    <script type="text/javascript">
      google.charts.load("current", {packages:["corechart"]});
      google.charts.setOnLoadCallback(drawChart);
      function drawChart() {
        var data = google.visualization.arrayToDataTable([
          ['Dinosaur', 'Length'],
          ['Acrocanthosaurus (top-spined lizard)', 12.2],
          ['Albertosaurus (Alberta lizard)', 9.1],
          ['Allosaurus (other lizard)', 12.2],
          ['Apatosaurus (deceptive lizard)', 22.9],
          ['Archaeopteryx (ancient wing)', 0.9],
          ['Argentinosaurus (Argentina lizard)', 36.6],
          ['Baryonyx (heavy claws)', 9.1],
          ['Brachiosaurus (arm lizard)', 30.5],
          ['Ceratosaurus (horned lizard)', 6.1],
          ['Coelophysis (hollow form)', 2.7],
          ['Compsognathus (elegant jaw)', 0.9],
          ['Deinonychus (terrible claw)', 2.7],
          ['Diplodocus (double beam)', 27.1],
          ['Dromicelomimus (emu mimic)', 3.4],
          ['Gallimimus (fowl mimic)', 5.5],
          ['Mamenchisaurus (Mamenchi lizard)', 21.0],
          ['Megalosaurus (big lizard)', 7.9],
          ['Microvenator (small hunter)', 1.2],
          ['Ornithomimus (bird mimic)', 4.6],
          ['Oviraptor (egg robber)', 1.5],
          ['Plateosaurus (flat lizard)', 7.9],
          ['Sauronithoides (narrow-clawed lizard)', 2.0],
          ['Seismosaurus (tremor lizard)', 45.7],
          ['Spinosaurus (spiny lizard)', 12.2],
          ['Supersaurus (super lizard)', 30.5],
          ['Tyrannosaurus (tyrant lizard)', 15.2],
          ['Ultrasaurus (ultra lizard)', 30.5],
          ['Velociraptor (swift robber)', 1.8]]);

        var options = {
          title: 'Lengths of dinosaurs, in meters',
          legend: { position: 'none' },
        };

        var chart = new google.visualization.Histogram(document.getElementById('chart_div'));
        chart.draw(data, options);
      }
    </script>
  </head>
  <body>
    <div id="chart_div" style="width: 900px; height: 500px;"></div>
  </body>
</html>

Os rótulos (neste caso, os nomes dos dinossauros) podem ser omitidos. Nesse caso, as dicas mostrarão apenas o valor numérico.

Como controlar cores

Veja um histograma das populações nacionais:

Há mais de 200 países com populações abaixo de 100.000, ficando severas depois disso.

Esse histograma usa a opção colors para desenhar os dados em verde:

  var options = {
    title: 'Country Populations',
    legend: { position: 'none' },
    colors: ['green'],
  };

Assim como em todos os gráficos do Google, as cores podem ser especificadas como nomes em inglês ou valores hexadecimais.

Como controlar buckets

Por padrão, o recurso Gráficos do Google escolhe o tamanho do bucket automaticamente usando um algoritmo conhecido para histogramas. No entanto, às vezes é necessário substituir isso, e o gráfico acima é um exemplo. Com tantos países no primeiro bucket, é difícil examiná-los em outros.

Para situações como essa, o gráfico do histograma fornece duas opções: histogram.bucketSize, que substitui o algoritmo e codifica o tamanho do bucket e histogram.lastBucketPercentile. A segunda opção precisa de mais explicações: ela muda a computação de tamanhos de bucket para ignorar os valores maiores ou menores do que os valores restantes pela porcentagem especificada. Os valores ainda estão incluídos no histograma, mas não afetam o modo como eles são agrupados. Isso é útil quando você não quer que os valores atípicos fiquem nos próprios buckets. Em vez disso, eles são agrupados com o primeiro ou o último bucket.

No gráfico acima, ignoramos os cinco principais e cinco piores valores de cálculo do tamanho do bucket. Os valores ainda são exibidos no gráfico. A única coisa que mudou é o tamanho do bucket, mas isso deixa o histograma mais legível.

Neste exemplo, também mostramos como alterar a escala do eixo vertical para usar a escala de "registro espelhado", que também ajuda a gerar gráficos com dados que têm uma cauda longa de valores pequenos.

  var options = {
    title: 'Country Populations',
    legend: { position: 'none' },
    colors: ['#e7711c'],
    histogram: { lastBucketPercentile: 5 },
    vAxis: { scaleType: 'mirrorLog' }
  };

Como você pode ver, remover os 5% superiores e inferiores do cálculo levou a um tamanho de bucket de 10.000.000 em vez de aos 100.000.000 que seriam. Se você soubesse que um tamanho de bucket de 10.000.000 era o que você queria, poderia ter usado histogram.bucketSize para fazer isso:

  var options = {
    title: 'Country Populations',
    legend: { position: 'none' },
    colors: ['#e7711c'],
    histogram: { bucketSize: 10000000 }
  };

No exemplo a seguir, mostramos como expandir o intervalo de buckets e exibir muito mais buckets sem lacunas entre eles. A opção maxNumBuckets pode ser usada para aumentar o número padrão de buckets. As opções histogram.minValue e histogram.maxValue expandirão o intervalo dos buckets, mas observe que, se houver dados fora desse intervalo, essas opções não o reduzirão.

Este exemplo também mostra que é possível especificar as marcações a serem exibidas para cada um dos buckets usando a opção ticks explícita para o hAxis. Isso não afeta os buckets em si, mas apenas como as marcações são exibidas.

Também especificamos o chartArea.width para que o número de buckets seja mais preciso sem artefatos visuais. Veja as opções para esse exemplo.

  var options = {
    title: 'Approximating Normal Distribution',
    legend: { position: 'none' },
    colors: ['#4285F4'],

    chartArea: { width: 405 },
    hAxis: {
      ticks: [-1, -0.75, -0.5, -0.25, 0, 0.25, 0.5, 0.75, 1]
    },
    bar: { gap: 0 },

    histogram: {
      bucketSize: 0.01,
      maxNumBuckets: 400,
      minValue: -1,
      maxValue: 1
    }
  };

Várias séries

Veja um histograma das cobranças de partículas subatômicas, de acordo com o modelo padrão:

O gráfico acima tem uma série que contém todas as partículas. As partículas subatômicas podem ser divididas em quatro grupos: quarks, leeptons e bósons. Vamos tratar cada uma como uma série:

Neste gráfico, usamos uma série diferente (e, portanto, cor) para cada um dos quatro tipos de partícula subatômica. Definimos explicitamente interpolateNulls como false para garantir que os valores nulos (necessários porque a série tem comprimento desigual) não sejam representados no gráfico. Também definimos legend.maxLines para adicionar outra linha à legenda:

  var data = google.visualization.arrayToDataTable([
    ['Quarks', 'Leptons', 'Gauge Bosons', 'Scalar Bosons'],
    [2/3, -1, 0, 0],
    [2/3, -1, 0, null],
    [2/3, -1, 0, null],
    [-1/3, 0, 1, null],
    [-1/3, 0, -1, null],
    [-1/3, 0, null, null],
    [-1/3, 0, null, null]
  ]);

  var options = {
    title: 'Charges of subatomic particles',
    legend: { position: 'top', maxLines: 2 },
    colors: ['#5C3292', '#1A8763', '#871B47', '#999999'],
    interpolateNulls: false,
  };

Carregando

O nome do pacote google.charts.load é "corechart".

  google.charts.load("current", {packages: ["corechart"]});

O nome da classe da visualização é google.visualization.Histogram:

  var visualization = new google.visualization.Histogram(container);

Formato de dados

Há duas maneiras de preencher uma tabela de dados de histograma. Quando há apenas uma série:

  var data = google.visualization.arrayToDataTable([
    ['Name', 'Number'],
    ['Name 1', number1],
    ['Name 2', number2],
    ['Name 3', number3],
    ...
  ]);

...e quando há várias séries:

  var data = google.visualization.arrayToDataTable([
    ['Series Name 1', 'Series Name 2', 'Series Name 3', ...],
    [series1_number1, series2_number1, series3_number1, ...],
    [series1_number2, series2_number2, series3_number2, ...],
    [series1_number3, series2_number3, series3_number3, ...],
    ...
  ]);

No momento, não há suporte para funções de coluna opcionais para histogramas.

Opções de configuração

Nome
animação.duração

É a duração da animação em milissegundos. Para mais detalhes, consulte a documentação de animação.

Tipo:número
Padrão: 0
animação.easing

A função de easing aplicada à animação. As seguintes opções estão disponíveis:

  • "linear" - Velocidade constante.
  • 'in' - Facilidade em - Começar devagar e acelerar.
  • "out" - "easing" - comece rápido e desacelere.
  • "InAndOut" - facilidade dentro e fora - Inicie devagar, acelere e, em seguida, desacelere.
Tipo: string
Padrão: "linear"
animação.startup

Determina se o gráfico vai ser animado no desenho inicial. Se true, o gráfico será iniciado no valor de referência e será animado para o estado final.

Tipo: booleano
Falso padrão
TitleTitleSPosition

Onde colocar os títulos dos eixos em comparação com a área do gráfico Os valores suportados são:

  • in - Desenhar os títulos dos eixos dentro da área do gráfico.
  • out - desenha os títulos do eixo fora da área do gráfico.
  • nenhum: omita os títulos dos eixos.
Tipo: string
Padrão: "out"
backgroundColor

A cor do plano de fundo da área principal do gráfico. Pode ser uma string de cor HTML simples, por exemplo: 'red' ou '#00cc00', ou um objeto com as seguintes propriedades.

Tipo: string ou objeto
Padrão: "branco"
backgroundColor.stroke

A cor da borda do gráfico, como uma string de cor HTML.

Tipo: string
Padrão: "#666"
backgroundColor.strokeWidth

A largura da borda em pixels.

Tipo: número
Padrão:0
backgroundColor.fill

A cor de preenchimento do gráfico, como uma string de cor HTML.

Tipo: string
Padrão: "branco"
Largura do grupo
A largura de um grupo de barras, especificada em um destes formatos:
  • Pixels (por exemplo, 50).
  • Porcentagem da largura disponível para cada grupo (por exemplo, "20%"), em que "100%" indica que não há espaço entre eles.
Tipo:número ou string
Padrão: a proporção dourada, aproximadamente 66,8%.
Área do gráfico

Um objeto com membros para configurar a posição e o tamanho da área do gráfico (em que o próprio gráfico é desenhado, excluindo eixo e legendas). Dois formatos são compatíveis: um número ou um número seguido por %. Um número simples é um valor em pixels. Um número seguido por % é uma porcentagem. Exemplo: chartArea:{left:20,top:0,width:'50%',height:'75%'}

Tipo: objeto
Padrão:nulo
chartArea.backgroundColor
Cor de fundo da área do gráfico. Quando usada, uma string pode ser hexadecimal (por exemplo, "#fdc") ou o nome da cor em inglês. Quando um objeto é usado, é possível fornecer as seguintes propriedades:
  • stroke: a cor, fornecida como uma string hexadecimal ou nome de cor em inglês.
  • strokeWidth: se fornecido, desenha uma borda ao redor da área do gráfico da largura especificada (e com a cor stroke).
Tipo: string ou objeto
Padrão: "branco"
gráficoArea.left

Até onde desenhar o gráfico da borda esquerda.

Tipo: número ou string
Padrão:automático
gráficoArea.top

Até onde desenhar o gráfico da borda superior.

Tipo:número ou string
Padrão: automático
gráficoArea.largura

Largura da área do gráfico.

Tipo:número ou string
Padrão: automático
gráficoArea.height

Altura da área do gráfico.

Tipo:número ou string
Padrão: automático
Cores

As cores a serem usadas nos elementos do gráfico. Uma matriz de strings, em que cada elemento é uma string de cor HTML, por exemplo: colors:['red','#004411'].

Tipo: matriz de strings
Padrão: cores padrão
Opacidade dos dados

A transparência dos pontos de dados, com 1.0 sendo completamente opaco e 0.0 totalmente transparente. Nos gráficos de dispersão, histograma, barra e coluna, isso se refere aos dados visíveis: pontos no gráfico de dispersão e retângulos nos outros. Nos gráficos em que a seleção de dados cria um ponto, como os gráficos de linhas e áreas, isso se refere aos círculos que aparecem ao passar o cursor ou selecionar. O gráfico de combinação exibe os dois comportamentos, e essa opção não afeta outros gráficos. Para mudar a opacidade de uma linha de tendência, consulte opacidade da linha de tendência .

Tipo: número
Padrão:1.0
enableInteractivity

Se o gráfico gera eventos com base no usuário ou reage à interação do usuário. Se for falso, o gráfico não gerará "select" ou outros eventos baseados em interação (mas fará eventos prontos ou de erro) e não exibirá texto passando ou mudará de acordo com a entrada do usuário.

Tipo: booleano
Padrão: verdadeiro
Meta de foco

É o tipo da entidade que recebe o foco ao passar o cursor. Também afeta qual entidade é selecionada pelo clique do mouse e qual elemento da tabela de dados está associado aos eventos. Será um dos seguintes valores:

  • "Dados" - Foque em um único ponto de dados. Correlaciona-se com uma célula na tabela de dados.
  • "category" - Concentre-se em um agrupamento de todos os pontos de dados ao longo do eixo principal. Correlaciona-se com uma linha na tabela de dados.

Na função "target" "category", a dica mostra todos os valores de categoria. Isso pode ser útil para comparar valores de séries diferentes.

Tipo: string
Padrão: "datum"
fontSize

O tamanho de fonte padrão, em pixels, de todo o texto do gráfico. É possível modificar isso usando propriedades para elementos específicos do gráfico.

Tipo: número
Padrão:automático
Nome da fonte

A fonte padrão para todo o texto no gráfico. É possível modificar isso usando propriedades para elementos específicos do gráfico.

Tipo: string
Padrão: "Arial"
FrameIForce

Desenha o gráfico dentro de um frame inline. No IE8, essa opção é ignorada. Todos os gráficos do IE8 são desenhados em i-frames.

Tipo: booleano
Padrão: falso
híbrido

Um objeto com membros para configurar vários elementos de eixo horizontal. Para especificar propriedades desse objeto, use a notação literal de objeto, conforme mostrado aqui:

{
  title: 'Hello',
  titleTextStyle: {
    color: '#FF0000'
  }
}
    
Tipo: objeto
Padrão: nulo
hAxis.gridlines

Um objeto com propriedades para configurar as linhas de grade no eixo horizontal. As linhas de grade do eixo horizontal são desenhadas verticalmente. Para especificar propriedades desse objeto, use a notação literal de objeto, conforme mostrado aqui:

{color: '#333', minSpacing: 20}
Tipo: objeto
Padrão:nulo
hAxis.gridlines.color

A cor das linhas de grade horizontais dentro da área do gráfico. Especifique uma string de cor HTML válida.

Tipo: string
Padrão: "#CCC"
hAxis.gridlines.count

O número aproximado de linhas de grade horizontais na área do gráfico. Se você especificar um número positivo para a gridlines.count, ela vai ser usada para calcular o minSpacing entre as linhas de grade. Especifique um valor de 1 para desenhar apenas uma linha de grade, ou 0 para desenhar nenhuma linha de grade. Especifique -1, que é o padrão, para calcular automaticamente o número de linhas de grade com base em outras opções.

Tipo: número
Padrão: -1
hAxis.gridlines.interval

Uma matriz de tamanhos (como valores de dados, não pixels) entre as linhas de grade adjacentes. No momento, essa opção é só para eixos numéricos, mas é análoga às opções gridlines.units.<unit>.interval, que são usadas apenas para datas e horas. Para escalas lineares, o padrão é [1, 2, 2.5, 5], o que significa que os valores da linha de grade podem cair em cada unidade (1), em unidades pares (2) ou em múltiplos de 2,5 ou 5. Qualquer potência de 10 vezes esses valores também é considerada (por exemplo, [10, 20, 25, 50] e [.1, .2, .25, .5]). Para escalas de registros, o padrão é [1, 2, 5].

Tipo: número entre 1 e 10, sem incluir 10.
Padrão:calculado
hAxis.gridlines.minSpacing

O espaço mínimo da tela, em pixels, entre as principais linhas de grade do Hadoop. O padrão para as principais linhas de grade é 40 para escalas lineares e 20 para escalas de registros. Se você especificar count, e não minSpacing, o minSpacing será calculado da contagem. Por outro lado, se você especificar minSpacing, e não count, a contagem será calculada com base em minSpacing. Se você especificar ambos, minSpacing será substituído.

Tipo: número
Padrão:calculado
haxis.gridlines.multiple

Todos os valores de grade e marcação precisam ser múltiplos do valor dessa opção. Observe que, ao contrário dos intervalos, potências de 10 vezes os múltiplos não são consideradas. Portanto, é possível forçar as marcações como números inteiros especificando gridlines.multiple = 1, ou forçar as marcações para que sejam múltiplos de 1.000, especificando gridlines.multiple = 1000.

Tipo: número
Padrão:1
hAxis.gridlines.units

Substitui o formato padrão para vários aspectos dos tipos de dados de data/hora/hora do dia quando usado com linhas de grade calculadas de acordo com o gráfico. Permite a formatação de anos, meses, dias, horas, minutos, segundos e milissegundos.

O formato geral é:

gridlines: {
  units: {
    years: {format: [/*format strings here*/]},
    months: {format: [/*format strings here*/]},
    days: {format: [/*format strings here*/]}
    hours: {format: [/*format strings here*/]}
    minutes: {format: [/*format strings here*/]}
    seconds: {format: [/*format strings here*/]},
    milliseconds: {format: [/*format strings here*/]},
  }
}
    

Mais informações podem ser encontradas em Datas e horas.

Tipo: objeto
Padrão: nulo
hAxis.minorGridlines

Um objeto com membros para configurar as linhas de grade secundárias no eixo horizontal, semelhante à opção hAxis.gridlines.

Tipo: objeto
Padrão:nulo
hAxis.minorGridlines.color

A cor das linhas de grade secundárias horizontais dentro da área do gráfico. Especifique uma string de cor HTML válida.

Tipo: string
Padrão:uma combinação da linha de grade e das cores do plano de fundo
hAxis.minorGridlines.count

A opção minorGridlines.count foi descontinuada, exceto para desativar linhas de grade secundárias definindo a contagem como 0. O número de linhas de grade secundárias agora depende totalmente do intervalo entre as principais linhas de grade (consulte hAxis.gridlines.interval) e o espaço mínimo necessário (consulte hAxis.minorGridlines.minSpacing).

Tipo: número
Padrão:1
hAxis.minorGridlines.intervalo

A opção minorGridlines.interval é como a opção do intervalo das linhas de grade principais, mas o intervalo escolhido será sempre um divisor uniforme do intervalo da linha de grade principal. O intervalo padrão para escalas lineares é [1, 1.5, 2, 2.5, 5], e para escalas de registro é [1, 2, 5].

Tipo:número
Padrão:1
hAxis.minorGridlines.minSpacing

O espaço mínimo necessário, em pixels, entre as linhas de grade secundárias e as linhas de grade menores e maiores. O valor padrão é 1/2 do minSpacing das principais linhas de grade para escalas lineares e 1/5 o minSpacing para escalas de registro.

Tipo: número
Padrão:calculado
hAxis.minorGridlines.multiple

O mesmo que ocorre no gridlines.multiple principal.

Tipo: número
Padrão:1
hAxis.minorGridlines.units

Substitui o formato padrão para vários aspectos de tipos de dados de data/hora/hora do dia quando usado com gráfico de grade calculado. Permite a formatação de anos, meses, dias, horas, minutos, segundos e milissegundos.

O formato geral é:

gridlines: {
  units: {
    years: {format: [/*format strings here*/]},
    months: {format: [/*format strings here*/]},
    days: {format: [/*format strings here*/]}
    hours: {format: [/*format strings here*/]}
    minutes: {format: [/*format strings here*/]}
    seconds: {format: [/*format strings here*/]},
    milliseconds: {format: [/*format strings here*/]},
  }
}
    

Mais informações podem ser encontradas em Datas e horas.

Tipo: objeto
Padrão:nulo
hAxis.textPosition

Posição do texto do eixo horizontal em relação à área do gráfico. Valores compatíveis: "out", "in", "none".

Tipo: string
Padrão: "out"
hAxis.textStyle

Um objeto que especifica o estilo de texto do eixo horizontal. O objeto tem este formato:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

O color pode ser qualquer string de cor HTML, por exemplo, 'red' ou '#00cc00'. Consulte também fontName e fontSize.

Tipo: objeto
Padrão: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.title

Propriedade hAxis que especifica o título do eixo horizontal.

Tipo: string
Padrão: nulo
hAxis.titleTextStyle

Um objeto que especifica o estilo do texto do título do eixo horizontal. O objeto tem este formato:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

O color pode ser qualquer string de cor HTML, por exemplo, 'red' ou '#00cc00'. Consulte também fontName e fontSize.

Tipo: objeto
Padrão: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.allowContainerBoundaryTextCutoff

Se for falso, os rótulos externos ficarão ocultos, em vez de permitir que sejam cortados pelo contêiner do gráfico. Se verdadeiro, permitirá o corte de rótulo.

Tipo: booleano
Padrão: falso
Texto do texto do relógio (hAxis.slantedText)

Se for verdadeiro, desenhe o texto do eixo horizontal em um ângulo para ajudar a ajustar mais texto ao longo do eixo. Se for falso, desenhe o texto do eixo horizontal na vertical. O comportamento padrão é inclinar o texto se ele não couber quando for desenhado para cima. Essa opção está disponível apenas quando o hAxis.textPosition está definido como "out" (o padrão). O padrão é false para datas e horários.

Tipo: booleano
Padrão:automático
hAxis.slantedTextAngle

É o ângulo do texto do eixo horizontal, se for inclinado. Ignorado se hAxis.slantedText for false ou estiver no modo automático, e o gráfico decidir desenhar o texto horizontalmente. Se o ângulo for positivo, a rotação será no sentido anti-horário e, se for negativa, no sentido horário.

Tipo:número, -90–90
Padrão:30
hAxis.maxAlternation

Número máximo de níveis de texto no eixo horizontal. Se os rótulos de texto dos eixos ficarem sobrecarregados, o servidor poderá deslocar os rótulos vizinhos para cima ou para baixo e, assim, ajustar os rótulos mais próximos. Esse valor especifica o maior número de níveis a ser usado. O servidor poderá usar menos níveis se os rótulos puderem ser ajustados sem sobreposição. Para datas e horas, o padrão é 1.

Tipo:número
Padrão:2
hAxis.maxTextLines

Número máximo de linhas permitido para os rótulos de texto. Os rótulos podem abranger várias linhas se forem muito longos, e o número de linhas for, por padrão, limitado pela altura do espaço disponível.

Tipo:número
Padrão:automático
hAxis.minTextSpacing

Espaçamento mínimo (em pixels) permitido entre dois rótulos de texto adjacentes. Se os rótulos forem muito espaçados ou muito longos, o espaçamento poderá cair abaixo desse limite e, nesse caso, uma das medidas de organização será aplicada (por exemplo, truncando os rótulos ou soltando alguns deles).

Tipo: número
Padrão:o valor de hAxis.textStyle.fontSize
hAxis.showTextEvery

Quantos rótulos de eixo horizontal serão mostrados, em que 1 significa para mostrar todos os rótulos, 2 para mostrar todos os outros rótulos e assim por diante. O padrão é tentar mostrar o máximo possível de rótulos sem sobreposição.

Tipo: número
Padrão:automático
hAxis.viewWindowMode

Especifica como dimensionar o eixo horizontal para renderizar os valores na área do gráfico. Os seguintes valores de string são compatíveis:

  • "pretty": dimensione os valores horizontais para que os valores máximo e mínimo de dados sejam renderizados um pouco à esquerda e à direita da área do gráfico. O viewWindow é expandido para a linha de grade principal mais próxima para números ou a linha de grade secundária mais próxima para datas e horários.
  • "maximizado": dimensione os valores horizontais para que os valores máximo e mínimo de dados toquem na área esquerda e direita da área do gráfico. haxis.viewWindow.min e haxis.viewWindow.max vão ser ignorados.
  • "explicita": uma opção obsoleta para especificar os valores de escala esquerdo e direito da área do gráfico. Descontinuado porque é redundante com haxis.viewWindow.min e haxis.viewWindow.max. Valores de dados fora desses valores serão cortados. É necessário especificar um objeto hAxis.viewWindow descrevendo os valores máximos e mínimos a serem mostrados.
Tipo: string
Padrão: equivalente a "pretinho", mas haxis.viewWindow.min e haxis.viewWindow.max têm precedência, se usados.
hAxis.viewWindow

Especifica o intervalo de corte do eixo horizontal.

Tipo: objeto
Padrão: nulo
hAxis.viewWindow.max

O índice de linhas com base em zero em que a janela de corte termina. Os pontos de dados nesse índice e superiores serão cortados. Junto com vAxis.viewWindowMode.min, ele define um intervalo semiaberto (min, max) que indica os índices de elementos a serem exibidos. Em outras palavras, cada índice de modo que min <= index < max seja exibido.

Ignorado quando hAxis.viewWindowMode é "bonito" ou "maximizado".

Tipo:número
Padrão: automático
hAxis.viewWindow.min

O índice de linhas com base em zero em que a janela de corte começa. Os pontos de dados em índices inferiores a esse serão cortados. Junto com vAxis.viewWindowMode.max, ele define um intervalo semiaberto (min, max) que indica os índices de elementos a serem exibidos. Em outras palavras, cada índice de modo que min <= index < max seja exibido.

Ignorado quando hAxis.viewWindowMode é "bonito" ou "maximizado".

Tipo:número
Padrão:automático
histograma.bucketSize

Codifique o tamanho de cada barra de histograma em vez de permitir que ela seja determinada por algoritmos.

Tipo: número
Padrão: automático
histograma.hideBucketItems

Omita as divisões finas entre os blocos do histograma, transformando-o em uma série de barras sólidas.

Tipo: booleano
Padrão:falso
histograma.lastBucketPercentile

Ao calcular o tamanho do bucket do histograma, ignore as porcentagens lastBucketPercentile na parte superior e inferior. Os valores ainda são incluídos no histograma, mas não afetam o agrupamento por classes.

Tipo: número
Padrão:0
histograma.Valor mínimo

Amplie o intervalo de buckets para incluir esse valor.

Tipo: número
Padrão:usar dados mínimo
histograma.maxValue

Amplie o intervalo de buckets para incluir esse valor.

Tipo:número
Padrão:usar dados máx.
Histo.numBucketsRule

Como calcular o número padrão de buckets. Os valores possíveis são:

  • 'sqrt': calcula a raiz quadrada do número de pontos de dados.
  • 'sturges': derivado da distribuição binomial. Implicita de forma implícita uma distribuição aproximadamente normal.
  • 'rice': uma alternativa mais simples à regra do Sturges.
Para mais detalhes, consulte a Wikipédia - Histograma: número de classes e largura

Tipo: string
Padrão:'sqrt'
altura

Altura do gráfico, em pixels.

Tipo: número
Padrão: altura do elemento em questão
interpolateNulls

Indica se o valor dos pontos ausentes precisa ser identificado. Se for verdadeiro, ele adivinhará o valor dos dados ausentes com base nos pontos vizinhos. Se for falso, ele vai deixar uma quebra na linha no ponto desconhecido.

Isso não é compatível com gráficos Área com a opção isStacked: true/'percent'/'relative'/'absolute'.

Tipo: booleano
Padrão:falso
empilhado

Se definido como verdadeiro, empilha os elementos para todas as séries em cada valor de domínio. Observação: nos gráficos Column, Area e SteppedArea, o Google Graph inverte a ordem dos itens de legenda para corresponder melhor ao empilhamento dos elementos da série (por exemplo, a série 0 será o item de legenda mais abaixo). Isso não se aplica a gráficos de barras.

A opção isStacked também é compatível com o empilhamento de 100%, em que as pilhas de elementos em cada valor de domínio são redimensionadas para somar até 100%.

As opções para isStacked são:

  • false: os elementos não serão empilhados. Essa é a opção padrão.
  • true: empilha os elementos para todas as séries em cada valor de domínio.
  • 'percent': empilha os elementos para todas as séries em cada valor de domínio e os redimensiona para que totalizem 100%, com o valor de cada elemento calculado como uma porcentagem de 100%.
  • 'relative': empilha os elementos para todas as séries em cada valor de domínio e os redimensiona para que adicionem até 1, com o valor de cada elemento calculado como uma fração de 1.
  • 'absolute': funciona da mesma forma que isStacked: true.

Para 100% de empilhamento, o valor calculado de cada elemento aparecerá na dica depois do valor real.

Por padrão, o eixo desejado vai usar valores de escala com base na escala relativa de 0 a 1, como frações de 1 a 'relative', e de 0 a 100% em 'percent'. Observação: ao usar a opção 'percent', os valores de eixo/marcação serão exibidos como porcentagens. No entanto, os valores reais são os valores de escala relativos de 0 a 1. Isso ocorre porque as marcações de eixo percentual são resultado do uso de um formato de "#.##%" nos valores de escala relativos de 0 a 1. Ao usar isStacked: 'percent', especifique as marcações/linhas de grade usando os valores de escala relativos de 0 a 1. Você pode personalizar as linhas de grade/valores de marcação e formatação usando as opções hAxis/vAxis apropriadas.

O empilhamento de 100% é compatível apenas com valores de dados do tipo number e precisa ter um valor de referência de zero.

Tipo: booleano/string
Padrão:falso
lenda

Um objeto com membros para configurar vários aspectos da legenda. Para especificar as propriedades desse objeto, use a notação literal de objeto, conforme mostrado aqui:

{position: 'top', textStyle: {color: 'blue', fontSize: 16}}
Tipo: objeto
Padrão:nulo
legenda.alinhamento

Alinhamento da legenda. Será um dos seguintes valores:

  • "start": alinhado ao início da área alocada para a legenda.
  • 'center' - centralizado na área alocada para a legenda.
  • 'end' - Alinhado ao final da área alocada para a legenda.

O início, o centro e o fim são relativos ao estilo (vertical ou horizontal) da legenda. Por exemplo, em uma legenda "direita", "início" e "fim" estão na parte superior e inferior, respectivamente. Para uma legenda "superior", "início" e "fim" estariam à esquerda e à direita da área, respectivamente.

O valor padrão depende da posição da legenda. Para legendas "inferior", o padrão é "center", outras legendas padrão são "start".

Tipo: string
Padrão:automático
legenda.maxLines

Número máximo de linhas na legenda. Defina um número maior do que um para adicionar linhas à legenda. Observação: a lógica exata usada para determinar o número real de linhas renderizadas ainda está em fluxo.

No momento, essa opção funciona apenas quando caption.position é "top".

Tipo: número
Padrão:1
legenda.pagina

Índice inicial selecionado da página com base em zero da legenda.

Tipo:número
Padrão: 0
legenda.posição

Posição da legenda. Será um dos seguintes valores:

  • "bottom" – abaixo do gráfico.
  • "left" - à esquerda do gráfico, desde que o eixo esquerdo não tenha séries associadas a ele. Portanto, se você quiser a legenda à esquerda, use a opção targetAxisIndex: 1.
  • "in": dentro do gráfico, no canto superior esquerdo.
  • "none": nenhuma legenda é exibida.
  • "right" - à direita do gráfico. Incompatível com a opção vAxes.
  • "top" - acima do gráfico.
Tipo: string
Padrão: "right"
legenda.Estilodetexto

Um objeto que especifica o estilo do texto da legenda. O objeto tem este formato:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

O color pode ser qualquer string de cor HTML, por exemplo, 'red' ou '#00cc00'. Consulte também fontName e fontSize.

Tipo: objeto
Padrão: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
orientação

A orientação do gráfico. Quando definido como 'vertical', gira os eixos do gráfico para que, por exemplo, um gráfico de colunas se torne um gráfico de barras e um gráfico de área cresça para a direita em vez de para cima:

Tipo: string
Padrão: "horizontal"
categorias inversas

Se definida como verdadeira, a série será desenhada da direita para a esquerda. O padrão é desenhar da esquerda para a direita.

Tipo: booleano
Padrão: falso
Série

Uma matriz de objetos, cada um descrevendo o formato da série correspondente no gráfico. Para usar valores padrão para uma série, especifique um objeto vazio {}. Se uma série ou um valor não for especificado, o valor global será usado. Cada objeto oferece suporte às seguintes propriedades:

  • color: a cor a ser usada para esta série. Especifique uma string de cor HTML válida.
  • labelInLegend: a descrição da série que aparece na legenda do gráfico.
  • targetAxisIndex: a qual eixo atribuir esta série, em que 0 é o eixo padrão e 1 é o eixo oposto. O valor padrão é 0. Defina como 1 para definir um gráfico em que diferentes séries são renderizadas em diferentes eixos. Pelo menos uma série está alocada ao eixo padrão. Você pode definir uma escala diferente para cada eixo.
  • visibleInLegend: um valor booleano, em que verdadeiro significa que a série precisa ter uma entrada de legenda e false significa que não deve. O padrão é "true".

É possível especificar uma matriz de objetos, sendo que cada uma delas se aplica à série na ordem fornecida, ou especificar um objeto em que cada filho tem uma chave numérica indicando a qual série ela se aplica. Por exemplo, as duas declarações a seguir são idênticas e declaram a primeira série como preta e ausente da legenda, e a quarta como vermelha e ausente da legenda:

series: [
  {color: 'black', visibleInLegend: false}, {}, {},
  {color: 'red', visibleInLegend: false}
]
series: {
  0:{color: 'black', visibleInLegend: false},
  3:{color: 'red', visibleInLegend: false}
}
    
Tipo: matriz de objetos ou objetos com objetos aninhados
Padrão: {}
tema

Um tema é um conjunto de valores de opção predefinidos que funcionam juntos para alcançar um comportamento ou efeito visual específico. Atualmente, apenas um tema está disponível:

  • "maximized" - maximiza a área do gráfico e desenha a legenda e todos os rótulos dentro da área do gráfico. Define as seguintes opções:
    chartArea: {width: '100%', height: '100%'},
    legend: {position: 'in'},
    titlePosition: 'in', axisTitlesPosition: 'in',
    hAxis: {textPosition: 'in'}, vAxis: {textPosition: 'in'}
            
Tipo: string
Padrão:nulo
title

Texto a ser exibido acima do gráfico.

Tipo: string
Padrão: sem título
Posição do título

Onde colocar o título do gráfico, em comparação com a área do gráfico. Os valores suportados são:

  • in - Desenhar o título dentro da área do gráfico.
  • out - desenhe o título fora da área do gráfico.
  • nenhum: omita o título.
Tipo: string
Padrão: "out"
TítulodoEstiloEstilo

Um objeto que especifica o estilo do texto do título. O objeto tem este formato:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

O color pode ser qualquer string de cor HTML, por exemplo, 'red' ou '#00cc00'. Consulte também fontName e fontSize.

Tipo: objeto
Padrão: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
dica

Um objeto com membros para configurar vários elementos de dica. Para especificar as propriedades desse objeto, use a notação literal de objeto, conforme mostrado aqui:

{textStyle: {color: '#FF0000'}, showColorCode: true}
Tipo: objeto
Padrão:nulo
tooltip.isHTML

Se definida como verdadeira, use dicas renderizadas por HTML (em vez de renderizadas por SVG). Consulte Como personalizar o conteúdo de dicas para mais detalhes.

Observação: a personalização do conteúdo da dica de HTML por meio do papel de dados da coluna de dica de ferramenta não é aceita pela visualização Gráfico de bolhas.

Tipo: booleano
Padrão:falso
tooltip.showColorCode

Se verdadeiro, mostra quadrados coloridos ao lado das informações da série na dica. O padrão é verdadeiro quando focusTarget estiver definido como "categoria". Caso contrário, será falso.

Tipo: booleano
Padrão: automático
tooltip.textStyle

Um objeto que especifica o estilo do texto da dica. O objeto tem este formato:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

O color pode ser qualquer string de cor HTML, por exemplo, 'red' ou '#00cc00'. Consulte também fontName e fontSize.

Tipo: objeto
Padrão: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
tooltip.trigger

A interação do usuário que faz com que a dica seja exibida:

  • "focus": a dica será exibida quando o usuário passar o cursor sobre o elemento.
  • "none": a dica não será exibida.
Tipo: string
Padrão: "focus"
Axx

Especifica propriedades para eixos verticais individuais, se o gráfico tiver vários eixos verticais. Cada objeto filho é um objeto vAxis e pode conter todas as propriedades compatíveis com vAxis. Esses valores substituem as configurações globais da mesma propriedade.

Para especificar um gráfico com vários eixos verticais, primeiro defina um novo eixo usando series.targetAxisIndex. Em seguida, configure o eixo usando vAxes. O exemplo a seguir atribui a série 2 ao eixo direito e especifica um título e estilo de texto personalizados para ele:

{
  series: {
    2: {
      targetAxisIndex:1
    }
  },
  vAxes: {
    1: {
      title:'Losses',
      textStyle: {color: 'red'}
    }
  }
}
    

Essa propriedade pode ser um objeto ou uma matriz: o objeto é uma coleção de objetos, cada uma com um rótulo numérico que especifica o eixo que define. Esse é o formato mostrado acima. A matriz é uma matriz de objetos, um por eixo. Por exemplo, a seguinte notação de estilo de matriz é idêntica ao objeto vAxis mostrado acima:

vAxes: [
  {}, // Nothing specified for axis 0
  {
    title:'Losses',
    textStyle: {color: 'red'} // Axis 1
  }
]
    
Tipo: matriz de objeto ou objeto com objetos filhos
Padrão: nulo
Eixo

Um objeto com membros para configurar vários elementos de eixo vertical. Para especificar as propriedades desse objeto, use a notação literal de objeto, conforme mostrado aqui:

{title: 'Hello', titleTextStyle: {color: '#FF0000'}}
Tipo: objeto
Padrão:nulo
vAxis.baseline

Propriedade vAxis que especifica o valor de referência para o eixo vertical. Se o valor de referência for maior que a linha de grade mais alta ou menor que a linha de grade mais baixa, ele será arredondado para a linha de grade mais próxima.

Tipo: número
Padrão: automático
vAxis.baselineColor

Especifica a cor do valor de referência do eixo vertical. Pode ser qualquer string de cor HTML, por exemplo, 'red' ou '#00cc00'.

Tipo:número
Padrão: "preto"
vAxis.direction

A direção em que os valores ao longo do eixo vertical crescem. Por padrão, os valores mais baixos ficam na parte inferior do gráfico. Especifique -1 para inverter a ordem dos valores.

Tipo: 1 ou -1
Padrão: 1
vAxis.format

Uma string de formato para rótulos de eixo numérico. Esse é um subconjunto do conjunto de padrões de ICU . Por exemplo, {format:'#,###%'} exibirá os valores "1.000%", "750%" e "50%" para os valores 10, 7,5 e 0,5. Também é possível fornecer o seguinte:

  • {format: 'none'}: exibe números sem formatação (por exemplo, 8000000)
  • {format: 'decimal'}: exibe números com separadores de milhares (por exemplo, 8.000.000)
  • {format: 'scientific'}: exibe números em notação científica (por exemplo, 8e6)
  • {format: 'currency'}: exibe números na moeda local (por exemplo, US$ 8.000.000)
  • {format: 'percent'}: exibe números como porcentagens (por exemplo, 800.000.000%)
  • {format: 'short'}: exibe números abreviados (por exemplo, 8 mi)
  • {format: 'long'}: exibe números como palavras completas (por exemplo, 8 milhões)

A formatação real aplicada ao rótulo é derivada da localidade com que a API foi carregada. Para mais detalhes, consulte Como carregar gráficos com uma localidade específica.

Ao calcular valores de marcação e linhas de grade, várias combinações alternativas de todas as opções relevantes serão consideradas, e as alternativas serão rejeitadas se os rótulos de marcação formatados forem duplicados ou se sobrepuserem. Portanto, especifique format:"#" se quiser mostrar apenas valores de marcação inteiros. No entanto, se nenhuma alternativa atender a essa condição, nenhuma grade ou marcação será exibida.

Tipo: string
Padrão:automático
vAxis.gridlines

Um objeto com membros para configurar as linhas de grade no eixo vertical. As linhas de grade do eixo vertical são desenhadas horizontalmente. Para especificar propriedades desse objeto, use a notação literal de objeto, conforme mostrado aqui:

{color: '#333', minSpacing: 20}
Tipo: objeto
Padrão:nulo
vAxis.gridlines.color

A cor das linhas de grade verticais dentro da área do gráfico. Especifique uma string de cor HTML válida.

Tipo: string
Padrão: "#CCC"
vAxis.gridlines.count

O número aproximado de linhas de grade horizontais na área do gráfico. Se você especificar um número positivo para a gridlines.count, ela vai ser usada para calcular o minSpacing entre as linhas de grade. Especifique um valor de 1 para desenhar apenas uma linha de grade, ou 0 para desenhar nenhuma linha de grade. Especifique -1, que é o padrão, para calcular automaticamente o número de linhas de grade com base em outras opções.

Tipo:número
Padrão: -1
vAxis.gridlines.interval

Uma matriz de tamanhos (como valores de dados, não pixels) entre as linhas de grade adjacentes. No momento, essa opção é só para eixos numéricos, mas é análoga às opções gridlines.units.<unit>.interval, que são usadas apenas para datas e horas. Para escalas lineares, o padrão é [1, 2, 2.5, 5], o que significa que os valores da linha de grade podem cair em cada unidade (1), em unidades pares (2) ou em múltiplos de 2,5 ou 5. Qualquer potência de 10 vezes esses valores também é considerada (por exemplo, [10, 20, 25, 50] e [.1, .2, .25, .5]). Para escalas de registros, o padrão é [1, 2, 5].

Tipo:número entre 1 e 10, sem incluir 10.
Padrão:calculado
vAxis.gridlines.minSpacing

O espaço mínimo da tela, em pixels, entre as principais linhas de grade do Hadoop. O padrão para as principais linhas de grade é 40 para escalas lineares e 20 para escalas de registros. Se você especificar count, e não minSpacing, o minSpacing será calculado da contagem. Por outro lado, se você especificar minSpacing, e não count, a contagem será calculada com base em minSpacing. Se você especificar ambos, minSpacing será substituído.

Tipo: número
Padrão: calculado
vAxis.gridlines.multiple

Todos os valores de grade e marcação precisam ser múltiplos do valor dessa opção. Observe que, ao contrário dos intervalos, potências de 10 vezes os múltiplos não são consideradas. Portanto, é possível forçar as marcações como números inteiros especificando gridlines.multiple = 1, ou forçar as marcações para que sejam múltiplos de 1.000, especificando gridlines.multiple = 1000.

Tipo: número
Padrão: 1
vAxis.gridlines.units

Substitui o formato padrão para vários aspectos dos tipos de dados de data/hora/hora do dia quando usado com linhas de grade calculadas de acordo com o gráfico. Permite a formatação de anos, meses, dias, horas, minutos, segundos e milissegundos.

O formato geral é:

gridlines: {
  units: {
    years: {format: [/*format strings here*/]},
    months: {format: [/*format strings here*/]},
    days: {format: [/*format strings here*/]},
    hours: {format: [/*format strings here*/]},
    minutes: {format: [/*format strings here*/]},
    seconds: {format: [/*format strings here*/]},
    milliseconds: {format: [/*format strings here*/]}
  }
}
    

Mais informações podem ser encontradas em Datas e horas.

Tipo: objeto
Padrão: nulo
vAxis.minorGridlines

Um objeto com membros para configurar as linhas de grade secundárias no eixo vertical, semelhante à opção vAxis.gridlines.

Tipo: objeto
Padrão: nulo
vAxis.minorGridlines.color

A cor das pequenas linhas de grade verticais dentro da área do gráfico. Especifique uma string de cor HTML válida.

Tipo: string
Padrão: uma combinação da linha de grade e das cores do plano de fundo
vAxis.minorGridlines.count

O uso da opção minorGridlines.count foi descontinuado, exceto pela desativação de linhas de grade menores, definindo a contagem como 0. O número de linhas de grade secundárias depende do intervalo entre as linhas de grade principais (consulte vAxis.gridlines.interval) e o espaço mínimo necessário (consulte vAxis.minorGridlines.minSpacing).

Tipo: número
Padrão: 1
vAxis.minorGridlines.intervalo

A opção minorGridlines.interval é como a opção do intervalo das linhas de grade principais, mas o intervalo escolhido será sempre um divisor uniforme do intervalo da linha de grade principal. O intervalo padrão para escalas lineares é [1, 1.5, 2, 2.5, 5], e para escalas de registro é [1, 2, 5].

Tipo: número
Padrão:1
vAxis.minorGridlines.minSpacing

O espaço mínimo necessário, em pixels, entre as linhas de grade secundárias e as linhas de grade menores e maiores. O valor padrão é 1/2 do minSpacing das principais linhas de grade para escalas lineares e 1/5 o minSpacing para escalas de registro.

Tipo: número
Padrão:calculado
vAxis.minorGridlines.multiple

O mesmo que ocorre no gridlines.multiple principal.

Tipo:número
Padrão:1
vAxis.minorGridlines.units

Substitui o formato padrão para vários aspectos de tipos de dados de data/hora/hora do dia quando usado com gráfico de grade calculado. Permite a formatação de anos, meses, dias, horas, minutos, segundos e milissegundos.

O formato geral é:

gridlines: {
  units: {
    years: {format: [/*format strings here*/]},
    months: {format: [/*format strings here*/]},
    days: {format: [/*format strings here*/]}
    hours: {format: [/*format strings here*/]}
    minutes: {format: [/*format strings here*/]}
    seconds: {format: [/*format strings here*/]},
    milliseconds: {format: [/*format strings here*/]},
  }
}
    

Mais informações podem ser encontradas em Datas e horas.

Tipo: objeto
Padrão: nulo
vAxis.logScale

Se for verdadeiro, torna o eixo vertical uma escala logarítmica. Observação: todos os valores precisam ser positivos.

Tipo: booleano
Padrão: falso
vAxis.scaleType

Propriedade vAxis que faz com que o eixo vertical seja uma escala logarítmica. Será um dos seguintes valores:

  • null: nenhum escalonamento logarítmico é executado.
  • "log": escalonamento logarítmico. Os valores negativos e zero não são representados no gráfico. Essa opção é igual à configuração de vAxis: { logscale: true }.
  • "MirrorLog": escalonamento logarítmico em que valores negativos e zero são representados no gráfico. O valor plotado de um número negativo é o negativo do registro do valor absoluto. Valores próximos a 0 são representados em uma escala linear.
Tipo: string
Padrão:nulo
vAxis.textPosition

Posição do texto do eixo vertical em relação à área do gráfico. Valores compatíveis: "out", "in", "none".

Tipo: string
Padrão: "out"
vAxis.textStyle

Um objeto que especifica o estilo de texto do eixo vertical. O objeto tem este formato:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

O color pode ser qualquer string de cor HTML, por exemplo, 'red' ou '#00cc00'. Consulte também fontName e fontSize.

Tipo: objeto
Padrão: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
Marcas de vídeo.

Substitui as marcações do eixo Y geradas automaticamente pela matriz especificada. Cada elemento da matriz precisa ser um valor de marcação válido (como um número, data, data/hora ou hora do dia) ou um objeto. Se for um objeto, ele precisará ter uma propriedade v para o valor da marcação e uma propriedade f opcional contendo a string literal a ser exibida como o rótulo.

A viewWindow será expandida automaticamente para incluir as marcações mínima e máxima, a menos que você especifique um viewWindow.min ou viewWindow.max para substituir.

Exemplos:

  • vAxis: { ticks: [5,10,15,20] }
  • vAxis: { ticks: [{v:32, f:'thirty two'}, {v:64, f:'sixty four'}] }
  • vAxis: { ticks: [new Date(2014,3,15), new Date(2013,5,15)] }
  • vAxis: { ticks: [16, {v:32, f:'thirty two'}, {v:64, f:'sixty four'}, 128] }
Tipo: matriz de elementos
Padrão:automático
vAxis.title

Propriedade vAxis que especifica um título para o eixo vertical.

Tipo: string
Padrão: sem título
vAxis.titleTextStyle

Um objeto que especifica o estilo do texto do título do eixo vertical. O objeto tem este formato:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
  

O color pode ser qualquer string de cor HTML, por exemplo, 'red' ou '#00cc00'. Consulte também fontName e fontSize.

Tipo: objeto
Padrão: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.maxValue

Move o valor máximo do eixo vertical para o valor especificado; isso será crescente na maioria dos gráficos. Será ignorado se esse valor for definido como um valor menor que o valor y máximo dos dados. vAxis.viewWindow.max modifica esta propriedade.

Tipo: número
Padrão: automático
vAxis.minValue

Move o valor mínimo do eixo vertical para o valor especificado. Esse valor será decrescente na maioria dos gráficos. Será ignorado se esse valor for maior que o valor y mínimo dos dados. vAxis.viewWindow.min modifica esta propriedade.

Tipo:número
Padrão:nulo
vAxis.viewWindowMode

Especifica como dimensionar o eixo vertical para renderizar os valores na área do gráfico. Os seguintes valores de string são compatíveis:

  • "pretty" - dimensione os valores verticais para que os valores máximo e mínimo dos dados sejam renderizados um pouco dentro das partes de baixo e de cima da área do gráfico. O viewWindow é expandido para a linha de grade principal mais próxima para números ou a linha de grade secundária mais próxima para datas e horários.
  • "maximizado": dimensione os valores verticais para que os valores máximo e mínimo de dados toquem nas partes de cima e de baixo da área do gráfico. vaxis.viewWindow.min e vaxis.viewWindow.max vão ser ignorados.
  • "explicita": uma opção obsoleta para especificar os valores de escala superior e inferior da área do gráfico. Descontinuado porque é redundante com vaxis.viewWindow.min e vaxis.viewWindow.max. Os valores de dados fora desses valores serão cortados. É preciso especificar um objeto vAxis.viewWindow descrevendo os valores máximos e mínimos a serem mostrados.
Tipo: string
Padrão:equivalente a "pretinho", mas vaxis.viewWindow.min e vaxis.viewWindow.max têm precedência, se usados.
vAxis.viewWindow

Especifica o intervalo de corte do eixo vertical.

Tipo: objeto
Padrão: nulo
vAxis.viewWindow.max

O valor máximo de dados verticais para renderização.

Ignorado quando vAxis.viewWindowMode é "bonito" ou "maximizado".

Tipo: número
Padrão: automático
vAxis.viewWindow.min

O valor mínimo de dados verticais para renderização.

Ignorado quando vAxis.viewWindowMode é "bonito" ou "maximizado".

Tipo:número
Padrão: automático
largura

Largura do gráfico, em pixels.

Tipo:número
Padrão:largura do elemento contido

Métodos

Método
draw(data, options)

Desenha o gráfico. O gráfico aceita mais chamadas de método somente após o evento ready ser acionado. Extended description

Tipo de retorno:nenhum
getAction(actionID)

Retorna o objeto de ação da dica com a actionID solicitada.

Return Type: objeto
getBoundingBox(id)

Retorna um objeto que contém os elementos esquerdo, superior, largura e altura do elemento do gráfico id. O formato de id ainda não foi documentado (são os valores de retorno dos manipuladores de eventos), mas veja alguns exemplos:

var cli = chart.getChartLayoutInterface();

Altura da área do gráfico
cli.getBoundingBox('chartarea').height
Largura da terceira barra na primeira série de um gráfico de barras ou de colunas
cli.getBoundingBox('bar#0#2').width
Caixa delimitadora do quinto encaixe de um gráfico de pizza
cli.getBoundingBox('slice#4')
Caixa delimitadora dos dados de um gráfico vertical (por exemplo, coluna):
cli.getBoundingBox('vAxis#0#gridline')
Caixa delimitadora dos dados de um gráfico horizontal (por exemplo, uma barra):
cli.getBoundingBox('hAxis#0#gridline')

Os valores são relativos ao contêiner do gráfico. Chame essa função após o gráfico ser desenhado.

Return Type: objeto
getChartAreaBoundingBox()

Retorna um objeto que contém o lado esquerdo, o topo, a largura e a altura do conteúdo do gráfico (ou seja, excluir rótulos e legendas):

var cli = chart.getChartLayoutInterface();

cli.getChartAreaBoundingBox().left
cli.getChartAreaBoundingBox().top
cli.getChartAreaBoundingBox().height
cli.getChartAreaBoundingBox().width

Os valores são relativos ao contêiner do gráfico. Chame essa função após o gráfico ser desenhado.

Return Type: objeto
getChartLayoutInterface()

Retorna um objeto que contém informações sobre o posicionamento na tela do gráfico e os elementos dele.

Os seguintes métodos podem ser chamados no objeto retornado:

  • getBoundingBox
  • getChartAreaBoundingBox
  • getHAxisValue
  • getVAxisValue
  • getXLocation
  • getYLocation

Chame essa função após o gráfico ser desenhado.

Return Type: objeto
getHAxisValue(xPosition, optional_axis_index)

Retorna o valor de dados horizontal em xPosition, que é um deslocamento de pixel da borda esquerda do contêiner do gráfico. Pode ser negativa.

Exemplo: chart.getChartLayoutInterface().getHAxisValue(400).

Chame essa função após o gráfico ser desenhado.

Tipo de retorno:número
getImageURI()

Retorna o gráfico serializado como um URI de imagem.

Chame essa função após o gráfico ser desenhado.

Consulte Como imprimir gráficos PNG.

Tipo de retorno:string
getSelection()

Retorna uma matriz das entidades do gráfico selecionadas. Entidades selecionáveis são barras, entradas de legenda e categorias. Nesse gráfico, apenas uma entidade pode ser selecionada por vez. Extended description

Tipo de retorno:matriz de elementos de seleção
getVAxisValue(yPosition, optional_axis_index)

Retorna o valor de dados verticais em yPosition, que é um deslocamento de pixel da borda superior do contêiner do gráfico. Pode ser negativa.

Exemplo: chart.getChartLayoutInterface().getVAxisValue(300).

Chame essa função após o gráfico ser desenhado.

Tipo de retorno: número
getXLocation(dataValue, optional_axis_index)

Retorna a coordenada X de pixel de dataValue em relação à borda esquerda do contêiner do gráfico.

Exemplo: chart.getChartLayoutInterface().getXLocation(400).

Chame essa função após o gráfico ser desenhado.

Tipo de retorno:número
getYLocation(dataValue, optional_axis_index)

Retorna a coordenada y de pixel de dataValue em relação à borda superior do contêiner do gráfico.

Exemplo: chart.getChartLayoutInterface().getYLocation(300).

Chame essa função após o gráfico ser desenhado.

Tipo de retorno: número
removeAction(actionID)

Remove a ação de dica com a actionID solicitada do gráfico.

Tipo de retorno: none
setAction(action)

Define uma ação de dica a ser executada quando o usuário clica no texto de ação.

O método setAction usa um objeto como parâmetro de ação. Esse objeto precisa especificar três propriedades: id, o ID da ação sendo definida, text, o texto que vai aparecer na dica da ação, e action, a função que precisa ser executada quando um usuário clica no texto da ação.

Toda e qualquer ação de dica precisa ser definida antes de chamar o método draw() do gráfico. Descrição estendida.

Tipo de retorno: none
setSelection()

Seleciona as entidades do gráfico especificadas. Cancela qualquer seleção anterior. Entidades selecionáveis são barras, entradas de legenda e categorias. Somente uma entidade pode ser selecionada por vez para este gráfico. Extended description

Tipo de retorno: nenhum
clearChart()

Limpa o gráfico e libera todos os recursos alocados.

Tipo de retorno: nenhum

Eventos

Para mais informações sobre como usar esses eventos, consulte Interatividade básica, Como lidar com eventos e Eventos de disparo.

Nome
animationfinish

Disparado quando a animação de transição é concluída.

Propriedades:nenhuma
click

Disparado quando o usuário clica dentro do gráfico. Pode ser usado para identificar quando o título, os elementos de dados, as entradas de legendas, os eixos, as linhas de grade ou os rótulos são clicados.

Propriedades:targetID.
error

Disparado quando ocorre um erro ao tentar renderizar o gráfico.

Propriedades: ID e mensagem
legendpagination

Disparado quando o usuário clica nas setas de paginação de legenda. Retorna o índice de páginas atual com base em zero e o número total de páginas.

Propriedades: currentPageIndex, totalPages
onmouseover

Disparado quando o usuário passa o mouse sobre uma entidade visual. Transmite os índices de linha e coluna do elemento da tabela de dados correspondente. Uma barra está correlacionada a uma célula na tabela de dados, uma entrada de legenda a uma coluna (o índice da linha é nulo) e uma categoria a uma linha (o índice da coluna é nulo).

Propriedades:linha, coluna
onmouseout

Disparado quando o usuário passa o mouse sobre uma entidade visual. Retorna os índices de linha e coluna do elemento da tabela de dados correspondente. Uma barra está correlacionada a uma célula na tabela de dados, uma entrada de legenda a uma coluna (o índice da linha é nulo) e uma categoria a uma linha (o índice da coluna é nulo).

Propriedades:linha, coluna
ready

O gráfico está pronto para chamadas de método externo. Se você quiser interagir com o gráfico e chamar métodos depois de desenhá-lo, configure um listener para esse evento antes de chamar o método draw e chame-o somente depois que o evento for acionado.

Propriedades:nenhuma
select

Disparado quando o usuário clica em uma entidade visual. Para saber o que foi selecionado, chame getSelection().

Propriedades:nenhuma

Política de dados

Todos os códigos e dados são processados e renderizados no navegador. Nenhum dado é enviado para nenhum servidor.