แผนที่ที่มีการปรับลักษณะ

ปรับแต่งการนําเสนอแผนที่มาตรฐานของ Google โดยใช้รูปแบบของคุณเองเมื่อใช้ Maps Static API คุณเปลี่ยนการแสดงผลภาพของฟีเจอร์ต่างๆ ได้ เช่น ถนน สวนสาธารณะ พื้นที่ที่สร้างเพิ่ม และสถานที่น่าสนใจอื่นๆ เปลี่ยนสีหรือสไตล์เพื่อเน้นเนื้อหาที่เฉพาะเจาะจง เสริมเนื้อหาที่อยู่รอบหน้า หรือแม้กระทั่งซ่อนฟีเจอร์ไว้โดยสิ้นเชิง

ตัวอย่าง

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

https://maps.googleapis.com/maps/api/staticmap?size=512x512&zoom=15&center=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&center=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 จะเลือกเฉพาะไอคอนที่แสดงในป้ายกํากับ&#39 ฟีเจอร์
    • 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 ที่มีอยู่