ภาพรวม
เครื่องหมายขั้นสูงคือไอคอนที่วางไว้ที่จุดใดจุดหนึ่งบนพื้นผิวของแผนที่
รับค่า GMSMarker
ฟังก์ชันสมาชิกสาธารณะแบบคงที่ | |
| (อินสแตนซ์ประเภท) | + markerWithPosition: |
| ตัวสร้างความสะดวกสำหรับตัวทำเครื่องหมายเริ่มต้น | |
| (UIImage *) | + markerImageWithColor: |
| สร้างภาพตัวทำเครื่องหมายเริ่มต้นเวอร์ชันแต้มสีเพื่อใช้เป็นไอคอน | |
พร็อพเพอร์ตี้ | |
| GMSCollisionBehavior | collisionBehavior |
| พฤติกรรมการชนของเครื่องหมาย ซึ่งกำหนดว่าการเปิดเผยของเครื่องหมายนั้นจะได้รับผลกระทบจากเครื่องหมายอื่นๆ หรือเนื้อหาที่ติดป้ายกำกับบนแผนที่หรือไม่ | |
| CLLocationCoordinate2D | ตำแหน่ง |
| ตำแหน่งเครื่องหมาย | |
| NSString * | ตัวอย่างข้อมูล |
| ข้อความข้อมูลเพิ่มเติม ซึ่งแสดงใต้ชื่อในหน้าต่างข้อมูลเมื่อคุณเลือก | |
| รูปภาพ UI * | ไอคอน |
| ไอคอนตัวทำเครื่องหมายเพื่อแสดงผล | |
| UIView * | iconView |
| มุมมองเครื่องหมายที่จะแสดงผล | |
| บูลีน | tracksViewChanges |
| ควบคุมว่าจะให้วาดไอคอนของเครื่องหมายนี้ใหม่ทุกเฟรมหรือไม่ | |
| บูลีน | tracksInfoWindowChanges |
| ควบคุมว่าควรวาดหน้าต่างข้อมูลของเครื่องหมายนี้ใหม่ทุกเฟรมหรือไม่ | |
| CGPoint | groundAnchor |
| ตัวยึดพื้นจะระบุจุดในภาพไอคอนซึ่งถูกยึดให้กับตำแหน่งของเครื่องหมายบนพื้นผิวโลก | |
| CGPoint | infoWindowAnchor |
| การเชื่อมโยงหน้าต่างข้อมูลจะระบุจุดในภาพไอคอนที่จะตรึงหน้าต่างข้อมูล ซึ่งจะแสดงเหนือจุดนี้โดยตรง | |
| GMSMarkerAnimation | appearAnimation |
| ควบคุมภาพเคลื่อนไหวที่ใช้เมื่อวางเครื่องหมายนี้บน GMSMapView (ค่าเริ่มต้นเป็น kGMSmarkerAnimationNone ไม่ใช่ภาพเคลื่อนไหว) | |
| บูลีน | ลากได้ |
| ควบคุมว่าเครื่องหมายนี้สามารถลากแบบอินเทอร์แอกทีฟได้หรือไม่ (ค่าเริ่มต้น NO) | |
| บูลีน | ราบ |
| ควบคุมว่าเครื่องหมายนี้ควรอยู่บนพื้นผิวโลก (ใช่) หรือป้ายบิลบอร์ดที่หันเข้าหากล้อง (NO ค่าเริ่มต้นคือ) | |
| CLLocationDegrees | การหมุนเวียน |
| ตั้งค่าการหมุนเครื่องหมายเป็นองศาตามเข็มนาฬิกาเกี่ยวกับจุดยึดของเครื่องหมาย | |
| float | ความทึบแสง |
| ตั้งค่าความทึบแสงของเครื่องหมายตั้งแต่ 0 (แบบโปร่งใสทั้งหมด) และ 1 (ค่าเริ่มต้น) | |
| GMSMarkerLayer * | เลเยอร์ |
| ระบุเลเยอร์ภาพเคลื่อนไหวหลักของ GMSMarker นี้ | |
| GMSPanoramaView * | panoramaView |
panoramaView ระบุว่ามุมมองพาโนรามาใดจะพยายามแสดงเครื่องหมายนี้ | |
| NSString * | ชื่อ [title] |
| ชื่อ คำอธิบายสั้นๆ ของโฆษณาซ้อนทับ | |
| GMSMapView * | แผนที่ |
| แผนที่ที่วางซ้อนนี้เปิดอยู่ | |
| บูลีน | แตะได้ |
| หากการวางซ้อนนี้ควรทำให้เกิดการแจ้งเตือนการแตะ | |
| int | zIndex |
การวางซ้อนค่า zIndex ที่สูงกว่าจะถูกวาดที่ด้านบนของเลเยอร์และการวางซ้อนของชิ้นส่วนค่า zIndex ที่ต่ำกว่า | |
| รหัส [id] | userData |
| ข้อมูลการวางซ้อน | |
เอกสารประกอบเกี่ยวกับฟังก์ชันของสมาชิก
| + (อินสแตนซ์) markerWithPosition: | (CLLocationCoordinate2D) | ตำแหน่ง |
ตัวสร้างความสะดวกสำหรับตัวทำเครื่องหมายเริ่มต้น
| + (UIImage *) markerImageWithColor: | (nullable UIColor *) | สี |
สร้างภาพตัวทำเครื่องหมายเริ่มต้นเวอร์ชันแต้มสีเพื่อใช้เป็นไอคอน
เอกสารประกอบเกี่ยวกับอสังหาริมทรัพย์
- (GMSCollisionBehavior) collisionBehavior [read, write, assign] |
พฤติกรรมการชนของเครื่องหมาย ซึ่งกำหนดว่าการเปิดเผยของเครื่องหมายนั้นจะได้รับผลกระทบจากเครื่องหมายอื่นๆ หรือเนื้อหาที่ติดป้ายกำกับบนแผนที่หรือไม่
- (CLLocationCoordinate2D) ตำแหน่ง [read, write, assign, inherited] |
ตำแหน่งเครื่องหมาย
ภาพเคลื่อนไหว
- (NSString*) ข้อมูลโค้ด [read, write, copy, inherited] |
ข้อความข้อมูลเพิ่มเติม ซึ่งแสดงใต้ชื่อในหน้าต่างข้อมูลเมื่อคุณเลือก
- ไอคอน (UIImage*) [read, write, assign, inherited] |
ไอคอนตัวทำเครื่องหมายเพื่อแสดงผล
หากเว้นว่างไว้ ให้ใช้เครื่องหมายระบุตำแหน่ง SDK เริ่มต้น
รองรับภาพเคลื่อนไหว แต่เฟรมแต่ละเฟรมต้องมีขนาดเท่ากัน หรือไม่ระบุลักษณะการทํางาน
รองรับการใช้AlignRectInsets เพื่อระบุพื้นที่การแตะที่ลดลง และยังเป็นการกำหนดวิธีการระบุ Anchor ใหม่ด้วย สำหรับภาพเคลื่อนไหว ระบบจะใช้ค่าของภาพเคลื่อนไหว ไม่ใช่แต่ละเฟรม
- (UIView*) iconView [read, write, assign, inherited] |
มุมมองเครื่องหมายที่จะแสดงผล
หากเป็นค่าว่าง ให้กลับไปที่พร็อพเพอร์ตี้ icon แทน
รองรับภาพเคลื่อนไหวของคุณสมบัติเคลื่อนไหวได้ทั้งหมดของ UIView ยกเว้น frame และ center ไม่รองรับการเปลี่ยนพร็อพเพอร์ตี้เหล่านี้หรือเวอร์ชัน CALayer ที่เกี่ยวข้อง รวมถึง position
โปรดทราบว่ามุมมองจะทำงานเสมือนตั้งค่า clipsToBounds เป็น "ใช่" ไม่ว่าค่าจริงจะเป็นเท่าใด
- (BOOL) tracksViewChanges [read, write, assign, inherited] |
ควบคุมว่าจะให้วาดไอคอนของเครื่องหมายนี้ใหม่ทุกเฟรมหรือไม่
โปรดทราบว่าเมื่อค่านี้เปลี่ยนจาก "ไม่" เป็น "ใช่" จะทำให้ไอคอนถูกวาดใหม่ในเฟรมถัดไป
ค่าเริ่มต้นคือ "ใช่" ไม่มีผลหาก iconView เป็น nil
- (BOOL) tracksInfoWindowChanges [read, write, assign, inherited] |
ควบคุมว่าควรวาดหน้าต่างข้อมูลของเครื่องหมายนี้ใหม่ทุกเฟรมหรือไม่
โปรดทราบว่าเมื่อค่านี้เปลี่ยนจาก "ไม่" เป็น "ใช่" รับประกันได้ว่าจะมีการวาดหน้าต่างข้อมูลใหม่ในเฟรมถัดไป
ค่าเริ่มต้นคือ NO
- (CGPoint) groundAnchor [read, write, assign, inherited] |
ตัวยึดพื้นจะระบุจุดในภาพไอคอนซึ่งถูกยึดให้กับตำแหน่งของเครื่องหมายบนพื้นผิวโลก
ระบบจะระบุจุดนี้ภายในพื้นที่ต่อเนื่อง [0.0, 1.0] x [0.0, 1.0] โดยที่ (0,0) คือมุมซ้ายบนของรูปภาพ และ (1,1) คือมุมขวาล่าง
หากรูปภาพมีการปรับแนวRectInsets ที่ไม่ใช่ 0 ส่วนด้านบนซ้ายและล่างขวาที่กล่าวถึงข้างต้นจะหมายถึงส่วนแทรกของรูปภาพ
- (CGPoint) infoWindowAnchor [read, write, assign, inherited] |
การเชื่อมโยงหน้าต่างข้อมูลจะระบุจุดในภาพไอคอนที่จะตรึงหน้าต่างข้อมูล ซึ่งจะแสดงเหนือจุดนี้โดยตรง
จุดนี้ระบุภายในพื้นที่เดียวกับ groundAnchor
- (GMSMarkerAnimation) appearAnimation [read, write, assign, inherited] |
ควบคุมภาพเคลื่อนไหวที่ใช้เมื่อวางเครื่องหมายนี้บน GMSMapView (ค่าเริ่มต้นเป็น kGMSmarkerAnimationNone ไม่ใช่ภาพเคลื่อนไหว)
- (BOOL) ลากได้ [read, write, assign, inherited] |
ควบคุมว่าเครื่องหมายนี้สามารถลากแบบอินเทอร์แอกทีฟได้หรือไม่ (ค่าเริ่มต้น NO)
- (BOOL) แนวราบ [read, write, assign, inherited] |
ควบคุมว่าเครื่องหมายนี้ควรอยู่บนพื้นผิวโลก (ใช่) หรือป้ายบิลบอร์ดที่หันเข้าหากล้อง (NO ค่าเริ่มต้นคือ)
- (CLLocationDegrees) การหมุนเวียน [read, write, assign, inherited] |
ตั้งค่าการหมุนเครื่องหมายเป็นองศาตามเข็มนาฬิกาเกี่ยวกับจุดยึดของเครื่องหมาย
แกนของการหมุนตั้งฉากกับเครื่องหมาย การหมุน 0 จะสอดคล้องกับตำแหน่งเริ่มต้นของเครื่องหมาย ภาพเคลื่อนไหว
เมื่อเครื่องหมายราบเรียบบนแผนที่ ตำแหน่งเริ่มต้นจะอยู่ในแนวเหนือและหมุน เครื่องหมายนั้นจะยังคงราบอยู่บนแผนที่ เมื่อเครื่องหมายเป็นป้ายบิลบอร์ด ตำแหน่งเริ่มต้นจะชี้ขึ้นและหมุนเป็นแบบที่เครื่องหมายหันเข้าหากล้องเสมอ
- (แบบลอย) ความทึบแสง [read, write, assign, inherited] |
ตั้งค่าความทึบแสงของเครื่องหมายตั้งแต่ 0 (แบบโปร่งใสทั้งหมด) และ 1 (ค่าเริ่มต้น)
- (GMSMarkerLayer*) เลเยอร์ [read, assign, inherited] |
ระบุเลเยอร์ภาพเคลื่อนไหวหลักของ GMSMarker นี้
- (GMSPanoramaView*) panoramaView [read, write, assign, inherited] |
panoramaView ระบุว่ามุมมองพาโนรามาใดจะพยายามแสดงเครื่องหมายนี้
โปรดทราบว่าหากเครื่องหมาย position อยู่ไกลจากตำแหน่งพาโนรามาปัจจุบันของ panoramaView มากเกินไป เครื่องหมายดังกล่าวจะไม่แสดงเนื่องจากจะมีขนาดเล็กเกินไป
สามารถตั้งค่าเป็น nil เพื่อนำเครื่องหมายออกจากมุมมองพาโนรามาปัจจุบันที่แนบอยู่
เครื่องหมายสามารถแสดงทั้งบนพาโนรามาและแผนที่ได้พร้อมกัน
- (NSString*) ชื่อ [read, write, copy, inherited] |
ชื่อ คำอธิบายสั้นๆ ของโฆษณาซ้อนทับ
การวางซ้อนบางอย่าง เช่น เครื่องหมาย จะแสดงชื่อบนแผนที่ ซึ่งจะเป็นข้อความการช่วยเหลือพิเศษเริ่มต้นด้วย
- (GMSMapView*) แผนที่ [read, write, assign, inherited] |
แผนที่ที่วางซ้อนนี้เปิดอยู่
การตั้งค่าคุณสมบัตินี้จะเพิ่มการวางซ้อนลงในแผนที่ การตั้งค่าเป็น "ว่าง" จะนำการซ้อนทับนี้ออกจากแผนที่ การวางซ้อนสามารถแสดงบนแผนที่ได้ไม่เกิน 1 รายการในช่วงเวลาใดเวลาหนึ่ง
- (BOOL) แตะได้ [read, write, assign, inherited] |
หากการวางซ้อนนี้ควรทำให้เกิดการแจ้งเตือนการแตะ
การวางซ้อนบางอย่าง เช่น เครื่องหมาย จะแตะได้โดยค่าเริ่มต้น
- (int) zIndex [read, write, assign, inherited] |
การวางซ้อนค่า zIndex ที่สูงกว่าจะถูกวาดที่ด้านบนของเลเยอร์และการวางซ้อนของชิ้นส่วนค่า zIndex ที่ต่ำกว่า
ค่าที่เท่ากันจะทำให้มีลำดับการวาดที่ไม่ได้กำหนดไว้ เครื่องหมายมีข้อยกเว้นว่าโดยไม่คำนึงถึง zIndex เครื่องหมายจะถูกวาดเหนือเลเยอร์ชิ้นส่วนและการวางซ้อนอื่นๆ ที่ไม่ใช่เครื่องหมายเสมอ จะถือว่าอยู่ในกลุ่มดัชนี z ที่แยกต่างหากเมื่อเทียบกับการวางซ้อนอื่นๆ
- (รหัส) userData [read, write, assign, inherited] |
ข้อมูลการวางซ้อน
คุณสามารถใช้พร็อพเพอร์ตี้นี้เพื่อเชื่อมโยงออบเจ็กต์ที่กำหนดเองกับโฆษณาซ้อนทับนี้ Google Maps SDK สำหรับ iOS ไม่ได้อ่านหรือเขียนพร็อพเพอร์ตี้นี้
โปรดทราบว่า userData ไม่ควรมีการอ้างอิงที่ชัดเจนไปยังวัตถุใน Maps มิฉะนั้นอาจมีการสร้างรอบการเก็บรักษา (เพื่อป้องกันการปล่อยวัตถุ)