Advanced Markers

AdvancedMarkerElement class

google.maps.marker.AdvancedMarkerElement ชั้นเรียน

แสดงตำแหน่งบนแผนที่ โปรดทราบว่าต้องตั้งค่า position เพื่อให้ AdvancedMarkerElement แสดง

หมายเหตุ: การใช้งานเป็นคอมโพเนนต์ของเว็บ (เช่น การใช้องค์ประกอบ HTML ที่กำหนดเอง <gmp-advanced-marker>) จะใช้ได้ในช่อง v=beta เท่านั้น

องค์ประกอบที่กำหนดเอง:
<gmp-advanced-marker position="lat,lng" title="string"></gmp-advanced-marker>

ชั้นเรียนนี้ขยายเวลา HTMLElement

คลาสนี้ใช้ AdvancedMarkerElementOptions

เข้าถึงได้โดยโทรไปที่ const {AdvancedMarkerElement} = await google.maps.importLibrary("marker")
ดูไลบรารีใน Maps JavaScript API

ผู้ผลิต
AdvancedMarkerElement	AdvancedMarkerElement([options]) พารามิเตอร์:  options:  AdvancedMarkerElementOptions optional สร้าง AdvancedMarkerElement โดยมีตัวเลือกที่ระบุ หากระบุแผนที่ ระบบจะเพิ่ม AdvancedMarkerElement ลงในแผนที่เมื่อสร้าง

พร็อพเพอร์ตี้
collisionBehavior	ประเภท:  CollisionBehavior optional ดูAdvancedMarkerElementOptions.collisionBehavior
content	ประเภท:  Node optional ดูAdvancedMarkerElementOptions.content
element	ประเภท:  HTMLElement ช่องนี้เป็นแบบอ่านอย่างเดียว องค์ประกอบ DOM ที่สนับสนุนมุมมอง
gmpClickable	หมายเหตุ: ใช้ได้เฉพาะในช่อง v=beta เท่านั้น ประเภท:  boolean optional ดูAdvancedMarkerElementOptions.gmpClickable
gmpDraggable	ประเภท:  boolean optional ดูAdvancedMarkerElementOptions.gmpDraggable
map	ประเภท:  Map optional ดูAdvancedMarkerElementOptions.map
position	ประเภท:  LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional ดูAdvancedMarkerElementOptions.position แอตทริบิวต์ HTML: <gmp-advanced-marker position="lat,lng"></gmp-advanced-marker> <gmp-advanced-marker position="lat,lng,altitude"></gmp-advanced-marker>
title	ประเภท:  string ดูAdvancedMarkerElementOptions.title แอตทริบิวต์ HTML: <gmp-advanced-marker title="string"></gmp-advanced-marker>
zIndex	ประเภท:  number optional ดูAdvancedMarkerElementOptions.zIndex

เมธอด
addEventListener	หมายเหตุ: ใช้ได้เฉพาะในช่อง v=beta เท่านั้น addEventListener(type, listener[, options]) พารามิเตอร์:  type:  string สตริงที่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ซึ่งแสดงถึงประเภทเหตุการณ์ที่จะรับฟัง listener:  EventListener|EventListenerObject ออบเจ็กต์ที่ได้รับการแจ้งเตือน ซึ่งต้องเป็นฟังก์ชันหรือออบเจ็กต์ที่มีเมธอด handleEvent options:  boolean|AddEventListenerOptions optional ดูตัวเลือก เหตุการณ์ที่กำหนดเองรองรับเฉพาะ capture และ passive ค่าที่ส่งคืน:  void ตั้งค่าฟังก์ชันที่จะเรียกใช้เมื่อใดก็ตามที่มีการส่งเหตุการณ์ที่ระบุไปยังเป้าหมาย ดู addEventListener
addListener	addListener(eventName, handler) พารามิเตอร์:  eventName:  string เหตุการณ์ที่สังเกตได้ handler:  Function ฟังก์ชันเพื่อจัดการเหตุการณ์ ค่าที่ส่งคืน:  MapsEventListener Listener เหตุการณ์ที่ได้ เพิ่มฟังก์ชัน Listener ที่ระบุลงในชื่อเหตุการณ์ที่ระบุในระบบการบันทึกเหตุการณ์ของ Maps
removeEventListener	หมายเหตุ: ใช้ได้เฉพาะในช่อง v=beta เท่านั้น removeEventListener(type, listener[, options]) พารามิเตอร์:  type:  string สตริงที่ระบุประเภทของเหตุการณ์ที่จะนำเครื่องมือฟังเหตุการณ์ออก listener:  EventListener|EventListenerObject Listener เหตุการณ์ของตัวแฮนเดิลเหตุการณ์ที่จะนำออกจากเป้าหมายเหตุการณ์ options:  boolean|EventListenerOptions optional ดูตัวเลือก ค่าที่ส่งคืน:  void นำ Listener เหตุการณ์ที่ลงทะเบียนไว้ก่อนหน้านี้ด้วย addEventListener ออกจากเป้าหมาย ดู removeEventListener

กิจกรรม
click	function(event) อาร์กิวเมนต์:  event:  MapMouseEvent เหตุการณ์นี้จะเริ่มทำงานเมื่อมีการคลิกองค์ประกอบ AdvancedMarkerElement ใช้กับ addEventListener() ไม่ได้ (ใช้ gmp-click แทน)
drag	function(event) อาร์กิวเมนต์:  event:  MapMouseEvent ระบบจะทริกเกอร์เหตุการณ์นี้ซ้ำๆ ขณะที่ผู้ใช้ลาก AdvancedMarkerElement ใช้กับ addEventListener() ไม่ได้
dragend	function(event) อาร์กิวเมนต์:  event:  MapMouseEvent เหตุการณ์นี้จะเริ่มทำงานเมื่อผู้ใช้หยุดลาก AdvancedMarkerElement ใช้กับ addEventListener() ไม่ได้
dragstart	function(event) อาร์กิวเมนต์:  event:  MapMouseEvent เหตุการณ์นี้จะเริ่มทำงานเมื่อผู้ใช้เริ่มลาก AdvancedMarkerElement ใช้กับ addEventListener() ไม่ได้
gmp-click	หมายเหตุ: ใช้ได้เฉพาะในช่อง v=beta เท่านั้น function(event) อาร์กิวเมนต์:  event:  AdvancedMarkerClickEvent เหตุการณ์นี้จะเริ่มทำงานเมื่อมีการคลิกองค์ประกอบ AdvancedMarkerElement ควรใช้กับ addEventListener() (แทน addListener())

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

google.maps.marker.AdvancedMarkerElementOptions อินเทอร์เฟซ

ตัวเลือกในการสร้าง AdvancedMarkerElement

พร็อพเพอร์ตี้
collisionBehavior optional	ประเภท:  CollisionBehavior optional การแจงนับที่ระบุลักษณะการทำงานของ AdvancedMarkerElement เมื่อซ้อนทับกับ AdvancedMarkerElement อื่นหรือกับป้ายกำกับแผนที่ฐานบนแผนที่เวกเตอร์ หมายเหตุ: การซ้อนทับของ AdvancedMarkerElement กับ AdvancedMarkerElement จะใช้ได้ทั้งในแผนที่แบบแรสเตอร์และเวกเตอร์ แต่การซ้อนทับของ AdvancedMarkerElement กับป้ายกำกับของแผนที่ฐานจะใช้ได้เฉพาะในแผนที่เวกเตอร์
content optional	ประเภท:  Node optional ค่าเริ่มต้น: PinElement.element องค์ประกอบ DOM ที่สนับสนุนภาพของ AdvancedMarkerElement หมายเหตุ: AdvancedMarkerElement ไม่ได้โคลนองค์ประกอบ DOM ที่ส่งเข้ามา เมื่อส่งองค์ประกอบ DOM ไปยัง AdvancedMarkerElement แล้ว การส่งองค์ประกอบ DOM เดียวกันไปยัง AdvancedMarkerElement อื่นจะย้ายองค์ประกอบ DOM และทำให้ AdvancedMarkerElement ก่อนหน้าดูว่างเปล่า
gmpClickable optional	หมายเหตุ: ใช้ได้เฉพาะในช่อง v=beta เท่านั้น ประเภท:  boolean optional ค่าเริ่มต้น: false หาก true AdvancedMarkerElement จะคลิกได้และทริกเกอร์เหตุการณ์ gmp-click และจะโต้ตอบได้เพื่อวัตถุประสงค์ในการช่วยเหลือพิเศษ (เช่น อนุญาตการนำทางด้วยแป้นพิมพ์ผ่านปุ่มลูกศร)
gmpDraggable optional	ประเภท:  boolean optional ค่าเริ่มต้น: false หาก true คุณจะลาก AdvancedMarkerElement ได้ หมายเหตุ: AdvancedMarkerElement ที่มีระดับความสูงจะลากไม่ได้
map optional	ประเภท:  Map optional แผนที่ที่จะแสดง AdvancedMarkerElement ต้องมีแผนที่เพื่อแสดง AdvancedMarkerElement และสามารถระบุได้โดยการตั้งค่า AdvancedMarkerElement.map หากไม่ได้ระบุไว้ในระหว่างการก่อสร้าง
position optional	ประเภท:  LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional ตั้งค่าตำแหน่งของ AdvancedMarkerElement AdvancedMarkerElement อาจสร้างขึ้นโดยไม่มีตำแหน่ง แต่จะไม่แสดงจนกว่าจะมีการระบุตำแหน่ง เช่น โดยการดำเนินการหรือตัวเลือกของผู้ใช้ AdvancedMarkerElement สามารถระบุตำแหน่งได้โดยการตั้งค่า AdvancedMarkerElement.position หากไม่ได้ระบุไว้ในตอนสร้าง หมายเหตุ: AdvancedMarkerElement ที่มีระดับความสูงรองรับเฉพาะในแผนที่เวกเตอร์
title optional	ประเภท:  string optional ข้อความเมื่อวางเมาส์ หากระบุไว้ ระบบจะเพิ่มข้อความการช่วยเหลือพิเศษ (เช่น สำหรับใช้กับโปรแกรมอ่านหน้าจอ) ลงใน AdvancedMarkerElement พร้อมค่าที่ระบุ
zIndex optional	ประเภท:  number optional AdvancedMarkerElement ทั้งหมดจะแสดงบนแผนที่ตามลำดับ zIndex โดยค่าที่สูงกว่าจะแสดงอยู่หน้า AdvancedMarkerElement ที่มีค่าต่ำกว่า โดยค่าเริ่มต้น AdvancedMarkerElement จะแสดงตามตำแหน่งแนวตั้งบนหน้าจอ โดย AdvancedMarkerElement ที่อยู่ด้านล่างจะปรากฏอยู่หน้า AdvancedMarkerElement ที่อยู่ด้านบนของหน้าจอ โปรดทราบว่าระบบยังใช้ zIndex เพื่อช่วยกำหนดลำดับความสำคัญที่สัมพันธ์กันระหว่างCollisionBehavior.OPTIONAL_AND_HIDES_LOWER_PRIORITYเครื่องหมายขั้นสูงด้วย ค่า zIndex ที่สูงขึ้นหมายถึงลำดับความสำคัญที่สูงขึ้น

AdvancedMarkerClickEvent class

google.maps.marker.AdvancedMarkerClickEvent ชั้นเรียน

หมายเหตุ: ใช้ได้เฉพาะในช่อง v=beta เท่านั้น

เหตุการณ์นี้สร้างขึ้นจากการคลิกเครื่องหมายขั้นสูง เข้าถึงตำแหน่งของเครื่องหมายด้วย event.target.position

ชั้นเรียนนี้ขยายเวลา Event

เข้าถึงได้โดยโทรไปที่ const {AdvancedMarkerClickEvent} = await google.maps.importLibrary("marker")
ดูไลบรารีใน Maps JavaScript API

PinElement class

google.maps.marker.PinElement ชั้นเรียน

PinElement แสดงถึงองค์ประกอบ DOM ที่ประกอบด้วยรูปร่างและอักขระ รูปร่างมีสไตล์บอลลูนเหมือนกับที่เห็นใน AdvancedMarkerElement เริ่มต้น Glyph เป็นองค์ประกอบ DOM ที่ไม่บังคับซึ่งแสดงในรูปทรงบอลลูน PinElementอาจมีสัดส่วนภาพที่แตกต่างกันไปตามPinElement.scale

หมายเหตุ: ระบบยังไม่รองรับการใช้งานเป็นคอมโพเนนต์บนเว็บ (เช่น การใช้งานเป็นคลาสย่อย HTMLElement หรือผ่าน HTML)

ชั้นเรียนนี้ขยายเวลา HTMLElement

คลาสนี้ใช้ PinElementOptions

เข้าถึงได้โดยโทรไปที่ const {PinElement} = await google.maps.importLibrary("marker")
ดูไลบรารีใน Maps JavaScript API

ผู้ผลิต
PinElement	PinElement([options]) พารามิเตอร์:  options:  PinElementOptions optional

พร็อพเพอร์ตี้
background	ประเภท:  string optional ดูPinElementOptions.background
borderColor	ประเภท:  string optional ดูPinElementOptions.borderColor
element	ประเภท:  HTMLElement ช่องนี้เป็นแบบอ่านอย่างเดียว องค์ประกอบ DOM ที่สนับสนุนมุมมอง
glyph	ประเภท:  string|Element|URL optional ดูPinElementOptions.glyph
glyphColor	ประเภท:  string optional ดูPinElementOptions.glyphColor
scale	ประเภท:  number optional ดูPinElementOptions.scale

เมธอด
addEventListener	หมายเหตุ: ใช้ได้เฉพาะในช่อง v=beta เท่านั้น addEventListener(type, listener[, options]) พารามิเตอร์:  type:  string listener:  EventListener|EventListenerObject options:  boolean|AddEventListenerOptions optional ค่าที่ส่งคืน:  void ฟังก์ชันนี้ยังไม่พร้อมใช้งาน
removeEventListener	หมายเหตุ: ใช้ได้เฉพาะในช่อง v=beta เท่านั้น removeEventListener(type, listener[, options]) พารามิเตอร์:  type:  string สตริงที่ระบุประเภทของเหตุการณ์ที่จะนำเครื่องมือฟังเหตุการณ์ออก listener:  EventListener|EventListenerObject Listener เหตุการณ์ของตัวแฮนเดิลเหตุการณ์ที่จะนำออกจากเป้าหมายเหตุการณ์ options:  boolean|EventListenerOptions optional ดูตัวเลือก ค่าที่ส่งคืน:  void นำ Listener เหตุการณ์ที่ลงทะเบียนไว้ก่อนหน้านี้ด้วย addEventListener ออกจากเป้าหมาย ดู removeEventListener

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

google.maps.marker.PinElementOptions อินเทอร์เฟซ

ตัวเลือกสำหรับการสร้าง PinElement

พร็อพเพอร์ตี้
background optional	ประเภท:  string optional สีพื้นหลังของรูปร่างหมุด รองรับค่าสี CSS ทั้งหมด
borderColor optional	ประเภท:  string optional สีเส้นขอบของรูปร่างหมุด รองรับค่าสี CSS ทั้งหมด
glyph optional	ประเภท:  string|Element|URL optional องค์ประกอบ DOM ที่แสดงในหมุด
glyphColor optional	ประเภท:  string optional สีของสัญลักษณ์ รองรับค่าสี CSS ทั้งหมด
scale optional	ประเภท:  number optional ค่าเริ่มต้น: 1 ขนาดของหมุด