Pemberitahuan Pengganti: Diagram peta ini telah diganti dengan versi yang lebih baru.

Halaman ini menjelaskan cara membuat peta berwarna menggunakan Chart API.

Daftar Isi

Ringkasan

Anda dapat membuat peta dengan berbagai negara atau negara bagian yang ditandai dengan warna khusus. Untuk menetapkan peta, Anda akan menentukan wilayah dunia yang akan diperbesar petanya. Anda juga akan menentukan daftar wilayah yang harus diberi warna pada peta, dan daftar data paralel yang menetapkan nilai numerik untuk setiap negara yang terkait. Setiap negara diwarnai di sepanjang gradien, sesuai dengan nilai yang ditetapkan pada negara tersebut. Secara opsional, Anda dapat menentukan gradasi warna kustom untuk nilai data.

Diagram peta mendukung parameter berikut:

Parameter	Wajib atau Opsional	Deskripsi
cht=t	Wajib	Menentukan diagram peta.
chs	Wajib	Ukuran peta. Ukuran maksimum peta adalah 440x220.
chtm=<zoom_area>	Wajib	Area geografis yang ditampilkan dalam diagram. zoom_area - Salah satu nilai berikut africa asia europe middle_east south_america usa world
chld=<country_or_state_codes>	Wajib	Daftar negara tempat Anda menerapkan nilai. Kode negara_atau_negara - Ini adalah rangkaian kode yang terdiri dari dua karakter, tanpa pembatas di antaranya. Gunakan salah satu jenis berikut (Anda tidak dapat menggabungkan jenis): Kode ISO 3166-1-alpha-2 untuk negara, atau Kode negara bagian Amerika Serikat Contoh: chld=DZEGMG
chd=<country_values>	Wajib	Daftar nilai yang sejajar dengan daftar wilayah, tempat nilai berlaku untuk wilayah yang sesuai. Nilainya adalah nilai data berformat standar. Setiap wilayah akan diberi warna di sepanjang skala yang ditentukan dalam chco, di mana nilai terendah dalam rentang diaplikasikan untuk warna terendah, dan nilai tertinggi dalam rentang tersebut diterapkan untuk warna terakhir. country_values - Daftar dalam string format yang sesuai. Contoh: t:10,20,30, s:aU2Ff, dan e:BaPoqM-A.
chco=<default_color>,<start_of_gradient>,...,<end_of_gradient>	Opsional	Rentang warna yang sesuai dengan nilai data rendah dan tinggi untuk rentang format data. Nilai data dikonversi menjadi nilai warna di sepanjang gradien ini, dan diterapkan ke negara yang sesuai. default_color - [Opsional] Warna region yang datanya tidak ditetapkan. Defaultnya adalah BEBEBE (abu-abu sedang). Angka heksadesimal format RRGGBB. start_of_gradient - [Opsional] Warna yang sesuai dengan nilai minimum dalam rentang format data. Nilai defaultnya adalah 0000FF (biru). Angka heksadesimal format RRGGBB. ... - [Opsional] Anda dapat memiliki warna perantara sebanyak yang diinginkan. end_of_gradient - [Opsional] Warna yang sesuai dengan nilai maksimum dalam rentang format data. Defaultnya adalah FF0000 (merah). Angka heksadesimal format RRGGBB
chtt, chts	Opsional	Judul dan gaya diagram
chma	Opsional	Margin diagram
chf=bg	Opsional	Isian padat (khusus latar belakang)

 

Contoh

Deskripsi	Contoh
Dalam contoh ini: Area zoom diagram adalah Afrika (chtm=africa). Ketiga negara akan ditetapkan nilai: Aljazair, Mesir, dan Madagaskar (chld=DZEGMG) Tiga nilai yang ditetapkan ke negara tersebut masing-masing adalah 0, 100, dan 50 (chd=t:0,100,50), yang merupakan nilai minimum, maksimum, dan nilai tengah untuk data format teks. Rentang warna adalah merah untuk 0, hijau untuk 100, dan putih untuk negara yang belum ditetapkan (chco=FFFFFF,FF0000,00FF00). Diagram juga memiliki isian latar belakang berwarna biru muda (chf=bg,s,EAF7FE).	cht=t chtm=africa chld=DZEGMG chd=t:0,100,50 chco=FFFFFF,FF0000,00FF00 chf=bg,s,EAF7FE
Diagram ini mirip dengan yang sebelumnya, tetapi dengan detail yang lebih lengkap.	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
Diagram ini menetapkan bahwa tidak ada negara yang ditandai dengan menentukan satu nilai yang tidak ditentukan (chd=t:-1).	chs=440x220 chd=t:-1 cht=t chtm=world

Kembali ke atas

Kode Negara Bagian Amerika Serikat

Berikut adalah kode negara bagian yang didukung saat peta diperbesar ke Amerika Serikat (chld=usa).

AL	Alabama	LA	Louisiana	OH	Ohio
AK	Alaska	ME	Maine	Oke	Oklahoma
AZ	Arizona	MD	Maryland	ATAU	Oregon
AR	Arkansas	MA	Massachusetts	PA	Pennsylvania
CA	California	MI	Michigan	RI	Rhode Island
CO	Colorado	MN	Minnesota	SC	South Carolina
CT	Connecticut	MS	Mississippi	SD	South Dakota
DE	Delaware	MO	Missouri	TN	Tennessee
FL	Florida	MT	Montana	TX	Texas
GA	Georgia	TL	Nebraska	UT	Utah
HI	Hawaii	NV	Nevada	VT	Vermont
ID	Idaho	NH	New Hampshire	VA	Virginia
IL	Illinois	NJ	New Jersey	WA	Washington
India	Indiana	NM	New Mexico	WV	West Virginia
AI	Iowa	NY	New York	WI	Wisconsin
KS	Kansas	NC	North Carolina	K	Wyoming
KY	Kentucky	ND	North Dakota

Kembali ke atas

Fitur Standar

Fitur lainnya di halaman ini adalah fitur bagan standar.

Judul Diagram chtt, chts [Semua diagram]

Anda dapat menentukan teks judul, warna, dan ukuran font untuk diagram.

Sintaksis

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

 

chtt - Menentukan judul diagram.

<chart_title>

Judul yang akan ditampilkan untuk diagram. Anda tidak dapat menentukan tempat munculnya, tetapi Anda dapat menentukan ukuran dan warna font secara opsional. Gunakan tanda + untuk menunjukkan spasi, dan karakter pipa ( | ) untuk menunjukkan pemisah baris.

 

chts [Opsional] - Warna dan ukuran font untuk parameter chtt.

<color>

Warna judul, dalam format heksadesimal RRGGBB. Warna defaultnya adalah hitam.

<font_size>

Ukuran font judul, dalam poin.

<opt_alignment>

[Opsional] Perataan judul. Pilih salah satu nilai string yang peka huruf besar/kecil berikut: "l" (kiri), "c" (tengah), "r" (kanan). Nilai defaultnya adalah "c".

 

Contoh

Deskripsi	Contoh
Diagram dengan judul, menggunakan warna dan ukuran font default. Tentukan ruang dengan tanda plus (+). Gunakan karakter pipa (|) untuk memaksa pemisah baris. chts tidak ditentukan di sini.	chtt=Site+visitors+by+month| January+to+July
Diagram dengan judul 20 titik berwarna biru, rata kanan.	chtt=Site+visitors chts=FF0000,20,r

Kembali ke atas

Margin Diagram chma [Semua diagram]

Anda dapat menentukan ukuran margin diagram, dalam piksel. Margin dihitung ke dalam dari ukuran diagram yang ditentukan (chs); menambah ukuran margin tidak akan meningkatkan total ukuran diagram, tetapi akan memperkecil tampilan area diagram, jika perlu.

Secara default, margin yang tersisa setelah ukuran diagram dihitung. Nilai default ini bervariasi menurut jenis diagram. Margin yang Anda tentukan adalah nilai minimum; jika area diagram menyisakan ruang untuk margin, ukuran marginnya adalah apa pun yang tersisa; Anda tidak dapat menekan margin yang lebih kecil dari yang diperlukan untuk legenda dan label. Berikut adalah diagram yang menunjukkan bagian-bagian dasar diagram:

Margin diagram berisi label sumbu dan area legend. Area legenda diubah ukurannya secara otomatis agar sesuai dengan teks dengan tepat, kecuali jika Anda menentukan lebar yang lebih besar menggunakan chma. Dengan begitu, ukuran margin akan diperluas lebih lebar sehingga area diagram akan menjadi lebih kecil. Anda tidak dapat memangkas legenda dengan menentukan ukuran yang terlalu kecil, tetapi Anda dapat membuatnya menggunakan lebih banyak ruang daripada yang dibutuhkan. Tips: Dalam diagram batang, jika batang memiliki ukuran tetap (default), lebar area diagram tidak dapat dikurangi. Anda harus menentukan ukuran batang yang lebih kecil atau dapat diubah menggunakan chbh.

 

Sintaksis

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

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

Ukuran margin minimum di sekeliling area diagram, dalam piksel. Tingkatkan nilai ini untuk menyertakan padding tertentu guna mencegah label sumbu tumpang-tindih dengan batas diagram.

<opt_legend_width>, <opt_legend_height>

[Opsional] Lebar margin di sekitar legenda, dalam piksel. Gunakan metode ini agar legenda tidak tumpang tindih dengan area diagram atau tepi gambar.

 

Contoh

Deskripsi	Contoh
Dalam contoh ini, diagram memiliki margin minimum 30 piksel di setiap sisi. Karena lebar legenda diagram lebih dari 30 piksel, margin di sisi kanan disetel sesuai lebar legenda diagram, dan berbeda dari margin lainnya. Label sumbu berada di luar area plot, sehingga ditempatkan di dalam ruang margin.	chma=30,30,30,30
Untuk menambahkan margin di sekitar legenda, tetapkan nilai untuk parameter <opt_legend_width> dan <opt_legend_height>. Dalam contoh ini, lebar legenda adalah sekitar 60 piksel. Jika Anda menetapkan <opt_legend_width> ke 80 piksel, margin akan diperluas hingga 20 piksel di luar legenda.	chma=20,20,20,30|80,20

Kembali ke atas

Pengisian Latar Belakang chf [Semua diagram]

Anda dapat menentukan warna dan gaya isian untuk area data diagram dan/atau seluruh latar belakang diagram. Jenis isian meliputi isian solid, isian bergaris, dan gradien. Anda dapat menentukan isian yang berbeda untuk area yang berbeda (misalnya, seluruh area diagram, atau hanya area data). Isi area diagram akan menimpa isian latar belakang. Semua isian ditentukan menggunakan parameter chf, dan Anda dapat menggabungkan berbagai jenis isian (solid, garis, gradien) dalam diagram yang sama dengan memisahkan nilai menggunakan karakter pipa ( | ). Area diagram mengisi menimpa isian latar belakang diagram.

Solid Fills chf [Semua Diagram]

Anda dapat menentukan isian solid untuk latar belakang dan/atau area diagram, atau menetapkan nilai transparansi ke seluruh diagram. Anda dapat menentukan beberapa isian menggunakan karakter pipa (|). (Maps: hanya latar belakang).

Sintaksis

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

<fill_type>

Bagian diagram yang diisi. Tentukan salah satu nilai berikut:

• bg - Isi latar belakang
• c - Isi area diagram. Tidak didukung untuk diagram peta.
• a - Membuat seluruh diagram (termasuk latar belakang) transparan. Enam digit pertama <color> diabaikan, dan hanya dua digit terakhir (nilai transparansi) yang diterapkan ke seluruh diagram dan semua isian.
• b<index> - Isian padat batang (hanya diagram batang). Ganti <index> dengan indeks deret batang untuk diisi dengan warna solid. Efeknya mirip dengan menentukan chco pada diagram batang. Lihat Warna Seri Diagram Batang untuk mengetahui contohnya.

d

Menunjukkan isian solid atau transparansi.

<color>

Warna pengisi, dalam format heksadesimal RRGGBB. Untuk transparansi, enam digit pertama diabaikan, tetapi tetap harus disertakan.

 

Contoh

Deskripsi	Contoh
Contoh ini mengisi latar belakang diagram dengan abu-abu pucat (EFEFEF).	chf=bg,s,EFEFEF
Contoh ini mengisi latar belakang diagram dengan abu-abu pucat (EFEFEF) dan mengisi area diagram dengan warna hitam (000000).	chf=c,s,000000| bg,s,EFEFEF
Contoh ini menerapkan transparansi 50% ke seluruh diagram (80 dalam heksadesimal adalah 128, atau sekitar 50% transparansi). Perhatikan latar belakang sel tabel yang ditampilkan di diagram.	chf=a,s,00000080

Kembali ke atas

Kembali ke atas