คลาส OverlayView
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แสดงแผงที่สามารถแสดง OverlayView นี้ หน้าต่างจะไม่เริ่มต้นจนกว่า API จะเรียกใช้ onAdd |
getProjection |
getProjection()พารามิเตอร์: ไม่มี
ค่าที่ส่งคืน:
MapCanvasProjectionแสดงผลออบเจ็กต์ MapCanvasProjection ที่เชื่อมโยงกับ OverlayView นี้ การฉายภาพจะไม่เริ่มต้นจนกว่า API จะเรียกใช้ onAdd |
onAdd |
onAdd()พารามิเตอร์: ไม่มี
ผลลัพธ์: ไม่มี
ใช้วิธีนี้เพื่อเริ่มต้นองค์ประกอบ DOM การวางซ้อน ระบบจะเรียกใช้เมธอดนี้ 1 ครั้งหลังจากเรียก setMap() ด้วยแผนที่ที่ถูกต้อง ในขั้นตอนนี้ หน้าต่างและการฉายภาพจะเริ่มต้น |
onRemove |
onRemove()พารามิเตอร์: ไม่มี
ผลลัพธ์: ไม่มี
ใช้วิธีนี้เพื่อนำองค์ประกอบออกจาก DOM ระบบจะเรียกใช้เมธอดนี้เมื่อติดตามการเรียก to setMap(null) |
setMap |
setMap(map)พารามิเตอร์:
ผลลัพธ์: ไม่มี
เพิ่มการวางซ้อนลงในแผนที่หรือพาโนรามา |
รับค่าเดิม:
addListener,
bindTo,
get,
notify,
set,
setValues,
unbind,
unbindAll
| |
อินเทอร์เฟซ MapPanes
อินเทอร์เฟซ
google.maps.MapPanes
พร็อพเพอร์ตี้ | |
|---|---|
floatPane |
ประเภท:
Elementช่องนี้มีหน้าต่างข้อมูล ซึ่งอยู่เหนือการวางซ้อนแผนที่ทั้งหมด (หน้า 4) |
mapPane |
ประเภท:
Elementบานหน้าต่างนี้เป็นช่องล่างสุดและอยู่เหนือการ์ด ไม่ได้รับเหตุการณ์ DOM (Pane 0) |
markerLayer |
ประเภท:
Elementช่องนี้มีเครื่องหมาย ไม่ได้รับเหตุการณ์ DOM (รูปที่ 2) |
overlayLayer |
ประเภท:
Elementช่องนี้ประกอบด้วยเส้นประกอบ รูปหลายเหลี่ยม การวางซ้อนพื้น และการวางซ้อนเลเยอร์ชิ้นส่วน ไม่ได้รับเหตุการณ์ DOM (รูปที่ 1) |
overlayMouseTarget |
ประเภท:
Elementแผงนี้มีองค์ประกอบที่ได้รับเหตุการณ์ DOM (หน้า 3) |
อินเทอร์เฟซ MapCanvasProjection
อินเทอร์เฟซ
google.maps.MapCanvasProjection
OverlayView จะใช้งานออบเจ็กต์นี้ได้จากภายในวิธีการวาด ไม่มีการรับประกันว่าจะเริ่มต้นจนกว่าจะเรียกใช้การวาด
วิธีการ | |
|---|---|
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 |