ประกาศด้านความปลอดภัย: เราตระหนักถึงปัญหาด้านความปลอดภัยที่อาจส่งผลกระทบต่อเว็บไซต์ที่ใช้ไลบรารีของบุคคลที่สามบางรายการ (รวมถึง polyfill.io) บางครั้งปัญหานี้อาจเปลี่ยนเส้นทางผู้เข้าชมออกจากเว็บไซต์ที่ตั้งใจไว้โดยที่เจ้าของเว็บไซต์ไม่ทราบหรือไม่อนุญาต ก่อนหน้านี้ตัวอย่าง JavaScript จำนวนมากของเรามีการประกาศสคริปต์ polyfill.io เราได้นำสิ่งนี้ออกจากตัวอย่างของเราแล้ว หากคุณใช้ตัวอย่าง JavaScript ที่มีการประกาศนี้ เราขอแนะนำให้นำการประกาศออก

หน้านี้ได้รับการแปลโดย Cloud Translation API

Marker (legacy)

คลาสมาร์กเกอร์

google.maps.Marker ชั้นเรียน

เลิกใช้งาน: เมื่อวันที่ 21 กุมภาพันธ์ 2024 เราจะเลิกใช้งาน google.maps.marker โปรดใช้ AdvancedMarkerElement แทน ในตอนนี้ยังไม่มีกำหนดการเลิกให้บริการ google.maps.marker แต่ขอแนะนำให้ใช้ AdvancedMarkerElement แทน google.maps.marker แม้ว่า google.maps.marker จะยังได้รับการแก้ไขข้อบกพร่องสำหรับการถดถอยครั้งใหญ่ต่อไป แต่ข้อบกพร่องที่มีอยู่แล้วใน google.maps.marker จะไม่ได้รับการแก้ไข เราจะแจ้งให้คุณทราบล่วงหน้าอย่างน้อย 12 เดือนก่อนที่การสนับสนุนจะสิ้นสุดลง โปรดดูรายละเอียดเพิ่มเติมที่ https://developers.google.com/maps/deprecations และดูคำแนะนำในการย้ายข้อมูลที่ https://developers.google.com/maps/documentation/javascript/advanced-markers/migration

ชั้นเรียนนี้ขยายระยะเวลาถึง MVCObject

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

ผู้ผลิต
`Marker`	`Marker([opts])` พารามิเตอร์: `opts`: `MarkerOptions optional` อาร์กิวเมนต์ตัวเลือกที่มีชื่อ สร้างเครื่องหมายโดยมีตัวเลือกที่ระบุไว้ หากมีการระบุแผนที่ ระบบจะเพิ่มเครื่องหมายลงในแผนที่เมื่อสร้าง โปรดทราบว่าจะต้องกำหนดตำแหน่งให้เครื่องหมายแสดง

ผู้ผลิต

Marker

Marker([opts])

พารามิเตอร์:

opts: MarkerOptions optional อาร์กิวเมนต์ตัวเลือกที่มีชื่อ

สร้างเครื่องหมายโดยมีตัวเลือกที่ระบุไว้ หากมีการระบุแผนที่ ระบบจะเพิ่มเครื่องหมายลงในแผนที่เมื่อสร้าง โปรดทราบว่าจะต้องกำหนดตำแหน่งให้เครื่องหมายแสดง

ค่าคงที่
`MAX_ZINDEX`	ดัชนีลำดับ Z เริ่มต้นสูงสุดที่ API จะกำหนดให้กับเครื่องหมาย คุณอาจตั้งค่าดัชนีลำดับ Z สูงขึ้นเพื่อให้เครื่องหมายแสดงอยู่ด้านหน้า

วิธีการ
`getAnimation`	`getAnimation()` พารามิเตอร์: ไม่มี ค่าที่ส่งคืน: `Animation\|null\|undefined` ดูภาพเคลื่อนไหวที่ทำงานอยู่
`getClickable`	`getClickable()` พารามิเตอร์: ไม่มี ผลลัพธ์: `boolean` จริง หากเครื่องหมายสามารถคลิกได้ ดูสถานะที่คลิกได้ของ `Marker`
`getCursor`	`getCursor()` พารามิเตอร์: ไม่มี ค่าที่ส่งคืน: `string\|null\|undefined` ดูประเภทเคอร์เซอร์ของเมาส์ที่แสดงเมื่อวางเมาส์เหนือ
`getDraggable`	`getDraggable()` พารามิเตอร์: ไม่มี ผลลัพธ์: `boolean` จริง หากลากเครื่องหมายได้ ดูสถานะที่ลากได้ของ `Marker`
`getIcon`	`getIcon()` พารามิเตอร์: ไม่มี ค่าที่ส่งคืน: `string\|Icon\|Symbol\|null\|undefined` ดาวน์โหลดไอคอน `Marker` ดู `MarkerOptions.icon`
`getLabel`	`getLabel()` พารามิเตอร์: ไม่มี ค่าที่ส่งคืน: `MarkerLabel\|string\|null\|undefined` รับป้ายกำกับของ `Marker` ดู `MarkerOptions.label`
`getMap`	`getMap()` พารามิเตอร์: ไม่มี ค่าที่ส่งคืน: `Map\|StreetViewPanorama` ดูแผนที่หรือพาโนรามาที่แสดงภาพ `Marker`
`getOpacity`	`getOpacity()` พารามิเตอร์: ไม่มี Return Value: `number\|null\|undefined` ตัวเลขระหว่าง 0.0 ถึง 1.0 รับความทึบแสงของ `Marker`
`getPosition`	`getPosition()` พารามิเตอร์: ไม่มี ค่าที่ส่งคืน: `LatLng\|null\|undefined` รับตำแหน่งของ `Marker`
`getShape`	`getShape()` พารามิเตอร์: ไม่มี ค่าที่ส่งคืน: `MarkerShape\|null\|undefined` รับรูปร่างของ `Marker` ที่ใช้สำหรับการโต้ตอบ โปรดดู`MarkerOptions.shape`และ`MarkerShape`
`getTitle`	`getTitle()` พารามิเตอร์: ไม่มี ค่าที่ส่งคืน: `string\|null\|undefined` รับชื่อของเคล็ดลับเครื่องมือ `Marker` ดู `MarkerOptions.title`
`getVisible`	`getVisible()` พารามิเตอร์: ไม่มี ผลลัพธ์: `boolean` จริง หากเครื่องหมายปรากฏ รับระดับการเข้าถึงของ `Marker`
`getZIndex`	`getZIndex()` พารามิเตอร์: ไม่มี ผลลัพธ์: `number\|null\|undefined` zดัชนีของเครื่องหมาย รับดัชนี z ของ `Marker` ดู `MarkerOptions.zIndex`
`setAnimation`	`setAnimation([animation])` พารามิเตอร์: `animation`: `Animation optional` ภาพเคลื่อนไหวที่จะเล่น ผลลัพธ์: ไม่มี เริ่มภาพเคลื่อนไหว ระบบจะยกเลิกการภาพเคลื่อนไหวที่ดำเนินอยู่ ภาพเคลื่อนไหวที่รองรับในปัจจุบันคือ `Animation.BOUNCE`, `Animation.DROP` การส่งผ่านใน `null` จะทำให้ภาพเคลื่อนไหวหยุดลง
`setClickable`	`setClickable(flag)` พารามิเตอร์: `flag`: `boolean` หากเป็น `true` จะสามารถคลิกเครื่องหมายได้ ผลลัพธ์: ไม่มี ตั้งค่าว่าจะให้ `Marker` คลิกได้หรือไม่
`setCursor`	`setCursor([cursor])` พารามิเตอร์: `cursor`: `string optional` ประเภทเคอร์เซอร์เมาส์ ผลลัพธ์: ไม่มี กำหนดประเภทเคอร์เซอร์ของเมาส์ที่แสดงเมื่อวางเมาส์เหนือ
`setDraggable`	`setDraggable(flag)` พารามิเตอร์: `flag`: `boolean optional` หากเป็น `true` คุณสามารถลากเครื่องหมายได้ ผลลัพธ์: ไม่มี ตั้งค่าว่าสามารถลาก `Marker` ได้ไหม
`setIcon`	`setIcon([icon])` พารามิเตอร์: `icon`: `string\|Icon\|Symbol optional` ผลลัพธ์: ไม่มี ตั้งค่าไอคอนสำหรับ `Marker` ดู `MarkerOptions.icon`
`setLabel`	`setLabel([label])` พารามิเตอร์: `label`: `string\|MarkerLabel optional` ป้ายกำกับสามารถเป็นสตริงอักขระหรือออบเจ็กต์ `MarkerLabel` ก็ได้ ผลลัพธ์: ไม่มี ติดป้ายกำกับสำหรับ `Marker` ดู `MarkerOptions.label`
`setMap`	`setMap(map)` พารามิเตอร์: `map`: `Map\|StreetViewPanorama` ผลลัพธ์: ไม่มี แสดงภาพ `Marker` บนแผนที่หรือพาโนรามาที่ระบุ หากแผนที่ได้รับการตั้งค่าเป็น `null` เครื่องหมายจะถูกลบออก
`setOpacity`	`setOpacity([opacity])` พารามิเตอร์: `opacity`: `number optional` ตัวเลขระหว่าง 0.0 โปร่งใส และ 1.0 ทึบ ผลลัพธ์: ไม่มี ตั้งค่าความทึบแสงของ `Marker`
`setOptions`	`setOptions(options)` พารามิเตอร์: `options`: `MarkerOptions` ผลลัพธ์: ไม่มี ตั้งค่าตัวเลือกสำหรับ `Marker`
`setPosition`	`setPosition([latlng])` พารามิเตอร์: `latlng`: `LatLng\|LatLngLiteral optional` ตำแหน่งใหม่ ผลลัพธ์: ไม่มี ตั้งค่าโพสต์สำหรับ `Marker`
`setShape`	`setShape([shape])` พารามิเตอร์: `shape`: `MarkerShape optional` ผลลัพธ์: ไม่มี กำหนดรูปร่างของ `Marker` ที่ใช้สำหรับการโต้ตอบ โปรดดู`MarkerOptions.shape`และ`MarkerShape`
`setTitle`	`setTitle([title])` พารามิเตอร์: `title`: `string optional` ผลลัพธ์: ไม่มี ตั้งชื่อเคล็ดลับเครื่องมือ `Marker` ดู `MarkerOptions.title`
`setVisible`	`setVisible(visible)` พารามิเตอร์: `visible`: `boolean` หากเป็น `true` เครื่องหมายจะปรากฏให้เห็น ผลลัพธ์: ไม่มี ตั้งค่าว่าจะให้ `Marker` แสดงหรือไม่
`setZIndex`	`setZIndex([zIndex])` พารามิเตอร์: `zIndex`: `number optional` ผลลัพธ์: ไม่มี ตั้งค่า zIndex ของ `Marker` ดู `MarkerOptions.zIndex`
รับค่าเดิม: `addListener`, `bindTo`, `get`, `notify`, `set`, `setValues`, `unbind`, `unbindAll`

กิจกรรม
`animation_changed`	`function()` อาร์กิวเมนต์: ไม่มี เหตุการณ์นี้จะเริ่มทำงานเมื่อพร็อพเพอร์ตี้ภาพเคลื่อนไหว `Marker` เปลี่ยนแปลง
`click`	`function(event)` อาร์กิวเมนต์: `event`: `MapMouseEvent` เหตุการณ์นี้จะเกิดขึ้นเมื่อคลิกไอคอน `Marker`
`clickable_changed`	`function()` อาร์กิวเมนต์: ไม่มี เหตุการณ์นี้จะเกิดขึ้นเมื่อพร็อพเพอร์ตี้ที่คลิกได้ของ `Marker` มีการเปลี่ยนแปลง
`contextmenu`	`function(event)` อาร์กิวเมนต์: `event`: `MapMouseEvent` เหตุการณ์นี้จะเกิดขึ้นเมื่อเหตุการณ์เมนูตามบริบทของ DOM เริ่มทำงานใน `Marker`
`cursor_changed`	`function()` อาร์กิวเมนต์: ไม่มี เหตุการณ์นี้จะเริ่มทำงานเมื่อพร็อพเพอร์ตี้ของเคอร์เซอร์ `Marker` เปลี่ยนแปลง
`dblclick`	`function(event)` อาร์กิวเมนต์: `event`: `MapMouseEvent` เหตุการณ์นี้จะเกิดขึ้นเมื่อดับเบิลคลิกไอคอน `Marker`
`drag`	`function(event)` อาร์กิวเมนต์: `event`: `MapMouseEvent` เหตุการณ์นี้จะเกิดขึ้นซ้ำๆ ขณะที่ผู้ใช้ลาก `Marker`
`dragend`	`function(event)` อาร์กิวเมนต์: `event`: `MapMouseEvent` เหตุการณ์นี้จะเกิดขึ้นเมื่อผู้ใช้หยุดลาก `Marker`
`draggable_changed`	`function()` อาร์กิวเมนต์: ไม่มี เหตุการณ์นี้จะเริ่มทำงานเมื่อพร็อพเพอร์ตี้ที่ลากได้ `Marker` มีการเปลี่ยนแปลง
`dragstart`	`function(event)` อาร์กิวเมนต์: `event`: `MapMouseEvent` เหตุการณ์นี้จะเกิดขึ้นเมื่อผู้ใช้เริ่มลาก `Marker`
`flat_changed`	`function()` อาร์กิวเมนต์: ไม่มี เหตุการณ์นี้จะเริ่มทำงานเมื่อพร็อพเพอร์ตี้แบบแฟลต `Marker` มีการเปลี่ยนแปลง
`icon_changed`	`function()` อาร์กิวเมนต์: ไม่มี เหตุการณ์นี้จะเกิดขึ้นเมื่อคุณสมบัติไอคอน `Marker` มีการเปลี่ยนแปลง
`mousedown`	`function(event)` อาร์กิวเมนต์: `event`: `MapMouseEvent` เหตุการณ์นี้เริ่มทำงานเนื่องจากเมาส์ดาวน์บน `Marker`
`mouseout`	`function(event)` อาร์กิวเมนต์: `event`: `MapMouseEvent` เหตุการณ์นี้จะเกิดขึ้นเมื่อเมาส์ออกจากพื้นที่ของไอคอน `Marker`
`mouseover`	`function(event)` อาร์กิวเมนต์: `event`: `MapMouseEvent` เหตุการณ์นี้จะเกิดขึ้นเมื่อเมาส์เข้าสู่พื้นที่ของไอคอน `Marker`
`mouseup`	`function(event)` อาร์กิวเมนต์: `event`: `MapMouseEvent` เหตุการณ์นี้เริ่มทำงานสำหรับเมาส์อัปใน `Marker`
`position_changed`	`function()` อาร์กิวเมนต์: ไม่มี เหตุการณ์นี้จะเกิดขึ้นเมื่อพร็อพเพอร์ตี้ตำแหน่ง `Marker` เปลี่ยนแปลง
`shape_changed`	`function()` อาร์กิวเมนต์: ไม่มี เหตุการณ์นี้จะเกิดขึ้นเมื่อคุณสมบัติรูปร่าง `Marker` เปลี่ยนแปลง
`title_changed`	`function()` อาร์กิวเมนต์: ไม่มี เหตุการณ์นี้จะเกิดขึ้นเมื่อพร็อพเพอร์ตี้ชื่อ `Marker` เปลี่ยนแปลง
`visible_changed`	`function()` อาร์กิวเมนต์: ไม่มี เหตุการณ์นี้จะเริ่มทำงานเมื่อพร็อพเพอร์ตี้ที่มองเห็นได้ `Marker` เปลี่ยนแปลง
`zindex_changed`	`function()` อาร์กิวเมนต์: ไม่มี เหตุการณ์นี้จะเริ่มทำงานเมื่อพร็อพเพอร์ตี้ zIndex `Marker` มีการเปลี่ยนแปลง
`rightclick`	เลิกใช้งาน: ใช้เหตุการณ์ `Marker.contextmenu` แทนเพื่อรองรับรูปแบบการใช้งาน เช่น การกด Control และคลิกใน macOS `function(event)` อาร์กิวเมนต์: `event`: `MapMouseEvent` เหตุการณ์นี้เริ่มทำงานเมื่อคลิกขวาที่ `Marker`

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

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

ออบเจ็กต์ MarkOptions ที่ใช้กำหนดคุณสมบัติที่สามารถตั้งค่าในมาร์คเกอร์ได้

พร็อพเพอร์ตี้
`anchorPoint optional`	ประเภท: `Point optional` ค่าออฟเซ็ตจากตำแหน่งของเครื่องหมายถึงปลายของ InfoWindow ที่ถูกเปิดโดยมีเครื่องหมายเป็น Anchor
`animation optional`	ประเภท: `Animation optional` ค่าเริ่มต้น: `null` ภาพเคลื่อนไหวที่จะเล่นเมื่อมีการเพิ่มตัวทำเครื่องหมายลงในแผนที่
`clickable optional`	ประเภท: `boolean optional` ค่าเริ่มต้น: `true` หากเป็น `true` เครื่องหมายจะได้รับเหตุการณ์เมาส์และเหตุการณ์การแตะ
`collisionBehavior optional`	เลิกใช้งาน: `collisionBehavior` เลิกใช้งานแล้วตั้งแต่เดือนกรกฎาคม 2023 โปรดใช้ `AdvancedMarkerElement.collisionBehavior` แทน ประกาศ: มีให้บริการเฉพาะในv=เวอร์ชันเบต้าเท่านั้น ประเภท: `string\|CollisionBehavior optional` ค่าเริ่มต้น: `null` ตั้งค่าพฤติกรรมการชนของเครื่องหมายบนแผนที่เวกเตอร์
`crossOnDrag optional`	ประเภท: `boolean optional` ค่าเริ่มต้น: `true` หากเป็น `false` ให้ปิดใช้งานกากบาทที่ปรากฏใต้เครื่องหมายเมื่อลาก
`cursor optional`	ประเภท: `string optional` ค่าเริ่มต้น: `pointer` ประเภทเคอร์เซอร์เมาส์ที่แสดงเมื่อวางเมาส์เหนือ
`draggable optional`	ประเภท: `boolean optional` ค่าเริ่มต้น: `false` หากเป็น `true` จะลากเครื่องหมายได้
`icon optional`	ประเภท: `string\|Icon\|Symbol optional` ไอคอนสำหรับเบื้องหน้า หากมีการระบุสตริง ระบบจะพิจารณาในรูปแบบ `Icon` ที่มีสตริงเป็น `url`
`label optional`	ประเภท: `string\|MarkerLabel optional` ค่าเริ่มต้น: `null` เพิ่มป้ายกำกับให้กับเครื่องหมาย ป้ายกำกับเครื่องหมายคือตัวอักษรหรือตัวเลขที่ปรากฏภายในเครื่องหมาย ป้ายกำกับอาจเป็นสตริงหรือออบเจ็กต์ `MarkerLabel` ก็ได้ หากระบุไว้และไม่ได้ใส่ `MarkerOptions.title` ระบบจะเพิ่มข้อความการช่วยเหลือพิเศษ (เช่น เพื่อใช้กับโปรแกรมอ่านหน้าจอ) ลงในเครื่องหมายพร้อมกับข้อความของป้ายกำกับที่ให้ไว้ โปรดทราบว่าปัจจุบัน `label` ใช้กับข้อความช่วยเหลือพิเศษสำหรับเครื่องหมายที่ไม่ได้รับการเพิ่มประสิทธิภาพเท่านั้น
`map optional`	ประเภท: `Map\|StreetViewPanorama optional` แผนที่ที่จะแสดงเครื่องหมาย ต้องมีแผนที่เพื่อแสดงเครื่องหมายและสามารถหา `Marker.setMap` ได้หากไม่ได้ระบุไว้ในการสร้างเครื่องหมาย
`opacity optional`	ประเภท: `number optional` ค่าเริ่มต้น: 1.0 ตัวเลขระหว่าง 0.0 โปร่งใส และ 1.0 ทึบ
`optimized optional`	ประเภท: `boolean optional` การเพิ่มประสิทธิภาพจะเพิ่มประสิทธิภาพด้วยการแสดงผลเครื่องหมายจำนวนมากเป็นองค์ประกอบแบบคงที่รายการเดียว ซึ่งจะเป็นประโยชน์ในกรณีที่ต้องใช้เครื่องหมายจำนวนมาก อ่านเพิ่มเติมเกี่ยวกับการเพิ่มประสิทธิภาพเครื่องหมาย
`position optional`	ประเภท: `LatLng\|LatLngLiteral optional` กำหนดตำแหน่งเครื่องหมาย เครื่องหมายอาจสร้างขึ้นแต่จะไม่แสดงจนกว่าจะมีการระบุตำแหน่ง เช่น จากการกระทำหรือทางเลือกของผู้ใช้ คุณระบุตำแหน่งเครื่องหมายได้ด้วย `Marker.setPosition` หากไม่ได้ระบุไว้ขณะสร้างเครื่องหมาย
`shape optional`	ประเภท: `MarkerShape optional` คำจำกัดความภูมิภาคของแผนที่รูปภาพที่ใช้สำหรับการลาก/คลิก
`title optional`	ประเภท: `string optional` ค่าเริ่มต้น: `undefined` ข้อความเมื่อวางเมาส์เหนือ หากมี ระบบจะเพิ่มข้อความการช่วยเหลือพิเศษ (เช่น เพื่อใช้กับโปรแกรมอ่านหน้าจอ) ลงในเครื่องหมายด้วยค่าที่ให้ไว้ โปรดทราบว่าปัจจุบัน `title` ใช้กับข้อความช่วยเหลือพิเศษสำหรับเครื่องหมายที่ไม่ได้รับการเพิ่มประสิทธิภาพเท่านั้น
`visible optional`	ประเภท: `boolean optional` ค่าเริ่มต้น: `true` หากเป็น `true` เครื่องหมายจะปรากฏให้เห็น
`zIndex optional`	ประเภท: `number optional` เครื่องหมายทั้งหมดจะแสดงบนแผนที่ตามลำดับ zIndex โดยค่าที่สูงกว่าจะแสดงอยู่ด้านหน้าของเครื่องหมายที่มีค่าต่ำกว่า โดยค่าเริ่มต้น เครื่องหมายจะแสดงตามตำแหน่งแนวตั้งบนหน้าจอ โดยแสดงเครื่องหมายอยู่ด้านหน้าของเครื่องหมายซึ่งอยู่ไกลออกไปบนหน้าจอ

ค่าคงที่ CollisionBehavior

ค่าคงที่ google.maps.CollisionBehavior

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

ค่าคงที่
`OPTIONAL_AND_HIDES_LOWER_PRIORITY`	แสดงเครื่องหมายเฉพาะในกรณีที่ไม่ซ้อนทับกับเครื่องหมายอื่นๆ หากตัวทำเครื่องหมาย 2 ตัวประเภทนี้จะทับซ้อนกัน ระบบจะแสดงตัวที่มี zIndex สูงกว่า หากมี zIndex เดียวกัน ระบบจะแสดงรายการที่มีตำแหน่งหน้าจอแนวตั้งต่ำกว่า
`REQUIRED`	แสดงเครื่องหมายเสมอโดยไม่คำนึงถึงการชน นี่คือลักษณะการทำงานเริ่มต้น
`REQUIRED_AND_HIDES_OPTIONAL`	แสดงเครื่องหมายเสมอโดยไม่คำนึงถึงการชน และซ่อนเครื่องหมาย OPTIONAL_AND_HIDES_LOWER_PRIORITY หรือป้ายกำกับที่จะทับซ้อนกับเครื่องหมาย

อินเทอร์เฟซ ไอคอน

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

โครงสร้างที่แสดงรูปภาพไอคอนเครื่องหมาย

พร็อพเพอร์ตี้
`url`	ประเภท: `string` URL ของรูปภาพหรือสไปรท์ชีต
`anchor optional`	ประเภท: `Point optional` ตำแหน่งที่จะตรึงรูปภาพในความสอดคล้องกับตำแหน่งของเครื่องหมายบนแผนที่ โดยค่าเริ่มต้น จุดยึดจะอยู่บนจุดศูนย์กลางของด้านล่างของภาพ
`labelOrigin optional`	ประเภท: `Point optional` ต้นทางของป้ายกำกับที่สัมพันธ์กับมุมซ้ายบนของรูปภาพไอคอน หากเครื่องหมายระบุป้ายกำกับไว้ โดยค่าเริ่มต้น ต้นทางจะอยู่ที่จุดศูนย์กลางของรูปภาพ
`origin optional`	ประเภท: `Point optional` ตำแหน่งของรูปภาพภายในสไปรท์ (หากมี) โดยค่าเริ่มต้น ต้นทางอยู่ที่มุมซ้ายบนของรูปภาพ `(0, 0)`
`scaledSize optional`	ประเภท: `Size optional` ขนาดของรูปภาพทั้งหมดหลังจากปรับขนาด หากมี ใช้คุณสมบัตินี้เพื่อยืด/ย่อรูปภาพหรือสไปรท์
`size optional`	ประเภท: `Size optional` ขนาดที่แสดงผลของสไปรท์หรือรูปภาพ เมื่อใช้สไปรท์ คุณต้องระบุขนาดสไปรท์ หากไม่ได้ระบุขนาด ระบบจะตั้งค่าเมื่อรูปภาพโหลด

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

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

ตัวเลือกเหล่านี้จะระบุลักษณะของป้ายกำกับเครื่องหมาย ป้ายกำกับของเครื่องหมายคือสตริง (มักเป็นอักขระตัวเดียว) ซึ่งจะปรากฏภายในเครื่องหมาย หากใช้ร่วมกับตัวทำเครื่องหมายที่กำหนดเอง คุณจะเปลี่ยนตำแหน่งด้วยพร็อพเพอร์ตี้ labelOrigin ในคลาส Icon ได้

พร็อพเพอร์ตี้
`text`	ประเภท: `string` ข้อความที่จะแสดงในป้ายกำกับ
`className optional`	ประเภท: `string optional` ค่าเริ่มต้น: `''` (สตริงว่างเปล่า) พร็อพเพอร์ตี้ className ขององค์ประกอบป้ายกำกับ (เทียบเท่ากับแอตทริบิวต์คลาสขององค์ประกอบ) คุณเพิ่มคลาส CSS ที่คั่นด้วยการเว้นวรรคได้หลายคลาส จะตั้งค่าสี ขนาด น้ำหนัก และครอบครัวของแบบอักษรได้ผ่านพร็อพเพอร์ตี้อื่นๆ ของ `MarkerLabel` เท่านั้น ไม่ควรใช้คลาส CSS เพื่อเปลี่ยนตำแหน่งหรือการวางแนวของป้ายกำกับ (เช่น การใช้คำแปลและการหมุน) หากใช้การจัดการการชนของเครื่องหมายด้วย
`color optional`	ประเภท: `string optional` ค่าเริ่มต้น: `'black'` สีของข้อความในป้ายกำกับ
`fontFamily optional`	ประเภท: `string optional` ชุดแบบอักษรของข้อความป้ายกำกับ (เทียบเท่ากับคุณสมบัติชุดแบบอักษรของ CSS)
`fontSize optional`	ประเภท: `string optional` ค่าเริ่มต้น: `'14px'` ขนาดแบบอักษรของข้อความป้ายกำกับ (เทียบเท่ากับคุณสมบัติขนาดแบบอักษรของ CSS)
`fontWeight optional`	ประเภท: `string optional` น้ำหนักแบบอักษรของข้อความป้ายกำกับ (เทียบเท่ากับคุณสมบัติน้ำหนักแบบอักษรของ CSS)

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

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

วัตถุนี้กำหนดพื้นที่ที่คลิกได้ของภาพเครื่องหมาย รูปร่างประกอบด้วยคุณสมบัติ 2 อย่าง คือ type และ coord ซึ่งเป็นการกำหนดพื้นที่ที่ไม่โปร่งใสของรูปภาพ

พร็อพเพอร์ตี้
`coords`	ประเภท: `Array<number>` รูปแบบของแอตทริบิวต์นี้ขึ้นอยู่กับค่าของ `type` และเป็นไปตามข้อกำหนดของ w3 AREA `coords` ซึ่งดูได้ที่ http://www.w3.org/TR/REC-html40/struct/objects.html#adef-coords แอตทริบิวต์ `coords` คืออาร์เรย์ของจำนวนเต็มที่ระบุตำแหน่งพิกเซลของรูปร่างโดยสัมพันธ์กับมุมซ้ายบนของรูปภาพเป้าหมาย พิกัดจะขึ้นอยู่กับค่าของ `type` ดังนี้ - `circle`: พิกัดคือ `[x1,y1,r]` โดยที่ x1,y2 คือพิกัดของจุดศูนย์กลางของวงกลม และ r คือรัศมีของวงกลม - `poly`: พิกัดคือ `[x1,y1,x2,y2...xn,yn]` โดยที่คู่ x,y แต่ละคู่มีพิกัดของจุดยอดมุม 1 จุดของรูปหลายเหลี่ยม - `rect`: พิกัดคือ `[x1,y1,x2,y2]` โดย x1,y1 คือพิกัดของมุมบนซ้ายของสี่เหลี่ยม และ x2,y2 คือพิกัดของพิกัดด้านล่างขวาของสี่เหลี่ยม
`type`	ประเภท: `string` อธิบายประเภทของรูปร่าง และสามารถเป็น `circle`, `poly` หรือ `rect`

พร็อพเพอร์ตี้

coords

ประเภท: Array<number>

รูปแบบของแอตทริบิวต์นี้ขึ้นอยู่กับค่าของ type และเป็นไปตามข้อกำหนดของ w3 AREA coords ซึ่งดูได้ที่ http://www.w3.org/TR/REC-html40/struct/objects.html#adef-coords
แอตทริบิวต์ coords คืออาร์เรย์ของจำนวนเต็มที่ระบุตำแหน่งพิกเซลของรูปร่างโดยสัมพันธ์กับมุมซ้ายบนของรูปภาพเป้าหมาย พิกัดจะขึ้นอยู่กับค่าของ type ดังนี้
- circle: พิกัดคือ [x1,y1,r] โดยที่ x1,y2 คือพิกัดของจุดศูนย์กลางของวงกลม และ r คือรัศมีของวงกลม
- poly: พิกัดคือ [x1,y1,x2,y2...xn,yn] โดยที่คู่ x,y แต่ละคู่มีพิกัดของจุดยอดมุม 1 จุดของรูปหลายเหลี่ยม
- rect: พิกัดคือ [x1,y1,x2,y2] โดย x1,y1 คือพิกัดของมุมบนซ้ายของสี่เหลี่ยม และ x2,y2 คือพิกัดของพิกัดด้านล่างขวาของสี่เหลี่ยม

type

ประเภท: string

อธิบายประเภทของรูปร่าง และสามารถเป็น circle, poly หรือ rect

อินเทอร์เฟซสัญลักษณ์

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

อธิบายสัญลักษณ์ซึ่งประกอบด้วยเส้นทางเวกเตอร์ที่มีการจัดรูปแบบ คุณสามารถใช้สัญลักษณ์เป็นไอคอนของตัวทำเครื่องหมายหรือวางไว้ในเส้นประกอบก็ได้

พร็อพเพอร์ตี้
`path`	ประเภท: `SymbolPath\|string` เส้นทางของสัญลักษณ์ ซึ่งเป็นเส้นทางสัญลักษณ์ในตัว หรือเส้นทางที่กําหนดเองซึ่งแสดงโดยใช้สัญกรณ์เส้นทาง SVG ต้องระบุ
`anchor optional`	ประเภท: `Point optional` ค่าเริ่มต้น: `google.maps.Point(0,0)` ตำแหน่งของสัญลักษณ์สัมพัทธ์กับเครื่องหมายหรือเส้นประกอบ ระบบจะแปลพิกัดของเส้นทางของสัญลักษณ์ไปทางซ้ายและขึ้นตามพิกัด x และ y ของจุดยึดตามลำดับ ตำแหน่งจะแสดงในระบบพิกัดเดียวกันกับเส้นทางของสัญลักษณ์
`fillColor optional`	ประเภท: `string optional` สีเติมของสัญลักษณ์ ระบบจะรองรับสี CSS3 ทั้งหมดยกเว้นสีที่มีชื่อเพิ่มเติม สำหรับเครื่องหมายสัญลักษณ์ ค่าเริ่มต้นจะเป็น "สีดำ" สำหรับสัญลักษณ์ของเส้นประกอบ ค่าเริ่มต้นจะเป็นสีเส้นโครงร่างของเส้นประกอบที่เกี่ยวข้อง
`fillOpacity optional`	ประเภท: `number optional` ค่าเริ่มต้น: `0` ความทึบแสงแบบเติมของสัญลักษณ์
`labelOrigin optional`	ประเภท: `Point optional` ค่าเริ่มต้น: `google.maps.Point(0,0)` ต้นทางของป้ายกำกับที่เกี่ยวข้องกับต้นทางของเส้นทาง หากเครื่องหมายระบุป้ายกำกับไว้ จุดเริ่มต้นจะแสดงในระบบพิกัดเดียวกันกับเส้นทางของสัญลักษณ์ ไม่ได้ใช้พร็อพเพอร์ตี้นี้สําหรับสัญลักษณ์ในโพลีไลน์
`rotation optional`	ประเภท: `number optional` ค่าเริ่มต้น: `0` มุมที่จะใช้หมุนสัญลักษณ์ ซึ่งแสดงตามเข็มนาฬิกาเป็นองศา สัญลักษณ์ใน `IconSequence` โดยที่ `fixedRotation` คือ `false` จะหมุนสัมพัทธ์กับมุมของขอบที่วางอยู่
`scale optional`	ประเภท: `number optional` ปริมาณของขนาดของสัญลักษณ์ สำหรับเครื่องหมายสัญลักษณ์ ค่าเริ่มต้นจะเป็น 1 หลังจากปรับขนาดแล้ว สัญลักษณ์จะมีขนาดใดก็ได้ สำหรับสัญลักษณ์ในเส้นประกอบ ค่าเริ่มต้นจะเป็นน้ำหนักเส้นโครงร่างของเส้นประกอบ หลังจากการปรับขนาด สัญลักษณ์จะต้องอยู่ภายในสี่เหลี่ยมจัตุรัสขนาด 22 พิกเซลซึ่งมีศูนย์กลางอยู่ที่จุดยึดของสัญลักษณ์
`strokeColor optional`	ประเภท: `string optional` สีเส้นโครงร่างของสัญลักษณ์ ระบบจะรองรับสี CSS3 ทั้งหมดยกเว้นสีที่มีชื่อเพิ่มเติม สำหรับเครื่องหมายสัญลักษณ์ ค่าเริ่มต้นจะเป็น "สีดำ" สำหรับสัญลักษณ์ในเส้นประกอบ ค่าเริ่มต้นจะเป็นสีเส้นโครงร่างของเส้นประกอบ
`strokeOpacity optional`	ประเภท: `number optional` ความทึบแสงของเส้นโครงร่าง สำหรับเครื่องหมายสัญลักษณ์ ค่าเริ่มต้นคือ 1 สำหรับสัญลักษณ์ในเส้นประกอบ ค่าเริ่มต้นจะเป็นความทึบแสงของเส้นโครงร่าง
`strokeWeight optional`	ประเภท: `number optional` ค่าเริ่มต้น: `Symbol.scale` ของสัญลักษณ์ น้ำหนักเส้นโครงร่างของสัญลักษณ์

SymbolPath ค่าคงที่

ค่าคงที่ google.maps.SymbolPath

เส้นทางสัญลักษณ์ในตัว

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

ค่าคงที่
`BACKWARD_CLOSED_ARROW`	ลูกศรปิดที่ชี้ไปข้างหลัง
`BACKWARD_OPEN_ARROW`	ลูกศรเปิดชี้ไปข้างหลัง
`CIRCLE`	วงกลม
`FORWARD_CLOSED_ARROW`	ลูกศรปิดที่ชี้ไปข้างหน้า
`FORWARD_OPEN_ARROW`	ลูกศรเปิดที่ชี้ไปข้างหน้า

ค่าคงที่ภาพเคลื่อนไหว

ค่าคงที่ google.maps.Animation

ภาพเคลื่อนไหวที่เล่นบนเครื่องหมายได้ ใช้เมธอด Marker.setAnimation ในตัวทำเครื่องหมายหรือตัวเลือก MarkerOptions.animation เพื่อเล่นภาพเคลื่อนไหว

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

ค่าคงที่
`BOUNCE`	ตัวทำเครื่องหมายจะตีกลับจนกว่าภาพเคลื่อนไหวจะหยุดลงโดยการเรียกใช้ `Marker.setAnimation` ด้วย `null`
`DROP`	เครื่องหมายตกลงจากด้านบนของแผนที่ไปยังตำแหน่งสุดท้าย ภาพเคลื่อนไหวจะหยุดเมื่อเครื่องหมายไม่มีการใช้งาน และ `Marker.getAnimation` จะแสดง `null` ภาพเคลื่อนไหวประเภทนี้มักจะระบุไว้ระหว่างการสร้างตัวทำเครื่องหมาย

ค่าคงที่

BOUNCE ตัวทำเครื่องหมายจะตีกลับจนกว่าภาพเคลื่อนไหวจะหยุดลงโดยการเรียกใช้ Marker.setAnimation ด้วย null

DROP เครื่องหมายตกลงจากด้านบนของแผนที่ไปยังตำแหน่งสุดท้าย ภาพเคลื่อนไหวจะหยุดเมื่อเครื่องหมายไม่มีการใช้งาน และ Marker.getAnimation จะแสดง null ภาพเคลื่อนไหวประเภทนี้มักจะระบุไว้ระหว่างการสร้างตัวทำเครื่องหมาย

Marker (legacy)

คลาสมาร์กเกอร์

ผู้ผลิต

ค่าคงที่

วิธีการ

กิจกรรม

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

พร็อพเพอร์ตี้

ค่าคงที่ CollisionBehavior

ค่าคงที่

อินเทอร์เฟซ ไอคอน

พร็อพเพอร์ตี้

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

พร็อพเพอร์ตี้

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

พร็อพเพอร์ตี้

อินเทอร์เฟซสัญลักษณ์

พร็อพเพอร์ตี้

SymbolPath ค่าคงที่

ค่าคงที่

ค่าคงที่ภาพเคลื่อนไหว

ค่าคงที่