ไอคอนที่วางอยู่ ณ จุดใดจุดหนึ่งบนพื้นผิวของแผนที่ มีการวาดไอคอนตัวทำเครื่องหมายในแนว บนหน้าจอของอุปกรณ์ แทนที่จะเป็นพื้นผิวของแผนที่ นั่นคือ ไม่ได้เปลี่ยนแปลงเสมอไป การวางแนวเนื่องจากการหมุน การเอียง หรือการซูมของแผนที่
เครื่องหมายมีคุณสมบัติดังต่อไปนี้
- อัลฟ่า
- ตั้งค่าความทึบแสงของเครื่องหมาย ค่าเริ่มต้นคือ 1.0
- เชื่อมโยง
- จุดบนรูปภาพที่จะวางอยู่ที่ตำแหน่ง
LatLng
ของเครื่องหมาย ค่าเริ่มต้นจะเป็น 50% จากด้านซ้ายของรูปภาพและที่ด้านล่างของรูปภาพ - อันดับ
- ค่า
LatLng
สำหรับตำแหน่งเครื่องหมายบนแผนที่ คุณสามารถเปลี่ยนค่านี้ได้ที่ เมื่อใดก็ได้หากคุณต้องการย้ายเครื่องหมาย - ชื่อ
- สตริงข้อความที่ปรากฏในหน้าต่างข้อมูลเมื่อผู้ใช้แตะเครื่องหมาย คุณสามารถ เปลี่ยนค่านี้ได้ตลอดเวลา
- ตัวอย่างข้อมูล
- ข้อความเพิ่มเติมที่แสดงใต้ชื่อ คุณสามารถเปลี่ยนแปลงค่านี้ได้ตลอดเวลา
- Icon
- บิตแมปที่แสดงสำหรับเครื่องหมาย หากไม่ได้ตั้งค่าไอคอนไว้ ระบบจะใช้ไอคอนเริ่มต้น
แสดงอยู่ คุณสามารถระบุสีสำรองของไอคอนเริ่มต้นได้โดยใช้
defaultMarker(float)
- สถานะการลาก
- หากต้องการอนุญาตให้ผู้ใช้ลากเครื่องหมาย ให้ตั้งค่าพร็อพเพอร์ตี้นี้เป็น
true
คุณ สามารถเปลี่ยนค่านี้ได้ตลอดเวลา โดยมีค่าเริ่มต้นเป็นfalse
- ระดับการแชร์
- โดยค่าเริ่มต้น เครื่องหมายจะปรากฏ หากต้องการซ่อนเครื่องหมาย ให้ตั้งค่าคุณสมบัตินี้เป็น
false
คุณสามารถเปลี่ยนแปลงค่านี้ได้ตลอดเวลา - แฟลตหรือบิลบอร์ด
- หากเครื่องหมายราบเรียบกับแผนที่ เครื่องหมายนั้นจะติดอยู่กับแผนที่ในลักษณะเดียวกับกล้อง
หมุนและเอียงแต่จะยังคงขนาดเดียวกับที่กล้องซูม ซึ่งต่างจาก
GroundOverlay
ถ้าเครื่องหมายเป็นบิลบอร์ด จะวาดโดยหันเข้าหากล้องเสมอ จะหมุนและเอียงไปพร้อมกับกล้อง ค่าเริ่มต้นคือบิลบอร์ด (false
) - การหมุน
- การหมุนของเครื่องหมายเป็นองศาตามเข็มนาฬิกาเกี่ยวกับจุดยึดของเครื่องหมาย แกน การหมุนตั้งฉากกับเครื่องหมาย การหมุน 0 สอดคล้องกับค่าเริ่มต้น ของเครื่องหมาย เมื่อเครื่องหมายราบเรียบบนแผนที่ ตำแหน่งเริ่มต้นคือทิศเหนือ จัดแนวตามแนวและการหมุนโดยที่เครื่องหมายยังคงแบนอยู่เสมอบนแผนที่ เมื่อ เป็นบิลบอร์ด ตำแหน่งเริ่มต้นจะชี้ขึ้นและการหมุน เครื่องหมายจะหันเข้าหากล้องเสมอ ค่าเริ่มต้นคือ 0
- zIndex
- ลำดับการวาดของเครื่องหมาย เครื่องหมายจะถูกวาดตามลำดับ zIndex พร้อมด้วย เครื่องหมาย zIndex สูงสุดวาดอยู่ด้านบน ในการตั้งค่าคุณสมบัติ zIndex ของเครื่องหมายแต่ละตัว คุณจะสามารถ ควบคุมเป้าหมายการแตะที่ผู้ใช้มีแนวโน้มจะทำมากที่สุด ค่าเริ่มต้นคือ 0
- แท็ก
Object
ที่เกี่ยวข้องกับเครื่องหมาย ตัวอย่างเช่นObject
อาจมี ข้อมูลเกี่ยวกับสิ่งที่เครื่องหมายแสดง วิธีนี้ง่ายกว่าการจัดเก็บMap<Marker, Object>
แยกต่างหาก อีกตัวอย่างหนึ่งคือคุณสามารถเชื่อมโยงรหัสString
ที่สอดคล้องกับรหัสจากชุดข้อมูล Google Maps SDK สำหรับ Android ไม่ได้อ่านหรือ เขียนพร็อพเพอร์ตี้นี้
ต้องเรียกใช้เมธอดในคลาสนี้บนเทรด Android UI หากไม่เป็นเช่นนั้น IllegalStateException
จะแสดงขณะรันไทม์
ตัวอย่าง
GoogleMap map = ... // get a map.
// Add a marker at San Francisco.
Marker marker = map.addMarker(new MarkerOptions()
.position(new LatLng(37.7750, 122.4183))
.title("San Francisco")
.snippet("Population: 776733"));
คู่มือนักพัฒนา
โปรดอ่านข้อมูลเพิ่มเติมจากนักพัฒนาซอฟต์แวร์ Markers
สรุปของชั้นเรียนที่ซ้อนกัน
@interface | Marker.CollisionBehavior | ระบุวิธีจัดการเครื่องหมายเมื่อเกี่ยวข้องกับการชนกับเครื่องหมายหรือฐานอื่นๆ ป้ายกำกับแผนที่ |
ข้อมูลสรุปของเมธอดสาธารณะ
boolean | |
จำนวนลอยตัว |
getAlpha()
รับอัลฟ่าของเครื่องหมาย
|
สตริง |
getId()
รับรหัสของเครื่องหมายนี้
|
LatLng |
getPosition()
แสดงตำแหน่งของเครื่องหมาย
|
จำนวนลอยตัว |
getRotation()
รับการหมุนของเครื่องหมาย
|
สตริง |
getSnippet()
ดึงข้อมูลโค้ดของเครื่องหมาย
|
ออบเจ็กต์ |
getTag()
รับแท็กสำหรับตัวทำเครื่องหมาย
|
สตริง |
getTitle()
รับชื่อของเครื่องหมาย
|
จำนวนลอยตัว |
getZIndex()
แสดง zIndex ของเครื่องหมาย
|
int |
hashCode()
|
เป็นโมฆะ |
hideInfoWindow()
ซ่อนหน้าต่างข้อมูลหากปรากฏจากเครื่องหมายนี้
|
boolean |
isDraggable()
รับความสามารถในการลากของเครื่องหมาย
|
boolean |
isFlat()
ตั้งค่าการทำเครื่องหมายเป็นแนวราบ
|
boolean |
isInfoWindowShown()
จะแสดงผลว่าหน้าต่างข้อมูลแสดงเหนือเครื่องหมายนี้หรือไม่
|
boolean |
isVisible()
รับการตั้งค่าการเปิดเผยของเครื่องหมายนี้
|
เป็นโมฆะ |
remove()
ลบเครื่องหมายนี้ออกจากแผนที่
|
เป็นโมฆะ |
setAlpha(อัลฟ่าแบบลอย)
ตั้งค่าอัลฟ่า (ความทึบแสง) ของเครื่องหมาย
|
เป็นโมฆะ |
setAnchor(แท็ก Anchor แบบลอย, โฆษณา Anchor แบบลอย)
ตั้งจุดยึดสำหรับเครื่องหมาย
|
เป็นโมฆะ |
setDraggable(boolean draggable)
ตั้งค่าความสามารถในการลากของเครื่องหมาย
|
เป็นโมฆะ |
setFlat(บูลีนแฟลต)
กำหนดว่าเครื่องหมายนี้ควรราบไปกับแผนที่
true หรือป้ายบิลบอร์ดที่หันหน้าไปทาง
กล้อง false |
เป็นโมฆะ | |
เป็นโมฆะ |
setInfoWindowAnchor(แท็ก Anchor แบบลอย, โฆษณา Anchor แบบลอย)
ระบุจุดในภาพเครื่องหมายที่จะยึดหน้าต่างข้อมูลเมื่อ
แสดงอยู่
|
เป็นโมฆะ | |
เป็นโมฆะ |
setRotation(การหมุนแบบลอย)
ตั้งค่าการหมุนของเครื่องหมายตามเข็มนาฬิกาเกี่ยวกับจุดยึดของเครื่องหมายตามเข็มนาฬิกา
|
เป็นโมฆะ |
setSnippet(ข้อมูลโค้ดสตริง)
ตั้งค่าข้อมูลโค้ดของเครื่องหมาย
|
เป็นโมฆะ |
setTag(แท็กออบเจ็กต์)
ตั้งค่าแท็กสำหรับตัวทำเครื่องหมาย
|
เป็นโมฆะ |
setTitle(ชื่อสตริง)
ตั้งชื่อของเครื่องหมาย
|
เป็นโมฆะ |
setVisible(boolean visible)
ตั้งค่าการแสดงผลของเครื่องหมายนี้
|
เป็นโมฆะ |
setZIndex(จำนวนลอยตัว zIndex)
ตั้งค่า zIndex ของเครื่องหมาย
|
เป็นโมฆะ |
showInfoWindow()
แสดงหน้าต่างข้อมูลของเครื่องหมายนี้บนแผนที่ หากเครื่องหมายนี้
isVisible() |
สรุปวิธีการที่รับมา
วิธีการสาธารณะ
สาธารณะ บูลีน เท่ากับ (ออบเจ็กต์อื่นๆ)
สาธารณะ จำนวนลอยตัว getAlpha ()
รับอัลฟ่าของเครื่องหมาย
การคืนสินค้า
- อัลฟ่าของเครื่องหมายในช่วง [0, 1]
สาธารณะ สตริง getId ()
รับรหัสของเครื่องหมายนี้ รหัสจะไม่ซ้ำกันกับเครื่องหมายทั้งหมดบนแผนที่
การคืนสินค้า
- ID ของเครื่องหมายนี้
สาธารณะ LatLng getPosition ()
แสดงตำแหน่งของเครื่องหมาย
การคืนสินค้า
- ออบเจ็กต์
LatLng
ที่ระบุตำแหน่งปัจจุบันของเครื่องหมาย
สาธารณะ จำนวนลอยตัว getRotation ()
รับการหมุนของเครื่องหมาย
การคืนสินค้า
- การหมุนของเครื่องหมายเป็นองศาตามเข็มนาฬิกาจากตำแหน่งเริ่มต้น
สาธารณะ สตริง getSnippet ()
ดึงข้อมูลโค้ดของเครื่องหมาย
การคืนสินค้า
- สตริงที่มีข้อมูลโค้ดของตัวทำเครื่องหมาย
สาธารณะ วัตถุ getTag ()
รับแท็กสำหรับตัวทำเครื่องหมาย
การคืนสินค้า
- หากตั้งค่าแท็กด้วย
setTag
null
หากไม่มีการตั้งค่าแท็ก
สาธารณะ สตริง getTitle ()
รับชื่อของเครื่องหมาย
การคืนสินค้า
- สตริงที่มีชื่อของเครื่องหมาย
สาธารณะ จำนวนลอยตัว getZIndex ()
แสดง zIndex ของเครื่องหมาย
การคืนสินค้า
- zIndex ของเครื่องหมายนี้
สาธารณะ Int hashCode ()
สาธารณะ เป็นโมฆะ hideInfoWindow ()
ซ่อนหน้าต่างข้อมูลหากปรากฏจากเครื่องหมายนี้
วิธีการนี้จะไม่มีผลหากเครื่องหมายนี้ไม่ปรากฏ
สาธารณะ บูลีน isDraggable ()
รับความสามารถในการลากของเครื่องหมาย เมื่อลากเครื่องหมายได้ ผู้ใช้สามารถย้ายเครื่องหมายได้โดย กดเครื่องหมายค้างไว้
การคืนสินค้า
true
หากเครื่องหมายสามารถลากได้ ไม่เช่นนั้น ระบบจะแสดงผลfalse
สาธารณะ บูลีน isFlat ()
ตั้งค่าการทำเครื่องหมายเป็นแนวราบ
การคืนสินค้า
true
หากเครื่องหมายราบเรียบกับแผนที่false
หากเครื่องหมายควร หันหน้าเข้าหากล้อง
สาธารณะ บูลีน isInfoWindowShown ()
จะแสดงผลว่าหน้าต่างข้อมูลแสดงเหนือเครื่องหมายนี้หรือไม่ วิธีนี้ไม่คำนึงถึง หน้าต่างข้อมูลจะแสดงบนหน้าจอจริงๆ หรือไม่
สาธารณะ บูลีน isVisible ()
รับการตั้งค่าการเปิดเผยของเครื่องหมายนี้ โปรดทราบว่าไม่ได้ระบุว่าเครื่องหมาย อยู่ภายในวิวพอร์ตของหน้าจอ ซึ่งเป็นตัวระบุว่าจะวาดเครื่องหมายหรือไม่หากเป็น ที่อยู่ในวิวพอร์ตของหน้าจอ
การคืนสินค้า
- การเปิดเผยเครื่องหมายนี้
สาธารณะ เป็นโมฆะ นำออก ()
ลบเครื่องหมายนี้ออกจากแผนที่ หลังจากลบเครื่องหมายแล้ว ลักษณะการทำงานของเครื่องหมายทั้งหมด ไม่ได้ระบุเมธอด
สาธารณะ เป็นโมฆะ setAlpha (อัลฟ่าแบบลอย)
ตั้งค่าอัลฟ่า (ความทึบแสง) ของเครื่องหมาย นี่คือค่าตั้งแต่ 0 ถึง 1 โดย 0 หมายถึงเครื่องหมาย มีความโปร่งใสทั้งหมด และ 1 หมายถึงเครื่องหมายทึบแสงทั้งหมด
พารามิเตอร์
อัลฟ่า |
---|
สาธารณะ เป็นโมฆะ setAnchor (แท็ก Anchor แบบลอย, โฆษณา Anchor แบบลอย)
ตั้งจุดยึดสำหรับเครื่องหมาย
จุดยึดจะระบุจุดในรูปภาพไอคอนซึ่งยึดอยู่กับตำแหน่งของเครื่องหมาย บนพื้นผิวโลก
ระบุจุดยึดในพื้นที่ต่อเนื่อง [0.0, 1.0] x [0.0, 1.0] โดยที่ (0, 0) คือมุมซ้ายบนของรูปภาพ และ (1, 1) คือมุมขวาล่าง จุดยึด ในรูปขนาด W x H คือจุดตารางแยกที่ใกล้ที่สุดใน (W + 1) x (H + 1) ที่ได้จากการปรับขนาดการปัดเศษแล้ว เช่น ในรูปภาพขนาด 4x2 จุดยึด (0.7, 0.6) จะแสดงเป็นจุดตารางที่ (3, 1)
*-----+-----+-----+-----* | | | | | | | | | | +-----+-----+-----+-----+ | | | X | | (U, V) = (0.7, 0.6) | | | | | *-----+-----+-----+-----* *-----+-----+-----+-----* | | | | | | | | | | +-----+-----+-----X-----+ (X, Y) = (3, 1) | | | | | | | | | | *-----+-----+-----+-----*
พารามิเตอร์
anchorU | พิกัด U ของจุดยึด เป็นอัตราส่วนของความกว้างของภาพ (ในช่วง [0, 1]) |
---|---|
anchorV | พิกัด v ของจุดยึด เป็นอัตราส่วนของความสูงของภาพ (ในช่วง [0, 1]) |
สาธารณะ เป็นโมฆะ setDraggable (ลากบูลีนได้)
ตั้งค่าความสามารถในการลากของเครื่องหมาย เมื่อลากเครื่องหมายได้ ผู้ใช้สามารถย้ายเครื่องหมายได้โดย กดเครื่องหมายค้างไว้
พารามิเตอร์
ลากได้ |
---|
สาธารณะ เป็นโมฆะ setFlat (บูลีนแฟลต)
กำหนดว่าเครื่องหมายนี้ควรราบไปกับแผนที่ true
หรือป้ายบิลบอร์ดที่หันหน้าไปทาง
กล้อง false
พารามิเตอร์
แบน |
---|
สาธารณะ เป็นโมฆะ setIcon (BitmapDescriptor iconDescriptor)
กำหนดไอคอนสำหรับเครื่องหมาย
พารามิเตอร์
iconDescriptor | หากเป็นค่าว่าง ระบบจะใช้เครื่องหมายเริ่มต้น |
---|
สาธารณะ เป็นโมฆะ setInfoWindowAnchor (แท็ก Anchor แบบลอย, โฆษณา Anchor แบบลอย)
ระบุจุดในภาพเครื่องหมายที่จะยึดหน้าต่างข้อมูลเมื่อ
แสดงอยู่ ข้อมูลนี้ระบุไว้ในระบบพิกัดเดียวกันกับสมอ ดูรายละเอียดเพิ่มเติมได้ที่ setAnchor(float, float)
ค่าเริ่มต้นคือตรงกลางด้านบนของรูปภาพ
พารามิเตอร์
anchorU | พิกัด U ของจุดยึดหน้าต่างข้อมูล เป็นอัตราส่วนของความกว้างของภาพ (ใน [0, 1]) |
---|---|
anchorV | พิกัด v ของจุดยึดหน้าต่างข้อมูล เป็นอัตราส่วนของความสูงของภาพ (ใน [0, 1]) |
สาธารณะ เป็นโมฆะ setPosition (LatLng latlng)
กำหนดตำแหน่งของเครื่องหมาย
พารามิเตอร์
ละติจูดและลองจิจูด |
---|
สาธารณะ เป็นโมฆะ setRotation (การหมุนแบบลอย)
ตั้งค่าการหมุนของเครื่องหมายตามเข็มนาฬิกาเกี่ยวกับจุดยึดของเครื่องหมายตามเข็มนาฬิกา แกน การหมุนตั้งฉากกับเครื่องหมาย การหมุน 0 สอดคล้องกับตำแหน่งเริ่มต้น ของเครื่องหมาย
พารามิเตอร์
การหมุน |
---|
สาธารณะ เป็นโมฆะ setSnippet (ข้อมูลโค้ดสตริง)
ตั้งค่าข้อมูลโค้ดของเครื่องหมาย
พารามิเตอร์
ตัวอย่างข้อมูล | หากเป็นค่าว่าง ระบบจะล้างข้อมูลโค้ด |
---|
สาธารณะ เป็นโมฆะ setTag (แท็กออบเจ็กต์)
ตั้งค่าแท็กสำหรับตัวทำเครื่องหมาย
คุณสามารถใช้พร็อพเพอร์ตี้นี้เพื่อเชื่อมโยง Object
กับเครื่องหมายนี้ได้ตามต้องการ สำหรับ
ตัวอย่างเช่น Object
อาจมีข้อมูลเกี่ยวกับสิ่งที่เครื่องหมายแสดง ง่ายกว่า
มากกว่าการจัดเก็บ Map<Marker, Object>
แยกต่างหาก อีกตัวอย่างหนึ่งคือ คุณสามารถเชื่อมโยง
รหัส String
ที่ตรงกับรหัสจากชุดข้อมูล Google Maps SDK สำหรับ Android ก็ไม่ได้เช่นกัน
จะอ่านและเขียนคุณสมบัตินี้ คุณมีหน้าที่โทรหา setTag(null)
เพื่อเคลียร์
แท็กเมื่อคุณไม่ต้องการใช้อีกต่อไป เพื่อป้องกันไม่ให้หน่วยความจำรั่วไหลในแอป
พารามิเตอร์
แท็ก | หากเป็นค่าว่าง ระบบจะล้างแท็ก |
---|
สาธารณะ เป็นโมฆะ setTitle (ชื่อสตริง)
ตั้งชื่อของเครื่องหมาย
พารามิเตอร์
title | หากเป็นค่าว่าง ระบบจะล้างชื่อ |
---|
สาธารณะ เป็นโมฆะ setVisible (แสดงบูลีน)
ตั้งค่าการแสดงผลของเครื่องหมายนี้ หากตั้งค่าเป็น false
และหน้าต่างข้อมูลเปิดอยู่
แสดง สำหรับเครื่องหมายนี้ ซึ่งจะเป็นการซ่อนหน้าต่างข้อมูล
พารามิเตอร์
มองเห็นได้ |
---|
สาธารณะ เป็นโมฆะ setZIndex (ดัชนี z แบบลอย)
ตั้งค่า zIndex ของเครื่องหมาย
พารามิเตอร์
zIndex |
---|
สาธารณะ เป็นโมฆะ showInfoWindow ()
แสดงหน้าต่างข้อมูลของเครื่องหมายนี้บนแผนที่ หากเครื่องหมายนี้ isVisible()
การขว้าง
IllegalArgumentException | ถ้า marker ไม่อยู่ในแผนที่นี้
|
---|