การนําทาง API

คลาสสุดท้ายสาธารณะ NavigationApi ขยายออบเจ็กต์

จุดแรกเข้าไปยัง Navigation API ใช้วิธีการแบบคงที่ในคลาสนี้เพื่อรับการอ้างอิงไปยัง Navigator

สรุปข้อมูลชั้นเรียนที่ซ้อนกัน

@อินเทอร์เฟซ	NavigationApi.ErrorCode		ErrorCode คือรหัสสถานะที่ getNavigator(Activity, NavigatorListener) และ getNavigator(Application, NavigatorListener) แสดงผลเมื่อรับ Navigator ไม่สำเร็จ
ที่ปรับปรุงใหม่	NavigationApi.NavigatorListener		ลงทะเบียน NavigatorListener กับ getNavigator(Activity, NavigatorListener) เพื่อรับการแจ้งเตือนเกี่ยวกับสถานะของ Navigator ดังกล่าว
ที่ปรับปรุงใหม่	NavigationApi.OnTermsResponseListener		ลงทะเบียน OnTermsResponseListener ด้วย showTermsAndConditionsDialog(Activity, String, OnTermsResponseListener) เพื่อรับการแจ้งเตือนเมื่อผู้ใช้ยอมรับหรือปฏิเสธข้อกำหนดและเงื่อนไข

สรุปวิธีการสาธารณะ

บูลีน แบบคงที่	areTermsAccepted(ใบสมัครใบสมัคร) แสดงผล true หากผู้ใช้ยอมรับข้อกำหนดและเงื่อนไขสำหรับการนำทางของ Google ไว้ก่อนหน้านี้
คงที่ เป็นโมฆะ	ล้าง() ล้างข้อมูลสถานะภายในของคอมโพเนนต์ NavSDK
ซิงค์แล้ว static ForegroundServiceManager	getForegroundServiceManager(แอปพลิเคชันแอปพลิเคชัน) รับอินสแตนซ์ ForegroundServiceManager เดี่ยว
static สตริง	getNavSDKVersion() แสดงผล NavSDK เวอร์ชันปัจจุบัน
คงที่ เป็นโมฆะ	getNavigator(แอปพลิเคชันแอปพลิเคชัน, โค้ดเรียกกลับ NavigationApi.NavigatorListener) รับอินสแตนซ์ Navigator
คงที่ เป็นโมฆะ	getNavigator(กิจกรรมกิจกรรม, โค้ดเรียกกลับ NavigationApi.NavigatorListener, TermsAndConditionsCheckOption TermsCheck) รับอินสแตนซ์ Navigator
คงที่ เป็นโมฆะ	getNavigator(กิจกรรมกิจกรรม, โค้ดเรียกกลับ NavigationApi.NavigatorListener) เทียบเท่ากับ getNavigator(activity, callback, {@link TermsAndConditionsCheckOption#ENABLED}
คงที่ เป็นโมฆะ	getNavigatorNoToS(แอปพลิเคชันแอปพลิเคชัน, โค้ดเรียกกลับ NavigationApi.NavigatorListener) รับอินสแตนซ์ Navigator
static RoadSnappedLocationProvider	getRoadSnappedLocationProvider(แอปพลิเคชันแอปพลิเคชัน) รับอินสแตนซ์ของ RoadSnappedLocationProvider ซึ่งสามารถใช้เพื่อสมัครใช้บริการตำแหน่งของผู้ใช้ที่ถูกสแนปถนนได้
แบบคงที่ NavigationTransactionRecorder	getTransactionRecorder(แอปพลิเคชันแอปพลิเคชัน) รับอินสแตนซ์ของ NavigationTransactionRecorder ซึ่งสามารถใช้เพื่อบันทึกธุรกรรมที่เกี่ยวข้องกับการนำทาง
ทำให้ข้อมูลตรงกันแล้ว คงที่ โมฆะ	initForegroundServiceManager(แอปพลิเคชันแอปพลิเคชัน, รหัสการแจ้งเตือนจำนวนเต็ม, String defaultMessage, ผู้ให้บริการ NotificationContentProvider) เริ่มต้นอินสแตนซ์ ForegroundServiceManager ด้วยอาร์กิวเมนต์ที่ระบุ
คงที่ เป็นโมฆะ	resetTermsAccepted(ใบสมัครแอปพลิเคชัน) รีเซ็ตข้อกำหนดในการให้บริการ - สำหรับการทดสอบ
คงที่ เป็นโมฆะ	showTermsAndConditionsDialog(กิจกรรมกิจกรรม, String companyName, ชื่อสตริง, Listener NavigationApi.OnTermsResponseListener) แสดงกล่องโต้ตอบที่ให้ผู้ใช้ยอมรับข้อกำหนดและเงื่อนไขของการนำทางของ Google โดยใช้รูปลักษณ์เริ่มต้น
คงที่ เป็นโมฆะ	showTermsAndConditionsDialog(กิจกรรมกิจกรรม, String companyName, ชื่อสตริง, uiParams TermsAndConditionsUIParams, NavigationApi.OnTermsResponseListener, TermsAndConditionsCheckOptiontermsAndConditionsCheckOption) แสดงกล่องโต้ตอบที่ให้ผู้ใช้ยอมรับข้อกำหนดในการให้บริการของการนำทางของ Google
คงที่ เป็นโมฆะ	showTermsAndConditionsDialog(กิจกรรมกิจกรรม, String companyName, Listener NavigationApi.OnTermsResponseListener) แสดงกล่องโต้ตอบที่ให้ผู้ใช้ยอมรับข้อกำหนดและเงื่อนไขของการนำทางของ Google โดยใช้ชื่อเริ่มต้นและรูปลักษณ์เริ่มต้น

ข้อมูลสรุปของเมธอดที่รับช่วงมา

จากคลาส java.lang.Object

boolean	เท่ากับ(อาร์กิวเมนต์วัตถุ 0)
จบ คลาส<?>	getClass()
int	hashCode()
สุดท้าย เป็นโมฆะ	notify()
สุดท้าย เป็นโมฆะ	notifyAll()
สตริง	toString()
สุดท้าย เป็นโมฆะ	wait(long arg0, int arg1)
สุดท้าย เป็นโมฆะ	รอ(อาร์กิวเมนต์ยาว0)
สุดท้าย เป็นโมฆะ	รอ (()

วิธีการสาธารณะ

สาธารณะ คงที่ บูลีน areTermsAccepted (แอปพลิเคชันแอปพลิเคชัน)

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

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

พารามิเตอร์

แอปพลิเคชัน	แอปพลิเคชันปัจจุบัน

คิกรีเทิร์น

• trueหากผู้ใช้ยอมรับข้อกำหนดแล้ว และfalse

สาธารณะ คงที่ โมฆะ ล้าง ()

ล้างข้อมูลสถานะภายในของคอมโพเนนต์ NavSDK หากมีตัวนำทางปัจจุบันอยู่ การนำทางจะหยุดและปิดใช้ การนำทางนี้ไม่สามารถขอคำแนะนำได้อีกในอนาคต เรียกใช้เมธอดนี้เพื่อกู้คืนหน่วยความจำเมื่อแอปของคุณไม่ต้องใช้ Navigator แล้ว และแอปได้ทำลายการอ้างอิงไปยัง Navigator ทั้งหมดแล้ว หากแอปของคุณต้องใช้ Navigator หลังจากการเรียกนี้ ให้ใช้ getNavigator() เพื่อสร้างใหม่ หมายเหตุ: การสร้างการนำทางใหม่ต้องใช้เวลา ลองพิจารณาว่าความล่าช้าจะส่งผลต่อประสิทธิภาพของแอปอย่างไรเมื่อเทียบกับประโยชน์ของหน่วยความจำที่กู้คืน

สาธารณะ คงที่ ซิงค์ ForegroundServiceManager getForegroundServiceManager (แอปพลิเคชันแอปพลิเคชัน)

รับอินสแตนซ์ ForegroundServiceManager เดี่ยว หากไม่มีการเรียกใช้ initForegroundServiceManager(Application, Integer, String, NotificationContentProvider) ก่อน getForegroundServiceManager(Application) ระบบจะใช้รหัสการแจ้งเตือนเริ่มต้น ข้อความ และผู้ให้บริการการแจ้งเตือน

พารามิเตอร์

แอปพลิเคชัน	Application ปัจจุบัน

สาธารณะ คงที่ สตริง getNavSDKVersion ()

แสดงผล NavSDK เวอร์ชันปัจจุบัน

สาธารณะ คงที่ void getNavigator (แอปพลิเคชันแอปพลิเคชัน, โค้ดเรียกกลับ NavigationApi.NavigatorListener)

รับอินสแตนซ์ Navigator

หากผู้ใช้ยังไม่ได้ยอมรับข้อกำหนดและเงื่อนไข โค้ดเรียกกลับจะเริ่มทำงานทันทีพร้อมรหัสข้อผิดพลาด TERMS_NOT_ACCEPTED

โปรดทราบว่า Navigator เป็น Singleton หากคุณเรียกใช้เมธอดนี้หลายครั้ง การเรียกแต่ละครั้งจะแสดง Navigator เดียวกัน

พารามิเตอร์

แอปพลิเคชัน	Application ปัจจุบัน
โค้ดเรียกกลับ	โค้ดเรียกกลับที่จะเริ่มทำงานเมื่อ Navigator พร้อมใช้งาน หรือเกิดข้อผิดพลาด

สาธารณะ คงที่ void getNavigator (กิจกรรมกิจกรรม, โค้ดเรียกกลับ NavigationApi.NavigatorListener, TermsAndConditionsCheckOption TermsCheck)

รับอินสแตนซ์ Navigator

หากผู้ใช้ยังไม่ได้ยอมรับข้อกำหนดและเงื่อนไข การโทรนี้จะแสดงกล่องโต้ตอบที่ขอให้ผู้ใช้ปฏิบัติตามกฎระเบียบท้องถิ่น

หาก termsCheck คือ ENABLED กล่องโต้ตอบจะมีลิงก์ไปยังข้อกำหนดและเงื่อนไขของ Navigation SDK ด้วย ระบบจะเรียกใช้ callback โดยมีข้อผิดพลาด TERMS_NOT_ACCEPTED หากผู้ใช้ยอมรับข้อกำหนดเหล่านี้

โปรดทราบว่า Navigator เป็น Singleton หากคุณเรียกใช้เมธอดนี้หลายครั้ง การเรียกแต่ละครั้งจะแสดง Navigator เดียวกัน

พารามิเตอร์

กิจกรรม	Activity เพื่อแสดงกล่องโต้ตอบข้อกำหนดและเงื่อนไขหากยังไม่มีการยอมรับ
โค้ดเรียกกลับ	โค้ดเรียกกลับที่จะเริ่มทำงานเมื่อ Navigator พร้อมใช้งาน หรือเกิดข้อผิดพลาด
termsCheck	ระบุว่าควรข้ามการตรวจสอบข้อกำหนดในการให้บริการหรือไม่

สาธารณะ static void getNavigator (กิจกรรมกิจกรรม, NavigationApi.NavigatorListener โค้ดเรียกกลับ)

เทียบเท่ากับ getNavigator(activity, callback, {@link TermsAndConditionsCheckOption#ENABLED}

พารามิเตอร์

กิจกรรม
โค้ดเรียกกลับ

ดูเพิ่มเติม

• getNavigator(Activity, NavigatorListener, TermsAndConditionsCheckOption)

สาธารณะ คงที่ void getNavigatorNoToS (แอปพลิเคชันแอปพลิเคชัน, โค้ดเรียกกลับ NavigationApi.NavigatorListener)

รับอินสแตนซ์ Navigator

ไม่เป็นไปตามข้อกำหนดและเงื่อนไข

โปรดทราบว่า Navigator เป็น Singleton หากคุณเรียกใช้เมธอดนี้หลายครั้ง การเรียกแต่ละครั้งจะแสดง Navigator เดียวกัน

พารามิเตอร์

แอปพลิเคชัน	Application ปัจจุบัน
โค้ดเรียกกลับ	โค้ดเรียกกลับซึ่งจะเริ่มทำงานเมื่อ Navigator พร้อมใช้งาน หรือเกิดข้อผิดพลาด

สาธารณะ static RoadSnappedLocationProvider getRoadSnappedLocationProvider (แอปพลิเคชันแอปพลิเคชัน)

รับอินสแตนซ์ของ RoadSnappedLocationProvider ซึ่งสามารถใช้เพื่อสมัครใช้บริการตำแหน่งของผู้ใช้ที่ถูกสแนปถนนได้ โปรดทราบว่าการสมัครรับข้อมูลการอัปเดตตำแหน่งที่ตัดถนนอาจทำให้แบตเตอรี่หมดหรือเก็บรวบรวมข้อมูลตำแหน่งของผู้ใช้โดยไม่ได้ตั้งใจหากปล่อยให้ทำงานในพื้นหลัง

ต้องได้รับ Navigator ก่อนเรียกใช้เมธอดนี้ มิฉะนั้นจะแสดงผลเป็น null

พารามิเตอร์

แอปพลิเคชัน	Application ปัจจุบัน

สาธารณะ static NavigationTransactionRecorder getTransactionRecorder (แอปพลิเคชัน)

รับอินสแตนซ์ของ NavigationTransactionRecorder ซึ่งสามารถใช้เพื่อบันทึกธุรกรรมที่เกี่ยวข้องกับการนำทาง

ควรใช้คลาสนี้ในกรณีที่ Google เรียกเก็บเงินจากบริษัทของคุณแบบ ต่อธุรกรรมเท่านั้น

ต้องได้รับ Navigator ก่อนเรียกใช้เมธอดนี้ มิฉะนั้นจะแสดงผลเป็น null

พารามิเตอร์

แอปพลิเคชัน	Application ปัจจุบัน

Public static ซิงโครไนซ์ void initForegroundServiceManager (แอปพลิเคชันแอปพลิเคชัน, รหัสการแจ้งเตือนจำนวนเต็ม, String defaultMessage, ผู้ให้บริการ NotificationContentProvider)

เริ่มต้นอินสแตนซ์ ForegroundServiceManager ด้วยอาร์กิวเมนต์ที่ระบุ

ระบบจะเรียกค่านี้เมื่อต้องการแก้ไขพารามิเตอร์เริ่มต้นเท่านั้น หรือโทรไปที่ getForegroundServiceManager(Application) โดยตรง ระบบจะเรียกใช้เมธอดนี้ได้เพียงครั้งเดียวเท่านั้นและต้องเรียกใช้ก่อนวันที่ getForegroundServiceManager(Application)

พารามิเตอร์

แอปพลิเคชัน	Application ปัจจุบัน
notificationId	รหัสการแจ้งเตือนสำหรับการแจ้งเตือนถาวร
defaultMessage	ข้อความเริ่มต้นที่จะแสดงหากไม่ได้ระบุ provider
ผู้ให้บริการ	การใช้งาน NotificationContentProvider

สาธารณะ static void resetTermsAccepted (แอปพลิเคชันแอปพลิเคชัน)

รีเซ็ตข้อกำหนดในการให้บริการ - สำหรับการทดสอบ เพิ่มการเรียกใช้นี้ก่อนที่จะเรียกไปยัง NavigationApi หากคุณต้องการทดสอบกล่องโต้ตอบข้อกำหนดและเงื่อนไข

พารามิเตอร์

แอปพลิเคชัน	แอปพลิเคชันปัจจุบัน

สาธารณะ static void showTermsAndConditionsDialog (กิจกรรมกิจกรรม, String companyName, ชื่อสตริง, NavigationApi.OnTermsResponseListener Listener)

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

พารามิเตอร์

กิจกรรม
companyName
title
Listener

ดูเพิ่มเติม

• for a description of the different parameters.

สาธารณะ คงที่ void showTermsAndConditionsDialog (กิจกรรมกิจกรรม, String companyName, ชื่อสตริง, TermsAndConditionsUIParams uiParams, NavigationApi.OnTermsResponseListenerListener, TermsAndConditionsCheckOption TermsAndConditionsCheckOption){/13

แสดงกล่องโต้ตอบที่ให้ผู้ใช้ยอมรับข้อกำหนดในการให้บริการของการนำทางของ Google หากระบุไว้ ระบบจะเรียกใช้ Listener ในเทรด UI โดยระบุว่าผู้ใช้ยอมรับข้อกำหนดและเงื่อนไขหรือไม่

โปรดทราบว่ากล่องโต้ตอบจะปรากฏขึ้นแม้ว่าผู้ใช้จะเคยยอมรับแล้วก็ตาม ควรเรียกใช้ URL นี้หาก areTermsAccepted(Application) คือ false เท่านั้น เนื่องจากผู้ใช้จะไม่ยอมรับข้อกําหนดและเงื่อนไขไม่ได้

พารามิเตอร์

กิจกรรม	Activity ที่กล่องโต้ตอบจะปรากฏขึ้น
companyName	ชื่อบริษัทของคุณ ซึ่งจะแสดงในกล่องโต้ตอบข้อกำหนดและเงื่อนไข
title	ชื่อของกล่องโต้ตอบ หาก Null กล่องโต้ตอบจะใช้ชื่อเริ่มต้น
uiParams	พารามิเตอร์ที่ใช้เพื่อปรับแต่งรูปลักษณ์ของกล่องโต้ตอบ หาก Null ระบบจะใช้รูปลักษณ์เริ่มต้น
Listener	โค้ดเรียกกลับซึ่งไม่บังคับซึ่งจะเริ่มทำงานเมื่อผู้ใช้ยอมรับหรือปฏิเสธข้อกำหนดและเงื่อนไข
termsAndConditionsCheckOption	TermsAndConditionsCheckOption ซึ่งระบุตัวเลือกสำหรับตรวจสอบข้อกำหนดและเงื่อนไข

สาธารณะ static void showTermsAndConditionsDialog (กิจกรรมกิจกรรม, String companyName, NavigationApi.OnTermsResponseListenerสู่Listener)

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

พารามิเตอร์

กิจกรรม
companyName
Listener

ดูเพิ่มเติม

• for a description of the different parameters.