ภาพรวม
หากต้องการจัดสไตล์การเติมและเส้นขอบของรูปหลายเหลี่ยมขอบเขต ให้ใช้ FeatureStyleOptions
เพื่อกำหนดแอตทริบิวต์สไตล์ และตั้งค่าพร็อพเพอร์ตี้ style
ในเลเยอร์ฟีเจอร์เป็น google.maps.FeatureStyleFunction
ซึ่งมีตรรกะการจัดสไตล์
แผนที่ตัวอย่างต่อไปนี้แสดงการไฮไลต์รูปหลายเหลี่ยมขอบเขตของภูมิภาคเดียว
ใช้รูปแบบกับองค์ประกอบขอบเขตโดยตั้งค่าพร็อพเพอร์ตี้ style
เป็น google.maps.FeatureStyleFunction
ซึ่งอาจมีตรรกะการจัดรูปแบบ ระบบจะเรียกใช้ฟังก์ชันสไตล์กับองค์ประกอบทุกรายการในเลเยอร์ฟีเจอร์ที่ได้รับผลกระทบ และจะนำไปใช้เมื่อคุณตั้งค่าพร็อพเพอร์ตี้สไตล์ หากต้องการอัปเดต คุณต้องตั้งค่าพร็อพเพอร์ตี้สไตล์อีกครั้ง
หากต้องการจัดรูปแบบองค์ประกอบทั้งหมดของเลเยอร์องค์ประกอบให้เหมือนกัน ให้ตั้งค่าพร็อพเพอร์ตี้ style
เป็น google.maps.FeatureStyleOptions
ในกรณีนี้ คุณไม่จำเป็นต้องใช้ฟังก์ชันสไตล์ฟีเจอร์ เนื่องจากไม่จำเป็นต้องใช้ตรรกะ
ฟังก์ชันสไตล์ควรแสดงผลลัพธ์ที่สอดคล้องกันเสมอเมื่อใช้กับฟีเจอร์ต่างๆ เช่น หากต้องการแรนดอมสีชุดองค์ประกอบ ไม่ควรใช้การแรนดอมในฟังก์ชันสไตล์องค์ประกอบ เนื่องจากอาจทำให้เกิดผลลัพธ์ที่ไม่ต้องการ
เนื่องจากฟังก์ชันนี้จะทำงานกับองค์ประกอบทุกรายการในเลเยอร์ การเพิ่มประสิทธิภาพจึงมีความสำคัญ วิธีหลีกเลี่ยงการส่งผลต่อเวลาในการเรนเดอร์
- เปิดใช้เฉพาะเลเยอร์ที่ต้องการ
- ตั้งค่า
style
เป็นnull
เมื่อไม่มีการใช้เลเยอร์แล้ว
หากต้องการจัดรูปแบบรูปหลายเหลี่ยมในเลเยอร์องค์ประกอบสถานที่ ให้ทำตามขั้นตอนต่อไปนี้
- หากยังไม่ได้ดำเนินการ ให้ทำตามขั้นตอนในเริ่มต้นใช้งานเพื่อสร้างรหัสแผนที่และรูปแบบแผนที่ใหม่ อย่าลืมเปิดใช้เลเยอร์องค์ประกอบสถานที่
รับการอ้างอิงเลเยอร์องค์ประกอบสถานที่เมื่อแผนที่เริ่มต้น
featureLayer = map.getFeatureLayer("LOCALITY");
สร้างคําจํากัดความของสไตล์ประเภท
google.maps.FeatureStyleFunction
ตั้งค่าพร็อพเพอร์ตี้
style
ในเลเยอร์ฟีเจอร์เป็นFeatureStyleFunction
ตัวอย่างต่อไปนี้แสดงการกำหนดฟังก์ชันเพื่อใช้รูปแบบกับgoogle.maps.Feature
ที่มีรหัสสถานที่ตรงกันเท่านั้นTypeScript
// Define a style with purple fill and border. //@ts-ignore const featureStyleOptions: google.maps.FeatureStyleOptions = { strokeColor: '#810FCB', strokeOpacity: 1.0, strokeWeight: 3.0, fillColor: '#810FCB', fillOpacity: 0.5 }; // Apply the style to a single boundary. //@ts-ignore featureLayer.style = (options: { feature: { placeId: string; }; }) => { if (options.feature.placeId == 'ChIJ0zQtYiWsVHkRk8lRoB1RNPo') { // Hana, HI return featureStyleOptions; } };
JavaScript
// Define a style with purple fill and border. //@ts-ignore const featureStyleOptions = { strokeColor: "#810FCB", strokeOpacity: 1.0, strokeWeight: 3.0, fillColor: "#810FCB", fillOpacity: 0.5, }; // Apply the style to a single boundary. //@ts-ignore featureLayer.style = (options) => { if (options.feature.placeId == "ChIJ0zQtYiWsVHkRk8lRoB1RNPo") { // Hana, HI return featureStyleOptions; } };
หากไม่พบรหัสสถานที่ที่ระบุหรือไม่ตรงกับประเภทองค์ประกอบที่เลือก ระบบจะไม่ใช้สไตล์ เช่น การพยายามจัดสไตล์เลเยอร์ POSTAL_CODE
ที่ตรงกับรหัสสถานที่สำหรับ "นิวยอร์กซิตี" จะไม่ส่งผลต่อการใช้สไตล์
นำการจัดสไตล์ออกจากเลเยอร์
หากต้องการนำการจัดสไตล์ออกจากเลเยอร์ ให้ตั้งค่า style
เป็น null
featureLayer.style = null;
ค้นหารหัสสถานที่เพื่อกําหนดเป้าหมายฟีเจอร์
วิธีรับรหัสสถานที่สำหรับภูมิภาค
- ใช้ Places API และการจัดรหัสพิกัดภูมิศาสตร์เพื่อค้นหาภูมิภาคตามชื่อ และรับรหัสสถานที่สำหรับภูมิภาคภายในขอบเขตที่ระบุ
- รับข้อมูลจากเหตุการณ์การคลิก ซึ่งจะแสดงองค์ประกอบที่สอดคล้องกับภูมิภาคที่คลิก ซึ่งจะให้สิทธิ์เข้าถึงรหัสสถานที่ ชื่อที่แสดง และหมวดหมู่ประเภทองค์ประกอบ
ความครอบคลุมจะแตกต่างกันไปตามภูมิภาค ดูรายละเอียดได้ที่ความครอบคลุมของขอบเขต Google
ชื่อทางภูมิศาสตร์มีให้บริการจากแหล่งที่มาหลายแห่ง เช่น คณะกรรมการชื่อทางภูมิศาสตร์ของ USGS และไฟล์สารานุกรมภูมิศาสตร์ของสหรัฐอเมริกา
โค้ดตัวอย่างที่สมบูรณ์
TypeScript
let map: google.maps.Map; //@ts-ignore let featureLayer; async function initMap() { // Request needed libraries. const { Map } = await google.maps.importLibrary("maps") as google.maps.MapsLibrary; map = new Map(document.getElementById('map') as HTMLElement, { center: { lat: 20.773, lng: -156.01 }, // Hana, HI zoom: 12, // In the cloud console, configure this Map ID with a style that enables the // "Locality" feature layer. mapId: 'a3efe1c035bad51b', // <YOUR_MAP_ID_HERE>, }); //@ts-ignore featureLayer = map.getFeatureLayer('LOCALITY'); // Define a style with purple fill and border. //@ts-ignore const featureStyleOptions: google.maps.FeatureStyleOptions = { strokeColor: '#810FCB', strokeOpacity: 1.0, strokeWeight: 3.0, fillColor: '#810FCB', fillOpacity: 0.5 }; // Apply the style to a single boundary. //@ts-ignore featureLayer.style = (options: { feature: { placeId: string; }; }) => { if (options.feature.placeId == 'ChIJ0zQtYiWsVHkRk8lRoB1RNPo') { // Hana, HI return featureStyleOptions; } }; } initMap();
JavaScript
let map; //@ts-ignore let featureLayer; async function initMap() { // Request needed libraries. const { Map } = await google.maps.importLibrary("maps"); map = new Map(document.getElementById("map"), { center: { lat: 20.773, lng: -156.01 }, // Hana, HI zoom: 12, // In the cloud console, configure this Map ID with a style that enables the // "Locality" feature layer. mapId: "a3efe1c035bad51b", // <YOUR_MAP_ID_HERE>, }); //@ts-ignore featureLayer = map.getFeatureLayer("LOCALITY"); // Define a style with purple fill and border. //@ts-ignore const featureStyleOptions = { strokeColor: "#810FCB", strokeOpacity: 1.0, strokeWeight: 3.0, fillColor: "#810FCB", fillOpacity: 0.5, }; // Apply the style to a single boundary. //@ts-ignore featureLayer.style = (options) => { if (options.feature.placeId == "ChIJ0zQtYiWsVHkRk8lRoB1RNPo") { // Hana, HI return featureStyleOptions; } }; } initMap();
CSS
/* * Always set the map height explicitly to define the size of the div element * that contains the map. */ #map { height: 100%; } /* * Optional: Makes the sample page fill the window. */ html, body { height: 100%; margin: 0; padding: 0; }
HTML
<html> <head> <title>Boundaries Simple</title> <link rel="stylesheet" type="text/css" href="./style.css" /> <script type="module" src="./index.js"></script> </head> <body> <div id="map"></div> <!-- prettier-ignore --> <script>(g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))}) ({key: "AIzaSyB41DRUbKWJHPxaFjMAwdrzWzbVKartNGg", v: "weekly"});</script> </body> </html>