การอ้างอิงคลาส GMSNavigationServices


ภาพรวม

บริการที่ช่วยให้ควบคุมการเข้าถึง Google Maps Navigation SDK สำหรับ iOS ผ่านอุปกรณ์เคลื่อนที่

ฟังก์ชันสมาชิกสาธารณะแบบคงที่

(BOOL) + areTermsAndConditionsAccepted
 สำหรับเวอร์ชัน >= 5.5.0 จะระบุว่าผู้ใช้รับทราบข้อกำหนดและเงื่อนไขแล้วหรือไม่
(void) + showTermsAndConditionsDialogIfNeededWithTitle:companyName:UIParams:callback:
 แสดงกล่องโต้ตอบโมดัลหากผู้ใช้แอปยังไม่ได้ยอมรับข้อกำหนดและเงื่อนไขของ Navigation SDK
(void) + showTermsAndConditionsDialogIfNeededWithTitle:companyName:callback:
 แสดงกล่องโต้ตอบข้อกำหนดและเงื่อนไขโดยใช้รูปลักษณ์เริ่มต้น
(void) + showTermsAndConditionsDialogIfneededWithCompanyName:ติดต่อกลับ:
 แสดงกล่องโต้ตอบข้อกำหนดและเงื่อนไขโดยใช้ชื่อและรูปลักษณ์เริ่มต้น
(void) + resetTermsAndConditionsAccepted
 รีเซ็ตข้อกำหนดในการให้บริการเป็นสถานะที่ยอมรับไม่ได้
(void) + setAbnormalCompleteReportingEnabled:
 เปิดใช้การรายงานการสิ้นสุดการใช้งาน SDK ที่ผิดปกติ เช่น แอปขัดข้องขณะที่ SDK ยังทำงานอยู่
(GMSNavigationSession *) ที่ไม่มีข้อมูลได้+ createNavigationSession
 สร้างเซสชันการนำทางใหม่ซึ่งไม่เชื่อมโยงกับมุมมองแผนที่
(NSString *)+ openSourceLicenseInfo
 ส่งคืนข้อมูลใบอนุญาตซอฟต์แวร์โอเพนซอร์สสำหรับ Google Navigation SDK สำหรับ iOS
(NSString *)+ navSDKVersion
 แสดงผลเวอร์ชันสำหรับ Navigation SDK สำหรับ iOS รุ่นนี้

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

บูลีนshouldOnlyShowDriverAwarenesssDisclaimer
 ระบุว่า showTermsAndConditionsDialogIfNeededWithCompanyName:callback: ควรแสดงข้อจำกัดความรับผิดเกี่ยวกับการรับรู้ของผู้ขับเท่านั้นหรือไม่

(โปรดทราบว่ารายการเหล่านี้ไม่ใช่ฟังก์ชันสมาชิก)

typedef void(^)GMSTermsResponseCallback )(ข้อกำหนด BOOL ที่ยอมรับ)
 เรียกใช้เมื่อผู้ใช้ยอมรับหรือปฏิเสธข้อกำหนดและเงื่อนไข

เอกสารประกอบเกี่ยวกับฟังก์ชันของสมาชิก

สำหรับเวอร์ชัน >= 5.5.0 จะระบุว่าผู้ใช้รับทราบข้อกำหนดและเงื่อนไขแล้วหรือไม่

สำหรับเวอร์ชันก่อนหน้าจะระบุว่าผู้ใช้ยอมรับข้อกำหนดและเงื่อนไขหรือไม่

หากเป็น "เท็จ" บริการจะปิดการเข้าถึงอินเทอร์เฟซการนำทาง

+ (เป็นโมฆะ) showTermsAndConditionsDialogIfLimitedWithTitle: (nullable NSString *)  ชื่อ [title]
ชื่อบริษัท: (NSString *) companyName
UIParams: (GMSNavigationTermsDialogUIParams ที่เป็นค่าว่างได้ *) UIParams
ติดต่อกลับ: (GMSTermsResponseCallback) ติดต่อกลับ

แสดงกล่องโต้ตอบโมดัลหากผู้ใช้แอปยังไม่ได้ยอมรับข้อกำหนดและเงื่อนไขของ Navigation SDK

ระบบจะส่งโค้ดเรียกกลับที่คิวหลักพร้อมคำตอบของผู้ใช้

หากผู้ใช้ยอมรับข้อกำหนดและเงื่อนไขแล้ว กล่องโต้ตอบจะไม่ปรากฏขึ้น และโค้ดเรียกกลับมี termsAccepted = YES

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

เรียกใช้เมธอดนี้จากเทรดหลัก การโทรหลายครั้งโดยไม่รอการตอบกลับจะไม่มีผล

พารามิเตอร์:
titleชื่อของกล่องโต้ตอบ หาก title เป็น nil กล่องโต้ตอบจะใช้ชื่อเริ่มต้น
หมายเหตุ
สำหรับชื่อที่กำหนดเอง ผู้เรียกใช้เมธอดนี้จะต้องแปลพารามิเตอร์นี้ บริการจะแปลเนื้อหาเริ่มต้นโดยอัตโนมัติ
พารามิเตอร์:
companyNameชื่อบริษัทที่เผยแพร่แอปและในข้อตกลงกับ Google ที่จะแชร์ข้อมูลตำแหน่ง
UIParamsพารามิเตอร์ที่กําหนดรูปลักษณ์ของกล่องโต้ตอบ หากเป็นค่าว่าง กล่องโต้ตอบจะใช้รูปลักษณ์เริ่มต้น
Callbackส่งการบล็อกบนคิวหลักพร้อมการตอบกลับของผู้ใช้แล้ว
+ (เป็นโมฆะ) showTermsAndConditionsDialogIfLimitedWithTitle: (nullable NSString *)  ชื่อ [title]
ชื่อบริษัท: (NSString *) companyName
ติดต่อกลับ: (GMSTermsResponseCallback) ติดต่อกลับ

แสดงกล่องโต้ตอบข้อกำหนดและเงื่อนไขโดยใช้รูปลักษณ์เริ่มต้น

โปรดดู +showTermsAndConditionsDialogIf WantedWithTitle:companyName:UIParams:callback: เพื่อดูรายละเอียด รวมถึงคำอธิบายพารามิเตอร์ companyName และ callback

+ (เป็นโมฆะ) showTermsAndConditionsDialogIfneededWithCompanyName: (NSString *) companyName
ติดต่อกลับ: (GMSTermsResponseCallback) ติดต่อกลับ

แสดงกล่องโต้ตอบข้อกำหนดและเงื่อนไขโดยใช้ชื่อและรูปลักษณ์เริ่มต้น

โปรดดูรายละเอียด รวมถึงคำอธิบายพารามิเตอร์ companyName และ callback ที่ +showTermsAndConditionsDialogIfneededWithTitle:companyName:UIParams:callback:

+ (เป็นโมฆะ) resetTermsAndConditionsAccepted

รีเซ็ตข้อกำหนดในการให้บริการเป็นสถานะที่ยอมรับไม่ได้

หลังจากเรียกใช้เมธอดนี้แล้ว areTermsAndConditionsAccepted จะแสดงผลเป็น NO และ #if SDK_BUILD_CONFIG(EnabledNavSDKSwitchToSOptions) showTermsAndConditionsDialogIfNeededWithOptions:callback: และ #endif showTermsAndConditionsDialogIfNeededWithCompanyName:callback: จะแสดงกล่องโต้ตอบข้อกำหนดและเงื่อนไข ระบบจะรีเซ็ตพร็อพเพอร์ตี้ navigationEnabled ของอินสแตนซ์ GMSMapView ที่มีอยู่เป็น NO

+ (เป็นโมฆะ) setAbnormalCloseReportingEnabled: (BOOL)  abnormalTerminationReportingEnabled

เปิดใช้การรายงานการสิ้นสุดการใช้งาน SDK ที่ผิดปกติ เช่น แอปขัดข้องขณะที่ SDK ยังทำงานอยู่

วิธีนี้ช่วยให้ Google ปรับปรุงความเสถียรของ SDK ได้ (หากมี) ค่าเริ่มต้นคือ YES และต้องมีการอัปเดตค่าก่อนที่อินสแตนซ์ของบริการจะเริ่มต้น

ต้องตั้งค่าพร็อพเพอร์ตี้นี้จากเทรดหลัก

+ (GMSNavigationSession *) ได้ (Nullable) createNavigationSession

สร้างเซสชันการนำทางใหม่ซึ่งไม่เชื่อมโยงกับมุมมองแผนที่

ซึ่งจะจัดสรรและแสดงผลเซสชันการนำทางใหม่ ระบบอาจกำหนดจุดอ้างอิงและตัวเลือกในเซสชัน และอาจเพิ่ม Listener ลงในเซสชันด้วย

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

คุณสามารถเชื่อมโยงเซสชันนี้กับแผนที่หลังจากที่สร้างโดยใช้ GMSMapView เมธอด -enableNavigationWithSession: เซสชันคือวัตถุหนักที่ใช้หน่วยความจำ ข้อมูล และแบตเตอรี่ ดังนั้นจึงควรจัดสรรเฉพาะเมื่อเซสชันการนำทางแบบถาวรเป็นฟีเจอร์หลักของแอปพลิเคชันเท่านั้น ด้วยเหตุผลเดียวกันนี้ หากแอปสร้าง UI การนำทางหลังจากสร้างเซสชันการนำทางแล้ว อย่าลืมเริ่ม UI การนำทางด้วยเซสชันการนำทางที่มีอยู่แทนที่จะสร้าง UI ใหม่

อายุการใช้งานของเซสชันการนำทางจะควบคุมด้วยความหมายของ Objective-C ปกติ ดังนั้น ผู้เรียกใช้กิจวัตรนี้จึงควรบันทึกการอ้างอิงไปยังเซสชัน

+ (NSString *) openSourceLicenseInfo

ส่งคืนข้อมูลใบอนุญาตซอฟต์แวร์โอเพนซอร์สสำหรับ Google Navigation SDK สำหรับ iOS

ข้อมูลนี้ต้องแสดงอยู่ในแอปพลิเคชันของคุณ

+ (NSString *) navSDKVersion

แสดงผลเวอร์ชันสำหรับ Navigation SDK สำหรับ iOS รุ่นนี้


- (typedef void(^ GMSTermsResponseCallback)(BOOLเหตุการณ์ที่ยอมรับ)) [related]

เรียกใช้เมื่อผู้ใช้ยอมรับหรือปฏิเสธข้อกำหนดและเงื่อนไข

สำหรับเวอร์ชัน >= 5.5.0 termsAccepted จะเป็น "ใช่" เสมอ


เอกสารประกอบเกี่ยวกับอสังหาริมทรัพย์

- (BOOL) shouldOnlyShowDriverAwarenesssDisclaimer [read, write, assign]

ระบุว่า showTermsAndConditionsDialogIfNeededWithCompanyName:callback: ควรแสดงข้อจำกัดความรับผิดเกี่ยวกับการรับรู้ของผู้ขับเท่านั้นหรือไม่

ค่าเริ่มต้นคือ NO และข้อจํากัดความรับผิดจะแสดงเพิ่มเติมจากข้อกำหนดในการให้บริการเริ่มต้นที่มาพร้อมกับ Navigation SDK ตั้งค่าเป็น YES เพื่อระบุว่าควรแสดงเฉพาะข้อจำกัดความรับผิดด้านการรับรู้ของผู้ขับเท่านั้น

หากโปรเจ็กต์ต้องแสดงกล่องโต้ตอบข้อกำหนดและเงื่อนไข การตั้งค่าตัวแปรนี้เป็น YES จะไม่มีผล นอกจากนี้ Method ของ Getter จะแสดงผล NO เสมอ

ต้องตั้งค่าหรืออ่านพร็อพเพอร์ตี้นี้จากเทรดหลัก