Domande frequenti

Per iniziare

Che cos'è l'API di visualizzazione Google?
L'API di visualizzazione Google ti consente di creare grafici e applicazioni per i report utilizzando dati strutturati, contribuendo a integrarli direttamente nel tuo sito web.
Cosa posso fare con l'API di visualizzazione?
Con l'API di visualizzazione Google 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 visualizzazione e/o applicazione compatibile con la visualizzazione di accedere ai tuoi dati. Il formato può essere utilizzato dalle applicazioni di creazione di report, analisi o creazione di grafici. Puoi quindi visualizzare i dati e/o aggiungere nuove funzionalità alle applicazioni, ad esempio i fogli di lavoro di Google.
Dove posso trovare la documentazione per l'API di visualizzazione?
Puoi trovare la guida per gli sviluppatori e tutta la relativa documentazione all'indirizzo https://developers.google.com/chart/interactive/docs.
Come faccio a creare un nuovo grafico?
Il modo migliore per iniziare è leggere la sezione Introduzione e la Guida rapida.
Che cos'è un URL origine dati?
Un URL dell'origine dati è l'identificatore univoco di un'origine dati dell'API di visualizzazione. Un URL dell'origine dati può includere anche parametri del linguaggio di query del grafico. In questo caso, prima di recuperare i dati, viene eseguita una query (ad esempio ordinamento, raggruppamento ecc.) nell'origine dati.
Dove posso trovare un codice di esempio di app Chart che utilizzano l'API di visualizzazione?
Puoi trovare il codice di esempio nella documentazione del codice di esempio dell'API di visualizzazione.
Un'applicazione Flash può accedere all'API di visualizzazione?
Assolutamente sì. L'API Visualizzazione utilizza un'API JavaScript, ma esistono librerie che consentono alle app Flash di connettersi al codice JavaScript. Una raccolta di questo tipo potrebbe essere utile all'indirizzo http://code.google.com/p/swfobject. Di seguito sono riportati alcuni problemi di sviluppo relativi a Flash.
Come faccio a implementare un'origine dati?
Leggi la sezione Utilizzare e creare un grafico per scoprire come funzionano i grafici, poi leggere Implementare un'origine dati per scoprire come creare un'origine dati. Puoi anche utilizzare la libreria Java dell'origine dati del grafico Google per iniziare rapidamente se utilizzi Java.
Posso accedere a un grafico da un'applicazione Java?
Sì. La Libreria di visualizzazione Google di Google Web Toolkit (GWT) 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 Google di Google Web Toolkit (GWT) 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/un problema diverso. Chi posso contattare per ricevere ulteriori informazioni?
Pubblica la tua domanda nel gruppo di discussione dell'API Google Preview per farti aiutare dalla community di sviluppatori di visualizzazione. Anche il team di visualizzazione Google partecipa a questo gruppo per rispondere alle domande.

Utilizzo dell'API

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

L'API Chart consente di creare in modo semplice grafici di vari tipi inviando un URL formattato che includa sia l'opzione di configurazione del grafico che quella dei dati a un server di Google. L'API Chart include un insieme chiuso di grafici con varie opzioni. I set di dati dell'API Chart sono limitati alla dimensione di un URL (circa 2000).

L'API di visualizzazione consente di collegare grafici e origini dati sul Web e di pubblicarli:

  • L'API di visualizzazione fornisce un'API JavaScript per accedere ai grafici.
  • La relativa galleria di grafici include i grafici creati da Google, ma è aperta anche a terze parti per creare visualizzazioni proprie conformi all'API di visualizzazione.
  • I grafici e i grafici dell'API di visualizzazione possono essere qualsiasi elemento che possa essere visualizzato da un browser. Sono inclusi immagini, JavaScript, immagini grafiche, Flash e così via.
  • Molti grafici dell'API Chart sono accessibili tramite l'API di visualizzazione, anche se alcune delle loro opzioni di configurazione potrebbero non essere disponibili.
  • L'API fornisce inoltre un protocollo per i cavi documentato e un modo per chiunque di esporre le proprie origini dati a qualsiasi visualizzazione delle API.
  • L'API ha un modello di evento definito che consente ai grafici di lanciare e ricevere eventi e quindi comunicare con la rispettiva pagina host e/o con altri grafici nella pagina.
A quali origini dati posso accedere utilizzando l'API di visualizzazione?
Con l'API Visualizzazione puoi accedere ai dati localmente dal tuo browser creando il formato DataTable standard dell'API o accedere a qualsiasi origine dati che supporti l'API. Le applicazioni famose che già supportano l'API sono Google Sheets e Salesforce.com sulla piattaforma per sviluppatori Force.com. Puoi anche implementare i tuoi dati come origine dati del grafico.
La mia applicazione si aspetta che i dati ricevuti 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 ricevi corrispondano a quanto previsto e inviare un messaggio di errore in caso di mancata corrispondenza.
È possibile incorporare in modo sicuro un grafico nel mio sito web?
L'esecuzione di codice di terze parti direttamente sul tuo sito web comporta rischi intrinseci. Google non fa promesse o dichiarazioni in merito alle prestazioni, alla qualità, alla sicurezza o ai contenuti delle applicazioni. Le applicazioni dei grafici che non rispettano i Termini di servizio dell'API Google Verification potrebbero essere rimosse dalle gallerie.
Posso utilizzare i grafici offline?
I computer degli utenti devono disporre dell'accesso a https://www.gstatic.com/charts/loader.js per poter utilizzare le funzionalità interattive di Google grafici. Ciò avviene perché le librerie di visualizzazione richieste dalla pagina vengono caricate dinamicamente prima di utilizzarle. Il codice per caricare la 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 Intranet?
Spiacenti, i nostri Termini di servizio non consentono di scaricare e salvare o ospitare il codice google.charts.load o google.visualization. Tuttavia, se non hai bisogno dell'interattività di Google Tables, puoi acquisire 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 o Chrome->Strumenti->Console JavaScript. Tutti i browser moderni hanno una console JavaScript. Potrebbe essere necessario sfogliare i menu con nomi come "Avanzate" o "Strumenti per sviluppatori".

Ci auguriamo che la console ti porti immediatamente al problema. Tuttavia, a volte sarà difficile tradurre il messaggio della console nella causa sottostante. Ecco alcune insidie comuni:

  • È possibile che tu stia utilizzando il caricatore Google in modo errato.
    • Carica i grafici/loader.js solo una volta. A prescindere dal numero di grafici presenti nella 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 carico.
    • Idealmente, chiama google.charts.load una sola volta, con tutti i pacchetti necessari per la 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 sopra).
  • Cerca gli errori di battitura. Ricorda che JavaScript è un linguaggio sensibile alle maiuscole.

Se non hai capito, cerca nel gruppo di discussione dell'API Visualizzazione Google per vedere se qualcuno ha riscontrato un problema simile. Se non riesci a trovare un post che risponda alla tua domanda, pubblica la tua domanda nel gruppo insieme a un link a una pagina web che dimostra il problema. Se possibile, includi una jsfiddle.

Perché i miei mesi e i miei giorni mancano di uno?
Google Tables utilizza JavaScript, che utilizza l'indicizzazione basata su zero. Il primo giorno del mese è 0 e i mesi vanno da 0 (gennaio) a 11 (dicembre). Se il codice presuppone l'indicizzazione basata su una sola, sottraine una prima di inserire i dati in un oggetto data di JavaScript.
Perché i miei grafici funzionano in alcuni browser ma non in tutti?
Consigliamo caniuse.com per trovare informazioni sulle incompatibilità dei browser. A seconda dei grafici di Google, a volte si verificano problemi in Internet Explorer 8 e versioni precedenti per due motivi:
  • IE8 non supporta SVG, quindi Classificherà i grafici in VML, che è più limitato.
  • Il codice JavaScript di IE8 non consente la virgola degli elenchi.
    • Perché il mio grafico basato su Flash non viene visualizzato quando lo testo?
    A causa delle impostazioni di sicurezza di Flash, i grafici basati su Flash potrebbero non funzionare correttamente se accessibili da una posizione nel browser (ad esempio, file:///c:/webhost/myhost/myviz.html) anziché da un URL del server web (ad esempio, http://www.myhost.com/myviz.html). In genere si tratta di un problema di test e non si tratta di un problema che si verifica quando accedi al grafico da un indirizzo http://. Puoi risolvere il problema come descritto sul sito web di Macromedia. In generale, consigliamo di evitare lo sviluppo di Flash quando possibile.

    Norme del programma di visualizzazione Google

    Quali sono le norme del programma di visualizzazione Google?
    Come descritto nei Termini di servizio, potremmo rifiutarci di includere e visualizzare i contenuti che violano le norme del programma mostrando o rimandando a:
    • Contenuti illegali.
    • La violazione della privacy personale.
    • Pornografia o oscenità.
    • Contenuti, ad esempio codice dannoso, che interferiscono con il computer dell'utente o da cui interferiscono con il funzionamento della pagina web host.
    • Promozione dell'odio o dell'incitamento alla violenza.
    • Violazioni del copyright. Per ulteriori informazioni, consulta le nostre norme DMCA.
    • Violazioni di marchi.
    • Furti d'identità di terze parti.

    Gli sviluppatori che creano grafici che raccolgono dati accettano di mantenere e rispettare le norme sulla privacy legalmente adeguate. Inoltre, agli sviluppatori viene richiesto di assicurarsi che il loro grafico sia sicuro e di mantenere la loro applicazione finché si trova nella directory del grafico.

    Le presenti norme possono essere modificate di tanto in tanto senza preavviso.

    L'API di visualizzazione Google è disponibile per uso commerciale?
    Sì. Per la versione integrale consulta i Termini di servizio dell'API Visualizzazione Google.
    Posso utilizzare l'API Visualizzazione Google per creare software lato client?
    Attualmente 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 la versione fine, leggi i Termini di servizio dell'API di visualizzazione Google.
    Google registra tutti i miei dati dei grafici?
    I dati del grafico inclusi nella richiesta HTTP vengono salvati nei log temporanei per non più di due settimane a scopo di test e debug interni. Naturalmente dovete capire che se il 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, il divieto di caricare i 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 candidatura a un programma?
    Per iniziare, posiziona il grafico nella Galleria dei grafici. Puoi ricollegarti al tuo sito e fornire il tuo codice sorgente, se vuoi. Partecipa al nostro gruppo di discussione per ricevere feedback dalla community.
    La Galleria di grafici è un elenco di applicazioni che utilizzano l'API di visualizzazione. Fornisce una posizione centrale per la community di sviluppatori di visualizzazione in cui condividere le applicazioni dei grafici. Per inviare la tua applicazione grafico alla galleria, richiedi la partecipazione online.
    Come faccio a promuovere l'origine dati dei grafici?
    Pubblica la tua implementazione nel gruppo di visualizzazione. Se ci piace, possiamo anche menzionarla noi stessi.