Domande frequenti

Per iniziare

Che cos'è l'API di visualizzazione di Google?
L'API Google Visualization ti consente di creare grafici e applicazioni di generazione di report utilizzando dati strutturati e di integrarli direttamente nel tuo sito web.
Che cosa posso fare con l'API di visualizzazione?
Con l'API Google Visualization puoi accedere a dati strutturati creati localmente nel tuo browser o recuperati da origini dati supportate in un semplice formato tabulare. Puoi anche implementare la tua origine dati come origine dati dell'API di visualizzazione e consentire a qualsiasi applicazione e/o visualizzazione conforme alla visualizzazione di accedere ai tuoi dati. Il formato può essere utilizzato da applicazioni di report, analisi o grafici. Puoi quindi visualizzare i dati e/o aggiungere nuove funzionalità alle applicazioni, come i fogli di lavoro Google.
Dove posso trovare la documentazione relativa all'API di visualizzazione?
La guida per gli sviluppatori e tutta la documentazione correlata sono disponibili all'indirizzo https://developers.google.com/chart/interactive/docs.
Come faccio a creare un nuovo grafico?
Il modo migliore per iniziare è leggere l'introduzione e la sezione Guida rapida.
Che cos'è un URL dell'origine dati?
Un URL origine dati è l'identificatore URL univoco di un'origine dati dell'API di visualizzazione. Un URL dell'origine dati può anche includere parametri Query Language del grafico. In questo caso, viene eseguita una query (ad esempio ordinamento, raggruppamento e così via) sull'origine dati prima di recuperare i dati.
Dove posso trovare il codice di esempio delle app di grafici che utilizzano l'API di visualizzazione?
Puoi trovare un codice di esempio nella documentazione relativa al codice di esempio dell'API di visualizzazione.
Un'applicazione Flash può accedere all'API di visualizzazione?
Assolutamente sì. L'API di visualizzazione utilizza un'API JavaScript, ma esistono librerie che consentono alle app Flash di connettersi con il codice JavaScript. Una di queste librerie che potrebbe esserti utile è disponibile all'indirizzo http://code.google.com/p/swfobject. Continua a leggere per conoscere alcuni problemi di sviluppo che riguardano Flash.
Come faccio a implementare un'origine dati?
Leggi la sezione sull'utilizzo e la creazione di un grafico per scoprire come funzionano i grafici, poi consulta Implementazione di un'origine dati per scoprire come creare un'origine dati. Per iniziare rapidamente, puoi utilizzare anche la libreria Java di origine dati di Google Chart.
Posso accedere a un grafico da un'applicazione Java?
Sì. La libreria di visualizzazione di Google per Google Web Toolkit (GWT) ti consente di accedere alle visualizzazioni conformi all'API dal codice Java compilato con il compilatore GWT e di scrivere visualizzazioni conformi all'API di visualizzazione in Java utilizzando il compilatore GWT. La libreria candidata alla release supporta anche il modello di eventi dell'API di visualizzazione.
Posso accedere a un grafico da un'applicazione scritta con il compilatore Google Web Toolkit (GWT)?
Sì. La libreria di visualizzazione di Google per Google Web Toolkit (GWT) ti consente di accedere alle visualizzazioni conformi all'API dal codice Java compilato con il compilatore GWT e di scrivere visualizzazioni conformi all'API di visualizzazione in Java utilizzando il compilatore GWT. La libreria candidata alla release supporta anche il modello di eventi dell'API di visualizzazione.
Ho una domanda o un problema diverso, chi posso contattare per avere ulteriori informazioni?
Pubblica la tua domanda nel gruppo di discussione dell'API Google Visualization per ricevere assistenza dalla community di sviluppatori della visualizzazione. Anche il team di visualizzazione di Google partecipa a questo gruppo per rispondere alle domande.

Utilizzo dell'API

Qual è la differenza tra l'API Google Chart e l'API Google Visualization?

L'API Chart fornisce un modo semplice per creare vari tipi di grafici immagine inviando a un server Google un URL formattato che include le opzioni di configurazione dei dati e del grafico. L'API Chart include un set chiuso di grafici con varie opzioni. I set di dati dell'API Chart sono limitati alle dimensioni di un URL (circa 2000).

L'API di visualizzazione consente di connettere grafici e origini dati sul web e di pubblicarli:

  • L'API di visualizzazione fornisce un'API JavaScript per accedere ai grafici.
  • La sua galleria di grafici include grafici creati da Google, ma è aperta a terze parti per creare visualizzazioni personalizzate conformi all'API di visualizzazione.
  • Grafici e grafici dell'API di visualizzazione possono essere qualsiasi cosa possa essere visualizzata da un browser. Sono inclusi immagini, JavaScript, immagini vettoriali, Flash e così via.
  • È possibile accedere a un numero considerevole di grafici dell'API Chart tramite l'API di visualizzazione, anche se alcune opzioni di configurazione potrebbero non essere disponibili.
  • L'API fornisce inoltre un protocollo di trasferimento documentato e un modo per chiunque di esporre le proprie origini dati a qualsiasi visualizzazione dell'API.
  • L'API ha un modello di eventi definito che consente ai grafici di generare e ricevere eventi e quindi di comunicare con la pagina host e/o altri grafici sulla pagina.
A quali origini dati posso accedere con l'API di visualizzazione?
Con l'API Visualization puoi accedere ai dati localmente dal browser creando il formato DataTable standard dell'API o accedere a qualsiasi origine dati che supporti l'API. Tra le applicazioni note che già supportano l'API ci sono Fogli di lavoro Google e Salesforce.com sulla piattaforma per sviluppatori Force.com. Puoi anche implementare i tuoi dati come origine dati del grafico.
La mia applicazione prevede che i dati che riceve siano in un formato specifico. Come faccio a gestire le eccezioni?
Puoi utilizzare i metodi getNumberOfColumns() e getColumnType() della classe google.visualization.DataTable per verificare che i dati che ottieni corrispondano a ciò che ti aspetti e inviare un messaggio di errore in caso di mancata corrispondenza.
È sicuro incorporare un grafico nel mio sito web?
L'esecuzione di codice di terze parti direttamente sul tuo sito web comporta rischi intrinseci. Google non rilascia alcuna garanzia né dichiarazione in merito alle prestazioni, alla qualità, alla sicurezza o ai contenuti delle applicazioni. Le applicazioni di grafici che non rispettano i Termini di servizio dell'API Google Visualization potrebbero essere rimosse dalle gallerie.
Posso utilizzare i grafici offline?
I computer degli utenti devono avere accesso a https://www.gstatic.com/charts/loader.js per utilizzare le funzionalità interattive di Google Graph. Questo perché le librerie di visualizzazione necessarie per la pagina vengono caricate dinamicamente prima dell'utilizzo. Il codice per il caricamento della libreria appropriata fa parte dello script incluso e viene chiamato quando richiami il metodo google.charts.load(). I nostri Termini di servizio non consentono di scaricare il codice google.charts.load o google.visualization da utilizzare offline.
Posso scaricare e ospitare il codice del grafico in locale o su una rete intranet?
Spiacenti, i nostri Termini di servizio non ti consentono di scaricare e salvare né di ospitare il codice google.charts.load o google.visualization. Tuttavia, se non hai bisogno dell'interattività di Google Grafici, puoi creare uno screenshot dei grafici e utilizzarli come preferisci.

Risoluzione dei problemi

Perché il mio grafico non viene visualizzato?

Innanzitutto, controlla la console JavaScript. Su Chrome, puoi accedere alla console JavaScript tramite Chrome->Visualizza->Sviluppatore->Console JavaScript oppure Chrome->Strumenti->Console JavaScript. Tutti i browser moderni hanno una console JavaScript; per trovarla, potresti dover esplorare i menu con nomi come "Avanzato" o "Strumenti per sviluppatori".

Se tutto va bene, la console ti porta immediatamente al problema. Tuttavia, a volte può essere difficile tradurre il messaggio della console nella causa sottostante. Ecco alcuni inconvenienti comuni:

  • È possibile che tu stia utilizzando il caricatore Google in modo errato.
    • Carica i grafici/loader.js solo una volta. Indipendentemente dal numero di grafici presenti sulla tua pagina web, dovresti avere una sola chiamata come questa: 
      <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> // Do this ONCE.
      Può trovarsi nell'intestazione o nel corpo della pagina web, a seconda di quando vuoi che venga eseguito il caricamento.
    • Idealmente, chiama google.charts.load una sola volta, con tutti i pacchetti necessari per la tua pagina 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>
  • Ogni grafico deve avere un ID elemento univoco (ad es. chart1, chart2 nell'esempio precedente).
  • Controlla che non ci siano errori di battitura. Ricorda che JavaScript è una lingua che fa distinzione tra maiuscole e minuscole.

Se hai ancora dubbi, cerca nel gruppo di discussione dell'API Google Visualization per vedere se qualcuno ha riscontrato un problema simile. Se non riesci a trovare un post che risponda alla tua domanda, pubblicala nel gruppo insieme a un link a una pagina web che dimostri il problema. Se possibile, includi un comando jsfiddle.

Perché i miei mesi e giorni sono liberi di uno?
I grafici Google utilizzano JavaScript, che utilizza l'indicizzazione su base zero. Il primo giorno del mese è 0 e i mesi vanno da 0 (gennaio) all'11 (dicembre). Se il codice presuppone che l'indicizzazione sia basata su una sola, sottrai una prima di inserire i dati in un oggetto date JavaScript.
Perché i miei grafici funzionano in alcuni browser, ma non in tutti?
Per una raccolta di informazioni sulle incompatibilità dei browser, consigliamo caniuse.com. Con Google Class, a volte si verificano problemi in Internet Explorer 8 e versioni precedenti per due motivi:
  • IE8 non supporta SVG, pertanto i grafici eseguono il failover in VML, che è più limitato.
  • Il codice JavaScript di IE8 non consente la presenza di virgole finali negli elenchi.
    • Perché il grafico basato su Flash non viene visualizzato durante il test?
    A causa delle impostazioni di sicurezza di Flash, i grafici basati su Flash potrebbero non funzionare correttamente se vi si accede dalla posizione di un file nel browser (ad es. file:///c:/webhost/myhost/myviz.html) anziché dall'URL di un server web (ad es. http://www.myhost.com/myviz.html). In genere si tratta di un problema solo di test, che non costituisce un problema quando si accede al grafico da un indirizzo http://. Puoi risolvere questo problema come descritto sul sito web di Macromedia. In generale, consigliamo di evitare lo sviluppo di Flash, se possibile.

    Norme del programma di visualizzazione di Google

    Che cosa sono le norme del programma di visualizzazione di Google?
    Come descritto nei Termini di servizio, potremmo rifiutarci di includere e mostrare contenuti che violano le nostre norme del programma mostrando o collegandoti a:
    • Contenuti illegali.
    • Invasioni della privacy personale.
    • Pornografia o oscenità.
    • Contenuti, ad esempio codice dannoso, che interferiscono con il computer di un utente o la pagina web host o sono dannosi per il funzionamento di quest'ultimo.
    • Incitamento all'odio o alla violenza.
    • Violazioni del copyright. Per ulteriori informazioni, consulta le nostre norme DMCA.
    • Violazioni dei marchi.
    • Furti d'identità di terze parti.

    Gli sviluppatori che creano grafici che raccolgono dati accettano di mantenere e rimandare a norme sulla privacy conformi alla legge. Inoltre, richiediamo agli sviluppatori di garantire che il loro grafico sia sicuro e di mantenere l'applicazione finché risiede nella directory dei grafici.

    Le presenti norme possono essere soggette a revisione di tanto in tanto senza preavviso.

    L'API di visualizzazione di Google è disponibile per uso commerciale?
    Sì. Per informazioni in piccolo, consulta i Termini di servizio dell'API Google Visualization.
    Posso utilizzare l'API Google Visualization per creare software lato client?
    Al momento non consentiamo agli sviluppatori di utilizzare l'API di visualizzazione per creare software lato client. Puoi utilizzare l'API di visualizzazione solo tramite l'interfaccia fornita. Per informazioni in piccolo, consulta i Termini di servizio dell'API Google Visualization.
    Google registra tutti i dati dei miei grafici?
    I dati del grafico inclusi nella richiesta HTTP vengono salvati in log temporanei per non più di due settimane a scopo di test interni e debug. Tieni presente che se il tuo grafico viene visualizzato in un tag immagine su una pagina web pubblica, potrebbe essere sottoposto a scansione.
    Violazioni delle norme del programma.
    Le violazioni di queste Norme del programma possono comportare la disattivazione o la rimozione del grafico, la blacklist per il caricamento di grafici futuri, la chiusura dei tuoi Account Google e/o l'eliminazione di tutti i grafici.

    Diventare attivi nella community

    Come faccio a condividere la mia applicazione di Google Chart con altri utenti?
    Inizia posizionando il grafico nella Galleria grafici. Puoi inserire un link al tuo sito e fornire il codice sorgente, se vuoi. Partecipa al nostro gruppo di discussione per ricevere il feedback della community.
    La Galleria grafici è un elenco di applicazioni che utilizzano l'API di visualizzazione. Offre alla community di sviluppatori delle visualizzazioni una posizione centralizzata in cui condividere le applicazioni per grafici. Per inviare l'applicazione del grafico alla galleria, applicala online.
    Come faccio a promuovere l'origine dati del grafico?
    Pubblica la tua implementazione nel gruppo di visualizzazione. Se ci piace, potremmo anche menzionarlo noi stessi.