Preguntas frecuentes

Introducción

¿Qué es la API de visualización de Google?
La API de visualización de Google te permite crear gráficos y aplicaciones de informes a través de datos estructurados y ayuda a integrarlos directamente en tu sitio web.
¿Qué puedo hacer con la API de visualización?
Con la API de visualización de Google, puedes acceder a datos estructurados creados de forma local en tu navegador o recuperados de fuentes de datos compatibles en un formato de tabla simple. También puedes implementar tu propia fuente de datos como fuente de datos de la API de visualización y habilitar cualquier visualización o aplicación compatible con visualización para acceder a tus datos. El formato puede usarse en aplicaciones de informes, análisis o gráficos. Así, podrás visualizar los datos o agregar nuevas funcionalidades a las aplicaciones, como Hojas de cálculo de Google.
¿Dónde puedo encontrar documentación sobre la API de visualización?
Puedes encontrar la guía para desarrolladores y toda la demás documentación relacionada en https://developers.google.com/chart/interactive/docs.
¿Cómo creo un gráfico nuevo?
La mejor manera de comenzar es leer la Introducción y la sección de Guía de inicio rápido.
¿Qué es una URL de fuente de datos?
Una URL de fuente de datos es el identificador de URL único de una fuente de datos de la API de visualización. Una URL de fuente de datos también puede incluir parámetros de lenguaje de consulta de gráficos. En este caso, se realiza una consulta (como ordenar, agrupar, etc.) en la fuente de datos antes de recuperar los datos.
¿Dónde puedo encontrar código de ejemplo de apps de gráficos con la API de visualización?
Puedes encontrar código de ejemplo en la documentación de código de ejemplo de la API de visualización.
¿Puede una aplicación Flash acceder a la API de visualización?
Por supuesto. La API de visualización utiliza una API de JavaScript, pero hay bibliotecas que permiten que las apps Flash se conecten con el código de JavaScript. Puedes encontrar una de esas bibliotecas que te pueden resultar útiles en http://code.google.com/p/swfobject. Consulta a continuación algunos problemas de desarrollo que afectan a Flash.
¿Cómo se implementa una fuente de datos?
Lee la sección sobre cómo usar y crear un gráfico para aprender cómo funcionan los gráficos. Luego, lee Cómo implementar una fuente de datos para aprender a crear una fuente de datos. También puedes usar la biblioteca de Java de fuente de datos de Google Charts para comenzar rápidamente si usas Java.
¿Puedo acceder a un gráfico desde una aplicación de Java?
Sí. La Biblioteca de visualización de Google para Google Web Toolkit (GWT) te permite acceder a visualizaciones que cumplen con la API del código Java compilado con el compilador de GWT y escribir visualizaciones que cumplen con la API de visualización en Java con el compilador de GWT. La biblioteca candidata para la versión también admite el modelo de eventos de la API de visualización.
¿Puedo acceder a un gráfico desde una aplicación escrita con el compilador de Google Web Toolkit (GWT)?
Sí. La Biblioteca de visualización de Google para Google Web Toolkit (GWT) te permite acceder a visualizaciones que cumplen con la API del código Java compilado con el compilador de GWT y escribir visualizaciones que cumplen con la API de visualización en Java con el compilador de GWT. La biblioteca candidata para la versión también admite el modelo de eventos de la API de visualización.
Tengo un problema o una pregunta diferente. ¿Con quién debo comunicarme para obtener más información?
Publica tu pregunta en el grupo de discusión de la API de visualización de Google para obtener ayuda de la comunidad de desarrolladores de visualización. El equipo de Visualización de Google también participa en este grupo para responder preguntas.

Cómo usar la API

¿Cuál es la diferencia entre la API de Google Chart y la API de visualización de Google?

La API de Chart proporciona una manera sencilla de crear gráficos de imágenes de varios tipos. Para ello, envía una URL con formato que incluya las opciones de configuración de datos y gráficos a un servidor de Google. La API de Chart incluye un conjunto cerrado de gráficos con varias opciones. Los conjuntos de datos de la API de Chart están limitados al tamaño de una URL (aproximadamente 2,000).

La API de visualización proporciona una manera de conectar gráficos y fuentes de datos en la Web y publicarlos:

  • La API de visualización proporciona una API de JavaScript para acceder a los gráficos.
  • Su galería de gráficos incluye gráficos creados por Google, pero también está disponible para que cualquier tercero cree sus propias visualizaciones compatibles con la API de visualización.
  • Los gráficos de la API de visualización pueden ser cualquier cosa que un navegador pueda renderizar. Esto incluye imágenes, JavaScript, gráficos vectoriales, Flash, etc.
  • Se puede acceder a una cantidad considerable de gráficos de la API de Chart a través de la API de visualización, aunque algunas de sus opciones de configuración pueden no estar disponibles.
  • La API también proporciona un protocolo de conexión documentado y una forma para que cualquiera exponga sus fuentes de datos a cualquiera de las visualizaciones de las APIs.
  • La API tiene un modelo de eventos definido que permite que los gráficos lancen y reciban eventos y, por lo tanto, se comuniquen con su página de host o con otros gráficos en la página.
¿A qué fuentes de datos puedo acceder con la API de visualización?
Con la API de visualización, puedes acceder a los datos de manera local desde tu navegador creando el formato DataTable estándar de la API, o bien acceder a cualquier fuente de datos que admita la API. Aplicaciones conocidas que ya admiten la API son Hojas de cálculo de Google y Salesforce.com en su plataforma para desarrolladores Force.com. También puedes implementar tus propios datos como una fuente de datos del gráfico.
Mi aplicación espera que los datos que recibe estén en un formato específico. ¿Cómo gestiono las excepciones?
Puedes usar los métodos getNumberOfColumns() y getColumnType() de la clase google.visualization.DataTable para probar que los datos que obtienes coincidan con lo que esperas y emitir un mensaje de error para las discrepancias.
¿Es seguro incrustar un gráfico en mi sitio web?
Ejecutar código de terceros directamente en tu sitio web implica riesgos inherentes. Google no realiza promesas ni representaciones sobre el rendimiento, la calidad, la seguridad ni el contenido de las aplicaciones. Es posible que las aplicaciones de gráficos que no cumplan con las Condiciones del servicio de la API de visualización de Google se eliminen de las galerías.
¿Puedo usar gráficos sin conexión?
Las computadoras de tus usuarios deben tener acceso a https://www.gstatic.com/charts/loader.js para poder usar las funciones interactivas de Google Charts. Esto se debe a que las bibliotecas de visualización que requiere tu página se cargan de forma dinámica antes de que las uses. El código para cargar la biblioteca adecuada forma parte de la secuencia de comandos incluida y se llama cuando invocas el método google.charts.load(). Nuestras Condiciones del Servicio no te permiten descargar el código google.charts.load o google.visualization para usarlo sin conexión.
¿Puedo descargar y alojar el código del gráfico de manera local o en una intranet?
Lo sentimos, pero nuestras Condiciones del Servicio no te permiten descargar, guardar ni alojar el código google.charts.load o google.visualization. Sin embargo, si no necesitas la interactividad de los gráficos de Google, puedes tomar una captura de pantalla de los gráficos y usarlos como desees.

Solución de problemas

¿Por qué no aparece mi gráfico?

Primero, revisa tu Consola de JavaScript. En Chrome, puedes acceder a la consola de JavaScript a través de Chrome > Ver > Desarrollador > Consola de JavaScript o Chrome-> Herramientas -> Consola de JavaScript. Todos los navegadores modernos tienen una consola de JavaScript; es posible que debas explorar menús con nombres como "Avanzado" o "Herramientas para desarrolladores" para encontrarlo.

Esperemos que la consola te guíe de inmediato al problema. Sin embargo, a veces será difícil traducir el mensaje de la consola a la causa subyacente. Estos son algunos errores comunes:

  • Es posible que estés usando incorrectamente el Cargador de Google.
    • Carga el elemento chart/loader.js una sola vez. Independientemente de la cantidad de gráficos que tengas en tu página web, debes tener una sola llamada como la siguiente: 
      <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> // Do this ONCE.
      . Esta puede estar en el encabezado o en el cuerpo de tu página web, según el momento en que desees que se produzca la carga.
    • Lo ideal es que llames a google.charts.load una sola vez, con todos los paquetes que necesitarás para tu página 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 debe tener un ID de elemento único (p.ej., chart1 y chart2 en el ejemplo anterior).
  • Busca errores de ortografía. Recuerda que JavaScript es un lenguaje en el que se distinguen mayúsculas y minúsculas.

Si todavía no sabes cómo hacerlo, busca en el grupo de discusión de la API de visualización de Google para ver si alguien encontró un problema similar. Si no encuentras una publicación que responda a tu pregunta, publícala en el grupo junto con un vínculo a una página web que demuestre el problema. Si es posible, incluye un jsfiddle.

¿Por qué mis meses y días libres están en uno?
Gráficos de Google usa JavaScript, que emplea indexación basada en cero. El primer día del mes es 0 y el mes varía de 0 (enero) a 11 (diciembre). Si tu código supone una indexación basada en uno, resta uno antes de colocar tus datos en un objeto de fecha de JavaScript.
¿Por qué mis gráficos funcionan en algunos navegadores, pero no en todos?
Recomendamos caniuse.com para obtener información sobre las incompatibilidades del navegador. Con los gráficos de Google, a veces, se producen problemas en Internet Explorer 8 y en las versiones anteriores por dos motivos:
  • IE8 no es compatible con SVG, por lo que los gráficos se conmutan por error en VML, que es más limitado.
  • El código JavaScript de IE8 no permite las comas finales en las listas.
    • ¿Por qué mi gráfico basado en Flash no aparece cuando lo estoy probando?
    Debido a la configuración de seguridad de Flash, es posible que los gráficos basados en Flash no funcionen correctamente cuando se acceda a ellos desde la ubicación de un archivo en el navegador (p.ej., file:///c:/webhost/myhost/myviz.html) en lugar de una URL de servidor web (p.ej., http://www.myhost.com/myviz.html). Por lo general, esto es solo un problema de prueba; no es un problema cuando accedes al gráfico desde una dirección http://. Puedes solucionar este problema como se describe en el sitio web de Macromedia. En general, recomendamos evitar el desarrollo con Flash siempre que sea posible.

    Política del Programa de Visualización de Google

    ¿Qué es la Política del Programa de Visualización de Google?
    Como se describe en las Condiciones del Servicio, podemos negarnos a incluir y mostrar el contenido que infrinja las políticas del programa si se agrega o vincula a lo siguiente:
    • Contenido ilegal.
    • Invasiones a la privacidad personal
    • Contenido pornográfico u obsceno
    • Contenido, como código malicioso, que interfiere o es dañino para la computadora de un usuario o el funcionamiento de la página web del host.
    • Incitación al odio o a la violencia
    • Violaciones a los derechos de autor Consulte nuestra política de la DMCA para obtener más información.
    • Violaciones a marcas comerciales
    • Suplantación de identidad de terceros.

    Los desarrolladores que crean gráficos que recopilan datos, acuerdan mantener una política de privacidad adecuada legalmente y establecer vínculos a ella. Además, exigimos que los desarrolladores se aseguren de que su gráfico sea seguro y que mantengan su aplicación mientras esta se encuentre en el directorio del gráfico.

    Estas políticas pueden ser revisadas ocasionalmente y sin previo aviso.

    ¿La API de visualización de Google está disponible para uso comercial?
    Sí. Para obtener la letra chica, consulta las Condiciones del Servicio de la API de visualización de Google.
    ¿Puedo usar la API de visualización de Google para crear software del cliente?
    Por el momento, no permitimos que los desarrolladores usen la API de visualización para crear software del cliente. Solo puedes usar la API de visualización a través de la interfaz proporcionada. Para obtener la letra chica, consulta las Condiciones del Servicio de la API de visualización de Google.
    ¿Google registra todos los datos de mi gráfico?
    Los datos del gráfico incluidos en la solicitud HTTP se guardan en registros temporales por no más de dos semanas para fines de depuración y pruebas internas. Por supuesto, debes comprender que, si tu gráfico aparece en una etiqueta de imagen en una página web pública, se puede rastrear.
    Incumplimientos de las políticas del programa
    Si incumple estas Políticas del Programa, es posible que se inhabilite o quite su gráfico, que se lo incluya en una lista negra para evitar que suba gráficos en el futuro, que se cierren sus Cuentas de Google o que se borren todos sus gráficos.

    Mantenerse activo en la comunidad

    ¿Cómo puedo compartir mi aplicación de Chart con otras personas?
    Primero, coloca tu gráfico en la Galería de gráficos. Puedes vincular a tu sitio y proporcionar tu código fuente si lo deseas. Participa en nuestro grupo de discusión para recibir comentarios de la comunidad.
    La Galería de gráficos es una lista de aplicaciones que usan la API de visualización. Proporciona una ubicación central para que la comunidad de desarrolladores de visualización comparta aplicaciones de gráficos. Para enviar tu postulación a la galería, hazlo en línea.
    ¿Cómo puedo promocionar mi fuente de datos de gráficos?
    Publica tu implementación en el grupo de visualización. Si nos gusta, incluso podríamos mencionarlo nosotros mismos.