Alert o zamienniku: ten wykres mapy został zastąpiony nowszą wersją.

Na tej stronie dowiesz się, jak utworzyć kolorową mapę za pomocą interfejsu Charts API.

Spis treści

Omówienie

Możesz utworzyć mapę z różnymi krajami lub województwami wyróżnionymi kolorami niestandardowymi. Aby wskazać mapę, musisz wskazać region świata, który ma być powiększony. Wskażesz też listę regionów do pokolorowania na mapie oraz równoległą listę danych, która do każdego z tych krajów przypisze wartość liczbową. Każdy kraj jest kolorowany wzdłuż gradientu zgodnie z przypisaną mu wartością. Opcjonalnie możesz określić niestandardowy gradient kolorów dla wartości danych.

Wykresy mapy obsługują te parametry:

Parametr	Wymagany czy opcjonalny	Opis
cht=t	Wymagane	Określa wykres mapy.
chs	Wymagane	Rozmiar mapy. Maksymalny rozmiar mapy to 440 x 220.
chtm=<zoom_area>	Wymagane	Obszar geograficzny widoczny na wykresie. zoom_area – jedna z tych wartości africa asia europe middle_east south_america usa world
chld=<country_or_state_codes>	Wymagane	Lista krajów lub stanów, do których stosujesz wartości. kody_kraju_lub_stanu – zestaw dwuznakowych kodów bez separatora oddzielającego od siebie. Użyj jednego z tych typów (nie można łączyć typów): kody ISO 3166-1-alpha-2 dla krajów lub Kody stanów USA Przykład: chld=DZEGMG
chd=<country_values>	Wymagane	Lista wartości równoległych do listy regionów, których wartość odnosi się do odpowiedniego regionu. Wartości to standardowe sformatowane wartości danych. Każdemu regionowi zostanie przypisany kolor wzdłuż skali określonej w chco, gdzie najniższa wartość w zakresie dotyczy najniższego koloru, a najwyższa wartość w tym zakresie dotyczy ostatniego koloru. country_values – lista w odpowiednim ciągu znaków w formacie. Przykłady: t:10,20,30, s:aU2Ff i e:BaPoqM-A.
chco=<default_color>,<start_of_gradient>,...,<end_of_gradient>	Opcjonalnie	Zakres kolorów odpowiadający niskim i wysokim wartościom danych w zakresie formatów danych. Wartości danych są konwertowane na wartości kolorów wzdłuż tego gradientu i stosowane do odpowiednich krajów. default_color – [opcjonalny] kolor regionów, które nie mają przypisanych danych. Domyślnie to BEBEBE (średni szary). Liczba szesnastkowa w formacie RRGGBB. start_of_gradient – [opcjonalny] kolor odpowiadający minimalnej wartości w zakresie formatów danych. Wartość domyślna to 0000FF (kolor niebieski). Liczba szesnastkowa w formacie RRGGBB. ... – [opcjonalny] Możesz mieć dowolną liczbę kolorów pośrednich. end_of_gradient – [opcjonalny] kolor odpowiadający maksymalnej wartości w zakresie formatów danych. Wartość domyślna to FF0000 (czerwony). Liczba szesnastkowa w formacie RRGGBB
chtt, chts	Opcjonalnie	Tytuł i styl wykresu
chma	Opcjonalnie	Marginesy wykresu
chf=bg	Opcjonalnie	Pełne wypełnienie (tylko w tle)

 

Przykłady

Opis	Przykład
W tym przykładzie: Obszar powiększeń wykresu to Afryka (chtm=africa). Te 3 kraje będą miały przypisane wartości: Algieria, Egipt i Madagaskar (chld=DZEGMG) Trzy wartości przypisane do tych krajów to odpowiednio 0, 100 i 50 (chd=t:0,100,50). Są to wartości minimalna, maksymalna i środkowa w przypadku danych w formacie tekstowym. Zakres kolorów to czerwony – 0, zielony – 100, i biały dla krajów bez przypisania (chco=FFFFFF,FF0000,00FF00). Tło wykresu jest też wypełnione jasnoniebieskim tłem (chf=bg,s,EAF7FE).	cht=t chtm=africa chld=DZEGMG chd=t:0,100,50 chco=FFFFFF,FF0000,00FF00 chf=bg,s,EAF7FE
Ten wykres jest podobny do poprzedniego, ale zawiera więcej szczegółów.	chtm=africa chld=DZEGMGAOBWNGCFKECGCVSNDJTZGHMZZM chco=FFFFFF,FF0000,FFFF00,00FF00 chd=t:0,100,50,32,60,40,43,12,14,54,98,17,70,76,18,29 chf=bg,s,EAF7FE
Na tym wykresie określone kraje są wyróżnione, podając jedną, niezdefiniowaną wartość (chd=t:-1).	chs=440x220 chd=t:-1 cht=t chtm=world

Powrót do góry

Amerykańskie kodeksy stanowe

Oto obsługiwane kody stanów, gdy mapa jest powiększona na Stany Zjednoczone (chld=usa).

AL	Alabama	Luizjana	Luizjana	OCH	Ohio
Alaska	Alaska	Bliski Wschód	Maine	OK	Oklahoma
AZ	Arizona	MD	Maryland	LUB	Oregon
AR	Arkansas	MA	Massachusetts	PA	Pensylwania
CA	Kalifornia	MI	Michigan	reklama pełnoekranowa z reklamą pełnoekranową	Rhode Island
CO	Kolorado	Min.	Minnesota	SC	Karolina Południowa
CT	Connecticut	MS	Missisipi	SD	Dakota Południowa
DE	Delaware	Missouri	Missouri	PN	Tennessee
FL	Floryda	MT	Montana	TX	Teksas
GA	Gruzja	płn.-wsch.	Nebraska	Utah	Utah
HI	Hawaje	NV	Nevada	VT	Vermont
Identyfikator	Idaho	NH	New Hampshire	VA	Wirginia
IL	Illinois	NJ	New Jersey	WA	Waszyngton
IN	Indiana	NM	Nowy Meksyk	Śr.	Wirginia Zachodnia
architektura informacji	Iowa	NY	Nowy Jork	WI	Wisconsin
Kansas	Kansas	NC	Karolina Północna	Wyoming	Wyoming
Kentucky	Kentucky	ND	Dakota Północna

Powrót do góry

Funkcje standardowe

Pozostałe funkcje na tej stronie to standardowe funkcje wykresu.

Tytuł wykresu chtt, chts [Wszystkie wykresy]

Możesz określić tekst tytułu, kolor i rozmiar czcionki wykresu.

Składnia

chtt=<chart_title>
chts=<color>,<font_size>,<opt_alignment>

 

chtt – określa tytuł wykresu.

<chart_title>

Tytuł do wyświetlenia na wykresie. Nie możesz określić, gdzie będzie ona widoczna, ale możesz opcjonalnie określić rozmiar i kolor czcionki. Użyj znaku + do oznaczenia spacji oraz kreski pionowej ( |) do oznaczenia podziałów wiersza.

 

chts [opcjonalny] – kolory i rozmiar czcionki w parametrze chtt.

<color>

Kolor tytułu w formacie szesnastkowym RRGGBB. Domyślny kolor to czarny.

<font_size>

Rozmiar czcionki tytułu (w punktach).

<opt_alignment>

[Opcjonalnie] Wyrównanie tytułu. Wybierz jedną z tych wartości ciągu znaków (z uwzględnieniem wielkości liter): „l” (po lewej), „c” (na środku) „r” (po prawej). Wartość domyślna to „c”.

 

Przykłady

Opis	Przykład
Wykres z tytułem, z domyślnym kolorem i rozmiarem czcionki. Wpisz spację za pomocą znaku plusa (+). Aby wymusić podział wiersza, użyj pionowej kreski (|). Nie określono tutaj: chts.	chtt=Site+visitors+by+month| January+to+July
Wykres z 20-punktowym tytułem niebieskim wyrównanym do prawej.	chtt=Site+visitors chts=FF0000,20,r

Powrót do góry

Marginesy wykresu chma [Wszystkie wykresy]

Możesz określić rozmiar marginesów wykresu w pikselach. Marginesy są obliczane do wewnątrz od określonego rozmiaru wykresu (chs). Jeśli to konieczne, zwiększenie marginesu nie zwiększy łącznego rozmiaru wykresu, ale w razie potrzeby zmniejszy jego obszar.

Domyślnie marginesy są pozostawione po obliczeniu rozmiaru wykresu. Ta wartość domyślna różni się w zależności od typu wykresu. Określone marginesy są wartością minimalną. Jeśli w obszarze wykresu pozostawia miejsce na marginesy, rozmiar marginesu będzie wynosić tyle, ile zostało. Nie możesz ściśnąć marginesów mniejszych niż wymagane w przypadku legend i etykiet. Oto schemat przedstawiający podstawowe elementy wykresu:

Marginesy wykresu obejmują etykiety osi i obszar legendy. Rozmiar obszaru legendy zmienia się automatycznie, aby dokładnie pasował do tekstu, chyba że określisz większą szerokość za pomocą parametru chma. W takim przypadku margines zostanie poszerzony, a obszar wykresu zostanie zmniejszony. Nie można przyciąć legendy przez określenie zbyt małego rozmiaru, ale można zmniejszyć, aby zajmowała więcej miejsca. Wskazówka: jeśli słupki na wykresie słupkowym mają stały rozmiar (domyślnie), nie można zmniejszyć szerokości obszaru wykresu. Musisz określić mniejszy lub możliwy do zmiany rozmiar paska za pomocą właściwości chbh.

 

Składnia

chma=
  <left_margin>,<right_margin>,<top_margin>,<bottom_margin>|<opt_legend_width>,<opt_legend_height>

<left_margin>, <right_margin>, <top_margin>, <bottom_margin>

Minimalny rozmiar marginesu wokół obszaru wykresu (w pikselach). Zwiększ tę wartość, aby uwzględnić pewne dopełnienie, dzięki czemu etykiety osi nie zderzają się z granicami wykresu.

<opt_legend_width>, <opt_legend_height>

[Opcjonalnie] Szerokość marginesów wokół legendy (w pikselach). Korzystaj z tej opcji, aby legenda nie zsunęła się o obszar wykresu ani na krawędzie obrazu.

 

Przykłady

Opis	Przykład
W tym przykładzie minimalny margines to 30 pikseli z każdej strony. Legenda wykresu ma ponad 30 pikseli szerokości, dlatego margines po prawej stronie jest ustawiony na szerokość legendy wykresu i różni się od pozostałych. Etykiety osi są poza obszarem wykresu, dlatego są rysowane w marginesie.	chma=30,30,30,30
Aby dodać margines do legendy, ustaw wartości parametrów <opt_legend_width> i <opt_legend_height>. W tym przykładzie legenda ma około 60 pikseli szerokości. Jeśli ustawisz <opt_legend_width> na 80 pikseli, margines będzie się wydłużać o 20 pikseli poza legendą.	chma=20,20,20,30|80,20

Powrót do góry

Wypełnienie tła chf [Wszystkie wykresy]

Możesz określić kolory i style wypełnienia dla obszaru danych wykresu lub całego tła wykresu. Typy wypełnienia obejmują: pełne wypełnienia, paski i gradienty. Możesz określić różne wypełnienia dla różnych obszarów (np. całego obszaru wykresu lub tylko obszaru danych). Wypełnienie obszaru wykresu zastępuje wypełnienie tła. Wszystkie wypełnienia są określane za pomocą parametru chf. Możesz mieszać różne typy wypełnienia na tym samym wykresie, rozdzielając wartości pionową kreską ( | ). Wypełnienia obszaru wykresu zastępują wypełnienia tła wykresu.

Wypełnienie jednolite chf [Wszystkie wykresy]

Możesz określić pełne wypełnienie dla tła lub obszaru wykresu albo przypisać wartość przezroczystości do całego wykresu. Możesz określić wiele wypełnienia, używając pionowej kreski (|). (Mapy: tylko tło).

Składnia

chf=<fill_type>,s,<color>|...

<fill_type>

Część wykresu jest wypełniana. Podaj jedną z tych wartości:

• bg – wypełnienie tła
• c – wypełnienie obszaru wykresu. Nieobsługiwany w przypadku wykresów map.
• a – zadbaj o przezroczystość całego wykresu (w tym tła). Pierwsze 6 cyfr wartości <color> jest ignorowanych, a tylko ostatnie 2 (wartość przezroczystości) są stosowane do całego wykresu i wszystkich wypełnienia.
• b<index> – wypełnienia słupkowe (tylko wykresy słupkowe). Zastąp ciąg <indeks> indeksem serii słupków, aby wypełnić go jednolitym kolorem. Efekt jest podobny do właściwości chco na wykresie słupkowym. Przykład znajdziesz w sekcji Kolory serii na wykresie słupkowym.

s

Oznacza wypełnienie pełne lub przezroczyste.

<color>

Kolor wypełnienia w formacie szesnastkowym RRGGBB. W przypadku przezroczystości pierwsze 6 cyfr jest ignorowanych, ale i tak trzeba je uwzględnić.

 

Przykłady

Opis	Przykład
W tym przykładzie tło wykresu wypełnia się jasnoszarym kolorem (EFEFEF).	chf=bg,s,EFEFEF
W tym przykładzie tło wykresu wypełnia jasnoszary (EFEFEF) i czarny (000000).	chf=c,s,000000| bg,s,EFEFEF
W tym przykładzie przezroczystość całego wykresu wynosi 50% (80 w zapisie szesnastkowym to 128, czyli około 50% przezroczystości). Zwróć uwagę na tło komórki tabeli widoczne na wykresie.	chf=a,s,00000080

Powrót do góry

Powrót do góry