DOM elements

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)
พารามิเตอร์: 
  • mapMap|StreetViewPanorama optional แผนที่หรือภาพพาโนรามา หากเป็น null ระบบจะนำเลเยอร์ออก
ผลลัพธ์: ไม่มี
เพิ่มการวางซ้อนลงในแผนที่หรือภาพพาโนรามา
รับค่ามา: 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])
พารามิเตอร์: 
  • pixelPoint optional
  • noClampNoWrapboolean optional
ผลลัพธ์:  LatLng|null
คํานวณพิกัดทางภูมิศาสตร์จากพิกัดพิกเซลในคอนเทนเนอร์ของแผนที่
fromDivPixelToLatLng
fromDivPixelToLatLng(pixel[, noClampNoWrap])
พารามิเตอร์: 
  • pixelPoint optional
  • noClampNoWrapboolean optional
ผลลัพธ์:  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