ปรับแต่งการนำเสนอแผนที่ของ 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
ไม่มีการแก้ไข) บ่งชี้ถึงจำนวนการแก้ไขแกมมาที่จะใช้กับองค์ประกอบ การแก้ไขค่า Gamma จะปรับความสว่างของสีในแบบที่ไม่เป็นเชิงเส้น แต่ไม่ส่งผลต่อค่าสีขาวหรือสีดำ โดยปกติแล้วการแก้ไขแกมมาจะใช้เพื่อแก้ไขคอนทราสต์ขององค์ประกอบหลายรายการ เช่น คุณอาจแก้ไขแกมมาเพื่อเพิ่มหรือลดคอนทราสต์ระหว่างขอบและภายในขององค์ประกอบได้หมายเหตุ: ตัวเลือกนี้จะปรับความสว่างตามสไตล์เริ่มต้นของ Google โดยใช้เส้นโค้งแกมมา หาก Google ทำการเปลี่ยนแปลงใดๆ กับรูปแบบแผนที่ฐาน การเปลี่ยนแปลงจะมีผลต่อฟีเจอร์ของแผนที่ของคุณซึ่งจัดรูปแบบด้วย
gamma
หากทำได้ เราขอแนะนำให้ใช้การจัดสไตล์color
แบบสัมบูรณ์invert_lightness
(หากtrue
) กลับค่าความสว่างที่มีอยู่ ซึ่งจะเป็นประโยชน์ ตัวอย่างเช่น สำหรับการเปลี่ยนไปใช้แผนที่สีเข้มขึ้นด้วยข้อความสีขาวได้อย่างรวดเร็วหมายเหตุ: ตัวเลือกนี้เพียงเปลี่ยนสไตล์เริ่มต้นของ Google หาก Google ทำการเปลี่ยนแปลงใดๆ กับรูปแบบแผนที่ฐาน การเปลี่ยนแปลงจะส่งผลต่อสถานที่ของแผนที่ ซึ่งจัดรูปแบบด้วย
invert_lightness
หากทำได้ เราขอแนะนำให้ใช้การจัดสไตล์color
แบบสัมบูรณ์visibility
(on
,off
หรือsimplified
) บ่งบอกว่าองค์ประกอบจะปรากฏในแผนที่หรือไม่และอย่างไร ระดับการเข้าถึงsimplified
จะนำฟีเจอร์รูปแบบบางรายการออกจากฟีเจอร์ที่ได้รับผลกระทบ เช่น ถนนจะลดความซับซ้อนเป็นเส้นบางๆ โดยไม่มีเส้นขอบ ส่วนสวนสาธารณะจะไม่มีข้อความของป้ายกำกับแต่ยังคงไอคอนป้ายกำกับไว้color
(สตริงฐานสิบหก RGB ของรูปแบบ#RRGGBB
) จะกำหนดสีของฟีเจอร์weight
(ค่าจำนวนเต็มที่มากกว่าหรือเท่ากับ 0) จะกำหนดน้ำหนักของฟีเจอร์เป็นพิกเซล การตั้งค่าน้ำหนักเป็นค่าสูงอาจส่งผลให้เกิดการถูกตัดออกใกล้กับขอบการ์ด
ระบบจะนำกฎรูปแบบไปใช้ตามลำดับที่คุณระบุ อย่ารวมการดำเนินการหลายรายการเป็นการดำเนินการรูปแบบเดียว แต่ให้กำหนดการดำเนินการแต่ละรายการเป็นรายการแยกต่างหากในอาร์เรย์รูปแบบ
หมายเหตุ: ลำดับเป็นสิ่งสำคัญ เนื่องจากการดำเนินการบางอย่างไม่สามารถสลับกันได้ ฟีเจอร์และ/หรือองค์ประกอบที่แก้ไขผ่านการดำเนินการด้านรูปแบบ (โดยปกติ) จะมีสไตล์อยู่แล้ว การดําเนินการจะดําเนินการกับรูปแบบที่มีอยู่ (หากมี)
โมเดลโทนสี ความอิ่มตัว ความสว่าง
แผนที่ที่มีการจัดรูปแบบใช้โมเดลโทนสี ความอิ่มตัว ความสว่าง (HSL) เพื่อระบุสีภายในการดำเนินการจัดสไตล์ โทนสีหมายถึงสีพื้นฐาน ความอิ่มตัวจะแสดงความเข้มของสีนั้น และความสว่างแสดงถึงปริมาณสัมพัทธ์ของสีขาวหรือสีดำในสีองค์ประกอบ
การแก้ไขแกมมาจะปรับความสว่างบนพื้นที่สี โดยทั่วไปแล้วจะเป็นการเพิ่มหรือลดคอนทราสต์ นอกจากนี้ โมเดล HSL ยังกำหนดสีภายในพื้นที่พิกัดซึ่ง hue
แสดงการวางแนวภายในวงล้อสี ส่วนความอิ่มตัวและความสว่างจะระบุแอมพลิจูดตามแกนต่างๆ เฉดสีจะวัดภายในพื้นที่สี RGB ซึ่งคล้ายกับพื้นที่สี RGB ส่วนใหญ่ เว้นแต่จะแสดงเฉดสีขาวและสีดำ
แม้ว่า hue
จะใช้ค่าสีแบบเลขฐาน 16 สำหรับ HTML แต่จะใช้ค่าสีพื้นฐานเท่านั้น ซึ่งได้แก่ การวางแนวรอบวงล้อสี ไม่ใช่ความอิ่มตัวหรือความสว่าง ซึ่งจะระบุแยกต่างหากเป็นเปอร์เซ็นต์การเปลี่ยนแปลง
เช่น คุณจะกำหนดโทนสีสำหรับสีเขียวล้วนเป็น hue:0x00ff00
หรือ hue:0x000100
ได้ เฉดสีทั้ง 2 สีเหมือนกัน ทั้ง 2 ค่าจะเป็นสีเขียวล้วนในโมเดลสี HSL
วงล้อสี RGB
ค่า hue
ของ RGB ที่ประกอบด้วยส่วนสีแดง เขียว และน้ำเงินเท่ากันไม่ได้ระบุโทน เนื่องจากค่าเหล่านั้นไม่ได้บ่งบอกถึงการวางแนวในพื้นที่พิกัด HSL ตัวอย่างเช่น "#000000" (สีดำ), "#FFFFFF" (สีขาว) และเฉดสีเทาล้วน หากต้องการระบุสีดำ ขาว หรือเทา คุณต้องนำ saturation
ทั้งหมดออก (กำหนดค่าเป็น -100
) และปรับ lightness
แทน
นอกจากนี้ เมื่อแก้ไขฟีเจอร์ที่มีอยู่ซึ่งมีรูปแบบสีอยู่แล้ว การเปลี่ยนค่า เช่น hue
จะไม่เปลี่ยนแปลง saturation
หรือ lightness
เดิม