ปรับแต่งการนําเสนอแผนที่มาตรฐานของ Google โดยใช้รูปแบบของคุณเองเมื่อใช้ Maps Static API คุณเปลี่ยนการแสดงผลภาพของฟีเจอร์ต่างๆ ได้ เช่น ถนน สวนสาธารณะ พื้นที่ที่สร้างเพิ่ม และสถานที่น่าสนใจอื่นๆ เปลี่ยนสีหรือสไตล์เพื่อเน้นเนื้อหาที่เฉพาะเจาะจง เสริมเนื้อหาที่อยู่รอบหน้า หรือแม้กระทั่งซ่อนฟีเจอร์ไว้โดยสิ้นเชิง
ตัวอย่าง
ตัวอย่างต่อไปนี้แสดงแผนที่ของเมืองบรุกลิน สหรัฐอเมริกา โดยจัดรูปแบบให้มีสีถนนในท้องถิ่นเป็นสีเขียวสดและพื้นที่พักอาศัย และยังปรับความสว่างของป้ายกํากับเพื่อให้โดดเด่นกว่าพื้นหลังสีเข้ม โปรดทราบว่าตัวอย่างนี้ทํางานโดยใช้การเข้ารหัส URL
https://maps.googleapis.com/maps/api/staticmap?size=512x512&zoom=15¢er=Brooklyn&style=feature:road.local%7Celement:geometry%7Ccolor:0x00ff00&style=feature:landscape%7Celement:geometry.fill%7Ccolor:0x000000&style=element:labels%7Cinvert_lightness:true&style=feature:road.arterial%7Celement:labels%7Cinvert_lightness:false&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
ตัวอย่างต่อไปนี้ใช้สไตล์และการลดความซับซ้อนของการจัดรูปแบบเพื่อประมาณลักษณะของแผนที่บริเวณถนนในสหรัฐฯ
https://maps.googleapis.com/maps/api/staticmap?size=512x512&zoom=12¢er=Chicago&format=png&style=feature:road.highway%7Celement:geometry%7Cvisibility:simplified%7Ccolor:0xc280e9&style=feature:transit.line%7Cvisibility:simplified%7Ccolor:0xbababa&style=feature:road.highway%7Celement:labels.text.stroke%7Cvisibility:on%7Ccolor:0xb06eba&style=feature:road.highway%7Celement:labels.text.fill%7Cvisibility:on%7Ccolor:0xffffff&key=YOUR_API_KEY&signature=DITIGAL_SIGNATURE
ไวยากรณ์ของรูปแบบ
หากต้องการสร้างแผนที่ที่มีสไตล์แบบกําหนดเอง ให้รวมพารามิเตอร์ style
อย่างน้อย 1 รายการใน URL คําขอ
การประกาศ style
แต่ละรายการอาจมีอาร์กิวเมนต์ต่อไปนี้ โดยคั่นด้วยอักขระไปป์ ("|
")
feature
(ไม่บังคับ) ระบุฟีเจอร์ให้เลือกสําหรับการแก้ไขรูปแบบนี้ สถานที่ต่างๆ รวมถึงสิ่งต่างๆ บนแผนที่ เช่น ถนน สวนสาธารณะ หรือจุดสนใจอื่นๆ หากไม่มีอาร์กิวเมนต์feature
รูปแบบที่ระบุจะใช้กับฟีเจอร์ทั้งหมดelement
(ไม่บังคับ) ระบุองค์ประกอบของฟีเจอร์ที่ระบุเพื่อเลือกการแก้ไขรูปแบบนี้ องค์ประกอบคือลักษณะของฟีเจอร์ เช่น เรขาคณิตหรือป้ายกํากับ หากไม่มีอาร์กิวเมนต์element
รูปแบบจะมีผลกับองค์ประกอบทั้งหมดของฟีเจอร์ที่ระบุ- ชุดกฎสไตล์ (บังคับ) เพื่อนําไปใช้กับฟีเจอร์และองค์ประกอบที่ระบุ API จะใช้กฎตามลําดับที่ปรากฏในการประกาศ
style
คุณระบุจํานวนกฎใดก็ได้ภายในข้อจํากัดความยาว URL ปกติของ Maps Static API
style=feature:myFeatureArgument|element:myElementArgument|myRule1:myRule1Argument|myRule2:myRule2Argument
ฟีเจอร์
การประกาศ style
ต่อไปนี้ให้สีถนนทุกเส้นบนแผนที่
style=feature:road|color:0xffffff
การเลือกฟีเจอร์ที่พบบ่อยมีดังนี้
feature:all
(ค่าเริ่มต้น) เลือกฟีเจอร์ทั้งหมดของแผนที่feature:road
เลือกถนนทั้งหมดในแผนที่feature:road.local
เลือกถนนในท้องที่ทั้งหมด
จุดสนใจหรือประเภทลักษณะเป็นลักษณะทางภูมิศาสตร์บนแผนที่ เช่น ถนน สวนสาธารณะ แหล่งน้ํา ธุรกิจ และอื่นๆ
ฟีเจอร์จะสร้างแผนผังหมวดหมู่โดยมี all
เป็นรูท หากคุณไม่ระบุสถานที่ ระบบจะเลือกฟีเจอร์ทั้งหมด
การระบุฟีเจอร์ของ all
จะมีผลเหมือนกัน
ฟีเจอร์บางอย่างมีฟีเจอร์ย่อยที่คุณระบุโดยใช้สัญลักษณ์จุด เช่น landscape.natural
หรือ road.local
หากคุณระบุเฉพาะฟีเจอร์หลัก เช่น road
รูปแบบที่คุณระบุสําหรับระดับบนสุดจะมีผลกับรายการย่อยทั้งหมด เช่น road.local
และ road.highway
โปรดทราบว่าฟีเจอร์หลักอาจมีองค์ประกอบบางอย่างที่ไม่ได้รวมอยู่ในฟีเจอร์ย่อยทั้งหมด
ฟีเจอร์ที่พร้อมใช้งานมีดังนี้
all
(ค่าเริ่มต้น) เลือกฟีเจอร์ทั้งหมดadministrative
เลือกเขตบริหารทั้งหมด การจัดรูปแบบมีผลกับป้ายกํากับของพื้นที่บริหารเท่านั้น ไม่ใช่ขอบเขตทางภูมิศาสตร์หรือการส่งโฆษณาadministrative.country
เลือกประเทศadministrative.land_parcel
เลือกที่ดินadministrative.locality
เลือกย่านadministrative.neighborhood
เลือกย่านใกล้เคียงadministrative.province
เลือกจังหวัด
landscape
เลือกรูปภาพทิวทัศน์ทั้งหมดlandscape.man_made
เลือกฟีเจอร์ที่มนุษย์สร้างขึ้น เช่น อาคารและโครงสร้างอื่นๆlandscape.natural
เลือกสถานที่ทางธรรมชาติ เช่น ภูเขา แม่น้ํา ทะเลทราย และธารน้ําแข็งlandscape.natural.landcover
เลือกจุดเด่นของที่ดิน ซึ่งเป็นวัสดุจริงที่บดบังพื้นผิวของพื้นโลก เช่น ป่า ทุ่งหญ้า พื้นที่ชุ่มน้ํา และพื้นที่เปลือยlandscape.natural.terrain
เลือกฟีเจอร์ภูมิประเทศของพื้นดิน เช่น ระดับความสูง ความลาดเอียง และการวางแนว
poi
เลือกจุดสนใจทั้งหมดpoi.attraction
เลือกสถานที่ท่องเที่ยวpoi.business
เลือกธุรกิจpoi.government
เลือกอาคารรัฐบาลpoi.medical
เลือกบริการช่วยเหลือฉุกเฉิน รวมถึงโรงพยาบาล ร้านขายยา ตํารวจ แพทย์ และอื่นๆpoi.park
เลือกสวนสาธารณะpoi.place_of_worship
เลือกสถานที่สักการะ ซึ่งรวมถึง โบสถ์ วัด มัสยิด และอื่นๆpoi.school
เลือกโรงเรียนpoi.sports_complex
เลือกศูนย์กีฬา
road
เลือกถนนทุกสายroad.arterial
เลือกถนนหลักroad.highway
เลือกทางหลวงroad.highway.controlled_access
เลือกทางหลวงที่มี การควบคุมroad.local
เลือกถนนในท้องที่
transit
เลือกสถานีขนส่งสาธารณะและสายทั้งหมดtransit.line
เลือกสายขนส่งสาธารณะtransit.station
เลือกสถานีขนส่งทั้งหมดtransit.station.airport
เลือกสนามบินtransit.station.bus
เลือกป้ายรถประจําทางtransit.station.rail
เลือกสถานีรถไฟ
water
เลือกแหล่งน้ํา
องค์ประกอบ
การประกาศ style
ต่อไปนี้จะติดป้ายกํากับป้ายกํากับสําหรับถนนในพื้นที่ทั้งหมด
style=feature:road.local|element:labels|color:0xffffff
องค์ประกอบคือส่วนย่อยของฟีเจอร์ ตัวอย่างเช่น ถนนประกอบด้วยเส้นกราฟิก (รูปทรงเรขาคณิต) บนแผนที่ นอกจากนี้ ยังมีข้อความที่แสดงถึงชื่อ (ป้ายกํากับ)
องค์ประกอบต่อไปนี้มีให้ใช้งาน แต่โปรดทราบว่าฟีเจอร์บางอย่างอาจไม่รองรับองค์ประกอบบางอย่าง บางส่วนหรือทั้งหมด
all
(ค่าเริ่มต้น) เลือกองค์ประกอบทั้งหมดของฟีเจอร์ที่ระบุgeometry
จะเลือกองค์ประกอบทางเรขาคณิตทั้งหมดของฟีเจอร์ที่ระบุgeometry.fill
เลือกเฉพาะการเติมรูปทรงเรขาคณิตของฟีเจอร์geometry.stroke
จะเลือกเฉพาะเส้นโครงร่างของเรขาคณิตของฟีเจอร์
labels
เลือกป้ายกํากับข้อความที่เกี่ยวข้องกับ ฟีเจอร์ที่ระบุlabels.icon
จะเลือกเฉพาะไอคอนที่แสดงในป้ายกํากับ' ฟีเจอร์labels.text
จะเลือกเฉพาะข้อความของป้ายกํากับlabels.text.fill
จะเลือกเฉพาะการเติมป้ายกํากับเท่านั้น ปกติแล้วป้ายกํากับ จะแสดงเป็นเส้นขอบสีที่ล้อมรอบข้อความป้ายกํากับlabels.text.stroke
จะเลือกเฉพาะสโตรกของข้อความ'
กฎสไตล์
กฎรูปแบบคือตัวเลือกการจัดรูปแบบที่ใช้กับฟีเจอร์และองค์ประกอบที่ระบุในการประกาศของ style
แต่ละรายการ
การประกาศ style
ต่อไปนี้ใช้กฎของกฎ 2 ข้อกับถนนในแผนที่ กฎข้อแรกจะใช้สีกับถนน กฎข้อที่ 2 ช่วยลดความซับซ้อนในการแสดงผลถนน ทําให้มีเส้นบางๆ ซึ่งไม่มีโครงร่าง
style=feature:road|color:0xffffff|visibility:simplified
การประกาศ style
แต่ละรายการต้องมีการดําเนินการอย่างน้อย 1 รายการแยกต่างหากโดยใช้อักขระไปป์ ("|
") การดําเนินการแต่ละรายการจะระบุค่าอาร์กิวเมนต์โดยใช้อักขระโคลอน (":
") และการดําเนินการทั้งหมดจะมีผลกับการเลือกตามลําดับที่คุณระบุ
ระบบรองรับตัวเลือกรูปแบบดังต่อไปนี้
hue
(สตริง RGB เลขฐานสิบหกในรูปแบบ#RRGGBB
) จะระบุสีพื้นฐานหมายเหตุ: ตัวเลือกนี้จะกําหนดโทนสีพร้อมกับรักษาความอิ่มตัวและความสว่างตามที่ระบุไว้ในรูปแบบเริ่มต้นของ Google (หรือตัวเลือกรูปแบบอื่นๆ ที่คุณกําหนดบนแผนที่) สีที่ได้จะสัมพันธ์กับรูปแบบของแผนที่ฐาน หาก Google ทําการเปลี่ยนแปลงรูปแบบแผนที่ฐาน การเปลี่ยนแปลงจะส่งผลต่อ ลักษณะของแผนที่โดยใช้
hue
คุณควรใช้สไตล์color
ที่สมบูรณ์หากทําได้lightness
(ค่าทศนิยมระหว่าง-100
ถึง100
) บอกเปอร์เซ็นต์การเปลี่ยนแปลงความสว่างขององค์ประกอบ ค่าลบจะเพิ่มความมืด (ซึ่ง -100 ระบุสีดํา) ขณะที่ค่าบวกจะเพิ่มความสว่าง (ซึ่ง +100 จะระบุสีขาว)หมายเหตุ: ตัวเลือกนี้จะระบุความสว่างในขณะที่เก็บความอิ่มตัวและโทนสีไว้ในสไตล์ Google ที่เป็นค่าเริ่มต้น (หรือในรูปแบบอื่นๆ ที่คุณกําหนดบนแผนที่) สีที่ได้จะสัมพันธ์กับรูปแบบของแผนที่ฐาน หาก Google ทําการเปลี่ยนแปลงรูปแบบแผนที่ฐาน การเปลี่ยนแปลงจะส่งผลต่อ ลักษณะของแผนที่โดยใช้
lightness
คุณควรใช้สไตล์color
ที่สมบูรณ์หากทําได้saturation
(ค่าทศนิยมระหว่าง-100
ถึง100
) บอกเปอร์เซ็นต์การเปลี่ยนแปลงของความเข้มของสีพื้นฐานที่จะใช้กับองค์ประกอบหมายเหตุ: ตัวเลือกนี้กําหนดความอิ่มตัวโดยที่ยังรักษาโทนสีและความสว่างไว้ในสไตล์เริ่มต้นของ Google (หรือตัวเลือกรูปแบบอื่นๆ ที่คุณกําหนดบนแผนที่) สีที่ได้จะสัมพันธ์กับรูปแบบของแผนที่ฐาน หาก Google ทําการเปลี่ยนแปลงรูปแบบแผนที่ฐาน การเปลี่ยนแปลงจะส่งผลต่อ ลักษณะของแผนที่โดยใช้
saturation
คุณควรใช้สไตล์color
สัมบูรณ์หากทําได้gamma
(ค่าทศนิยมระหว่าง0.01
ถึง10.0
โดยที่1.0
ไม่ได้ใช้การแก้ไข) จะระบุจํานวนของการแก้ไขแกมมาที่จะใช้กับองค์ประกอบ การแก้ไขค่าแกมมาจะแก้ไขความสว่างของสีในแบบที่ไม่ใช่แบบเส้นตรง ในขณะเดียวกันก็ไม่ส่งผลต่อค่าสีขาวหรือสีดํา โดยปกติแล้ว การแก้ไขค่าแกมมาจะใช้เพื่อแก้ไขคอนทราสต์ขององค์ประกอบต่างๆ ตัวอย่างเช่น คุณอาจแก้ไขแกมมาเพื่อเพิ่มหรือลดคอนทราสต์ระหว่างขอบและภายในขององค์ประกอบหมายเหตุ: ตัวเลือกนี้จะปรับความสว่างตามสไตล์เริ่มต้นของ Google โดยใช้เส้นโค้งแกมมา หาก Google ทําการเปลี่ยนแปลงรูปแบบแผนที่ฐาน การเปลี่ยนแปลงนั้นจะส่งผลต่อฟีเจอร์ของแผนที่และรูปแบบของ
gamma
เราขอแนะนําให้ใช้สไตล์color
ที่สมบูรณ์หากเป็นไปได้invert_lightness
(หากtrue
) กลับค่าแสงที่มีอยู่ ซึ่งจะมีประโยชน์ เช่น เปลี่ยนเป็นแผนที่สีเข้มขึ้นด้วยข้อความสีขาวได้อย่างรวดเร็วหมายเหตุ: ตัวเลือกนี้จะกลับรูปแบบของ Google ตามค่าเริ่มต้น หาก Google ทําการเปลี่ยนแปลงรูปแบบแผนที่ฐาน การเปลี่ยนแปลงจะส่งผลต่อฟีเจอร์แผนที่ที่จัดรูปแบบด้วย
invert_lightness
คุณควรใช้สไตล์color
สัมบูรณ์หากทําได้visibility
(on
,off
หรือsimplified
) เป็นตัวระบุว่าองค์ประกอบจะปรากฏบนแผนที่หรือไม่และอย่างไร ระดับการเข้าถึงแบบsimplified
จะนําฟีเจอร์สไตล์บางอย่างออกจากฟีเจอร์ที่ได้รับผลกระทบ ตัวอย่างเช่น ถนนบางๆ จะเรียบง่ายขึ้นเป็นเส้นบางๆ ซึ่งไม่มีโครงร่าง ขณะที่สวนสาธารณะจะสูญเสียข้อความป้ายกํากับ แต่ยังคงเก็บไอคอนป้ายกํากับไว้ได้color
(สตริง RGB เลขฐานสิบหกในรูปแบบ#RRGGBB
) ตั้งค่าสีของฟีเจอร์weight
(ค่าจํานวนเต็มที่มากกว่าหรือเท่ากับ 0) จะกําหนดน้ําหนักของฟีเจอร์ในหน่วยพิกเซล การตั้งค่าน้ําหนักให้มีค่าสูงอาจส่งผลให้มีการตัดคลิปใกล้กับขอบของชิ้นส่วนแผนที่
กฎรูปแบบจะมีผลตามลําดับที่คุณระบุ อย่ารวมการดําเนินการหลายรายการไว้ในการดําเนินการรูปแบบเดียว แต่ให้กําหนดการดําเนินการแต่ละอย่างเป็นรายการแยกต่างหากในอาร์เรย์รูปแบบแทน
หมายเหตุ: คําสั่งซื้อมีความสําคัญเนื่องจากการดําเนินการบางอย่างไม่สื่อความหมาย ฟีเจอร์และ/หรือองค์ประกอบที่แก้ไขผ่านการดําเนินการรูปแบบ (มักจะ) มีอยู่แล้ว การดําเนินการจะดําเนินการกับรูปแบบที่มีอยู่ (หากมี)
โทนสี ความอิ่มตัว รูปแบบความสว่าง
แผนที่ที่มีการจัดรูปแบบจะใช้โมเดล Hue, ความอิ่มตัว, ความสว่าง (HSL) เพื่อแสดงถึงสีภายในการดําเนินการของสไตล์ โทนสีหมายถึงสีพื้นฐาน ความอิ่มตัวจะระบุความเข้มของสีนั้น และความสว่างหมายถึงปริมาณสีขาวหรือสีดําที่สัมพัทธ์ในสีส่วนประกอบ
การแก้ไขค่าแกมมาจะแก้ไขความสว่างเหนือพื้นที่สี โดยทั่วไปแล้วจะเพิ่มหรือลดคอนทราสต์ นอกจากนี้ โมเดล HSL จะกําหนดสีภายในพื้นที่พิกัดที่ hue
ระบุการวางแนวภายในวงล้อสี ในขณะที่ความอิ่มตัวและความสว่างจะแสดงแอมพลิจูดตามแกนต่างๆ เฉดสีจะวัดภายในพื้นที่สี RGB ซึ่งคล้ายกับพื้นที่สี RGB ส่วนใหญ่ ยกเว้นเฉดขาวและดํา
แม้ว่า hue
จะใช้ค่าสีแบบเลขฐาน 16 แบบ HTML แต่จะใช้ค่านี้เพื่อระบุสีพื้นฐานเท่านั้น นั่นคือ การวางแนวรอบวงล้อสี ไม่ใช่ความอิ่มตัวหรือความสว่าง ซึ่งจะระบุแยกต่างหากเมื่อเปอร์เซ็นต์การเปลี่ยนแปลง
เช่น กําหนดโทนสีเขียวอ่อนเป็น hue:0x00ff00
หรือ hue:0x000100
ทั้ง 2 สีเหมือนกัน ทั้ง 2 ค่าจะเปลี่ยนเป็นสีเขียวล้วนในโมเดลสี HSL
วงล้อสี RGB
ค่า RGB hue
ที่มีส่วนเท่ากันคือสีแดง เขียว และน้ําเงินไม่ได้แสดงถึงโทนสีใด เนื่องจากค่าเหล่านั้นไม่มีค่าที่ระบุการวางแนวในพื้นที่พิกัด HSL ตัวอย่างเช่น "#000000" (สีดํา) "#FFFFFF" (สีขาว)
และเฉดสีเทาทั้งหมด หากต้องการระบุว่าเป็นสีดํา สีขาว หรือสีเทา คุณต้องนํา saturation
ทั้งหมดออก (กําหนดค่าเป็น -100
) และปรับ lightness
แทน
นอกจากนี้ เมื่อแก้ไขฟีเจอร์ที่มีอยู่ซึ่งมีรูปแบบสีอยู่แล้ว การเปลี่ยนค่า เช่น hue
จะไม่เปลี่ยน saturation
หรือ lightness
ที่มีอยู่