DOM elements

ClassView คลาส

google.maps.OverlayView คลาส

คุณใช้คลาสนี้ได้หากต้องการแสดงออบเจ็กต์การวางซ้อนประเภทที่กําหนดเองบนแผนที่

รับค่าจากชั้นเรียนนี้โดยการตั้งค่าต้นแบบของการวางซ้อน: 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() เพื่อวางตําแหน่งโฆษณาซ้อนทับให้สัมพันธ์กับ MapPanes อย่างถูกต้อง เมธอดนี้จะเรียกใช้หลังจาก onAdd() และเรียกเมื่อเปลี่ยนการซูมหรือตรงกลาง เราไม่แนะนําให้ทําการคํานวณราคาแพงด้วยวิธีนี้
getMap
getMap()
พารามิเตอร์: ไม่มี
แสดงผลค่า:  Map|StreetViewPanorama
getPanes
getPanes()
พารามิเตอร์: ไม่มี
แสดงผลค่า:  MapPanes|null
แสดงผลแผงที่แสดงผล RenderView นี้ได้ แผงต่างๆ จะไม่เริ่มต้นจนกว่า API จะเรียกใช้ onAdd
getProjection
getProjection()
พารามิเตอร์: ไม่มี
แสดงผลค่า:  MapCanvasProjection
แสดงผลออบเจ็กต์ MapCanvasProjection ที่เชื่อมโยงกับ OverlayView นี้ การคาดการณ์ไม่เริ่มต้นจนกว่า API จะเรียกใช้ onAdd
onAdd
onAdd()
พารามิเตอร์: ไม่มี
ค่าการแสดงผล: ไม่มี
ใช้วิธีการนี้เพื่อเริ่มต้นองค์ประกอบ DOM การวางซ้อน ระบบจะเรียกใช้เมธอดนี้ครั้งเดียวหลังจากเรียก setMap() ด้วยแผนที่ที่ถูกต้อง เมื่อถึงจุดนี้ แผงและการคาดการณ์จะเริ่มขึ้น
onRemove
onRemove()
พารามิเตอร์: ไม่มี
ค่าการแสดงผล: ไม่มี
ใช้วิธีการนี้เพื่อนําองค์ประกอบออกจาก DOM ระบบจะเรียกเมธอดนี้หลังจากเรียกใช้ setMap(Null)
setMap
setMap(map)
พารามิเตอร์: 
  • mapMap|StreetViewPanorama optional แผนที่หรือพาโนรามา หากเป็น null ระบบจะนําเลเยอร์ออก
ค่าการแสดงผล: ไม่มี
เพิ่มการวางซ้อนลงในแผนที่หรือพาโนรามา
รับค่า: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

อินเทอร์เฟซ MapPanes

อินเทอร์เฟซ 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 จากภายในเมธอดการวาด ไม่มีการรับประกันว่าจะเริ่มต้นทํางานจนกว่าจะมีการเรียกภาพวาด

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 หาก โฆษณาซ้อนทับView อยู่ใน StreetViewพาโนรามา
getWorldWidth
getWorldWidth()
พารามิเตอร์: ไม่มี
แสดงผลค่า:  number
ความกว้างของโลกเป็นพิกเซลในระดับการซูมปัจจุบัน สําหรับฉายภาพที่มีมุมส่วนหัว 90 หรือ 270 องศาจะสอดคล้องกับช่วงพิกเซลในแกน Y