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

ปรับแต่งการนำเสนอแผนที่ของ 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
US Road Atlas Map Style

ไวยากรณ์ของรูปแบบ

หากต้องการสร้างแมปที่มีสไตล์แบบกำหนดเอง ให้ใส่พารามิเตอร์ 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 เดิม