OverlayView class
google.maps.OverlayView
class
คุณสามารถใช้คลาสนี้ได้หากต้องการแสดงออบเจ็กต์การวางซ้อนประเภทที่กำหนดเองบนแผนที่
รับค่าจากคลาสนี้โดยการตั้งค่าต้นแบบของการวางซ้อน: MyOverlay.prototype = new google.maps.OverlayView();
รับประกันว่าตัวสร้าง OverlayView
จะเป็นฟังก์ชันว่าง
คุณต้องใช้ 3 วิธี ได้แก่ onAdd()
, draw()
และ onRemove()
- ในเมธอด
onAdd()
คุณควรสร้างออบเจ็กต์ DOM และเพิ่มไว้ต่อท้ายเป็นรายการย่อยของแผง - คุณควรจัดตําแหน่งองค์ประกอบเหล่านี้ในเมธอด
draw()
- ในเมธอด
onRemove()
คุณควรนําออบเจ็กต์ออกจาก DOM
setMap()
ด้วยออบเจ็กต์ Map
ที่ถูกต้องเพื่อเรียกใช้เมธอด onAdd()
และ setMap(null)
เพื่อเรียกใช้เมธอด onRemove()
เรียกเมธอด setMap()
ได้ในตอนที่สร้างหรือเมื่อใดก็ได้หลังจากนั้นเมื่อต้องการให้แสดงการวางซ้อนอีกครั้งหลังจากนําออก จากนั้นระบบจะเรียกใช้เมธอด draw()
ทุกครั้งที่มีการเปลี่ยนแปลงพร็อพเพอร์ตี้แผนที่ที่อาจเปลี่ยนตําแหน่งขององค์ประกอบ เช่น การซูม การจัดกึ่งกลาง หรือประเภทแผนที่
คลาสนี้ขยายจาก MVCObject
เข้าถึงโดยโทรหา const {OverlayView} = await google.maps.importLibrary("maps")
หรือ const {OverlayView} = await google.maps.importLibrary("streetView")
โปรดดูไลบรารีใน Maps JavaScript API
ผู้ผลิต | |
---|---|
OverlayView |
OverlayView() พารามิเตอร์: ไม่มี
สร้าง OverlayView |
เมธอดแบบคงที่ | |
---|---|
preventMapHitsAndGesturesFrom |
preventMapHitsAndGesturesFrom(element) พารามิเตอร์:
ผลลัพธ์: ไม่มี
หยุดเหตุการณ์การคลิก การแตะ การลาก และการใช้ล้อเลื่อนบนองค์ประกอบไม่ให้ส่งไปยังแผนที่ ใช้เพื่อป้องกันการลากและซูมแผนที่ รวมถึงเหตุการณ์ "คลิก" ของแผนที่ |
preventMapHitsFrom |
preventMapHitsFrom(element) พารามิเตอร์:
ผลลัพธ์: ไม่มี
หยุดการคลิกหรือแตะองค์ประกอบไม่ให้แสดงบนแผนที่ ใช้เพื่อไม่ให้แผนที่ทริกเกอร์เหตุการณ์ "คลิก" |
เมธอด | |
---|---|
draw |
draw() พารามิเตอร์: ไม่มี
ผลลัพธ์: ไม่มี
ใช้เมธอดนี้เพื่อวาดหรืออัปเดตการวางซ้อน ใช้ตำแหน่งจาก projection.fromLatLngToDivPixel() เพื่อจัดตำแหน่งการวางซ้อนให้ถูกต้องเมื่อเทียบกับ MapPane ระบบจะเรียกใช้เมธอดนี้หลังจาก onAdd() และเรียกใช้เมื่อมีการเปลี่ยนแปลงการซูมหรือการจัดกึ่งกลาง เราไม่แนะนําให้ทํางานที่มีการคำนวณมากในวิธีการนี้ |
getMap |
getMap() พารามิเตอร์: ไม่มี
ผลลัพธ์:
Map|StreetViewPanorama |
getPanes |
getPanes() พารามิเตอร์: ไม่มี
ผลลัพธ์:
MapPanes|null แสดงผลแผงในการแสดงผล OverlayView นี้ ระบบจะไม่เริ่มต้นแผงจนกว่า API จะเรียกใช้ onAdd |
getProjection |
getProjection() พารามิเตอร์: ไม่มี
ผลลัพธ์:
MapCanvasProjection แสดงผลออบเจ็กต์ MapCanvasProjection ที่เชื่อมโยงกับ OverlayView นี้ ระบบจะไม่เริ่มต้นโปรเจ็กชันจนกว่า API จะเรียกใช้ onAdd |
onAdd |
onAdd() พารามิเตอร์: ไม่มี
ผลลัพธ์: ไม่มี
ใช้เมธอดนี้เพื่อเริ่มต้นองค์ประกอบ DOM การวางซ้อน ระบบจะเรียกใช้เมธอดนี้ 1 ครั้งหลังจากเรียกใช้ setMap() ด้วยแผนที่ที่ถูกต้อง เมื่อถึงขั้นตอนนี้ ระบบจะเริ่มต้นใช้งานแผงและการแสดงผลแล้ว |
onRemove |
onRemove() พารามิเตอร์: ไม่มี
ผลลัพธ์: ไม่มี
ใช้เมธอดนี้เพื่อนำองค์ประกอบออกจาก DOM ระบบจะเรียกใช้เมธอดนี้ 1 ครั้งหลังจากการเรียก setMap(null) |
setMap |
setMap(map) พารามิเตอร์:
ผลลัพธ์: ไม่มี
เพิ่มการวางซ้อนลงในแผนที่หรือภาพพาโนรามา |
รับค่ามา:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
MapPanes interface
google.maps.MapPanes
อินเทอร์เฟซ
พร็อพเพอร์ตี้ | |
---|---|
floatPane |
ประเภท:
Element แผงนี้มีหน้าต่างข้อมูล โดยจะอยู่เหนือการวางซ้อนแผนที่ทั้งหมด (แผง 4) |
mapPane |
ประเภท:
Element แผงนี้เป็นแผงที่อยู่ต่ำสุดและอยู่เหนือการ์ด แต่จะไม่ได้รับเหตุการณ์ DOM (แผง 0) |
markerLayer |
ประเภท:
Element แผงนี้มีเครื่องหมาย แต่จะไม่ได้รับเหตุการณ์ DOM (แผง 2) |
overlayLayer |
ประเภท:
Element แผงนี้มีเส้นประกอบ รูปหลายเหลี่ยม การวางซ้อนพื้นดิน และการวางซ้อนเลเยอร์ไทล์ แต่จะไม่ได้รับเหตุการณ์ DOM (แผง 1) |
overlayMouseTarget |
ประเภท:
Element แผงนี้มีองค์ประกอบที่รับเหตุการณ์ DOM (แผง 3) |
MapCanvasProjection อินเทอร์เฟซ
google.maps.MapCanvasProjection
อินเทอร์เฟซ
ออบเจ็กต์นี้จะพร้อมใช้งานสําหรับ OverlayView
จากภายในเมธอด draw เราไม่รับประกันว่าจะมีการเริ่มต้นจนกว่าจะมีการเรียกใช้การวาด
เมธอด | |
---|---|
fromContainerPixelToLatLng |
fromContainerPixelToLatLng(pixel[, noClampNoWrap]) พารามิเตอร์:
ผลลัพธ์:
LatLng|null คํานวณพิกัดทางภูมิศาสตร์จากพิกัดพิกเซลในคอนเทนเนอร์ของแผนที่ |
fromDivPixelToLatLng |
fromDivPixelToLatLng(pixel[, noClampNoWrap]) พารามิเตอร์:
ผลลัพธ์:
LatLng|null คํานวณพิกัดทางภูมิศาสตร์จากพิกัดพิกเซลใน div ที่เก็บแผนที่ที่ลากได้ |
fromLatLngToContainerPixel |
fromLatLngToContainerPixel(latLng) พารามิเตอร์:
ผลลัพธ์:
Point|null คํานวณพิกัดพิกเซลของสถานที่ตั้งทางภูมิศาสตร์ที่ระบุในองค์ประกอบคอนเทนเนอร์ของแผนที่ |
fromLatLngToDivPixel |
fromLatLngToDivPixel(latLng) พารามิเตอร์:
ผลลัพธ์:
Point|null คํานวณพิกัดพิกเซลของสถานที่ตั้งทางภูมิศาสตร์ที่ระบุในองค์ประกอบ DOM ที่เก็บแผนที่ที่ลากได้ |
getVisibleRegion |
getVisibleRegion() พารามิเตอร์: ไม่มี
ผลลัพธ์:
VisibleRegion|null ภูมิภาคที่มองเห็นได้ของแผนที่ แสดงผล null หากแผนที่ไม่มีขนาด แสดงค่า null หาก OverlayView อยู่ใน StreetViewPanorama |
getWorldWidth |
getWorldWidth() พารามิเตอร์: ไม่มี
ผลลัพธ์:
number ความกว้างของโลกเป็นพิกเซลในระดับการซูมปัจจุบัน สําหรับการฉายที่มีมุมการนําทาง 90 หรือ 270 องศา ค่านี้จะสอดคล้องกับช่วงพิกเซลในแกน Y |