ภาพรวม
การใช้แผนที่บนหน้าเว็บอาจต้องใช้ตัวเลือกที่เฉพาะเจาะจงเพื่อควบคุมวิธีที่ผู้ใช้โต้ตอบกับแผนที่ในการซูมและเลื่อน ตัวเลือกเหล่านี้ เช่น gestureHandling
, minZoom
, maxZoom
และ restriction
จะกำหนดไว้ในอินเทอร์เฟซ MapOptions
ลักษณะการทำงานเริ่มต้น
แผนที่ต่อไปนี้แสดงลักษณะการทํางานเริ่มต้นของการโต้ตอบกับแผนที่ที่มีการสร้างอินสแตนซ์แผนที่โดยกําหนดเฉพาะตัวเลือก zoom
และ center
โค้ดของแผนที่นี้อยู่ด้านล่าง
TypeScript
new google.maps.Map(document.getElementById("map")!, { zoom, center, });
JavaScript
new google.maps.Map(document.getElementById("map"), { zoom, center, });
การควบคุมการจัดการท่าทางสัมผัส
เมื่อผู้ใช้เลื่อนหน้าเว็บที่มีแผนที่ การเลื่อนอาจทำให้แผนที่ซูมโดยไม่ตั้งใจ คุณควบคุมลักษณะการทำงานนี้ได้โดยใช้ตัวเลือกแผนที่ gestureHandling
gestureHandling: cooperative
แผนที่ด้านล่างใช้ตัวเลือกgestureHandlingที่ตั้งค่าเป็น cooperative
ซึ่งช่วยให้ผู้ใช้เลื่อนหน้าเว็บได้ตามปกติโดยไม่ต้องซูมหรือเลื่อนแผนที่ ผู้ใช้สามารถซูมแผนที่ได้โดยคลิกตัวควบคุมการซูม นอกจากนี้ ยังซูมและเลื่อนแผนที่ได้ด้วยการใช้ 2 นิ้วบนแผนที่สำหรับอุปกรณ์หน้าจอสัมผัส
รหัสสำหรับแผนที่นี้อยู่ด้านล่าง
TypeScript
new google.maps.Map(document.getElementById("map")!, { zoom, center, gestureHandling: "cooperative", });
JavaScript
new google.maps.Map(document.getElementById("map"), { zoom, center, gestureHandling: "cooperative", });
การจัดการด้วยท่าทางสัมผัส: auto
แผนที่ที่ด้านบนของหน้าซึ่งไม่มีตัวเลือก gestureHandling
จะทำงานเหมือนกับแผนที่ก่อนหน้าที่มีการตั้งค่า gestureHandling เป็น cooperative
เนื่องจากแผนที่ทั้งหมดในหน้านี้อยู่ภายใน <iframe>
ค่า gestureHandling เริ่มต้น
auto
จะสลับระหว่าง greedy
และ cooperative
ขึ้นอยู่กับว่าแผนที่มีอยู่ใน <iframe>
หรือไม่
แผนที่อยู่ภายใน <iframe> |
ลักษณะการทำงาน |
---|---|
ใช่ | cooperative |
ไม่ | greedy |
gestureHandling: greedy
แผนที่ที่มีการตั้งค่า gestureHandling เป็น greedy
อยู่ด้านล่าง แผนที่นี้ตอบสนองต่อท่าทางสัมผัสการแตะและเหตุการณ์การเลื่อนทั้งหมด ซึ่งต่างจาก
cooperative
gestureHandling: none
นอกจากนี้ คุณยังตั้งค่าตัวเลือก gestureHandling เป็น none
เพื่อปิดใช้ท่าทางสัมผัสบนแผนที่ได้ด้วย
การปิดใช้งานการเลื่อนและซูม
หากต้องการปิดใช้ความสามารถในการเลื่อนและซูมแผนที่โดยสมบูรณ์ คุณต้องใส่ตัวเลือก 2 รายการ ได้แก่ gestureHandling และ zoomControl
TypeScript
new google.maps.Map(document.getElementById("map")!, { zoom, center, gestureHandling: "none", zoomControl: false, });
JavaScript
new google.maps.Map(document.getElementById("map"), { zoom, center, gestureHandling: "none", zoomControl: false, });
แผนที่ด้านล่างแสดงการใช้ gestureHandling และ zoomControl ร่วมกันในโค้ดด้านบน
การจำกัดขอบเขตและการซูมแผนที่
คุณอาจต้องการอนุญาตการควบคุมด้วยท่าทางสัมผัสและการซูม แต่จำกัดแผนที่ให้อยู่ภายในขอบเขตที่เฉพาะเจาะจงหรือการซูมขั้นต่ำและสูงสุด คุณอาจตั้งค่าตัวเลือกข้อจำกัด minZoom และ maxZoom เพื่อให้บรรลุเป้าหมายนี้ได้ โค้ดและแผนที่ต่อไปนี้แสดงตัวเลือกเหล่านี้
TypeScript
new google.maps.Map(document.getElementById("map")!, { zoom, center, minZoom: zoom - 3, maxZoom: zoom + 3, restriction: { latLngBounds: { north: -10, south: -40, east: 160, west: 100, }, }, });
JavaScript
new google.maps.Map(document.getElementById("map"), { zoom, center, minZoom: zoom - 3, maxZoom: zoom + 3, restriction: { latLngBounds: { north: -10, south: -40, east: 160, west: 100, }, }, });