แผนภูมิแผนที่

หน้านี้จะอธิบายวิธีสร้างแผนที่สีโดยใช้ Charts API แผนภูมินี้เป็นแผนภูมิเวอร์ชันใหม่ที่ปรับปรุงแล้ว ซึ่งรองรับแผนที่ขนาดใหญ่ขึ้นและฟีเจอร์มากกว่าแผนภูมิแผนที่ที่เก่ากว่า (cht=t)

สารบัญ

ฟีเจอร์เฉพาะแผนภูมิ ภาพรวม พารามิเตอร์ที่รองรับ การซูมและการจัดกึ่งกลาง

ฟีเจอร์มาตรฐาน ชื่อแผนภูมิ (chtt, chts) สีแผนภูมิ (chco) ระยะขอบของแผนภูมิ (chma) การเติมพื้นหลัง Solid Fills (chf) คำอธิบายแผนภูมิ (chdl, Chdlp) เครื่องหมายรูปร่าง (chm) ตัวทำเครื่องหมายข้อความและข้อมูล (chm)

ภาพรวม

คุณสร้างแผนที่โดยไฮไลต์ประเทศหรือรัฐต่างๆ ด้วยสีที่กำหนดเองได้ คุณให้แผนที่ซูมไปยังระดับที่เหมาะสมเพื่อแสดงประเทศที่คุณเลือกได้อย่างถูกต้อง หรือจะซูมเข้าหรือออกในระดับที่กำหนดเองก็ได้โดยใช้ค่าละติจูดและลองจิจูด

พารามิเตอร์ที่รองรับ

แผนภูมิแผนที่รองรับพารามิเตอร์ต่อไปนี้

พารามิเตอร์	ต้องระบุหรือไม่บังคับ	คำอธิบาย
cht=map<opt_zoom_and_center>	ต้องระบุ	ระบุแผนภูมิแผนที่ Opt_zoom_and_center - สตริงที่ระบุหรือไม่ก็ได้ที่ช่วยให้คุณสามารถซูมหรือจัดแผนภูมิให้อยู่กึ่งกลางของพื้นที่เฉพาะ ดูรายละเอียด
chs	ต้องระบุ	ขนาดแผนที่ ขนาดสูงสุดของแผนที่คือ 600 พิกเซล สูง 600 พิกเซล หรือรวม 300,000 พิกเซล
chd=  <first_country_value>,  ...,  <last_country_value>	ไม่บังคับ	หากใช้ ค่าข้อมูลจะแสดงสีของประเทศที่เกี่ยวข้องตามการไล่ระดับสีสีที่ระบุโดย chco
chld=  <country_or_region_codes>|...|	ต้องระบุ	รายชื่อประเทศหรือรัฐที่คั่นด้วยอักขระไปป์ซึ่งจะไฮไลต์เป็นสีที่ระบุโดย chco แผนที่จะซูมโดยอัตโนมัติเพื่อรวมทุกประเทศที่ระบุ เว้นแต่คุณจะซูมหรือจัดกึ่งกลางเอง รหัสต้องเป็นตัวพิมพ์ใหญ่ รหัสเหล่านี้เป็นรหัส ISO 3166-1-alpha-2 ซึ่งเป็นตัวอักษรพิมพ์ใหญ่ 2 ตัว โดยจะตามด้วยขีดกลางและตัวระบุตัวที่ 2 สำหรับภูมิภาคหรือเมือง ตัวอย่างเช่น GB (บริเตนใหญ่), GB-LND (ลอนดอน), US-NJ (รัฐนิวเจอร์ซีย์ในสหรัฐอเมริกา)
chco หากไม่ได้ใช้ chd จะเป็นดังนี้ chco=  <unselected_land_color>|  <first_region_color>|    ...|  <last_region_color> หากใช้ chd: chco=  <unselected_land_color>,  <color_range_start>,    ...,  <color_range_end>	ไม่บังคับ	สีแผนภูมิ รูปแบบของสตริงนี้ขึ้นอยู่กับว่าคุณใช้ chd หรือไม่ ในไวยากรณ์ทั้ง 2 รูปแบบ <unselected_land_color> คือสีของภูมิภาคที่ไม่ได้ระบุไว้ใน chld โปรดทราบว่าเส้นแบ่งจะแตกต่างกันสำหรับไวยากรณ์ที่ต่างกัน (เครื่องหมายคอมมาในหนึ่ง และเครื่องหมายขีดคั่นในอีกคำสั่ง) หากไม่ได้ใช้ ระบบจะเติมขอบภูมิภาคแต่จะไม่มีสี chd ใช้แล้ว - สีที่ 2 และสีหลังจากนั้นจะอธิบายช่วงสี คุณต้องมีค่า chd 1 ค่าสำหรับแต่ละประเทศใน chld และประเทศที่เกี่ยวข้องจะใส่สีในช่วงตั้งแต่ <first_region_color> (ค่าช่วงข้อมูลขั้นต่ำ) ถึง <last_region_color> (ค่าช่วงข้อมูลสูงสุด) ดูตัวอย่างในตารางด้านล่าง chd ไม่ได้ใช้ - สีที่ 2 และสีต่อๆ ไปจะใช้กับภูมิภาคที่เกี่ยวข้องใน chld ตามลำดับที่แสดง หากมีจำนวนประเทศมากกว่าสี ระบบจะใช้สีสุดท้ายกับประเทศที่เกินมาทั้งหมดในรายการ
chtt, chts	ไม่บังคับ	ชื่อและรูปแบบของแผนภูมิ
chm	ไม่บังคับ	เครื่องหมายแผนภูมิ
chma	ไม่บังคับ	ระยะขอบของแผนภูมิ
chf=bg...	ไม่บังคับ	การเติมสีแบบทึบ (พื้นหลังเท่านั้น)
chdl	ไม่บังคับ	คำอธิบายแผนภูมิ

 

ตัวอย่าง

คำอธิบาย	ตัวอย่าง
ในตัวอย่างนี้ cht=map:fixed=-60,0,80,-35 - พื้นที่ซูมแผนภูมิคือละติจูด -60 ถึงละติจูด 80, ลองจิจูด 0 ถึงลองจิจูด -35 chld=CA-BC|CN|IT|GR|US-UT - ภูมิภาคที่มีอันดับสูงสุด ได้แก่ บริติชโคลัมเบีย จีน อิตาลี กรีซ และยูทาห์ chm - เครื่องหมายของแผนภูมิสำหรับแฟล็ก chma=0,110,0,0 - เส้นขอบด้านขวาเพิ่มขึ้นเป็น 110 พิกเซลเพื่อให้พอดีกับคำอธิบายอย่างเหมาะสม chtt=Last+Five+Olympic+Hosts - ชื่อแผนภูมิ โดยมีเครื่องหมาย + ใช้เพื่อระบุช่องว่าง	cht=map:fixed=-60,0,80,-35 chs=600x350 chld=CA-BC|CN|IT|GR|US-UT chdl=Vancouver|Beijing|Torino|Athens|Salt+Lake+City chco=B3BCC0|5781AE|FF0000|FFC726|885E80|518274 chtt=Last+Five+Olympic+Hosts chm=f2010+Winter,000000,0,0,10 f2008+Summer,000000,0,1,10 f2008+Winter,000000,0,2,10,1,:-5:10 f2004+Summer,000000,0,3,10 f2004+Summer,000000,0,4,10 chma=0,110,0,0
แผนที่แสดงฝรั่งเศสที่ไฮไลต์ 2 ภูมิภาค ดังนี้ chld=FR-D|FR-B|FR - ระบุ 3 ภูมิภาค ได้แก่ บูร์กอญ (ทางตะวันออก) อากีแตน (ทางตะวันตกเฉียงใต้) และฝรั่งเศส chco=676767|FF4444|44FF44|4444FF - ไม่ได้ระบุพารามิเตอร์ chd ในแผนที่นี้ ดังนั้นค่าสีแต่ละค่าหลังจากค่าแรกจะใช้เพื่อระบุประเทศที่เกี่ยวข้อง สีแดงหมายถึงบูร์กอญ สีเขียวแทนอากีแตน สีน้ำเงินสำหรับฝรั่งเศส คุณจะเห็นว่าสีหลังจากนี้ไม่กลบสีก่อนหน้า	chld=FR-D|FR-B|FR chco=676767|FF4444|44FF44|4444FF
แผนที่นี้สาธิตโดยใช้การไล่ระดับสี chd=t:0,50,100 - พารามิเตอร์ chd บ่งบอกถึงการไล่ระดับสี ในที่นี้มีการระบุการเข้ารหัสข้อความซึ่งมีช่วงตั้งแต่ 0—100 chco=CCCCCC,FF0000,000000 - สีพื้นหลังเป็นสีเทาอ่อน (CCCCCC) และช่วงสีมาจากสีแดง (FF0000) ถึงสีดำ (000000) ประเทศตรงกลางที่แสดงคือสีกลางของการไล่ระดับสีดังกล่าว	chd=t:0,50,100 chco=CCCCCC,FF0000,000000
โปรดทราบว่าแผนที่ครอบตัดภายในขนาดแผนภูมิที่ระบุได้ เนื่องจากเราจะไม่บิดเบือนแผนที่ให้พอดีกับขนาดแผนภูมิที่ระบุ แต่เราจะจำกัดแผนที่ไว้เฉพาะภูมิภาคที่คุณระบุใน chld คุณอาจต้องปรับขนาดแผนที่ด้วยตนเองเพื่อหลีกเลี่ยงพื้นที่ครอบตัดภายในขอบเขตแผนภูมิ	cht=map chs=300x300 chld=GB ประเทศอังกฤษมีความยาวและบางตามธรรมชาติ ดังนั้นการระบุแผนที่สี่เหลี่ยมจัตุรัสจะรวมถึงพื้นที่ที่ครอบตัดทางด้านขวา cht=map chs=180x300 chld=GB ปรับความกว้างของแผนภูมิเพื่อครอบตัดส่วนเกินออก โปรดสังเกตว่ายังมีการครอบตัดด้านล่างอยู่บ้าง ที่ควรแก้ไขโดยการลดความสูงของแผนที่ cht=map chs=180x300 chld=GB ฝรั่งเศสมีรูปร่างสม่ำเสมอกว่ามาก จึงมีขนาดพอดีกับแผนที่สี่เหลี่ยมจัตุรัสมากขึ้น

กลับไปด้านบน

การซูมและการจัดกึ่งกลาง

โดยค่าเริ่มต้น แผนภูมิจะได้รับการซูมและจัดกึ่งกลางที่กึ่งกลางของภูมิภาคที่คุณเลือก และทําให้พื้นที่ดังกล่าวพอดีกับพื้นที่แสดงผลมากที่สุดเท่าที่จะทำได้ โดยอยู่ภายในขนาดแผนที่ที่กำหนด แต่คุณปรับแต่งระดับการจัดกึ่งกลางและการซูมของแผนภูมิได้ 2 วิธี ดังนี้

ตามพิกเซล

หากต้องการปรับเส้นขอบตามขนาดพิกเซล ให้ใช้รูปแบบนี้

cht=map:auto=<left_border>,<right_border>,<top_border>,<bottom_border>

เมื่อขนาดเส้นขอบแต่ละขนาดคือเส้นขอบเพิ่มเติมที่จะแสดง หน่วยเป็นพิกเซลนอกเหนือจากระดับการซูมที่คำนวณโดยอัตโนมัติ

คุณซูมออกได้ (ค่าบวก) เท่านั้น และซูมเข้า (ค่าลบ) ใกล้ระดับการซูมเริ่มต้นโดยใช้การซูมแบบพิกเซลไม่ได้

ตัวอย่างเช่น

ตัวอย่างเหล่านี้ทั้งหมดแสดงลอนดอน (Lat

ไม่ซูม (ค่าเริ่มต้น)	ซูมออก 30 พิกเซลต่อด้าน	ซูมออกและลงไปทางขวา
cht=map	cht=map:auto=30,30,30,30	cht=map:auto=50,0,80,0

 

ตามละติจูดและลองจิจูด

คุณระบุเส้นขอบด้านบน ด้านล่าง ด้านซ้าย และด้านขวาที่แน่นอนของแผนที่ที่แสดงผลได้โดยใช้ละติจูดและลองจิจูดโดยใช้ไวยากรณ์ที่แสดงไว้ที่นี่

cht=map:fixed=<bottom_border_lat>,<left_border_long>,<top_border_lat>,<right_border_long>

โดยที่ <bottom_border_lat> และ <top_border_lat> ระบุละติจูดของ เส้นขอบด้านล่างและด้านบน และ <left_border_long> และ <right_border_long> ระบุลองจิจูดของเส้นขอบด้านซ้ายและขวา

หมายเหตุ: เนื่องจากการบิดเบี้ยวของเส้นโครง Mercator (โดยพื้นฐานแล้ว การฉายแผนที่แบบโค้งบนภาพแบน) การโฟกัสที่แถบสูงและแคบจึงอาจทำให้ขนาดแผนที่ของคุณแตกต่างอย่างไม่คาดคิด

ตัวอย่างเช่น

ตัวอย่างต่อไปนี้แสดงลอนดอน (ไฮไลต์เป็นสีน้ำเงิน) ซึ่งมีลองจิจูด 0.1° และละติจูด 51.5° โปรดสังเกตว่ามีการครอบตัดแผนที่อย่างไร เนื่องจากแผนที่พยายามแสดงเฉพาะบริเตนใหญ่ (ตามที่ระบุไว้) และเติมเต็มแผนภูมิที่ระบุโดยไม่ทำให้บิดเบี้ยว

มีสมาธิ	ละติจูดขยับ +10*	ซูมโดยการลดค่าทั้งหมด
cht=map:fixed=40,-10,60,10	cht=map:fixed=50,-10,70,10	cht=map:fixed=48,-3,54,3

อย่าลืมว่าขนาดของรูปภาพตรงกลางเล็กกว่ารูปภาพแรกเล็กน้อย แม้ว่าเราจะเลื่อนจำนวนองศาขึ้นให้เท่ากันก็ตาม เนื่องจากเรากำลังฉายภาพทรงกลม 3 มิติไปยังภาพ 2 มิติ คุณจะต้องเพิ่มความกว้างของแผนภูมิที่ 2 เพื่อให้มีขนาดเดียวกับแผนภูมิแรก

กลับไปด้านบน

ฟีเจอร์มาตรฐาน

ฟีเจอร์ที่เหลือในหน้านี้เป็นฟีเจอร์แผนภูมิมาตรฐาน

ชื่อแผนภูมิ chtt, chts [แผนภูมิทั้งหมด]

คุณสามารถระบุข้อความชื่อ สี และขนาดแบบอักษรให้กับแผนภูมิได้

ไวยากรณ์

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

 

chtt - ระบุชื่อแผนภูมิ

<chart_title>

ชื่อที่จะแสดงสำหรับแผนภูมิ คุณระบุตำแหน่งที่จะปรากฏไม่ได้ แต่คุณเลือกที่จะระบุขนาดและสีของแบบอักษรได้ ใช้เครื่องหมาย + เพื่อระบุช่องว่าง และอักขระไปป์ ( | ) เพื่อระบุการขึ้นบรรทัดใหม่

 

chts [ไม่บังคับ] - สีและขนาดแบบอักษรสำหรับพารามิเตอร์ chtt

<color>

สีของชื่อในรูปแบบเลขฐานสิบหก RRGGBB สีเริ่มต้นคือสีดำ

<font_size>

ขนาดแบบอักษรของชื่อในหน่วยจุด

<opt_alignment>

[ไม่บังคับ] การจัดตำแหน่งชื่อ เลือกค่าสตริงที่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ต่อไปนี้ "l" (ซ้าย), "c" (กึ่งกลาง) "r" (ขวา) ค่าเริ่มต้นคือ "c"

 

ตัวอย่าง

คำอธิบาย	ตัวอย่าง
แผนภูมิที่มีชื่อ โดยใช้สีและขนาดแบบอักษรเริ่มต้น ระบุเว้นวรรคด้วยเครื่องหมายบวก (+) ใช้อักขระไปป์ (|) เพื่อบังคับการขึ้นบรรทัดใหม่ ไม่ได้ระบุ chts ที่นี่	chtt=Site+visitors+by+month| January+to+July
แผนภูมิที่มีชื่อ 20 จุดสีน้ำเงิน จัดชิดขวา	chtt=Site+visitors chts=FF0000,20,r

กลับไปด้านบน

อัตรากำไรของแผนภูมิ chma [แผนภูมิทั้งหมด]

คุณระบุขนาดระยะขอบของแผนภูมิในหน่วยพิกเซลได้ ระบบจะคำนวณขอบด้านเข้าจากขนาดแผนภูมิที่ระบุ (chs) การเพิ่มขนาดของขอบจะไม่เพิ่มขนาดแผนภูมิทั้งหมด แต่จะลดขนาดพื้นที่ในแผนภูมิหากจำเป็น

โดยค่าเริ่มต้น ระยะขอบจะเป็นจำนวนที่เหลืออยู่หลังจากคำนวณขนาดของแผนภูมิ ค่าเริ่มต้นนี้จะแตกต่างกันไปตามประเภทของแผนภูมิ ระยะขอบที่ระบุเป็นค่าขั้นต่ำ หากพื้นที่ในแผนภูมิยังมีที่ว่างสำหรับระยะขอบ ขนาดของขอบจะเป็นเท่าใดก็ได้ที่เหลืออยู่ และคุณจะบีบระยะขอบให้น้อยกว่าที่ต้องการสำหรับคำอธิบายและป้ายกำกับไม่ได้ นี่คือแผนภาพที่แสดงส่วนพื้นฐานของแผนภูมิ

ระยะขอบของแผนภูมิประกอบด้วยป้ายกำกับแกน และพื้นที่คำอธิบาย พื้นที่คำอธิบายจะปรับขนาดโดยอัตโนมัติให้พอดีกับข้อความทั้งหมด เว้นแต่คุณจะระบุความกว้างมากขึ้นโดยใช้ chma ซึ่งในกรณีนี้ พื้นที่ของคำอธิบายจะขยายขนาดขอบให้กว้างขึ้น โดยการบีบพื้นที่ของแผนภูมิให้เล็กลง คุณครอบตัดคำอธิบายโดยระบุขนาดที่เล็กเกินไปไม่ได้ แต่สามารถใช้พื้นที่มากกว่าที่ต้องการ เคล็ดลับ: ในแผนภูมิแท่ง หากแท่งมีขนาดคงที่ (ค่าเริ่มต้น) คุณจะลดความกว้างของพื้นที่แผนภูมิไม่ได้ คุณต้องระบุขนาดแท่งที่เล็กลงหรือปรับขนาดได้โดยใช้ chbh

 

ไวยากรณ์

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

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

ขนาดระยะขอบขั้นต่ำรอบพื้นที่แผนภูมิ หน่วยเป็นพิกเซล เพิ่มค่านี้ให้รวมระยะห่างจากขอบบางส่วนเพื่อป้องกันไม่ให้ป้ายกำกับแกนชนกับเส้นขอบของแผนภูมิ

<opt_legend_width>, <opt_legend_height>

[ไม่บังคับ] ความกว้างของขอบรอบคำอธิบาย หน่วยเป็นพิกเซล ใช้การตั้งค่านี้เพื่อหลีกเลี่ยงไม่ให้คำอธิบายกระแทกกับพื้นที่แผนภูมิหรือขอบ ของรูปภาพ

 

ตัวอย่าง

คำอธิบาย	ตัวอย่าง
ในตัวอย่างนี้ แผนภูมิมีระยะขอบอย่างน้อย 30 พิกเซลในแต่ละด้าน เนื่องจากคำอธิบายแผนภูมิกว้างมากกว่า 30 พิกเซล ระยะขอบด้านขวาจึงตั้งเป็นความกว้างของคำอธิบายแผนภูมิและแตกต่างจากขอบอื่นๆ ป้ายกำกับแกนอยู่นอกพื้นที่พล็อต ดังนั้นจึงวาดอยู่ภายในพื้นที่ขอบ	chma=30,30,30,30
หากต้องการเพิ่มระยะขอบรอบคำอธิบาย ให้ตั้งค่าสำหรับพารามิเตอร์ <opt_legend_width> และ <opt_legend_height> ในตัวอย่างนี้ คำอธิบายจะมีความกว้างประมาณ 60 พิกเซล หากคุณตั้งค่า <opt_legend_width> เป็น 80 พิกเซล ขอบจะขยายเป็น 20 พิกเซลนอกคำอธิบาย	chma=20,20,20,30|80,20

กลับไปด้านบน

การเติมพื้นหลัง chf [แผนภูมิทั้งหมด]

คุณสามารถระบุสีเติมและรูปแบบสำหรับพื้นที่ข้อมูลแผนภูมิและ/หรือพื้นหลังของแผนภูมิทั้งหมด ประเภทการเติมสี ได้แก่ สีทึบ สีเติมลายทาง และการไล่ระดับสี คุณระบุการเติมสีที่แตกต่างกันสำหรับพื้นที่ต่างๆ ได้ (เช่น พื้นที่ทั้งหมดในแผนภูมิ หรือเฉพาะพื้นที่ข้อมูล) การเติมพื้นที่แผนภูมิ จะเขียนทับสีพื้นหลัง การเติมสีทั้งหมดจะระบุโดยใช้พารามิเตอร์ chf และคุณสามารถรวมการเติมสีประเภทต่างๆ (สีทึบ แถบ การไล่ระดับสี) ในแผนภูมิเดียวกันโดยการแยกค่าด้วยอักขระไปป์ ( | ) พื้นที่แผนภูมิจะแสดงแทนที่การเติมพื้นหลังแผนภูมิ

Solid Fill chf [แผนภูมิทั้งหมด]

คุณสามารถระบุการเติมสีทึบสำหรับพื้นที่พื้นหลังและ/หรือแผนภูมิ หรือกำหนดค่าความโปร่งใสให้กับแผนภูมิทั้งหมด คุณสามารถระบุการเติมสีหลายรายการโดยใช้อักขระไปป์ (|) (Maps: พื้นหลังเท่านั้น)

ไวยากรณ์

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

<fill_type>

ส่วนของแผนภูมิที่แสดงข้อมูล โปรดระบุค่าใดค่าหนึ่งต่อไปนี้

• bg - สีพื้นหลัง
• c - การเติมพื้นที่แผนภูมิ ไม่รองรับแผนภูมิแผนที่
• a - ทำให้แผนภูมิทั้งแผนภูมิ (รวมถึงพื้นหลัง) โปร่งใส ระบบจะไม่สนใจตัวเลข 6 หลักแรกของ <color> และจะใช้เฉพาะ 2 หลักสุดท้าย (ค่าความโปร่งใส) กับทั้งแผนภูมิและข้อมูลที่เติมทั้งหมด
• b<index> - การเติมสีแบบแท่ง (เฉพาะแผนภูมิแท่ง) แทนที่ <index> ด้วยดัชนีชุดของแท่งแผนภูมิเพื่อเติมสีทึบ เอฟเฟกต์ดังกล่าวคล้ายกับการระบุ chco ในแผนภูมิแท่ง ดูตัวอย่างได้ที่สีชุดของแผนภูมิแท่ง

s

หมายถึงการเติมพื้นทึบหรือโปร่งใส

<color>

สีเติมในรูปแบบเลขฐานสิบหก RRGGBB สำหรับความโปร่งแสง ระบบจะไม่สนใจตัวเลข 6 หลักแรกแต่ก็ยังต้องมี

 

ตัวอย่าง

คำอธิบาย	ตัวอย่าง
ตัวอย่างนี้เติมพื้นหลังแผนภูมิด้วยสีเทาซีด (EFEFEF)	chf=bg,s,EFEFEF
ตัวอย่างนี้เติมพื้นหลังของแผนภูมิด้วยสีเทาซีด (EFEFEF) และเติมพื้นที่แผนภูมิด้วยสีดำ (000000)	chf=c,s,000000| bg,s,EFEFEF
ตัวอย่างนี้ใช้ความโปร่งใส 50% กับทั้งแผนภูมิ (80 ในเลขฐาน 16 คือ 128 หรือโปร่งใสประมาณ 50%) สังเกตว่าพื้นหลังของเซลล์ตารางปรากฏทั่วทั้งแผนภูมิ	chf=a,s,00000080

กลับไปด้านบน

ข้อความและรูปแบบคำอธิบายแผนภูมิ chdl, chdlp, chdls [แผนภูมิทั้งหมด]

คำอธิบายคือส่วนด้านข้างของแผนภูมิซึ่งมีคำอธิบายข้อความสั้นๆ ของแต่ละชุด คุณระบุข้อความที่เชื่อมโยงกับแต่ละชุดในคำอธิบายนี้ รวมถึงระบุตำแหน่งในแผนภูมิควรปรากฏได้

ดูเพิ่มเติมที่ chma เพื่อดูวิธีตั้งค่าขอบรอบคำอธิบาย

หมายเหตุเกี่ยวกับค่าสตริง: สตริงป้ายกำกับอนุญาตให้ใช้เฉพาะอักขระที่ปลอดภัยสำหรับ URL เท่านั้น เพื่อความปลอดภัย คุณควรเข้ารหัส URL สตริงทั้งหมดที่มีอักขระที่ไม่ได้อยู่ในชุดอักขระ 0-9a-zA-Z โปรดดูโปรแกรมเปลี่ยนไฟล์ URL ในเอกสารประกอบของ Google Visualization

ไวยากรณ์

chdl=<data_series_1_label>|...|<data_series_n_label>
chdlp=<opt_position>|<opt_label_order>
chdls=<color>,<size>

 

chdl - ข้อความของแต่ละชุดที่จะแสดงในคำอธิบาย

<data_series_label>

ข้อความสำหรับรายการคำอธิบาย ป้ายกำกับแต่ละรายการจะมีผลกับชุดที่สอดคล้องกันในอาร์เรย์ chd ใช้เครื่องหมาย + เพื่อเว้นช่องว่าง หากคุณไม่ระบุพารามิเตอร์นี้ แผนภูมิจะไม่มีคำอธิบาย คุณจะระบุการขึ้นบรรทัดใหม่ในป้ายกำกับไม่ได้ โดยทั่วไปคำอธิบายจะขยายออกเพื่อใส่ข้อความคำอธิบาย และพื้นที่แผนภูมิจะลดขนาดลงเพื่อรองรับคำอธิบาย

chdlp - [ไม่บังคับ] ตำแหน่งของคำอธิบายและลำดับของรายการคำอธิบาย คุณระบุ <position> และ/หรือ <label_order> ได้ หากระบุทั้ง 2 อย่าง ให้คั่นแต่ละรายการด้วยอักขระแท่ง คุณจะเพิ่ม "s" ลงในค่าใดก็ได้หากต้องการให้ระบบข้ามรายการคำอธิบายที่ว่างเปล่าใน chdl ในคำอธิบาย เช่น chdlp=bv, chdlp=r, chdlp=bv|r, chdlp=bvs|r

<opt_position>

[ไม่บังคับ] ระบุตำแหน่งของคำอธิบายในแผนภูมิ หากต้องการระบุระยะห่างจากขอบเพิ่มเติมระหว่างคำอธิบายและพื้นที่ของแผนภูมิหรือเส้นขอบรูปภาพ ให้ใช้พารามิเตอร์ chma เลือกค่าใดค่าหนึ่งต่อไปนี้

• b - คำอธิบายที่ด้านล่างของแผนภูมิ รายการคำอธิบายในแถวแนวนอน
• bv - คำอธิบายที่ด้านล่างของแผนภูมิ รายการคำอธิบายในคอลัมน์แนวตั้ง
• t - คำอธิบายที่ด้านบนของแผนภูมิ รายการคำอธิบายในแถวแนวนอน
• tv - คำอธิบายที่ด้านบนของแผนภูมิ รายการคำอธิบายในคอลัมน์แนวตั้ง
• r - [ค่าเริ่มต้น] คำอธิบายทางด้านขวาของแผนภูมิ รายการคำอธิบายในคอลัมน์แนวตั้ง
• l - คำอธิบายทางด้านซ้ายของแผนภูมิ รายการคำอธิบายในคอลัมน์แนวตั้ง

<opt_label_order>

[ไม่บังคับ] ลำดับการแสดงป้ายกำกับในคำอธิบาย เลือกค่าใดค่าหนึ่งต่อไปนี้

• l - [ค่าเริ่มต้นสำหรับคำอธิบายแนวตั้ง] แสดงป้ายกำกับตามลำดับที่กำหนดให้กับ chdl
• r - แสดงป้ายกำกับในลำดับย้อนกลับตามที่ให้กับ chdl ซึ่งจะเป็นประโยชน์ในแผนภูมิแท่งแบบซ้อนเพื่อแสดงคำอธิบาย
  ในลำดับเดียวกันกับที่แถบปรากฏขึ้น
• a - [ค่าเริ่มต้นสำหรับคำอธิบายแนวนอน] การเรียงลำดับอัตโนมัติ: หมายถึงการจัดเรียงตามความยาวโดยสั้นที่สุดก่อนตามที่วัดเป็นบล็อก 10 พิกเซล เมื่อองค์ประกอบ 2 รายการมีความยาวเท่ากัน (แบ่งออกเป็นบล็อก 10 พิกเซล) องค์ประกอบที่แสดงในรายการแรกจะปรากฏขึ้นก่อน
• 0,1,2... - ลำดับป้ายกำกับที่กำหนดเอง นี่คือรายการดัชนีป้ายกำกับแบบฐาน 0 จาก chdl โดยคั่นด้วยคอมมา

chdls - [ไม่บังคับ] ระบุสีและขนาดแบบอักษรของข้อความคำอธิบาย

<color>

สีข้อความของคำอธิบายในรูปแบบเลขฐานสิบหก RRGGBB

<size>

ขนาดจุดของข้อความคำอธิบาย

 

ตัวอย่าง

คำอธิบาย	ตัวอย่าง
ตัวอย่าง 2 ตัวอย่าง ระบุข้อความคำอธิบายในลำดับเดียวกันกับชุดข้อมูล	chdl=NASDAQ|FTSE100|DOW chco=FF0000,00FF00,0000FF chdl=First|Second|Third chco=ff0000,00ff00,0000ff
แผนภูมิแรกแสดงรายการคำอธิบายแนวนอน (chdlp=t เลย์เอาต์เริ่มต้นคือแนวนอน) และแผนภูมิที่ 2 แสดงรายการคำอธิบายแนวตั้งด้านล่าง (chdlp=bv)	chdl=First|Second|Third chco=ff0000,00ff00,0000ff chdlp=t chdl=First|Second|Third chco=ff0000,00ff00,0000ff chdlp=bv
ตัวอย่างนี้แสดงการเปลี่ยนขนาดแบบอักษร	chdls=0000CC,14

กลับไปด้านบน

เครื่องหมายรูปร่าง chm [บาร์ เส้น เรดาร์ กระจาย]

คุณระบุเครื่องหมายกราฟิกสำหรับจุดข้อมูลทั้งหมดหรือแต่ละจุดในแผนภูมิได้ หากตัวทำเครื่องหมายอย่างน้อย 2 ตัวอยู่ในจุดเดียวกัน ระบบจะวาดตัวทำเครื่องหมายตามลำดับที่ปรากฏในพารามิเตอร์ chm นอกจากนี้ คุณยังสร้างตัวทำเครื่องหมายข้อความบนจุดข้อมูลได้ ซึ่งครอบคลุมอยู่ในเครื่องหมายจุดข้อมูล

คุณรวมตัวทำเครื่องหมายรูปร่างกับพารามิเตอร์ chm อื่นๆ ได้โดยใช้อักขระไปป์ ( | ) เพื่อแยกพารามิเตอร์ chm

ไวยากรณ์

ระบุชุดพารามิเตอร์ต่อไปนี้ 1 ชุดสำหรับแต่ละชุดควรทำเครื่องหมายไว้ หากต้องการทำเครื่องหมายหลายชุด ให้สร้างชุดพารามิเตอร์เพิ่มเติมโดยคั่นด้วยอักขระไปป์ คุณไม่จำเป็นต้องมาร์กอัปทุกชุด หากคุณไม่ได้กำหนดตัวทำเครื่องหมายให้กับชุดข้อมูล จะไม่มีเครื่องหมายเลย

เครื่องหมายรูปร่างจะทำงานแตกต่างออกไปเล็กน้อยในแผนภูมิกระจาย ดูข้อมูลเพิ่มเติมในเอกสารประกอบดังกล่าว

chm=
  [@]<marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_offset>
    |...|
  [@]<marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_offset>

@

[ไม่บังคับ] หากคุณใส่อักขระ @ ไว้หน้าประเภทเครื่องหมาย <opt_selected_points> ควรใช้รูปแบบ x:y

<marker_type>

ประเภทของเครื่องหมายที่จะใช้ โปรดระบุประเภทใดประเภทหนึ่งต่อไปนี้

• a - ลูกศร
• c - กากบาท
• C - สี่เหลี่ยมผืนผ้า หากเป็นเครื่องหมายรูปสี่เหลี่ยมผืนผ้า คุณต้องมีชุดข้อมูลอย่างน้อย 2 ชุด โดยชุด 0 ระบุขอบด้านล่างและชุดที่ 1 ระบุขอบด้านบน <size> ระบุความกว้างของสี่เหลี่ยมผืนผ้าเป็นพิกเซล
• d - ไดมอนด์
• E - ตัวทำเครื่องหมายแถบข้อผิดพลาด ( ) เครื่องหมายนี้ต้องใช้ชุดข้อมูล 2 ชุดในการสร้าง ค่าหนึ่งสำหรับด้านล่าง และจุดที่สอดคล้องกันในชุดที่ 2 สำหรับด้านบน นอกจากนี้ยังแสดง ไวยากรณ์ <size> แบบขยายด้วย: line_thickness[:top_and_bottom_width] โดยที่เลือก top_and_bottom_width หรือไม่ก็ได้ โปรดดูตัวอย่างด้านล่าง
• h - เส้นแนวนอนตลอดแผนภูมิที่ความสูงที่ระบุ (รูปแบบเดียวที่ใช้ได้สําหรับพารามิเตอร์ <opt_which_points> คือ n.d)
• H - เส้นแนวนอนผ่านเครื่องหมายข้อมูลที่ระบุ ซึ่งรองรับไวยากรณ์ <size> แบบขยายซึ่งให้คุณระบุความยาวบรรทัดที่แน่นอนได้ ดังนี้ line_thickness[:length] โดยที่ :length ไม่บังคับ และมีค่าเริ่มต้นเป็นความกว้างของพื้นที่เต็มในแผนภูมิ
• o - วงกลม
• s - สี่เหลี่ยมจัตุรัส
• v - เส้นแนวตั้งจากแกน x ไปยังจุดข้อมูล
• V - เส้นแนวตั้งที่มีความยาวที่ปรับได้ ซึ่งรองรับไวยากรณ์ค่า <size> แบบขยายซึ่งให้คุณระบุความยาวบรรทัดที่แน่นอนได้ ซึ่งได้แก่ line_thickness[:length] โดยที่ :length จะไม่บังคับ และมีค่าเริ่มต้นเป็นความสูงของพื้นที่แผนภูมิแบบเต็ม เครื่องหมายจะอยู่ตรงกลางของจุดข้อมูล
• x - X

<color>

สีของเครื่องหมายสําหรับชุดนี้ ในรูปแบบเลขฐานสิบหก RRGGBB

<series_index>

ดัชนีฐาน 0 ของชุดข้อมูลที่ใช้วาดเครื่องหมาย ละเว้นสำหรับตัวทำเครื่องหมาย h และตัวทำเครื่องหมายที่ระบุตำแหน่งโดยตำแหน่ง x/y (ขึ้นต้นด้วยอักขระ @) คุณสามารถใช้ชุดข้อมูลที่ซ่อนอยู่เป็นแหล่งที่มาของเครื่องหมายได้ โปรดดูแผนภูมิผสมสำหรับข้อมูลเพิ่มเติม แผนภูมิแท่งแนวตั้งที่จัดกลุ่มรองรับไวยากรณ์แบบขยายพิเศษเพื่อจัดตัวทำเครื่องหมายให้สอดคล้องกับแท่งแผนภูมิที่เฉพาะเจาะจง

<opt_which_points>

[ไม่บังคับ] จุดที่ใช้วาดเครื่องหมาย ค่าเริ่มต้นคือเครื่องหมายทั้งหมด โปรดใช้ค่าใดค่าหนึ่งต่อไปนี้

• n.d - ตำแหน่งที่ใช้ในการวาดเครื่องหมาย ความหมายจะขึ้นอยู่กับประเภทเครื่องหมายดังนี้
  • ทุกประเภทยกเว้น h - จุดข้อมูลที่จะวาดเครื่องหมายไว้ โดยที่ n.d คือดัชนีฐาน 0 ในชุด หากระบุค่าที่ไม่ใช่จำนวนเต็ม เศษส่วนจะระบุจุดกลางที่คำนวณแล้ว เช่น 3.5 หมายถึงจุดกึ่งกลางระหว่างจุด 3 กับจุด 4
  • h - ตัวเลขตั้งแต่ 0.0 ถึง 1.0 โดย 0.0 คือด้านล่างของแผนภูมิ และ 1.0 คือด้านบนสุดของแผนภูมิ
• -1 - วาดเครื่องหมายบนจุดข้อมูลทั้งหมด นอกจากนี้ คุณยังปล่อยพารามิเตอร์นี้ว่างไว้เพื่อให้แสดงในจุดข้อมูลทั้งหมดได้
• -n - วาดเครื่องหมายบนจุดข้อมูลที่ n ทุกจุด ค่าคะแนนลอย ถ้า n น้อยกว่า 1 แผนภูมิจะคำนวณจุดกลางเพิ่มเติมให้คุณ เช่น -0.5 จะทำให้มีเครื่องหมายมากกว่าจุดข้อมูล 2 เท่า
• start:end:n - วาดเครื่องหมายบนจุดข้อมูลที่ n ทุกจุดในช่วง ตั้งแต่ค่าดัชนี start ถึง end พารามิเตอร์ทั้งหมดไม่บังคับ (อาจไม่มี) ดังนั้น 3::1 จะมาจากองค์ประกอบที่ 4 ถึงสุดท้าย ขั้นตอนที่ 1 และการละเว้นพารามิเตอร์นี้ทั้งหมดจะมีค่าเริ่มต้นเป็น first:last:1 ค่าทั้งหมดเป็นจำนวนทศนิยมได้ โดย start และ end อาจเป็นค่าลบได้ เพื่อนับย้อนจากค่าล่าสุด หากทั้ง start และ end เป็นค่าลบ โปรดตรวจสอบว่ามีการระบุไว้ในค่าที่เพิ่มขึ้น (เช่น -6:-1:1) หากค่าขั้นตอน n น้อยกว่า 1 ระบบจะคำนวณจุดข้อมูลเพิ่มเติมโดยการประมาณค่าข้อมูลที่ระบุ ค่าเริ่มต้นคือ first:last:1
• x:y - วาดเครื่องหมายที่จุด x/y ที่เฉพาะเจาะจงบนแผนภูมิ จุดนี้ไม่จำเป็นต้องอยู่บนเส้นทาง เพิ่มอักขระ @ ก่อนประเภทเครื่องหมายเพื่อใช้ตัวเลือกนี้ ระบุพิกัดเป็นค่าทศนิยม โดย 0:0 จะอยู่มุมซ้ายล่างของแผนภูมิ และ 1:1 เป็นมุมบนขวาของแผนภูมิ เช่น หากต้องการเพิ่มเพชรสีแดงขนาด 15 พิกเซลตรงกลางแผนภูมิ ให้ใช้ @d,FF0000,0,0.5:0.5,15

<size>

ขนาดของเครื่องหมายในหน่วยพิกเซล ส่วนใหญ่จะใช้ค่าตัวเลขเดียวสำหรับพารามิเตอร์นี้ เครื่องหมาย V, H และ S รองรับไวยากรณ์ <size>[:width] โดยส่วนที่สองที่ไม่บังคับระบุความยาวของเส้นหรือเครื่องหมาย

<opt_z_order>

[ไม่บังคับ] เลเยอร์ที่จะวาดเครื่องหมายเทียบกับเครื่องหมายอื่นๆ และองค์ประกอบแผนภูมิอื่นๆ ทั้งหมด นี่คือจำนวนลอยตัวตั้งแต่ -1.0 ถึง 1.0 โดย -1.0 คือด้านล่างและ 1.0 คือบนสุด องค์ประกอบของแผนภูมิ (เส้นและแท่ง) จะมีค่าต่ำกว่า 0 หากเครื่องหมาย 2 ตัวมีค่าเหมือนกัน ระบบจะวาดตามลำดับที่ URL ให้ไว้ ค่าเริ่มต้นคือ 0.0 (เหนือองค์ประกอบแผนภูมิ)

<opt_offset>

[ไม่บังคับ] ให้คุณระบุออฟเซ็ตแนวนอนและแนวตั้งจากตำแหน่งที่ระบุ ต่อไปนี้เป็นไวยากรณ์ที่ใช้ตัวคั่น : reserved:<horizontal_offset>:<vertical_offset> หากระบุไว้ คุณจะใส่ค่า ,, ว่าง ในสตริงพารามิเตอร์ chm สำหรับ <opt_z_order> ได้ ตัวอย่างเช่น o,FF9900,0,4,12,,:10 o,FF9900,0,4,12.0,,:-10:20 o,FF9900,0,4,12,1,::20

• จองไว้ - เว้นว่างไว้
• <horizontal_offset> - ตัวเลขบวกหรือลบที่ระบุออฟเซ็ตแนวนอน มีหน่วยเป็นพิกเซล (ไม่บังคับ) เว้นว่างไว้หากไม่ได้ใช้
• <vertical_offset> - ตัวเลขบวกหรือลบที่ระบุออฟเซ็ตแนวตั้งเป็นพิกเซล (ไม่บังคับ) เว้นว่างไว้หากไม่ได้ใช้

 

ตัวอย่าง

คำอธิบาย	ตัวอย่าง
นี่คือตัวอย่างของรูปร่างและเครื่องหมายเส้น a,990066,0,0.0,9.0 - ลูกศรสีม่วง, ชุดแรก, จุดแรก, ขนาด 9 c,FF0000,0,1.0,20.0 - กากบาทสีแดง, ชุดที่ 1, คะแนนที่ 2, ขนาด 9 d,80C65A,0,2,20.0 - เพชรสีเขียว, ชุดที่ 1, จุดที่ 3, ขนาด 9 H,000000,0,3,1:40 - เส้นแนวนอนสีดำ ซีรีส์แรก จุดข้อมูล 3 กว้าง 1 พิกเซล ยาว 40 พิกเซล o,FF9900,0,4.0,12.0 - วงกลมสีส้ม, ชุดแรก, จุดที่ 5, ขนาด 12 s,3399CC,0,5.0,11.0 - สี่เหลี่ยมจัตุรัสสีน้ำเงิน, ชุดที่ 1, จุดที่ 6, ขนาด 11 v,BBCCED,0,6.0,1.0 - เส้นแนวตั้งถึงจุด ชุดที่ 1 จุด 7 กว้าง 1 พิกเซล V,3399CC,0,7.0,1.0 - เส้นแนวตั้งจากล่างไปด้านบนของแผนภูมิ ชุดแรก จุด 8 กว้าง 1 พิกเซล x,FFCC33,0,8.0,20.0 - "X" สีเหลือง ชุดแรก จุดที่ 9 ขนาด 20 H,FFFF00,0,9,2 - เส้นสีเหลืองแนวนอนตามความกว้างของแผนภูมิที่จุดข้อมูล 9 h,FF0000,0,0.5,1 - เส้นแนวนอนสีแดงตามความสูงที่กำหนด, ชุดแรก, ครึ่งทางของแผนภูมิ, กว้าง 1 พิกเซล	chm=   a,990066,0,0.0,9.0|   c,FF0000,0,1.0,20|   d,80C65A,0,2.0,20.0|   H,000000,0,3,1:40|   o,FF9900,0,4.0,12.0|   s,3399CC,0,5.0,11.0|   v,BBCCED,0,6,1.0|   V,3399CC,0,7,1.0|   x,FFCC33,0,8,20|   H,FFFF00,0,9,2|   h,FF0000,0,0.5,1
นี่คือตัวอย่างการใช้เพชรสำหรับชุดข้อมูลหนึ่ง และวงกลมสำหรับชุดข้อมูลอื่นๆ หากตัวทำเครื่องหมายตั้งแต่ 2 ตัวขึ้นไปอยู่ในจุดเดียวกัน ระบบจะวาดตัวทำเครื่องหมายตามลำดับที่ปรากฏในพารามิเตอร์ chm ในตัวอย่างนี้ วงกลมคือเครื่องหมายแรกที่ระบุด้วย chm ดังนั้นจึงถูกวาดก่อน มีการระบุและวาดรูปเพชรเป็นลำดับที่สอง ทำให้มีการวาดเพชรไว้เหนือวงกลม	chm=   o,FF9900,0,-1,15.0|   d,FF0000,1,-1,10.0
นี่คือแผนภูมิเส้นที่มีเครื่องหมายบนจุดข้อมูลทุกวินาที (-2 หมายถึงจุดอื่นๆ ทุกจุด)	chd=t:   0,20,20,50,40,70,70,90,85,45,40,50 chm=   o,0066FF,0,-2,6
นี่คือแผนภูมิเส้นซึ่งมีตัวทำเครื่องหมายเป็น 2 เท่าของจุดข้อมูล (-0.5 หมายถึงจุดทุกครึ่งจุด)	chd=t:   0,20,20,50,40,70,70,90,85,45,40,50 chm=   o,0066FF,0,-.5,6
ตัวอย่างนี้แสดงวิธีใช้ตัวทำเครื่องหมาย h และ v เพื่อสร้างเส้นตารางกริดด้วยสีและความหนาที่กำหนดเอง ค่าลำดับ z (ค่าสุดท้าย) จะถูกตั้งค่าเป็น -1 เพื่อให้ระบบวาดเส้นตารางใต้บรรทัดข้อมูล	chm=   h,76A4FB,0,0:1:.2,2,-1|   V,76A4FB,0,::2,0.5,-1
แผนภูมินี้จะเพิ่มเส้นเติมแนวตั้งในแผนภูมิเส้น v - เส้นแนวตั้งแสดงแผนภูมิ FF0000 - เส้นสีแดง 0 - ดัชนีชุดหนังสือ : :.5 - ตัวระบุช่วง: ตั้งแต่เริ่มต้นถึงปลายทาง ทุกๆ 0.5 จุด 2 - ความหนา 2 พิกเซล	chm=   v,FF0000,0,::.5,2
ตัวอย่างนี้เพิ่มลูกศรและเครื่องหมายข้อความลงในแผนภูมิโดยใช้พิกัดแบบตรงกันทุกประการ เครื่องหมาย D แรกคือเส้นการติดตามที่อยู่ใต้แถบ เครื่องหมายที่ 2 คือลูกศร และเครื่องหมายที่ 3 คือข้อความลูกศร	chm=   D,003971,1,0,3|   @a,000000,0,.25:.75,7|   @tExpected,000000,0,.35:.85,10
เส้นแนวนอนที่ติดอยู่กับจุดข้อมูลที่เฉพาะเจาะจง (H) มีประโยชน์ในการแสดงค่าแบบสัมพัทธ์หรือเน้นความสูงของค่าข้อมูลในแผนภูมิ	chm=H,FF0000,0,18,1
กราฟนี้แสดงตัวทำเครื่องหมายที่ระบุความหนาและความยาวของเส้นได้ในพารามิเตอร์ <size> E,000000,0,6,1:20 - แถบข้อผิดพลาดสีดำที่มีเส้นกว้าง 1 พิกเซล แถบด้านบนและด้านล่างยาว 20 พิกเซล ด้านล่างยึดกับชุด 0 จุด 8 และด้านบนยึดอยู่กับชุด 1 จุด 8 H,990066,1,2,5:50 - เส้นแนวนอนสีม่วงกว้าง 5 พิกเซล ยาว 50 พิกเซลยาว 50 พิกเซลตรงกลางจุดข้อมูล 2 V,3399CC,0,8,3:50- เส้นแนวตั้งสีน้ำเงิน กว้าง 3 พิกเซล ยาว 50 พิกเซล กึ่งกลางจุดข้อมูล 8	title="cht=lc&chd=s:2gounjqLaCf,jqLaCf2goun&chco=008000,00008033&chls=2.0,4.0,1.0&chs=250x150&chm=H,990066,1,2,5:9%, chm=   E,000000,0,6,1:20|   H,990066,1,2,5:50|   V,3399CC,0,8,3:50

กลับไปด้านบน

เครื่องหมายค่าของข้อความและข้อมูล chm [Bar, Line, Radar, Scatter]

คุณอาจติดป้ายกำกับจุดที่เจาะจงในแผนภูมิด้วยข้อความที่กำหนดเองหรือด้วยเวอร์ชันที่มีการจัดรูปแบบของข้อมูล ณ จุดนั้น

คุณรวมตัวทำเครื่องหมาย chm ใดก็ได้โดยใช้อักขระไปป์ ( | ) เพื่อแยกชุดพารามิเตอร์ chm

หมายเหตุเกี่ยวกับค่าสตริง: สตริงป้ายกำกับอนุญาตให้ใช้เฉพาะอักขระที่ปลอดภัยสำหรับ URL เท่านั้น เพื่อความปลอดภัย คุณควรเข้ารหัส URL สตริงทั้งหมดที่มีอักขระที่ไม่ได้อยู่ในชุดอักขระ 0-9a-zA-Z โปรดดูโปรแกรมเปลี่ยนไฟล์ URL ในเอกสารประกอบของ Google Visualization

ไวยากรณ์

ระบุพารามิเตอร์ต่อไปนี้ 1 ชุดให้กับแต่ละชุดที่ควรทำเครื่องหมาย หากต้องการทำเครื่องหมายหลายชุด ให้สร้างชุดพารามิเตอร์เพิ่มเติมโดยคั่นด้วยอักขระไปป์ คุณไม่จำเป็นต้องมาร์กอัปทุกชุด หากคุณไม่ได้กำหนดตัวทำเครื่องหมายให้กับชุดข้อมูล จะไม่มีเครื่องหมายเลย

chm=
  <marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_placement>
    |...|
  <marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_placement>

<marker_type>

ประเภทของเครื่องหมายที่จะใช้ คุณเลือกได้จากประเภทต่อไปนี้

• f<text> - ธงที่มีข้อความ ระบุอักขระ "f" ตามด้วยข้อความเข้ารหัส URL ที่กำหนดเอง หากต้องการยกเว้นเครื่องหมายจุลภาคในตัวทำเครื่องหมายข้อความ ให้ใส่เครื่องหมาย \ ไว้หน้าเครื่องหมายจุลภาค ตัวอย่าง: fHello\,+World!
• t<text> - ตัวทำเครื่องหมายข้อความแบบง่าย ระบุอักขระ "t" ตามด้วยข้อความที่เข้ารหัส URL ที่กำหนดเอง หากต้องการยกเว้นเครื่องหมายจุลภาคในตัวทำเครื่องหมายข้อความ ให้ใส่เครื่องหมาย \ ไว้หน้าเครื่องหมายจุลภาค ตัวอย่าง: tHello\,+World!
• A<text> - ตัวทำเครื่องหมายคำอธิบายประกอบ เครื่องหมายนี้คล้ายกับเครื่องหมายธง แต่ตัวทำเครื่องหมายจะประสานกันในตำแหน่งเพื่อไม่ให้ซ้อนทับกัน รูปแบบเดียวที่ใช้ได้สําหรับ <opt_which_points> คือ n.d เพื่อแสดงถึงดัชนีของจุดในชุด
• N<formatting_string> - ค่าของข้อมูล ณ จุดนี้โดยมีการจัดรูปแบบที่ไม่บังคับ หากไม่ได้ใช้พารามิเตอร์ chds (การปรับขนาดที่กําหนดเอง) URL จะให้ค่าที่เข้ารหัสแบบแม่นยำ หากคุณใช้พารามิเตอร์ดังกล่าวกับประเภทรูปแบบใดก็ตาม ระบบจะปรับขนาดค่าเป็นช่วงที่คุณระบุ ดูตัวอย่างของ chds ที่มีเครื่องหมายตัวเลขด้านล่าง ด้วยเครื่องหมายประเภทนี้ในแผนภูมิแท่งแบบซ้อน หากระบุ -1 สำหรับ <series_index> คุณจะเห็นเครื่องหมายที่แสดงผลรวมของค่าทั้งหมดในแถบที่ซ้อนกันนี้ ไวยากรณ์สตริงการจัดรูปแบบมีดังนี้
         <preceding_text>*<number_type><decimal_places>zs<x or y>*<following_text>
  องค์ประกอบทั้งหมดนี้ไม่บังคับ ความหมายขององค์ประกอบแต่ละรายการมีดังนี้
  • <preceding_text> - ข้อความที่นำหน้าแต่ละค่า
  • *...* - บล็อกที่ไม่บังคับซึ่งรวมไว้ในเครื่องหมายดอกจันตามตัวอักษร ซึ่งคุณสามารถระบุรายละเอียดการจัดรูปแบบสำหรับตัวเลขได้ ระบบรองรับค่าต่อไปนี้และไม่บังคับทั้งหมด
    • <number_type> - รูปแบบตัวเลขสำหรับค่าตัวเลข เลือกตัวเลือกใดตัวเลือกหนึ่งต่อไปนี้
      • f - [ค่าเริ่มต้น] รูปแบบจุดแบบลอย ลองระบุความแม่นยำด้วยค่า <decimal_places>
      • p - รูปแบบเปอร์เซ็นต์ เครื่องหมาย % จะต่อท้ายโดยอัตโนมัติ หมายเหตุ: เมื่อใช้รูปแบบนี้ ค่าของข้อมูลตั้งแต่ 0.0 - 1.0 จะแมปเป็น 0 - 100% (เช่น 0.43 จะแสดงเป็น 43%)
      • e - รูปแบบสัญกรณ์วิทยาศาสตร์
      • c<CUR> - จัดรูปแบบตัวเลขในสกุลเงินที่ระบุ พร้อมทำเครื่องหมายสกุลเงินที่เหมาะสม แทนที่ <CUR> ด้วยรหัสสกุลเงิน 3 ตัวอักษร เช่น cEUR สำหรับเงินยูโร คุณดูรายการรหัสได้ในเว็บไซต์ ISO แม้ว่าจะรองรับสัญลักษณ์บางตัวเท่านั้น
    • <decimal_places> - จำนวนเต็มที่ระบุจำนวนหลักทศนิยมที่จะแสดง ระบบจะปัดเศษ (ไม่ถูกตัด) ตามความยาวนี้ ค่าเริ่มต้นคือ 2
    • z - แสดงเลขศูนย์ต่อท้าย ค่าเริ่มต้นคือ no (ไม่)
    • s - แสดงเส้นแบ่งกลุ่ม ค่าเริ่มต้นคือ no (ไม่)
    • x หรือ y -แสดงข้อมูลจากพิกัด x หรือ y ตามที่ระบุ ความหมายของข้อมูล x จะแตกต่างกันไปตามประเภทแผนภูมิ โดยทดสอบกับแผนภูมิเพื่อหาความหมาย ค่าเริ่มต้นคือ "y"
  • <following_text> - ข้อความที่จะต่อท้ายแต่ละค่า

<color>

สีของตัวทำเครื่องหมายสำหรับชุดนี้ ในรูปแบบเลขฐานสิบหก RRGGBB

<series_index>

ดัชนีฐาน 0 ของชุดข้อมูลที่ใช้วาดเครื่องหมาย หากเป็นแผนภูมิแท่งแบบซ้อนและประเภทเครื่องหมายคือ N (ค่าจุดข้อมูล) คุณจะระบุ -1 เพื่อสร้างตัวทำเครื่องหมายค่าผลรวมสำหรับแท่งของแต่ละแท่งได้ โปรดดูตัวอย่างด้านล่าง

<opt_which_points>

[ไม่บังคับ] จุดที่ใช้วาดเครื่องหมาย ค่าเริ่มต้นคือเครื่องหมายทั้งหมด โปรดใช้ค่าใดค่าหนึ่งต่อไปนี้

• n.d - จุดข้อมูลที่จะใช้วาดเครื่องหมาย โดย n.d คือดัชนีฐาน 0 ในชุด หากระบุค่าที่ไม่ใช่จำนวนเต็ม เศษส่วนจะระบุคะแนนกลางที่คำนวณได้ เช่น 3.5 หมายถึงจุดกึ่งกลางระหว่างจุด 3 กับจุด 4
• -1 - วาดเครื่องหมายบนจุดข้อมูลทั้งหมด นอกจากนี้ คุณยังปล่อยพารามิเตอร์นี้ว่างไว้เพื่อให้แสดงในจุดข้อมูลทั้งหมดได้
• -n - วาดเครื่องหมายบนจุดข้อมูลที่ n ทุกจุด
• start:end:n - วาดเครื่องหมายบนจุดข้อมูลที่ n ทุกจุดในช่วง ตั้งแต่ค่าดัชนี start ถึง end พารามิเตอร์ทั้งหมดไม่บังคับ (อาจไม่มี) ดังนั้น 3::1 จะมาจากองค์ประกอบที่ 4 ถึงสุดท้าย ขั้นตอนที่ 1 และการละเว้นพารามิเตอร์นี้ทั้งหมดจะมีค่าเริ่มต้นเป็น first:last:1 ค่าทั้งหมดเป็นจำนวนทศนิยมได้ โดย start และ end อาจเป็นค่าลบได้ เพื่อนับย้อนจากค่าล่าสุด หากทั้ง start และ end เป็นค่าลบ โปรดตรวจสอบว่ามีการระบุไว้ในค่าที่เพิ่มขึ้น (เช่น -6:-1:1) หากค่าขั้นตอน n น้อยกว่า 1 ระบบจะคำนวณจุดข้อมูลเพิ่มเติมโดยการประมาณค่าข้อมูลที่ระบุ ค่าเริ่มต้นคือ first:last:1
• x:y - [ไม่รองรับตัวทำเครื่องหมายประเภท N] วาดเครื่องหมายที่จุด x/y ที่เจาะจงบนแผนภูมิ จุดนี้ไม่จำเป็นต้องอยู่บนเส้น เพิ่มอักขระ @ (@) ก่อนประเภทเครื่องหมายเพื่อใช้ตัวเลือกนี้ ระบุพิกัดเป็นค่าจุดลอยตัว โดย 0:0 อยู่มุมซ้ายล่างของแผนภูมิ 0.5:0.5 คือจุดศูนย์กลางของแผนภูมิ และ 1:1 คือมุมขวาบนของแผนภูมิ เช่น หากต้องการเพิ่มเพชรสีแดงขนาด 15 พิกเซลที่กึ่งกลางแผนภูมิ ให้ใช้ @d,FF0000,0,0.5:0.5,15

<size>

ขนาดของเครื่องหมายในหน่วยพิกเซล หากเป็นแผนภูมิกระจายที่มีชุดข้อมูลที่ 3 (ใช้เพื่อระบุขนาดจุด) ระบบจะปรับขนาดตามช่วงข้อมูล ดังนั้นหากช่วงข้อมูลคือ 0—100 และ <size> คือ 30 ค่าข้อมูล 100 จะเท่ากับความกว้าง 30 พิกเซล ค่าข้อมูล 50 จะเท่ากับความกว้าง 15 พิกเซล เป็นต้น

<opt_z_order>

[ไม่บังคับ] เลเยอร์ที่จะวาดเครื่องหมายเทียบกับเครื่องหมายอื่นๆ และองค์ประกอบแผนภูมิอื่นๆ ทั้งหมด นี่คือจำนวนลอยตัวตั้งแต่ -1.0 ถึง 1.0 โดย -1.0 คือด้านล่างและ 1.0 คือบนสุด องค์ประกอบของแผนภูมิ (เส้นและแท่ง) มีค่าต่ำกว่า 0 หากเครื่องหมาย 2 ตัวมีค่าเหมือนกัน ระบบจะวาดตามลำดับที่ URL ให้ไว้ ค่าเริ่มต้นคือ 0.0 (เหนือองค์ประกอบแผนภูมิ)

<opt_placement>

[ไม่บังคับ] รายละเอียดตำแหน่งเพิ่มเติมที่อธิบายถึงตำแหน่งที่ควรวางเครื่องหมายนี้ซึ่งสัมพันธ์กับจุดข้อมูล คุณระบุการจัดตำแหน่งแบบสัมพัทธ์ในแนวนอนและ/หรือแนวตั้ง รวมถึงออฟเซ็ตได้ ไวยากรณ์ตำแหน่งเป็นสตริงที่มีตัวคั่น : องค์ประกอบทั้งหมดเป็นค่าที่ไม่บังคับ: <horizontal_and_vertical_justification>:<horizontal_offset>:<vertical_offset> หากระบุไว้ คุณจะใส่ค่า ,, ว่าง ในสตริงพารามิเตอร์ chm สำหรับ <opt_z_order> ได้ ตัวอย่างเช่น N,000000,0,1,10,,b และ N,000000,0,1,10,,lv และ N,000000,0,1,10,,r::10

horizontal_and_vertical_justification

จุดยึดของตัวทำเครื่องหมาย ซึ่งทำงานตรงข้ามกับการจัดชิดขอบ ดังนั้น Anchor ทางซ้ายจะวางตัวทำเครื่องหมายไว้ที่ขวาของจุดข้อมูล คุณเลือกเครื่องมือเปรียบเทียบแบบแนวนอนและ/หรือแนวตั้งได้จากรายการต่อไปนี้

• การวางแบบแนวนอน: "l", "h" หรือ "r" - ตรึงไว้ด้านซ้าย ตรงกลาง หรือแบบขวาในแนวนอน ค่าเริ่มต้นคือ 'l'
• การวางตำแหน่งแนวตั้ง: "b", "v", "t" - ยึดตำแหน่งด้านล่าง ตรงกลาง หรือด้านบนในแนวตั้ง ค่าเริ่มต้นคือ 'b'
• ตำแหน่งโฆษณาแบบแท่ง [เฉพาะแผนภูมิแท่ง]: "s", "c", "e" - ฐาน กึ่งกลาง หรือด้านบนของแท่ง สำหรับแผนภูมิแบบเรียงซ้อน นี่จะสัมพันธ์กับส่วนของแท่งสำหรับแต่ละชุด ไม่ใช่ทั้งแท่ง หากดัชนีชุดหนังสือที่กำหนดคือ -1 (สแต็กทั้งหมด) ก็จะสัมพันธ์กับทั้งแถบ ค่านี้ใช้ร่วมกับค่าตำแหน่งแนวตั้งได้ เช่น "เป็น" หรือ "กับ" ค่าเริ่มต้นคือ "e"

horizontal_offset

ค่าออฟเซ็ตแนวนอนสำหรับเครื่องหมายนี้ หน่วยเป็นพิกเซล ค่าเริ่มต้นคือ 0

vertical_offset

ค่าออฟเซ็ตแนวตั้งของเครื่องหมายนี้ หน่วยเป็นพิกเซล ค่าเริ่มต้นแบบไม่ใช่แผนภูมิแท่ง: 15 แผนภูมิแท่งมีค่าเริ่มต้น: 2

คำอธิบาย	ตัวอย่าง
นี่คือตัวอย่างป้ายกำกับค่าในแผนภูมิแท่ง แผนภูมิแรก (N*p0*) ระบุตัวทำเครื่องหมายค่าของข้อมูลโดยมีค่าแสดงเป็นเปอร์เซ็นต์ ปัดเศษทศนิยมเป็นศูนย์ทศนิยม สีดำทุกค่าในข้อความ 11 จุด โปรดทราบว่าค่าข้อมูลต้องอยู่ระหว่าง 0.0 ถึง 1.0 ทั้งหมด ซึ่งจะย้ายตำแหน่งที่มีทศนิยม 2 ตำแหน่งในรูปแบบเปอร์เซ็นต์ แผนภูมิที่ 2 (N*cEUR1*) แสดงค่าในรูปแบบเดียวกันกับค่ายูโร มีทศนิยม 1 ตำแหน่ง สีดำ สำหรับทุกค่าเป็นข้อความ 11 จุด	chm=   N*p0*,000000,0,-1,11 chd=t:   0.4356,0.3562,0.4834,0.575,0.673,0.6091 chm=   N*cEUR1*,000000,0,-1,11
คุณใช้พารามิเตอร์ chds เพื่อปรับขนาดค่าตัวเลขที่แสดงได้ คุณใช้ chds ได้กับทุกรูปแบบข้อมูล รวมถึงการเข้ารหัสแบบง่ายและการเข้ารหัสแบบขยาย ซึ่งจะไม่ส่งผลต่อขนาดแท่งหรือป้ายกำกับแกน แต่จะส่งผลต่อค่าเครื่องหมายข้อมูลเท่านั้น ตัวอย่างนี้แสดงแผนภูมิที่มีค่าที่เข้ารหัสแบบง่ายเป็น 46, 39, 29, 30, 43, 41 ช่วงการเข้ารหัสอย่างง่ายคือ 0—61 พารามิเตอร์ chds กำหนดสเกลเครื่องหมายที่กำหนดเองไว้ที่ 0-1 ดังนั้นค่าของเครื่องหมายจะปรับขนาดตามช่วงนี้ แต่ความสูงของแท่งจะไม่ได้รับผลกระทบ (หากเป็นข้อมูลรูปแบบข้อความ แท่งแผนภูมิจะมีการปรับขนาดด้วยเช่นกัน)	chd=s:underp chm=N,000000,0,-1,11 chds=0,1
ต่อไปนี้คือตัวอย่างของแผนภูมิที่มีป้ายกำกับข้อความที่จุดต่ำสุดและป้ายกำกับที่จุดสูงสุด	chm=   tMin,0000FF,0,1,10|   fMax,FF0000,0,3,15
ตัวอย่างนี้แสดงแผนภูมิแบบเรียงซ้อนที่มีค่าสำหรับชุดแต่ละชุด บวกกับยอดรวมของชุดหนังสือ หากต้องการแสดงค่าของชุดแบบซ้อน เราต้องใช้ตัวเลือกการจัดตำแหน่ง "c" หากไม่เป็นเช่นนั้น ค่าแท่งแผนภูมิด้านบนจะซ้อนทับค่าผลรวมที่ด้านบนของแต่ละแท่ง	chm=   N,FF0000,-1,,12|   N,000000,0,,12,,c|   N,000000,1,,12,,c|   N,ffffff,2,,12,,c
การสาธิตเพิ่มเติมเกี่ยวกับวิธีการทำงานของตำแหน่งแนวตั้งและแนวนอน ตัวอย่างนี้แสดงชุดค่าผสมต่างๆ ของค่า Anchor สำหรับแผนภูมิแท่ง (ซึ่งใช้ s, c และ e สำหรับตำแหน่งแนวตั้ง) โปรดสังเกตว่าจุดยึดด้านขวาย้ายเครื่องหมายไปทางซ้าย และหมุดด้านบนย้ายเครื่องหมายลงอย่างไร และในทางกลับกัน จุดสีแดงจะแสดงฐาน กึ่งกลาง และด้านบนของแต่ละแท่ง ตัวเลขคือค่าข้อมูล ซึ่งคงที่โดยใช้ค่า Anchor ที่แตกต่างกันสำหรับแต่ละแท่ง	chm=   N,000000,0,0,10,,rs   N,000000,0,1,10,,ls   N,000000,0,2,10,,c   N,000000,0,3,10,,e   N,000000,0,4,10,,e::15   N,000000,0,5,10,,e::-12
ตัวทำเครื่องหมายคำอธิบายประกอบจะปรับตำแหน่งของป้ายกำกับโดยอัตโนมัติเพื่อไม่ให้ทับซ้อนกัน ค่า chm แรกมีไว้สำหรับการเติมบรรทัด ค่าต่อไปนี้คือตัวทำเครื่องหมายคำอธิบายประกอบทั้งหมด	chm=B,C5D4B5BB,0,0,0   AA,666666,0,3,15   AB,666666,0,5,15   AC,666666,0,24,15   AD,666666,0,25,15   AE,666666,0,26,15   AF,666666,0,51,15   AG,666666,0,60,15   AH,666666,0,73,15   AI,666666,0,80,15   AJ,666666,0,99,15
ตัวอย่างตัวทำเครื่องหมายคำอธิบายประกอบอีกตัวอย่างหนึ่งที่แสดงระดับความสูงของเมืองในสวิตเซอร์แลนด์

กลับไปด้านบน