Perguntas frequentes

Como começar

O que é a API de visualização do Google?
Com a API de visualização do Google, você pode criar gráficos e aplicativos de relatórios usando dados estruturados e integrá-los diretamente ao seu site.
O que posso fazer com a API de visualização?
Com a API de visualização do Google, é possível acessar dados estruturados, criados localmente no navegador ou recuperados de fontes de dados compatíveis em um formato tabular simples. Você também pode implementar sua própria fonte de dados como a API de visualização e permitir que qualquer visualização e/ou aplicativo compatível com a visualização acesse os dados. O formato pode ser usado por aplicativos de relatórios, análises ou gráficos. Assim, é possível visualizar os dados e/ou adicionar novas funcionalidades a aplicativos, como as Planilhas Google.
Onde posso encontrar a documentação da API de visualização?
O guia para desenvolvedores e todas as outras documentações relacionadas estão disponíveis em https://developers.google.com/chart/interactive/docs.
Como crio um novo gráfico?
A melhor maneira de começar é ler a Introdução e a seção Guia de início rápido.
O que é um URL de fonte de dados?
O URL da fonte de dados é o identificador exclusivo de uma fonte da API de visualização. O URL de uma fonte de dados também pode incluir parâmetros de linguagem de consulta do gráfico. Nesse caso, uma consulta (como classificação, agrupamento etc.) é realizada na fonte de dados antes de buscar os dados.
Onde posso encontrar um exemplo de código de aplicativos de gráfico que usam a API de visualização?
Você encontra um exemplo de código na documentação do exemplo de código da API de visualização.
Um aplicativo Flash pode acessar a API de visualização?
Com certeza. A API de visualização usa uma API JavaScript, mas há bibliotecas que permitem a conexão de aplicativos em Flash com o código JavaScript. Uma dessas bibliotecas que você pode achar útil pode ser encontrada em http://code.google.com/p/swfobject. Veja abaixo alguns problemas de desenvolvimento que afetam o Flash.
Como faço para implementar uma fonte de dados?
Leia a seção sobre como usar e criar um gráfico para saber como os gráficos funcionam. Em seguida, leia Como implementar uma fonte de dados para saber como criar uma fonte de dados. Também é possível usar a biblioteca Java de origem de dados de gráficos do Google para começar rapidamente se você usar Java.
Posso acessar um gráfico de um aplicativo Java?
Sim. A Biblioteca de visualização do Google do Google Web Toolkit (GWT, na sigla em inglês) permite acessar visualizações compatíveis com a API a partir do código Java compilado com o compilador GWT e escrever visualizações compatíveis com a API de visualização em Java usando o compatível com GWT. A biblioteca de candidato a lançamento também oferece suporte ao modelo de eventos da API de visualização.
Posso acessar um gráfico de um aplicativo escrito com o compilador do Google Web Toolkit (GWT)?
Sim. A Biblioteca de visualização do Google do Google Web Toolkit (GWT, na sigla em inglês) permite acessar visualizações compatíveis com a API a partir do código Java compilado com o compilador GWT e escrever visualizações compatíveis com a API de visualização em Java usando o compatível com GWT. A biblioteca de candidato a lançamento também oferece suporte ao modelo de eventos da API de visualização.
Tenho uma dúvida/problema diferente. Com quem devo entrar em contato para obter mais informações?
Publique sua pergunta no grupo de discussão da API Google Visualization para receber ajuda da comunidade de desenvolvedores de visualização. A equipe de visualização do Google também participa desse grupo para responder a perguntas.

Como usar a API

Qual é a diferença entre a API de gráficos do Google e a API de visualização do Google?

A API de gráficos oferece uma maneira simples de criar gráficos de imagens de vários tipos enviando um URL formatado que inclui as opções de configuração de dados e gráficos para um servidor do Google. Ela inclui um conjunto fechado de gráficos com várias opções. Os conjuntos de dados da API de gráficos são limitados ao tamanho de um URL (cerca de 2 mil).

Com a API de visualização, é possível conectar gráficos e fontes de dados pela Web e publicá-los:

  • A API de visualização fornece uma API JavaScript para acessar gráficos.
  • Sua galeria de gráficos inclui gráficos criados pelo Google, mas também está aberto para que terceiros criem suas próprias visualizações em conformidade com a API de visualização.
  • Os gráficos da API de visualização podem ser qualquer coisa que possa ser renderizada por um navegador. Isso inclui imagens, JavaScript, gráficos vetoriais, Flash etc.
  • Uma quantidade considerável de gráficos da API de gráficos pode ser acessada pela API de visualização, embora algumas das opções de configuração não estejam disponíveis.
  • A API também oferece um protocolo de transferência documentado e uma maneira de qualquer pessoa expor as fontes de dados a qualquer visualização de APIs.
  • A API tem um modelo de eventos definido que permite que os gráficos lancem e recebam eventos e, assim, se comuniquem com a página que hospedam e/ou outros gráficos na página.
Quais fontes de dados posso acessar usando a API de visualização?
Com a API de visualização, é possível acessar dados localmente no navegador criando o formato padrão de tabela de dados da API ou acessar qualquer fonte de dados compatível com a API. Aplicativos conhecidos que já aceitam a API são o Planilhas Google e o Salesforce.com na plataforma para desenvolvedores Force.com. Também é possível implementar seus próprios dados como uma fonte de dados de gráfico.
Meu aplicativo espera que os dados recebidos estejam em um formato específico. Como lidar com exceções?
Você pode usar os métodos getNumberOfColumns() e getColumnType() da classe google.visualization.DataTable para testar se os dados recebidos correspondem ao esperado e emitir uma mensagem de erro quando houver incompatibilidades.
É seguro incorporar um gráfico em meu site?
A execução de códigos de terceiros diretamente no seu site apresenta riscos inerentes. O Google não oferece garantias nem faz declarações sobre o desempenho, a qualidade, a segurança ou o conteúdo do aplicativo. Os apps de gráficos que não obedecerem aos Termos de Serviço da API de visualização do Google podem ser removidos das galerias.
Posso usar gráficos off-line?
Os computadores dos usuários precisam ter acesso a https://www.gstatic.com/charts/loader.js para usar os recursos interativos do Gráficos Google. Isso ocorre porque as bibliotecas de visualização exigidas pela sua página são carregadas dinamicamente antes de serem usadas. O código para carregar a biblioteca adequada faz parte do script incluído e é chamado quando você invoca o método google.charts.load(). De acordo com nossos Termos de Serviço, não é permitido fazer o download do código google.charts.load ou google.visualization para usar off-line.
Posso fazer o download e hospedar o código do gráfico localmente ou em uma intranet?
Nossos Termos de Serviço não permitem que você faça o download e salve ou hospede o código google.charts.load ou google.visualization. No entanto, se você não precisa da interatividade dos gráficos do Google, faça uma captura de tela dos gráficos e use-os como quiser.

Solução de problemas

Por que meu gráfico não aparece?

Primeiro, verifique o console JavaScript. No Google Chrome, você pode acessar o Console JavaScript em Chrome -> Visualizar -> Desenvolvedor -> Console JavaScript ou Chrome -> Ferramentas -> Console JavaScript. Todos os navegadores modernos têm um console JavaScript; talvez seja necessário pesquisar nos menus com nomes como “Avançado” ou “Ferramentas do desenvolvedor” para encontrá-lo.

Esperamos que o console leve você ao problema imediatamente. No entanto, às vezes pode ser difícil traduzir a mensagem do console para a causa subjacente. Aqui estão algumas armadilhas comuns:

  • Você pode estar usando o Google Loader de forma incorreta.
    • Carregue ocharts/loader.js apenas uma vez. Não importa quantos gráficos você tenha na sua página da Web, você deve ter apenas uma chamada como esta: 
      <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> // Do this ONCE.
      Ela pode estar no cabeçalho ou no corpo da sua página da Web, dependendo de quando você quer que o carregamento ocorra.
    • O ideal é chamar google.charts.load apenas uma vez, com todos os pacotes necessários para sua página da Web. 
      <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script>
<script>
  google.charts.load("current", {packages: ["corechart", "timeline"]});

  google.charts.setOnLoadCallback(drawBarChart1);
  function drawBarChart1() {
    ...
    var barChart1 = new google.visualization.BarChart(document.getElementById('chart1'));
    ...
  }

  google.charts.setOnLoadCallback(drawBarChart2);
  function drawBarChart2() {
    ...
    var barChart2 = new google.visualization.BarChart(document.getElementById('chart2'));
    ...
  }

  google.charts.setOnLoadCallback(drawTimeline);
  function drawTimeline() {
    ...
    var timeline = new google.visualization.Timeline(document.getElementById('chart3'));
    ...
  }

</script>
<div id="chart1"></div>
...
<div id="chart2"></div>
...
<div id="chart3"></div>
  • Cada gráfico precisa ter um ID de elemento exclusivo (por exemplo, chart1, chart2 no exemplo acima).
  • Procure erros de digitação. Lembre-se de que a linguagem JavaScript diferencia maiúsculas de minúsculas.

Se você ainda estiver com dúvidas, pesquise no grupo de discussão da API Google Visualization para ver se alguém já teve algum problema semelhante. Se você não encontrar uma postagem que responda à sua pergunta, publique a pergunta no grupo com um link para uma página da Web que demonstre o problema. Se possível, inclua um jsfiddle.

Por que meus meses e dias de folga estão em um?
O Google Charts usa JavaScript, que usa indexação baseada em zero. O primeiro dia do mês é 0, e os meses variam de 0 (janeiro) a 11 (dezembro). Caso seu código presuma a indexação baseada em 1, subtraia um antes de colocar seus dados em um objeto de data JavaScript.
Por que meus gráficos funcionam em alguns navegadores, mas não em todos?
Recomendamos o site caniuse.com (link em inglês) para consultar várias informações sobre incompatibilidades de navegadores. Com o Gráficos Google, às vezes, existem problemas no Internet Explorer 8 e em versões anteriores, por dois motivos:
  • O IE8 não é compatível com SVG. Por isso, os gráficos passam para o VML, que é mais limitado.
  • O JavaScript do IE8 não permite vírgulas à direita em listas.
    • Por que meu gráfico em Flash não aparece quando estou testando?
    Devido às configurações de segurança do Flash, os gráficos em Flash podem não funcionar corretamente quando acessados de um local de arquivo no navegador (por exemplo, file:///c:/webhost/myhost/myviz.html), e não de um URL de servidor da Web (por exemplo, http://www.myhost.com/myviz.html). Isso normalmente é apenas um problema de teste. O problema não é um problema quando você acessa o gráfico de um endereço http://. É possível resolver esse problema conforme descrito no site da Macromedia. Em geral, recomendamos evitar o desenvolvimento em Flash sempre que possível.

    Política do Programa de Visualização do Google

    O que é a política do programa de visualização do Google?
    Conforme descrito nos Termos de Serviço, podemos recusar a inclusão e exibição de conteúdo que viole nossa Política do Programa, exibindo ou vinculando a:
    • Conteúdo ilegal.
    • Invasões de privacidade pessoal.
    • Pornografia ou obscenidade.
    • Conteúdo, como código malicioso, que interfira ou seja prejudicial ao computador de um usuário ou ao funcionamento da página da Web host.
    • Incitação ao ódio ou à violência.
    • Violações de direitos autorais. Para mais informações, consulte a política da DMCA (Lei dos Direitos Autorais do Milênio Digital).
    • Violações de marca registrada.
    • Falsificação de identidade de terceiros.

    Os desenvolvedores que criam gráficos que coletam dados concordam em manter e vincular uma Política de Privacidade legalmente adequada. Além disso, os desenvolvedores precisam garantir a segurança dos gráficos e manter o aplicativo enquanto ele estiver no diretório do gráfico.

    Essas políticas podem ser revisadas periodicamente e sem aviso prévio.

    A API de visualização do Google está disponível para uso comercial?
    Sim. Para detalhes, consulte os Termos de Serviço da API Google Visualization.
    Posso usar a API de visualização do Google para criar software do lado do cliente?
    No momento, não permitimos que os desenvolvedores usem a API Visualization para criar software do lado do cliente. Você só pode usar a API de visualização pela interface fornecida. Para detalhes, consulte os Termos de Serviço da API Google Visualization.
    O Google registra em logs todos os dados do meu gráfico?
    Os dados do gráfico incluídos na solicitação HTTP são salvos em registros temporários por, no máximo, duas semanas para fins de teste interno e depuração. É importante entender que, se o gráfico aparecer em uma tag de imagem em uma página da Web pública, ele poderá ser rastreado.
    Violações das políticas do programa.
    As violações dessas políticas do programa podem resultar na desativação ou remoção do seu gráfico, ficando impedido de fazer o upload de gráficos futuros, no encerramento das suas Contas do Google e/ou na exclusão de todos os seus gráficos.

    Participar de forma ativa na comunidade

    Como posso compartilhar meu aplicativo no gráfico com outras pessoas?
    Comece colocando seu gráfico na Galeria de gráficos. Se quiser, você pode incluir um link para seu site e fornecer o código-fonte. Participe do nosso grupo de discussão para receber o feedback da comunidade.
    A Galeria de gráficos é uma lista de aplicativos que usam a API de visualização. Ela fornece um local central para a comunidade de desenvolvedores de visualização compartilhar aplicativos de gráficos. Para enviar seu aplicativo de gráfico para a galeria, inscreva-se on-line.
    Como posso promover minha fonte de dados de gráfico?
    Publique sua implementação no grupo de visualização. Se gostarmos dele, poderemos até mencionar isso nós mesmos.