Perguntas frequentes

Como começar

O que é a API de visualização do Google?
Com a API Google preview, você cria gráficos e aplicativos de relatórios com dados estruturados e os integra diretamente ao seu site.
O que posso fazer com a API de visualização do Google?
Com a API Google Visualize, é possível acessar dados estruturados, criados localmente no seu navegador, ou recuperados de fontes de dados com suporte em um formato tabular simples. Também é possível implementar sua própria fonte de dados como a API de visualização do Google e permitir que qualquer visualização e/ou aplicativo compatível com a visualização acesse seus dados. O formato pode ser usado por relatórios, análises ou aplicativos de gráficos. Dessa forma, é possível visualizar os dados e/ou adicionar novas funcionalidades a aplicativos, como as Planilhas Google.
Onde posso encontrar a documentação da API Preview?
Você pode encontrar o guia do desenvolvedor e toda a documentação relacionada em https://developers.google.com/graph/interactive/docs.
Como criar um novo gráfico?
A melhor maneira de começar é ler a seção Introdução e Início rápido.
O que é um URL da fonte de dados?
Um URL de fonte de dados é o identificador exclusivo de uma fonte da API Maps Preview. 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 da busca deles.
Onde posso encontrar um exemplo de código de apps de gráfico usando a API de visualização?
Veja o código de exemplo na documentação do exemplo de API.
Um aplicativo em Flash pode acessar a API de visualização?
Claro. A API de visualização usa uma API JavaScript, mas há bibliotecas que permitem que os apps em Flash se conectem com o código JavaScript. Uma dessas bibliotecas pode ser útil em http://code.google.com/p/swfobject. Veja abaixo alguns problemas de desenvolvimento que afetam o Flash.
Como posso implementar uma fonte de dados?
Leia a seção sobre como usar e criar um gráfico para saber como os gráficos funcionam e, em seguida, leia Como implementar uma fonte de dados para saber como criar uma fonte de dados. Você também pode usar a biblioteca Java de fonte de dados do gráfico do Google para começar rapidamente se usar Java.
Posso acessar um gráfico de um aplicativo Java?
Sim. A Biblioteca de visualização do Google do Google Web Toolkit (GWT) permite acessar as visualizações em conformidade com a API do código Java compilado com o compilador do GWT e criar visualizações compatíveis com a API de visualização em Java usando o elemento compatível. A biblioteca candidata de lançamento também é compatível com o modelo de eventos da API Preview.
Posso acessar um gráfico de um aplicativo escrito com o compilador Google Web Toolkit (GWT)?
Sim. A Biblioteca de visualização do Google do Google Web Toolkit (GWT) permite acessar as visualizações em conformidade com a API do código Java compilado com o compilador do GWT e criar visualizações compatíveis com a API de visualização em Java usando o elemento compatível. A biblioteca candidata de lançamento também é compatível com o modelo de eventos da API Preview.
Tenho outra dúvida/problema, com quem posso entrar em contato para receber mais informações?
Poste sua pergunta no grupo de discussão da API Google Layouts para receber ajuda da comunidade de desenvolvedores de visualização. A equipe de visualização do Google também participa desse grupo para responder às 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. A API Chart 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).

A API de visualização fornece uma maneira de conectar gráficos e fontes de dados na Web e publicá-los:

  • A API Preview oferece uma API JavaScript para acessar gráficos.
  • A galeria de gráficos inclui gráficos criados pelo Google, mas também está aberta a terceiros para que eles criem suas próprias visualizações em conformidade com a API de visualização.
  • Os gráficos e as APIs da visualização podem ser qualquer coisa que pode ser renderizada por um navegador. Isso inclui imagens, JavaScript, gráficos vetoriais, Flash etc.
  • Um número considerável de gráficos da API de gráficos do Google é acessível por meio da API de visualização, embora algumas de suas opções de configuração possam não estar disponíveis.
  • A API também fornece um protocolo de transmissão documentado e uma maneira de expor as fontes de dados a qualquer visualização das APIs.
  • A API tem um modelo de evento definido que permite que os gráficos gerem e recebam eventos e, assim, se comuniquem com a página do host e/ou outros gráficos na página.
Quais fontes de dados podem ser acessadas usando a API de visualização do Google?
Com ela, é possível acessar dados localmente no navegador criando o formato DataTable padrão da API ou acessando qualquer fonte compatível com a API. Os aplicativos conhecidos que já aceitam a API são as Planilhas do Google e o Salesforce.com na plataforma de desenvolvedores Force.com (links em inglês). Você também pode implementar seus próprios dados como uma fonte do gráfico.
Meu aplicativo espera que os dados recebidos estejam em um formato específico. Como lidar com as 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 para inconsistências.
É seguro incorporar um gráfico ao meu site?
A execução de código de terceiros diretamente no seu site apresenta riscos inerentes. O Google não faz promessas nem faz declarações sobre o desempenho, a qualidade, a segurança ou o conteúdo do aplicativo. Os aplicativos de gráficos que não estiverem em conformidade com os Termos de Serviço da API Google preview serão removidos das galerias.
Posso usar gráficos off-line?
Os computadores dos usuários precisam ter acesso ao site https://www.gstatic.com/graphics/loader.js para usar os recursos interativos do recurso Gráficos do 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 apropriada faz parte do script incluído e é chamado quando você invoca o método google.charts.load(). Nossos Termos de Serviço não permitem 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?
Os Termos de Serviço não permitem fazer o download nem salvar ou hospedar o código google.charts.load ou google.visualization. No entanto, se você não precisa da interatividade dos Gráficos Google, faça uma captura de tela e use como quiser.

Solução de problemas

Por que meu gráfico não aparece?

Primeiro, verifique o Console JavaScript. No Chrome, acesse o Console JavaScript usando as ferramentas Chrome->View->Desenvolvedor->Console JavaScript ou Chrome->Ferramentas->Console JavaScript. Todos os navegadores modernos têm um console JavaScript. Talvez seja necessário procurar em menus com nomes como "Avançado" ou "Ferramentas para desenvolvedores".

Esperamos que o console direcione você imediatamente ao problema. Algumas vezes, no entanto, será difícil traduzir a mensagem do console para a causa subjacente. Veja algumas armadilhas comuns:

  • Talvez você esteja usando o carregador do Google incorretamente.
    • Carregue o Graph/loader.js apenas uma vez. Não importa quantos gráficos você tem na página da Web, precisa 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 página, 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 a 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 perdido, pesquise no grupo de discussão da API Google preview para ver se alguém encontrou um problema semelhante. Se você não encontrar uma postagem que responda à sua pergunta, poste-a 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 estão de folga?
Os gráficos do Google usam JavaScript, que usa a indexação baseada em zero. O primeiro dia do mês é 0, e os meses variam de 0 (janeiro) a 11 (dezembro). Se o código presumir 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?
É recomendável usar o caniuse.com (em inglês) para encontrar informações sobre incompatibilidades de navegador. Nos gráficos do Google, às vezes há problemas no Internet Explorer 8 e versões anteriores por dois motivos:
  • Como o IE8 não oferece suporte a SVG, os gráficos fazem o failover no VML, que é mais limitado.
  • O JavaScript do IE8 não permite vírgulas nas listas.
  • Por que meu gráfico em Flash não é exibido quando ele é testado?
    Por causa das configurações de segurança do Flash, os gráficos com base em Flash podem não funcionar corretamente quando acessados no local de um arquivo no navegador (por exemplo, file:///c:/webhost/myhost/myviz.html), e não em um URL de servidor da Web (por exemplo, http://www.myhost.com/myviz.html). Normalmente, esse é apenas um problema de teste. O problema não é um problema quando você acessa o gráfico em 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 a exibição de conteúdo que viole a política do programa com a exibição ou vinculação a:
    • Conteúdo ilegal.
    • Invasões de privacidade pessoal.
    • Pornografia ou obscenidade.
    • Conteúdo, como código malicioso, que interfere ou é prejudicial ao computador de um usuário ou ao funcionamento da página da Web que hospeda o conteúdo.
    • 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 que o gráfico seja seguro e que mantenham o aplicativo enquanto residir no diretório do gráfico.

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

    A API de visualização do Google está disponível para uso comercial?
    Sim. Para ver os detalhes, consulte os Termos de Serviço da API Google Layouts.
    Posso usar a API Google preview para criar um software do lado do cliente?
    No momento, não permitimos que os desenvolvedores usem a API Visualize para criar software do lado do cliente. Só é possível usar a API de visualização pela interface fornecida. Para ver informações detalhadas, consulte os Termos de Serviço da API Google Preview.
    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 testes internos e depuração. Obviamente, é importante entender que, se o gráfico aparecer em uma tag de imagem em uma página pública, ele poderá ser rastreado.
    Violações das políticas do programa
    Violações dessas Políticas do Programa podem resultar na desativação ou remoção do gráfico, ser impedido de fazer upload de gráficos futuros, no encerramento das suas Contas do Google e/ou na exclusão de todos os seus gráficos.

    Torne-se ativo na comunidade

    Como posso compartilhar meu aplicativo de paradas com outras pessoas?
    Comece colocando seu gráfico na Galeria de gráficos. Se você quiser, adicione um link ao seu site e forneça 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 oferece um local central para que a comunidade de desenvolvedores de visualização possa compartilhar aplicativos de gráficos. Para enviar seu aplicativo de gráfico à galeria, inscreva-se on-line.
    Como posso promover minha fonte de dados de gráficos?
    Poste sua implementação no grupo de visualização. Se gostarmos, podemos até mesmo mencionar a gente.