ภาพรวม
GMSGroundOverlay จะระบุตัวเลือกที่ใช้ได้สำหรับการวางซ้อนพื้นบนพื้นผิวโลก
ตำแหน่งของการวางซ้อนพื้นซึ่งต่างจากเครื่องหมายระบุตำแหน่งอย่างชัดเจน และไม่หันหน้าเข้าหากล้อง
รับค่า GMSOverlay
ฟังก์ชันสมาชิกสาธารณะแบบคงที่ | |
(ประเภทอินสแตนซ์) | + groundOverlayWithBounds:ไอคอน |
เครื่องมือสร้างความสะดวกสำหรับ GMSGroundOverlay สำหรับ bounds และ icon บางรายการ | |
(ประเภทอินสแตนซ์) | + groundOverlayWithPosition:icon:zoomLevel: |
สร้าง GMSGroundOverlay ที่แสดงผล icon ที่ระบุที่ position เหมือนว่าขนาดจริงของรูปภาพตรงกับพิกเซลกล้องที่ zoomLevel | |
พร็อพเพอร์ตี้ | |
CLLocationCoordinate2D | ตำแหน่ง |
ตำแหน่งของ GMSGroundOverlay นี้หรือกล่าวอย่างเจาะจงคือ ตำแหน่งทางกายภาพของจุดยึด | |
CGPoint | โฆษณาด้านล่างสุด |
แท็ก Anchor จะระบุตำแหน่งที่ GMSGroundOverlay นี้ยึดอยู่กับ Earth โดยสัมพันธ์กับ bounds | |
UIImage * | ไอคอน |
ไอคอนที่จะแสดงผลภายใน bounds บน Earth | |
float | ความทึบแสง |
ตั้งค่าความทึบแสงของการวางซ้อนพื้นระหว่าง 0 (โปร่งใสทั้งหมด) และ 1 (ค่าเริ่มต้น) | |
CLLocationDirection | การแบกรับ |
ทิศทางของการวางซ้อนพื้นนี้ หน่วยเป็นองศา | |
GMSCoordinateBounds * | ขอบเขต |
ขอบเขต 2 มิติของโลกที่วาด icon | |
NSString * | ชื่อ [title] |
ชื่อ คำอธิบายสั้นๆ ของโฆษณาซ้อนทับ | |
GMSMapView * | แผนที่ |
แผนที่ที่ซ้อนทับนี้เปิดอยู่ | |
บูลีน | แตะได้ |
หากการวางซ้อนนี้ควรทำให้เกิดการแจ้งเตือนการแตะ | |
int | zIndex |
การวางซ้อนค่า zIndex ที่สูงกว่าจะถูกวาดทับบนเลเยอร์และการวางซ้อนของค่า zIndex ที่ต่ำกว่า | |
รหัส | userData |
ข้อมูลซ้อนทับ |
เอกสารประกอบเกี่ยวกับฟังก์ชันสมาชิก
+ (instancetype) groundOverlayWithBounds: | (GMSCoordinateBounds ที่เป็นค่าว่าง *) | ขอบเขต | |
ไอคอน: | (nullable UIImage *) | ไอคอน | |
เครื่องมือสร้างความสะดวกสำหรับ GMSGroundOverlay สำหรับ bounds
และ icon
บางรายการ
จะตั้งค่า position
ให้สอดคล้องกัน
+ (instancetype) groundOverlayWithPosition: | (CLLocationCoordinate2D) | ตำแหน่ง | |
ไอคอน: | (nullable UIImage *) | ไอคอน | |
ระดับการซูม: | (CGFloat) | zoomLevel | |
สร้าง GMSGroundOverlay ที่แสดงผล icon
ที่ระบุที่ position
เหมือนว่าขนาดจริงของรูปภาพตรงกับพิกเซลกล้องที่ zoomLevel
เอกสารประกอบเกี่ยวกับอสังหาริมทรัพย์
- (CLLocationCoordinate2D) ตำแหน่ง [read, write, assign] |
ตำแหน่งของ GMSGroundOverlay นี้หรือกล่าวอย่างเจาะจงคือ ตำแหน่งทางกายภาพของจุดยึด
หากเปลี่ยนการตั้งค่านี้ ระบบจะย้าย bounds
ไปยังตำแหน่งใหม่
- (CGPoint) โฆษณาด้านล่างสุด [read, write, assign] |
แท็ก Anchor จะระบุตำแหน่งที่ GMSGroundOverlay นี้ยึดอยู่กับ Earth โดยสัมพันธ์กับ bounds
หากแก้ไข ระบบจะตั้งค่า position
เป็นตำแหน่งใหม่ที่เกี่ยวข้องภายใน bounds
- ไอคอน (UIImage*) [read, write, assign] |
ไอคอนที่จะแสดงผลภายใน bounds
บน Earth
หากเป็นค่า nil ระบบจะไม่แสดงการวางซ้อน (ต่างจาก GMSMarker ที่มีรูปภาพเริ่มต้น)
- (แบบลอย) ความทึบแสง [read, write, assign] |
ตั้งค่าความทึบแสงของการวางซ้อนพื้นระหว่าง 0 (โปร่งใสทั้งหมด) และ 1 (ค่าเริ่มต้น)
- (CLLocationDirection) ทิศทาง [read, write, assign] |
ทิศทางของการวางซ้อนพื้นนี้ หน่วยเป็นองศา
ค่าเริ่มต้นซึ่งก็คือศูนย์ จะชี้ภาพซ้อนทับพื้นนี้ขึ้น/ลงตามแกน Y ปกติของโลก
- (GMSCoordinateBounds*) ขอบเขต [read, write, assign] |
ขอบเขต 2 มิติของโลกที่วาด icon
การเปลี่ยนค่านี้จะปรับ position
ให้สอดคล้องกัน
- (NSString*) title [read, write, copy, inherited] |
ชื่อ คำอธิบายสั้นๆ ของโฆษณาซ้อนทับ
การวางซ้อนบางอย่าง เช่น เครื่องหมาย จะแสดงชื่อบนแผนที่ ชื่อนี้จะเป็นข้อความการช่วยเหลือพิเศษเริ่มต้นด้วย
- (GMSMapView*) แผนที่ [read, write, assign, inherited] |
แผนที่ที่ซ้อนทับนี้เปิดอยู่
การตั้งค่าคุณสมบัตินี้จะเพิ่มภาพซ้อนทับลงในแผนที่ การตั้งค่าเป็น nil จะนำการซ้อนทับนี้ออกจากแผนที่ ภาพซ้อนทับสามารถแสดงบนแผนที่ได้ไม่เกิน 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 มิฉะนั้นอาจมีการสร้างรอบการเก็บรักษา (ป้องกันไม่ให้ปล่อยวัตถุ)