Ta strona została przetłumaczona przez Cloud Translation API.

Najczęstsze pytania

Pierwsze kroki
Za pomocą interfejsu API
Rozwiązywanie problemów
Zasady korzystania z interfejsu Google wizualizacji API
Jak być aktywnym członkiem społeczności

Pierwsze kroki

Czym jest Google wizualizacji API?: Interfejs GoogleWizualizacj API umożliwia tworzenie wykresów i aplikacji do raportowania na podstawie danych strukturalnych oraz pomaga zintegrować te dane bezpośrednio z witryną.
Co mogę zrobić za pomocą interfejsu API wizualizacji?: Za pomocą interfejsu Googletzn. API możesz uzyskać dostęp do uporządkowanych danych utworzonych lokalnie w przeglądarce lub pobranych z obsługiwanych źródeł danych w formacie tabelarycznym. Możesz też zaimplementować własne źródło danych jako źródło danych interfejsu API wizualizacji, a także umożliwić dostęp do danych dowolnej wizualizacji lub aplikacji zgodnej z wizualizacją. Format jest odpowiedni do użytku w raportach, analizach i aplikacjach na wykresach. Dzięki temu możesz wizualizować dane i dodawać do aplikacji nowe funkcje, takie jak Arkusze Google.
Gdzie znajdę dokumentację interfejsu API wizualizacji?: Ten przewodnik dla programistów i wszystkie inne powiązane dokumenty znajdziesz na stronie https://developers.google.com/schema/interactive/docs.
Jak utworzyć nowy wykres?: Najlepiej zacząć od przeczytania wstępu i sekcji Krótkie wprowadzenie.
Co to jest URL źródła danych?: URL źródła danych to unikalny identyfikator URL źródła danych interfejsu API wizualizacji. URL źródła danych może też zawierać parametry języka zapytań związane z wykresem. W takim przypadku przed pobraniem danych wykonuje się zapytanie (np. sortowanie, grupowanie itp.) w źródle danych.
Gdzie znajdę przykładowy kod aplikacji wykonywany przy użyciu interfejsu Visual API?: Przykładowy kod znajdziesz w dokumentacji przykładowego kodu interfejsu API wizualizacji.
Czy aplikacja Flash ma dostęp do interfejsu API wizualizacji?: Oczywiście. Interfejs API wizualizacji korzysta z interfejsu API JavaScript, ale istnieją biblioteki umożliwiające połączenie aplikacji Flash z kodem JavaScript. Jedną z takich przydatnych bibliotek znajdziesz na http://code.google.com/p/swfobject. Więcej informacji o problemach z programowaniem Flasha znajdziesz poniżej.
Jak zaimplementować źródło danych?: Zapoznaj się z sekcją poświęconą wykorzystaniu i tworzeniu wykresu, aby dowiedzieć się, jak działają wykresy, a potem przeczytaj artykuł Implementacja źródła danych, aby dowiedzieć się, jak utworzyć źródło danych. Jeśli używasz Javy, możesz też szybko skorzystać z biblioteki Javy źródła danych Google.
Czy mogę uzyskać dostęp do wykresu za pomocą aplikacji w języku Java?: Tak. Biblioteka Google wizualizacji dla Google Web Toolkit (GWT) umożliwia dostęp do wizualizacji zgodnych z interfejsem API z kodu Java skompilowanego za pomocą kompilatora GWT oraz do zapisywania w Javie wizualizacji zgodnych z interfejsem API w Javie. Biblioteka kandydujących do wersji obsługuje też model zdarzeń interfejsu API wizualizacji.
Czy mogę uzyskać dostęp do wykresu z aplikacji napisanej za pomocą kompilatora Google Web Toolkit (GWT)?: Tak. Biblioteka Google wizualizacji dla Google Web Toolkit (GWT) umożliwia dostęp do wizualizacji zgodnych z interfejsem API z kodu Java skompilowanego za pomocą kompilatora GWT oraz do zapisywania w Javie wizualizacji zgodnych z interfejsem API w Javie. Biblioteka kandydujących do wersji obsługuje też model zdarzeń interfejsu API wizualizacji.
Mam inne pytanie lub problem, z którym mam się skontaktować, aby uzyskać więcej informacji?: Jeśli chcesz uzyskać pomoc od społeczności programistów korzystających z wizualizacji, zadaj pytanie na grupie dyskusyjnej Google wizualizacji interfejsu API. W ramach tej grupy odpowiada także zespół Google ds. wizualizacji, który odpowiada na pytania.

Korzystanie z interfejsu API

Jaka jest różnica między interfejsem Google Chart API a interfejsem GoogleWizualizacj API?

Interfejs Chart API pozwala łatwo tworzyć różnego rodzaju wykresy, wysyłając na serwer Google sformatowany adres URL, który zawiera opcje konfiguracji danych i wykresu. Interfejs Chart API zawiera zamknięty zestaw wykresów z różnymi opcjami. Zbiory danych Chart API są ograniczone do rozmiaru adresu URL (około 2K).

Interfejs API wizualizacji umożliwia łączenie wykresów i źródeł danych w internecie oraz ich publikowanie:

Wizualizacja udostępnia interfejsy API JavaScript.
Galeria wykresów zawiera wykresy utworzone przez Google, ale można je też tworzyć, by tworzyć własne wizualizacje zgodne z interfejsem API wizualizacji.
Wykresy i interfejsy API wizualizacji mogą zawierać wszystko, co może wyświetlić przeglądarka. Dotyczy to obrazów, JavaScriptu, grafiki wektorowej, Flasha itp.
Znaczna liczba wykresów interfejsu API Chart jest dostępna przez interfejs API wizualizacji, ale niektóre z nich mogą być niedostępne.
Interfejs API zapewnia również udokumentowany protokół przewodowy oraz sposób na udostępnienie źródeł danych dowolnej wizualizacji interfejsu API.
Interfejs API ma zdefiniowany model zdarzeń, który pozwala wykresom wysyłać i odbierać zdarzenia, a tym samym komunikować się ze stroną hosta lub innymi wykresami na stronie.

Do jakich źródeł danych mogę uzyskać dostęp za pomocą interfejsu API wizualizacji?

Za pomocą interfejsu API wizualizacji możesz uzyskiwać dostęp do danych lokalnie z poziomu przeglądarki przez utworzenie standardowego formatu API DataTable lub dostęp do dowolnego źródła danych, które obsługuje ten interfejs API. Znanymi aplikacjami, które obsługują już ten interfejs API, są Arkusze kalkulacyjne Google i witryna Salesforce.com na platformie dla programistów Force.com. Jako źródło danych wykresu możesz też zaimplementować własne dane.

Moja aplikacja oczekuje, że otrzymane dane będą miały określony format. Jak obsługiwać wyjątki?

Możesz użyć metod getNumberOfColumns() i getColumnType() klasy google.visualization.DataTable, aby sprawdzić, czy otrzymane dane spełniają Twoje oczekiwania, a także wysłać komunikat o błędzie z niezgodności.

Czy mogę umieścić wykres w witrynie?

Uruchomienie kodu przez firmę zewnętrzną bezpośrednio w Twojej witrynie stwarza ryzyko. Google nie składa żadnych obietnic ani nie reprezentuje wydajności aplikacji, jej jakości, bezpieczeństwa ani treści. Aplikacje związane z wykresami, które nie są zgodne z Warunkami korzystania z interfejsu API Google, mogą zostać usunięte z galerii.

Czy mogę korzystać z wykresów offline?

Aby można było korzystać z interaktywnych funkcji Map Google, komputery użytkowników muszą mieć dostęp do strony https://www.gstatic.com/schemas/loader.js. Dzieje się tak, ponieważ biblioteki wizualizacji wymagane przez Twoją stronę są ładowane dynamicznie przed ich użyciem. Kod wczytywania odpowiedniej biblioteki jest częścią dołączonego skryptu, który jest wywoływany po wywołaniu metody google.charts.load(). Zgodnie z naszymi Warunkami korzystania z usługi nie możesz pobrać kodu google.charts.load ani google.visualization, aby korzystać z nich offline.

Czy mogę pobrać i przechowywać kod wykresu lokalnie lub w intranecie?

Nasze Warunki korzystania z usługi nie zezwalają na pobieranie ani zapisywanie kodu google.charts.load lub google.visualization. Jeśli jednak nie potrzebujesz interaktywności wykresów Google, możesz zrobić zrzuty ekranu i użyć ich wedle uznania.

Rozwiązywanie problemów

Dlaczego nie widzę mojego wykresu?

Najpierw sprawdź konsolę JavaScriptu. Aby uzyskać dostęp do konsoli JavaScript w Chrome, kliknij Chrome > Widok > Deweloper > Konsola JavaScript > Konsola > Narzędzia > Konsola JavaScript. Wszystkie nowoczesne przeglądarki mają konsolę JavaScriptu. Aby ją znaleźć, konieczne może być przejrzenie menu z takimi nazwami jak „Zaawansowane” lub „Narzędzia dla programistów”.

Mamy nadzieję, że konsola natychmiast doprowadzi Cię do problemu. Czasem jednak trudno jest przetłumaczyć wiadomość w konsoli na przyczynę tej sytuacji. Oto kilka typowych błędów:

Możliwe, że używasz Google Loader nieprawidłowo.

Wczytaj wykresy/loader.js tylko raz . Niezależnie od tego, ile masz wykresów na swojej stronie internetowej, musisz utworzyć jedno lub tylko jedno wywołanie:
```
<script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> // Do this ONCE.
```
Może to być nagłówek lub treść strony – zależnie od tego, kiedy ma się nastąpić.

Najlepiej jest zadzwonić na stronę google.charts.load tylko raz i z wszystkimi pakietami, których potrzebujesz na swojej stronie internetowej.

<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>

Każdy wykres powinien mieć unikalny identyfikator elementu (np. chart1, chart2 w powyższym przykładzie).
Sprawdź, czy nie ma literówek. Pamiętaj, że w języku JavaScript rozróżniana jest wielkość liter.

Jeśli nadal nie wszystko jest dla Ciebie jasne, przeszukaj grupę dyskusyjną poświęconą interfejsowi GoogleWizualizacja interfejsu API, aby sprawdzić, czy nikt nie napotkał podobnego problemu. Jeśli nie możesz znaleźć posta z odpowiedzią na swoje pytanie, opublikuj pytanie w grupie wraz z linkiem do strony internetowej, na której widać występujący problem. Jeśli to możliwe, dodaj jsfiddle.

Dlaczego moje dni i miesiące są przesunięte o jeden?

Wykresy Google korzystają z kodu JavaScript, który korzysta z indeksowania opartego na zero. Pierwszy dzień miesiąca to 0, a miesiące – od 0 (styczeń) do 11 (grudzień). Jeśli kod zakłada, że indeksowanie odbywa się w ten sposób, odejmij jeden z nich, zanim umieścisz dane w obiekcie data JavaScript.

Dlaczego moje wykresy działają w niektórych przeglądarkach, ale nie wszystkie?

Odwiedź stronę caniuse.com, aby uzyskać informacje na temat niezgodności przeglądarek. W przypadku Wykresów Google w przeglądarce Internet Explorer 8 i starszych mogą wystąpić problemy z dwóch powodów:

IE8 nie obsługuje SVG, więc wykres staje się niedostępny w VML, co jest bardziej ograniczone.

Kod JavaScript IE8 nie zezwala na dodawanie przecinków na listach.

Dlaczego mój wykres oparty na technologii Flash nie pojawia się podczas testowania?

Ze względu na ustawienia zabezpieczeń reklam Flash wykresy oparte na lokalizacji mogą nie działać prawidłowo w przypadku otwarcia pliku w przeglądarce (np. file:///c:/webhost/myhost/myviz.html), a nie za pomocą adresu URL serwera WWW (np. http://www.myhost.com/myviz.html). Jest to zwykle problem testowy. Nie dotyczy on wyświetlania wykresu za pomocą adresu http://. Możesz rozwiązać ten problem zgodnie z opisem na stronie Macromedia. Ogólnie zalecamy, aby w miarę możliwości unikać tworzenia kreacji Flash.

Zasady programu wizualizacji Google

Jakie są zasady programu wizualizacji Google?

Zgodnie z Warunkami korzystania z usługi możemy odmówić uwzględnienia i wyświetlania treści naruszających zasady programu, prezentując takie linki lub prowadzące do nich:

Treści niezgodne z prawem.
Naruszenie prywatności.
Treści pornograficzne lub nieprzyzwoite.
Treści, takie jak złośliwy kod, które utrudniają lub zakłócają działanie komputera użytkownika albo funkcjonowania strony internetowej hosta.
Promowanie nienawiści lub podżegania do przemocy.
Naruszenia praw autorskich. Więcej informacji znajdziesz w naszych zasadach dotyczących ustawy DMCA.
Naruszenia znaku towarowego.
Podszywanie się pod inne osoby.

Deweloperzy, którzy tworzą wykresy zbierające dane, zobowiązują się utrzymywać odpowiednią politykę prywatności i mieć do niej dostęp. Ponadto wymagamy od deweloperów, aby mieli pewność, że wykres jest bezpieczny i zachowują jego aplikacje, dopóki znajdują się w katalogu wykresów.

Zasady mogą być zmieniane bez wcześniejszego powiadomienia.

Czy interfejs GoogleWizualizacj API jest dostępny do zastosowań komercyjnych?

Tak. Drobny druk można znaleźć w Warunkach korzystania z interfejsu API wizualizacji Google.

Czy do tworzenia oprogramowania po stronie klienta mogę używać interfejsu GoogleWizualizacj API?

Obecnie nie zezwalamy deweloperom na używanie interfejsu Visual API do tworzenia oprogramowania po stronie klienta. Interfejsu Visual API możesz używać tylko za pomocą podanego interfejsu. Informacje na temat drobnych druków znajdziesz w Warunkach korzystania z interfejsu GoogleVisual API.

Czy Google rejestruje wszystkie dane na wykresie?

Dane wykresu zawarte w żądaniu HTTP są przechowywane w dziennikach tymczasowych przez maksymalnie 2 tygodnie na potrzeby testów wewnętrznych i debugowania. Musisz oczywiście pamiętać, że jeśli wykres jest widoczny w tagu graficznym na publicznej stronie internetowej, może zostać zindeksowany.

Naruszenia zasad programu.

Naruszenie tych zasad programu może spowodować wyłączenie lub usunięcie Twojego wykresu, uniemożliwienie jego przesyłania w przyszłości, usunięcie kont Google lub usunięcie wszystkich wykresów.

Aktywny wypoczynek w społeczności

Jak udostępnić aplikację Wykres innym osobom?: Zacznij od umieszczenia wykresu w Galerii wykresów. Jeśli chcesz, możesz wrócić do swojej witryny i podać kod źródłowy. Dołącz do grupy dyskusyjnej, aby poznać opinie społeczności.
Co to jest Galeria wykresów?: Galeria wykresów zawiera listę aplikacji, które używają interfejsu Visual API. Jest to centralne miejsce, w którym społeczność programistów wizualizacji będzie mogła współdzielić aplikacje na wykresie. Aby przesłać wykres do galerii, prześlij zgłoszenie online.
Jak mogę promować moje źródło danych na wykresie?: Opublikuj implementację w grupie wizualizacji. Jeśli film nam się spodoba, możemy nawet wspomnieć o sobie.