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


ภาพรวม

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

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

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

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

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

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

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

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

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

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

+ (void) showTermsAndConditionsDialogIfneededWithTitle: (nullable NSString *)  ชื่อ [title]
ชื่อบริษัท: (NSString *) companyName
UIParams: (GMSNavigationTermsDialogUIParams ที่ไม่มีข้อมูลได้ *) UIParams
โค้ดเรียกกลับ: (GMSTermsResponseCallback) โทรกลับ

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

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

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

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

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

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

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

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

+ (void) showTermsAndConditionsDialogIfneededWithCompanyName: (NSString *) companyName
โค้ดเรียกกลับ: (GMSTermsResponseCallback) โทรกลับ

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

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

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

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

หลังจากเรียกใช้เมธอดนี้ areTermsAndConditionsAccepted จะแสดงค่า "ไม่" และ showTermsAndConditionsDialogIfNeededWithCompanyName:callback: จะแสดงกล่องโต้ตอบข้อกำหนดและเงื่อนไข ระบบจะรีเซ็ตพร็อพเพอร์ตี้ navigationEnabled ของอินสแตนซ์ GMSMapView ที่มีอยู่เป็น NO

+ (void) setAbnormalExpirationReportingEnabled: (BOOL)  abnormalTerminationReportingEnabled

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

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

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

+ (GMSNavigationSession ว่างเปล่า *) createNavigationSession

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

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

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

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

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

+ (NSString *) openSourceLicenseInfo

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

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

+ (NSString *) navSDKVersion

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


- (typedef void(^ GMSTermsResponseCallback)(ข้อกำหนดของ BOOL ที่ได้)) [related]

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


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

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

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

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

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

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