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

Najczęstsze pytania

Pierwsze kroki
Korzystanie z interfejsu API
Rozwiązywanie problemów
Zasady dotyczące interfejsu GoogleVisual API
Aktywność w społeczności

Pierwsze kroki

Czym jest interfejs GoogleVisual API?: Interfejs Google Wizualizacja API umożliwia tworzenie wykresów i aplikacji do raportowania za pomocą uporządkowanych danych oraz pomaga zintegrować je bezpośrednio z Twoją witryną.
Co mogę zrobić za pomocą interfejsu Vision API?: Dzięki interfejsowi GoogleVisual API możesz uzyskać dostęp do uporządkowanych danych utworzonych lokalnie w przeglądarce lub pobranych z obsługiwanych źródeł danych w prostym formacie tabelarycznym. Możesz też zaimplementować własne źródło danych jako źródło danych interfejsu Wizualizacja API i umożliwić dostęp do danych dowolnej wizualizacji lub aplikacji zgodnej z wizualizacją. Ten format może być używany przez aplikacje do raportowania, analizy lub wykresów. Dzięki temu możesz wizualizować dane lub dodawać nowe funkcje do aplikacji, takich jak Arkusze Google.
Gdzie znajdę dokumentację dotyczącą interfejsu API wizualizacji?: Przewodnik dla programistów i całą powiązaną dokumentację znajdziesz na https://developers.google.com/chart/interactive/docs.
Jak utworzyć nowy wykres?: Najlepiej zacząć od przeczytania wprowadzenia i sekcji krótkie wprowadzenie.
Co to jest adres URL źródła danych?: Adres URL źródła danych to unikalny identyfikator adresu URL źródła danych interfejsu API wizualizacji. Adres URL źródła danych może też zawierać parametry Język zapytań wykresu. W takim przypadku przed pobraniem danych ze źródła danych wykonywane jest zapytanie (np. sortowanie, grupowanie).
Gdzie znajdę przykładowy kod aplikacji Chart przy użyciu interfejsu API wizualizacji?: Przykładowy kod znajdziesz w dokumentacji interfejsu API wizualizacji przykładowego kodu.
Czy aplikacja Flash ma dostęp do interfejsu API wizualizacji?: Oczywiście. Wizualizacja API korzysta z interfejsu JavaScript API, ale istnieją biblioteki, które umożliwiają aplikacjom Flash łączenie się z kodem JavaScript. Jedna z takich bibliotek może być przydatna na stronie http://code.google.com/p/swfobject. Poniżej znajdziesz informacje o niektórych problemach deweloperskich dotyczących Flasha.
Jak zaimplementować źródło danych?: Przeczytaj sekcję poświęconą używaniu i tworzeniu wykresu, aby dowiedzieć się, jak działają wykresy, a potem przeczytaj artykuł Implementowanie źródła danych, z którego dowiesz się, jak utworzyć źródło danych. Jeśli używasz języka Java, możesz też szybko rozpocząć pracę, korzystając z biblioteki w Javie Google Chart Data Source.
Czy mogę uzyskać dostęp do wykresu z aplikacji Java?: Tak. Biblioteka wizualizacji Google w pakiecie narzędzi Google Web Toolkit (GWT) zapewnia dostęp do zgodnych z interfejsem API wizualizacji z kodu Java skompilowanego za pomocą kompilatora GWT, a także umożliwia pisanie wizualizacji zgodnych z interfejsem API wizualizacji w języku Java za pomocą kompilatora GWT. Biblioteka kandydująca 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 wizualizacji Google w pakiecie narzędzi Google Web Toolkit (GWT) zapewnia dostęp do zgodnych z interfejsem API wizualizacji z kodu Java skompilowanego za pomocą kompilatora GWT, a także umożliwia pisanie wizualizacji zgodnych z interfejsem API wizualizacji w języku Java za pomocą kompilatora GWT. Biblioteka kandydująca do wersji obsługuje też model zdarzeń interfejsu API wizualizacji.
Mam inne pytanie lub inny problem. Z kim mogę się skontaktować, aby uzyskać więcej informacji?: Zadaj pytanie na grupie dyskusyjnej dotyczącej interfejsu GoogleVisual API, aby uzyskać pomoc od społeczności programistów wizualizacji. Zespół Wizualizacji Google również uczestniczy w tej grupie, aby odpowiadać na pytania.

Korzystanie z interfejsu API

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

Interfejs Chart API pozwala w prosty sposób tworzyć różne wykresy graficzne przez wysyłanie do serwera Google sformatowanego adresu URL zawierającego zarówno opcje konfiguracji danych, jak i wykresów. Interfejs Chart API zawiera zamknięty zestaw wykresów z różnymi opcjami. Zbiory danych interfejsu Chart API są ograniczone do rozmiaru adresu URL (około 2 tys.).

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

Wizualizacja API udostępnia interfejs JavaScript API umożliwiający dostęp do wykresów.
Galeria wykresów w niej zawiera wykresy utworzone przez Google, ale każdy może tworzyć własne wizualizacje zgodne z interfejsem API wizualizacji.
Wykresy i wykresy z interfejsu API wizualizacji mogą być dowolne, co może być renderowane przez przeglądarkę. Obejmuje to grafiki, JavaScript, grafiki wektorowe, Flash itp.
Wiele wykresów interfejsu Chart API jest dostępnych za pomocą tego interfejsu, ale niektóre opcje ich konfiguracji mogą być niedostępne.
Udostępnia też udokumentowany protokół przewodów i sposób, który każdy może ujawnić swoje źródła danych dowolnej wizualizacji interfejsów API.
Interfejs API ma zdefiniowany model zdarzeń, który umożliwia wykresom zgłaszanie i odbieranie zdarzeń, a tym samym komunikację ze stroną hosta lub innymi wykresami na tej stronie.

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

Interfejs API wizualizacji umożliwia dostęp do danych lokalnie z poziomu przeglądarki (przez utworzenie standardowego formatu tabeli DataTable interfejsu API). Można też uzyskać 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 ich platformie dla programistów Force.com. Jako źródło danych wykresu możesz też zaimplementować własne dane.

Moja aplikacja oczekuje, że odbierane dane mają 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 są zgodne z Twoimi oczekiwaniami, i wyświetlać komunikat o błędzie w przypadku rozbieżności.

Czy umieszczenie wykresu w mojej witrynie jest bezpieczne?

Uruchamianie kodu zewnętrznego bezpośrednio w witrynie wiąże się z ryzykiem. Google nie składa żadnych obietnic dotyczących wydajności, jakości, bezpieczeństwa ani zawartości aplikacji. Aplikacje do tworzenia wykresów, które nie spełniają Warunków korzystania z usługi interfejsu GoogleVisual API, mogą zostać usunięte z galerii.

Czy mogę korzystać z wykresów w trybie offline?

Aby można było korzystać z interaktywnych funkcji Wykresów Google, komputery użytkowników muszą mieć dostęp do strony https://www.gstatic.com/charts/loader.js. Dzieje się tak, ponieważ biblioteki wizualizacji, których wymaga Twoja strona, są ładowane dynamicznie przed użyciem. Kod wczytywania odpowiedniej biblioteki jest częścią dołączonego skryptu i jest wywoływany przy wywoływaniu metody google.charts.load(). Nasze Warunki korzystania z usługi nie zezwalają na pobieranie kodu google.charts.load ani google.visualization do użytku offline.

Czy kod wykresu można pobrać i hostować lokalnie lub w intranecie?

Zgodnie z naszymi Warunkami korzystania z usługi nie możesz pobierać, zapisywać ani hostować kodu google.charts.load lub google.visualization. Jeśli jednak nie potrzebujesz interaktywności wykresów Google, możesz tworzyć zrzuty ekranu i korzystać z nich według własnego uznania.

Rozwiązywanie problemów

Dlaczego mój wykres się nie wyświetla?

Najpierw sprawdź konsolę JavaScript. W Chrome możesz to zrobić, klikając kolejno Chrome > Widok > Programista > Konsola JavaScript lub Chrome > Narzędzia > Konsola JavaScript. Wszystkie nowoczesne przeglądarki mają konsolę JavaScript. Aby ją znaleźć, konieczne może być przeszukanie menu o nazwach takich jak „Zaawansowane” lub „Narzędzia dla programistów”.

Mamy nadzieję, że konsola natychmiast doprowadzi Cię do problemu. Czasami jednak trudno jest przenieść komunikat w konsoli z uwzględnieniem pierwotnej przyczyny. Oto kilka typowych pułapek:

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

Wykresy/loader.js wczytuj tylko raz. Niezależnie od liczby wykresów na stronie możesz mieć jedno i tylko jedno wywołanie podobne do tego:
```
<script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> // Do this ONCE.
```
Może to być w nagłówku lub w treści strony, w zależności od tego, kiedy ma nastąpić obciążenie.

Najlepiej zadzwonić do firmy google.charts.load tylko raz i mieć wszystkie pakiety potrzebne do utworzenia strony 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 i chart2 w przykładzie powyżej).
Sprawdź, czy nie ma literówek. Pamiętaj, że w języku JavaScript wielkość liter ma znaczenie.

Jeśli nadal nie masz pewności, przeszukaj grupę dyskusyjną interfejsu Google wizualizacji API, aby sprawdzić, czy ktoś nie napotkał podobnego problemu. Jeśli nie możesz znaleźć posta z odpowiedzią na Twoje pytanie, opublikuj je w grupie razem z linkiem do strony internetowej ilustrującej problem. Jeśli to możliwe, dołącz tag jsfiddle.

Dlaczego moje miesiące i dni są wolne od siebie?

Wykresy Google używają JavaScriptu, w którym indeksowanie liczone jest od zera. Pierwszy dzień miesiąca to 0, a zakres miesięcy od 0 (styczeń) do 11 (grudnia). Jeśli w Twoim kodzie zakładamy, że indeksowanie jest jednolite, odejmij je przed umieszczeniem danych w obiekcie daty w języku JavaScript.

Dlaczego moje wykresy działają w niektórych przeglądarkach?

Polecamy stronę caniuse.com, gdzie znajdziesz więcej informacji o niezgodnościach przeglądarek. W przypadku Wykresów Google czasami w Internet Explorerze 8 i starszych wersjach mogą występować problemy z 2 powodów:

IE8 nie obsługuje SVG, więc wykresy przełączają się w tryb VML, który jest bardziej ograniczony.

W JavaScripcie IE8 nie można umieszczać przecinków na listach.

Dlaczego mój wykres oparty na Flashu nie jest widoczny podczas testowania?

Ze względu na ustawienia zabezpieczeń Flash wykresy oparte na technologii Flash mogą nie działać poprawnie, gdy otworzysz je z poziomu pliku w przeglądarce (np. file:///c:/webhost/myhost/myviz.html), a nie z adresu URL serwera WWW (np. http://www.mojhost.com/myviz.html). Zazwyczaj jest to problem tylko podczas testowania. Problem nie dotyczy sytuacji, gdy uzyskujesz dostęp do wykresu z adresu http://. Możesz rozwiązać ten problem w sposób opisany w witrynie Macromedia. Ogólnie w miarę możliwości zalecamy unikanie tworzenia plików w formacie 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, które naruszają zasady programu, wyświetlając lub zamieszczając linki do:

Treści niezgodne z prawem.
Treści naruszające prywatność.
Treści pornograficzne lub nieprzyzwoite.
Treści (np. złośliwy kod), które zakłócają działanie komputera użytkownika lub strony internetowej hosta albo są szkodliwe dla użytkownika.
treści propagujące nienawiść lub podburzające do przemocy;
Naruszenia praw autorskich Więcej informacji znajdziesz w zasadach dotyczących ustawy DMCA.
Naruszenia znaku towarowego.
Podszywanie się pod inne osoby.

Deweloperzy, którzy tworzą wykresy, które zbierają dane, zgadzają się na utrzymywanie polityki prywatności obowiązującej w danym kraju i podanie linku do niej. Ponadto wymagamy od deweloperów dbania o bezpieczeństwo wykresów i utrzymywania aplikacji, dopóki znajdują się one w katalogu wykresów.

Te zasady mogą być co jakiś czas zmieniane bez powiadomienia.

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

Tak. Szczegółowe informacje znajdziesz w Warunkach korzystania z usługi API Google Wizualizacja.

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

Obecnie nie zezwalamy deweloperom na korzystanie z interfejsu API wizualizacji do tworzenia oprogramowania po stronie klienta. Interfejsu Vision API możesz używać tylko za pomocą udostępnionego interfejsu. Szczegółowe informacje na temat drobnego druku znajdziesz w Warunkach korzystania z interfejsu GoogleVisual API.

Czy Google rejestruje wszystkie dane z moich wykresów?

Dane wykresu uwzględnione w żądaniu HTTP są zapisywane w dziennikach tymczasowych nie dłużej niż 2 tygodnie na potrzeby testów wewnętrznych i debugowania. Pamiętaj, że jeśli wykres pojawia się w tagu obrazu 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, zablokowanie możliwości przesyłania przyszłych wykresów, usunięcie Twoich kont Google lub usunięcie wszystkich Twoich wykresów.

Aktywne działania w społeczności

Jak mogę udostępnić swój wykres innym osobom?: Zacznij od umieszczenia wykresu w Galerii wykresów. Jeśli chcesz, możesz dodać link do swojej witryny oraz swój kod źródłowy. Dołącz do naszej grupy dyskusyjnej, aby poznać opinie społeczności.
Co to jest Galeria wykresów?: Galeria wykresów zawiera listę aplikacji, które korzystają z interfejsu API wizualizacji. Stanowi centralne miejsce, w którym społeczność programistów wizualizacji może udostępniać aplikacje do tworzenia wykresów. Aby przesłać swój wykres do galerii, zgłoś się online.
Jak mogę promować swoje źródło danych z wykresu?: Opublikuj implementację w grupie wizualizacji. Jeśli nam się spodoba, możemy nawet o niej wspomnieć.