Preguntas frecuentes

Cómo comenzar

¿Qué es la Google Visualization API?
La API de visualización de Google te permite crear gráficos y aplicaciones de informes en 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 los datos estructurados, que se crean de forma local en tu navegador o se recuperan de fuentes de datos compatibles en un formato tabular simple. También puedes implementar tu propia fuente de datos como la fuente de datos de la API de visualización y habilitar cualquier visualización o aplicación compatible con la visualización para acceder a tus datos. Se puede usar el formato mediante aplicaciones de informes, análisis o gráficos. Por lo tanto, puedes visualizar los datos o agregar funcionalidades nuevas a las aplicaciones, como las 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 documentación relacionada en https://developers.google.com/chart/interactive/docs.
¿Cómo puedo crear un gráfico nuevo?
La mejor manera de comenzar es leer las secciones Introducción y 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 la fuente de datos también puede incluir los parámetros del Lenguaje de consulta del gráfico. En este caso, se realiza una consulta (como el ordenamiento, la agrupación, etc.) en la fuente de datos antes de recuperar los datos.
¿Dónde puedo encontrar un ejemplo de código de apps de gráficos que usan la API de visualización?
Puede encontrar código de ejemplo en la documentación de ejemplo de código de la API de visualización.
¿Una aplicación Flash puede acceder a la API de visualización?
Por supuesto. La API de visualización usa una API de JavaScript, pero hay bibliotecas que permiten que las apps Flash se conecten con el código de JavaScript. Una de esas bibliotecas puede resultarte útil en http://code.google.com/p/swfobject. Consulta la siguiente información para obtener información sobre algunos problemas de desarrollo que afectan a Flash.
¿Cómo implemento una fuente de datos?
Lee la sección sobre cómo usar y crear un gráfico, a fin de obtener información sobre cómo funcionan los gráficos. Luego, lee Implementa una fuente de datos para aprender a crear una fuente de datos. También puedes usar la biblioteca Java de la fuente de datos de gráficos de Google para comenzar con rapidez 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) le permite acceder a las visualizaciones de la API que cumplen con el código Java compilado con el compilador de GWT y escribir visualizaciones compatibles con la API de visualización en Java mediante el compilador de GWT. La biblioteca candidata para el lanzamiento 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 Google Web Toolkit (GWT)?
Sí. La Biblioteca de visualización de Google para Google Web Toolkit (GWT) le permite acceder a las visualizaciones de la API que cumplen con el código Java compilado con el compilador de GWT y escribir visualizaciones compatibles con la API de visualización en Java mediante el compilador de GWT. La biblioteca candidata para el lanzamiento 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 gráficos proporciona una manera sencilla de crear gráficos de imagen de varios tipos mediante el envío de una URL con formato que incluye las opciones de configuración de datos y gráficos a un servidor de Google. La API de gráficos incluye un conjunto cerrado de gráficos con varias opciones. Los conjuntos de datos de la API de gráficos se limitan al tamaño de una URL (aproximadamente 2K).

La API de visualización proporciona una forma de conectar gráficos y fuentes de datos a través de 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á abierta a cualquier tercero para que cree sus propias visualizaciones compatibles con la API de visualización.
  • Los gráficos de visualización de la API pueden ser cualquier elemento que un navegador pueda renderizar. Esto incluye imágenes, JavaScript, gráficos vectoriales, Flash, etc.
  • Se puede acceder a una gran cantidad de gráficos de la API de Chart mediante la API de visualización, aunque es posible que algunas de sus opciones de configuración no estén disponibles.
  • La API también proporciona un protocolo de conexión documentado y una manera de que cualquiera pueda exponer sus fuentes de datos a cualquiera de las visualizaciones de las API.
  • La API tiene un modelo de eventos definido que permite que los gráficos generen y reciban eventos, y que se comuniquen con su página de alojamiento o con otros gráficos en la página.
¿A qué fuentes de datos puedo acceder mediante la API de visualización?
Con la API de visualización, puedes acceder a los datos de forma local desde tu navegador. Para ello, crea el formato de DataTable estándar de la API o accede a cualquier fuente de datos que admita la API. Las aplicaciones conocidas que ya admiten la API son Hojas de cálculo de Google y Salesforce.com en su plataforma para desarrolladores de Force.com. También puede implementar sus propios datos como fuente de datos de los gráficos.
Mi aplicación espera que los datos que recibe estén en un formato específico. ¿Cómo controlo las excepciones?
Puedes usar los métodos getNumberOfColumns() y getColumnType() de la clase google.visualization.DataTable a fin de probar que los datos que obtienes coincidan con lo que esperas y emitir un mensaje de error para las faltas de coincidencia.
¿Es seguro insertar un gráfico en mi sitio web?
Ejecutar código de terceros directamente en su sitio web representa riesgos inherentes. Google no realiza ninguna promesa ni representación acerca del rendimiento, la calidad, la seguridad o 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 los gráficos sin conexión?
Para poder usar las funciones interactivas de Google Charts, las computadoras de los usuarios deben tener acceso a https://www.gstatic.com/charts/loader.js. Esto se debe a que las bibliotecas de visualización que requiere tu página se cargan de forma dinámica antes de usarlas. 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 permiten descargar el código google.charts.load ni google.visualization para usarlo sin conexión.
¿Puedo descargar y alojar el código del gráfico de forma local o en una intranet?
nuestras Condiciones del Servicio no te permiten descargar ni 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 la consola de JavaScript. En Chrome, puede acceder a la Consola de JavaScript mediante 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 buscar menús con nombres como "Avanzado" o "Herramientas para programadores" para encontrarlo.

Esperamos que Console te dirija de inmediato al problema. Sin embargo, a veces será difícil traducir el mensaje de la consola a la causa subyacente. Estas son algunas dificultades comunes:

  • Es posible que estés usando Google Loader de forma incorrecta.
    • Solo cargue el archivo chart/loader.js una vez. Independientemente de la cantidad de gráficos que tengas en tu página web, debes tener una y solo una llamada como la siguiente:
      <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> // Do this ONCE.
      Esto puede estar en el encabezado o en el cuerpo de la página web, según cuándo desees que se realice la carga.
    • Lo ideal es llamar a google.charts.load solo una 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, 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 el grupo de discusión de la API de visualización de Google para ver si alguien tuvo un problema similar. Si no encuentras una publicación que responda 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 no están disponibles en uno?
Gráficos de Google usa JavaScript, que usa la indexación basada en cero. El primer día del mes es 0, y los meses varían de 0 (enero) a 11 (diciembre). Si tu código supone una indexación basada en uno, resta uno antes de colocar los datos en un objeto de fecha de JavaScript.
¿Por qué mis gráficos funcionan en algunos navegadores, pero no en todos?
Te recomendamos usar caniuse.com para obtener información sobre las incompatibilidades de los navegadores. En los gráficos de Google, a veces hay problemas en Internet Explorer 8 y versiones anteriores, por dos motivos:
  • IE8 no admite SVG, por lo que los gráficos se conmutan por error en la VML, que es más limitada.
  • El código JavaScript de IE8 no permite 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 accede a ellos desde una ubicación de 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, este es un problema de prueba, que no ocurre 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 de 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, es posible que nos neguemos a incluir y mostrar contenido que infrinja nuestra política del programa. Para ello, debemos mostrar lo siguiente:
    • Contenido ilegal
    • Invasiones a la privacidad personal.
    • Pornografía u obscenidad.
    • Contenido, como código malicioso, que interfiera en la computadora del usuario o sea perjudicial para su computadora o para el funcionamiento de la página web del host
    • Incitación al odio o a la violencia
    • Violación de los derechos de autor Consulte nuestra política de DMCA para obtener más información.
    • infracciones de marcas comerciales;
    • Robo de identidad de terceros

    Los desarrolladores que crean gráficos que recopilan datos aceptan mantener una política de privacidad legalmente adecuada y establecer un vínculo con ella. Además, exigimos a los desarrolladores que se aseguren de que su gráfico sea seguro y que mantengan su aplicación siempre que resida en el directorio del gráfico.

    Estas políticas pueden revisarse de vez en cuando 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?
    Actualmente, 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 que se proporciona. Para obtener la letra chica, consulta las Condiciones del Servicio de la API de visualización de Google.
    ¿Google registra todos los datos de mis gráficos?
    Los datos del gráfico incluidos en la solicitud HTTP se guardan en los registros temporales durante no más de dos semanas para fines de pruebas internas y depuración. Por supuesto, debes comprender que si tu gráfico aparece en una etiqueta de imagen en una página web pública, se podría rastrear.
    Infringir las políticas del programa
    Si se incumplen estas Políticas del Programa, es posible que se inhabilite o quite el gráfico, que se le provoque una carga negra para impedir que suba gráficos en el futuro, que se cierre su Cuenta de Google o que se borren todos sus gráficos.

    Mantente activo en la comunidad

    ¿Cómo puedo compartir mi solicitud de ranking con otras personas?
    Para comenzar, ubica tu gráfico en la Galería de gráficos. Puedes volver 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 utilizan la API de visualización. Proporciona una ubicación central para que la comunidad de desarrolladores de visualización comparta las aplicaciones de Chart. Para enviar la solicitud de gráfico a la galería, envía tu solicitud en línea.
    ¿Cómo puedo promocionar mi fuente de datos de Chart?
    Publique su implementación en el grupo de visualización. Si nos gusta, podríamos mencionarlo nosotros mismos.