Wykres mapy (wersja wycofana)

 

Alert dotyczący zastąpienia: ten wykres mapy został zastąpiony nowszą wersją.

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

Spis treści

Funkcje dotyczące wykresu

  1. Omówienie
  2. Kody stanu USA

Funkcje standardowe

  1. Tytuł wykresu (chtt, chts)
  2. Chart Margins (Marginesy wykresu) (chma)
  3. Wypełnienie tła
    1. Wypełnienie (chf)

Omówienie

Możesz utworzyć mapę z różnymi krajami i stanami zaznaczonymi w niestandardowym kolorze. Aby określić mapę, wskaż region świata, którą chcesz powiększyć. Określisz też listę regionów, które powinny być oznaczone kolorem na mapie, oraz równoległe dane, które przypiszą wartość liczbową do każdego kraju. Każdy kraj jest oznaczony kolorem zgodnie z gradientem, zgodnie z przypisaną mu wartością. Opcjonalnie możesz określić niestandardowy gradient kolorów dla wartości danych.

Wykresy mapowe obsługują te parametry:

Parametr Wymagany czy opcjonalny Opis
cht=t Wymagany Określa wykres mapy.
chs Wymagany Rozmiar mapy. Maksymalny rozmiar mapy to 440 x 220.
chtm=<zoom_area> Wymagany

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

Lista krajów lub stanów, do których stosujesz wartości.

Przykład: chld=DZEGMG
chd=<country_values> Wymagany

Lista wartości równoległa do listy regionów, gdzie wartość dotyczy odpowiedniego regionu. Wartości to standardowe sformatowane wartości danych. Do każdego regionu zostanie przypisany kolor na skali określonej we właściwości chco, gdzie najniższą wartość z zakresu odnosi się do najniższego koloru, a najwyższa wartość z tego zakresu – do ostatniego.

  • country_values – lista w odpowiednim ciągu znaków formatu. 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 niskiom i wysokim wartościom danych dla zakresu 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, do których nie są przypisane dane. Wartością domyślną jest BEBEBE (średnioszary). 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 (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. Domyślna wartość to FF0000 (czerwony). Liczba szesnastkowa w formacie RRGGBB.
chtt, chts Opcjonalnie Tytuł i styl wykresu
chma Opcjonalnie Marginesy wykresu
chf=bg Opcjonalnie Wypełnienia jednolite (tylko w tle)

 

Przykłady

Opis Przykład

W tym przykładzie:

  • Obszar powiększenia wykresu to Afryka (chtm=africa).
  • Tym 3 krajom zostaną 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 minimalne, maksymalne i środkowe w przypadku danych w formacie tekstowym.
  • Zakres kolorów to czerwony – 0, zielony – 100 i biały – nieprzypisane kraje (chco=FFFFFF,FF0000,00FF00).
  • Wykres ma też jasnoniebieskie tło (chf=bg,s,EAF7FE).

Mapa Afryki
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.

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

Ten wykres określa, że kraje nie są wyróżnione przez określenie 1 niezdefiniowanej wartości (chd=t:-1).

 Mapa świata
chs=440x220
chd=t:-1
cht=t
chtm=world

Powrót do góry

Kody stanu USA

Oto kody stanów, które są obsługiwane przy powiększeniu mapy w Stanach Zjednoczonych (chld=usa).

AL Alabama Luizjana Luizjana Ohio Ohio
Alaska Alaska JA Maine, OK Oklahoma
Arizona Arizona MD Maryland LUB Oregon
AR Arkansas MA Massachusetts PA Pensylwania
CA Kalifornia MI Michigan Reklamy pełnoekranowe z nagrodą Rhode Island
CO Kolorado MS Minnesota SC Karolina Południowa
CT Connecticut MS Missisipi SD Dakota Południowa
DE Delaware Cele marketingowe Missouri TN Tennessee
FL Floryda MT Montana TX Teksas
GA Georgia 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, Wirtualne Wirginia Zachodnia
IA Iowa NY Nowy Jork WI Wisconsin
Kansas Kansas NC Karolina Północna Wyoming Wyoming
Kentucky Kentucky Dawid Dakota Północna

Powrót do góry

Funkcje standardowe

Pozostałe funkcje dostępne na tej stronie to standardowe funkcje wykresów.

Tytuł wykresu chtt, chts [Wszystkie wykresy]

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

Składnia

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

 

chtt – określa tytuł wykresu.

<chart_title>
Tytuł wykresu. Nie możesz określić, gdzie ma się ona wyświetlać, ale możesz opcjonalnie określić rozmiar i kolor czcionki. Użyj znaku + do oznaczenia spacji, a pionowej kreski ( |) do oznaczenia podziałów wiersza.

 

chts [opcjonalny] – kolory i rozmiar czcionki parametru chtt.

<color>
Kolor tytułu w formacie szesnastkowym RRGGBB. Kolor domyślny to czarny.
<font_size>
Rozmiar czcionki tytułu w punktach.
<opt_alignment>
[Opcjonalne] wyrównanie tytułu. Wybierz jedną z tych wartości ciągu znaków (z uwzględnieniem wielkości liter): „l” (po lewej), „c” (wyśrodkowana) „r” (po prawej). Wartość domyślna to „c”.

 

Przykłady

Opis Przykład

Wykres z tytułem, w którym jest używany domyślny kolor i rozmiar czcionki.

Określ spację ze znakiem plusa (+).

Aby wymusić podział wiersza, użyj pionowej kreski (|).

chts nie został tutaj określony.

 Pionowy wykres słupkowy z tytułem
chtt=Site+visitors+by+month|
January+to+July

Wykres z 20-punktowym tytułem wyrównanym do prawej.

 Pionowy wykres słupkowy z niebieskim wykresem, 20 pikseli, tytuł
chtt=Site+visitors
chts=FF0000,20,r

Powrót do góry

Marginesy wykresu chma [wszystkie wykresy]

Rozmiar marginesów wykresu możesz określić w pikselach. Marginesy są obliczane do wewnątrz od określonego rozmiaru wykresu (chs). Zwiększenie marginesu nie zwiększy całkowitego rozmiaru wykresu, ale w razie potrzeby zmniejszy obszar wykresu.

Marginesy są domyślnie ustawiane tak, by pozostały po obliczeniu rozmiaru wykresu. Ta wartość domyślna zależy od typu wykresu. Określone marginesy mają wartość minimalną. Jeśli w obszarze wykresu jest dość miejsca na marginesy, rozmiar marginesów będzie taki sam jak ten, który zostanie przekroczony. Nie możesz ściśnąć marginesów mniejszych niż wymagane w legendach i etykietach. Oto diagram przedstawiający podstawowe części wykresu:

Margines wykresu, obszar legendy i obszar wykresu

marginesy wykresu obejmują etykiety osi i obszar legendy, Rozmiar obszaru legendy zmienia się automatycznie, aby dokładnie dopasować się do tekstu, chyba że określisz większą szerokość za pomocą właściwości chma. W takim przypadku margines zostanie szerszy, ściskając obszar wykresu. Nie możesz przyciąć legendy, określając zbyt mały rozmiar legendy, ale możesz zwiększyć jej rozmiar.

Wskazówka: jeśli słupki mają stały rozmiar (domyślnie), na wykresie słupkowym nie można zmniejszyć szerokości obszaru wykresu. Musisz określić mniejszy rozmiar słupka lub jego rozmiar, który można zmienić 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 dookoła obszaru wykresu w pikselach. Zwiększ tę wartość, by uwzględnić dopełnienie, które zapobiegnie stykaniu się etykiet osi z granicami wykresu.
<opt_legend_width>, <opt_legend_height>
[Opcjonalny] Szerokość marginesu wokół legendy w pikselach. Pozwala to uniknąć sytuacji, w której legenda przesunie się na obszar wykresu lub krawędzie obrazu.

 

Przykłady

Opis Przykład

W tym przykładzie każdy bok wykresu ma minimalny margines 30 pikseli. Legenda do 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 znajdują się poza obszarem wykresu, dlatego są rysowane w obszarze marginesów.

Wykres liniowy z szarym tłem i marginesami po każdej stronie.
chma=30,30,30,30

Aby dodać margines wokół legendy, ustaw wartość 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 zostanie wydłużony do 20 pikseli poza legendą.

Wykres liniowy z szarym tłem i marginesami po każdej stronie.
chma=20,20,20,30|80,20

Powrót do góry

Tło wypełniło chf [Wszystkie wykresy]

Możesz określić kolory i style wypełnienia obszaru danych wykresu lub całego tła wykresu. Wypełnienia mogą obejmować wypełnienie Jednolite, paskowe i gradientowe. Możesz określić różne wypełnienia 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 (ciągłe, paski, gradienty) na tym samym wykresie, rozdzielając wartości pionową kreską ( | ). Obszar wykresu zastępuje wypełnienie tła wykresu.

Wypełnienia jednolite chf [Wszystkie wykresy]

Możesz określić jednolite wypełnienie tła lub obszaru wykresu albo przypisać wartość przezroczystości do całego wykresu. Możesz określić wiele wypełnienia za pomocą pionowej kreski (|). (Mapy: tylko w tle).

Składnia

chf=<fill_type>,s,<color>|...
<fill_type>
Wypełniana część wykresu. Określ jedną z tych wartości:
  • bg – wypełnienie tła
  • c – wypełnienie obszaru wykresu. Nieobsługiwane w przypadku wykresów mapy.
  • a – ustaw cały wykres (w tym tło) przezroczysty. Pierwsze 6 cyfr funkcji <color> jest ignorowanych, a tylko ostatnie 2 (wartość przezroczystości) są stosowane do całego wykresu i do wszystkich wypełnienia.
  • b<index> – wypełnienie słupkowe (tylko w przypadku wykresów słupkowych), Zastąp <indeks> indeksem serii słupków, aby wypełnić jednolitym kolorem. Efekt jest podobny do określania właściwości chco na wykresie słupkowym. Przykład znajdziesz w sekcji Kolory serii wykresu słupkowego.
s
Oznacza wypełnienie przezroczyste lub jednolite.
<color>
Kolor wypełnienia w formacie szesnastkowym RRGGBB. W przypadku przezroczystości pierwsze 6 cyfr jest ignorowanych, ale mimo to należy je uwzględnić.

 

Przykłady

Opis Przykład

W tym przykładzie tło wykresu jest szare (EFEFEF).

Wykres liniowy z czerwoną linią i czarnym wypełnieniem.

chf=bg,s,EFEFEF

W tym przykładzie tło wykresu jest szare (EFEFEF) i wypełnia obszar wykresu kolorem czarnym (000000).

Wykres liniowy z czerwoną linią i czarnym obszarem wykresu z bladoszarym tłem.

chf=c,s,000000|
bg,s,EFEFEF
W tym przykładzie zastosowano do całego wykresu przezroczystość wynoszącą 50% (w przypadku 80% przezroczystość w systemie szesnastkowym to 128, czyli około 50%). Zwróć uwagę, że na wykresie widać tło komórki tabeli.

Wykres rozproszony z punktami zaznaczonymi na niebiesko i przezroczystością równą 50%.

chf=a,s,00000080

Powrót do góry

Format koloru

Kolory możesz określić za pomocą 6-znakowego ciągu wartości szesnastkowych i dwóch opcjonalnych wartości przezroczystości w formacie RRGGBB[AA]. Na przykład:

  • FF0000 = czerwony
  • 00FF00 = zielony
  • 0000FF = niebieski
  • 000000 = czarny
  • FFFFFF = biały

AA to opcjonalna wartość przezroczystości, gdzie 00 jest całkowicie przezroczysta, a FF – całkowicie nieprzezroczysta. Na przykład:

  • 0000FFFF = świeci na niebiesko
  • 0000FF66 = przezroczysty niebieski

Powrót do góry