คอมโพเนนต์การนำทางในแอป แฟรกเมนต์นี้เป็นวิธีที่ง่ายที่สุดในการใช้การนำทางในแอปพลิเคชัน ซึ่งเป็น Wrapper มุมมองของแผนที่การนำทางเพื่อจัดการกับความต้องการที่จำเป็นในวงจรโดยอัตโนมัติ เมื่อเป็นส่วนย่อย คุณจะเพิ่มคอมโพเนนต์นี้ลงในไฟล์เลย์เอาต์ของกิจกรรมได้ง่ายๆ โดยใช้ XML ด้านล่าง
<fragment class="com.google.android.libraries.navigation.NavigationFragment" android:layout_width="match_parent" android:layout_height="match_parent"/>
สรุปค่าคงที่ที่รับช่วงมา
สรุปเครื่องมือสร้างสาธารณะ
NavigationFragment() ของคุณ
|
สรุปวิธีการสาธารณะ
กล้อง |
getCamera()
แสดงวัตถุกล้องถ่ายรูปที่สามารถใช้เพื่อเปลี่ยนวิวพอร์ตของแผนที่
|
NavigationMap |
getMap() ได้
แสดงวัตถุที่สามารถใช้เพิ่มเนื้อหาลงในแผนที่
|
void |
onConfigurationChanged(การกำหนดค่าการกำหนดค่า)
|
ดู |
onCreateView(LayoutInflater Inflater, คอนเทนเนอร์ ViewGroup, Bundle ที่บันทึกไว้ InstanceState)
|
void | |
void |
onPause()
|
void |
onResume()
|
void |
onSaveInstanceState(Bundle outState)
|
void |
onStart()
|
void |
onStop()
|
void |
onTrimMemory(ระดับสี)
|
void |
setCalloutInfoDisplayModeOverride(NavigationCalloutDisplayMode calloutInfoDisplayModeOverride)
ลบล้างโหมดการแสดงผลเริ่มต้นสำหรับไฮไลต์เวลาถึงโดยประมาณระหว่างการนำทาง
|
void |
setCalloutInfoFormatOverride(RouteCalloutInfoFormat calloutInfoFormatOverride)
ตั้งค่าโหมดรูปแบบข้อมูลไฮไลต์สำหรับไฮไลต์เส้นทาง
|
void |
setCompassEnabled(เปิดใช้บูลีน)
ตั้งค่าว่าจะให้มองเห็นเข็มทิศหรือไม่
|
void |
setCustomControl(ดูการควบคุม, ตำแหน่ง CustomControlPosition)
ตั้งค่ามุมมองการควบคุมที่กำหนดเองซึ่งจะปรากฏในตำแหน่งที่กำหนดใน UI การนำทาง
|
void |
setEtaCardEnabled(เปิดใช้บูลีน)
ตั้งค่าว่าจะแสดงการ์ดเวลาถึงโดยประมาณระหว่างการนำทางหรือไม่
|
void |
setForceNightMode(int forceNightMode)
|
void |
setHeaderEnabled(เปิดใช้บูลีน)
ตั้งค่าว่าส่วนหัวการนำทางแบบเลี้ยวต่อเลี้ยวจะปรากฏระหว่างการนำทางหรือไม่
|
void |
setOnNightModeChangedListener(Listener NavigationView.OnNightModeChangedListener)
ตั้งค่า Listener ซึ่งจะได้รับแจ้งเมื่อ UI เข้าหรือออกจากโหมดกลางคืน
|
void |
setOnRecenterButtonClickedListener(ListenerNavigationView.OnRecenterButtonClickedListener)
ตั้งค่าผู้ฟังซึ่งจะได้รับแจ้งเมื่อมีการคลิกปุ่มตัวล่าสุด
|
void |
setRecenterButtonEnabled(เปิดใช้บูลีน)
ตั้งค่าว่าควรแสดงปุ่มกึ่งกลางใหม่หรือไม่
|
void |
setSpeedAlertOptions(SpeedAlertOptions SpeedAlertOptions)
ตั้งค่า
SpeedAlertOptions เพื่อปรับแต่งเกณฑ์ทริกเกอร์สำหรับ SpeedAlertSeverity |
void |
setSpeedLimitIconEnabled(เปิดใช้บูลีน)
ระบุว่าจะแสดงไอคอนการจำกัดความเร็วหรือไม่
|
void |
setSpeedometerIconEnabled(เปิดใช้บูลีน)
ระบุว่าจะแสดงไอคอนมาตรวัดความเร็วหรือไม่
|
void |
setSpeedometerUiOptions(SpeedometerUiOptions SpeedAlertUiOptions)
กำหนดค่า UI ของเครื่องวัดความเร็ว
SpeedometerUiOptions ตาม SpeedAlertSeverity |
void | |
void |
setTrafficIncidentCardsEnabled(เปิดใช้บูลีน)
ตั้งค่าว่าควรแสดงการ์ดปัญหาการจราจรหรือไม่ เมื่อผู้ใช้คลิกไอคอนเหตุการณ์การจราจร
|
void |
setTrafficPromptsEnabled(เปิดใช้บูลีน)
ตั้งค่าว่าควรแสดงข้อความแจ้งเกี่ยวกับการจราจรหรือไม่
|
ข้อมูลสรุปของเมธอดที่รับช่วงมา
ผู้รับสร้างสาธารณะ
สาธารณะ NavigationFragment ()
วิธีการสาธารณะ
สาธารณะ กล้อง getCamera ()
แสดงวัตถุกล้องถ่ายรูปที่สามารถใช้เพื่อเปลี่ยนวิวพอร์ตของแผนที่
คิกรีเทิร์น
- ออบเจ็กต์
Camera
ที่เชื่อมโยงกับส่วนย่อยนี้
สาธารณะ void onConfigurationChanged (การกำหนดค่าการกำหนดค่า)
พารามิเตอร์
การกำหนดค่า |
---|
สาธารณะ ดู onCreateView (LayoutInflater inflater, คอนเทนเนอร์ ViewGroup, Bundle SavedInstanceState)
พารามิเตอร์
ลมเป่าลม | |
---|---|
คอนเทนเนอร์ | |
savedInstanceState |
สาธารณะ void onDestroy ()
สาธารณะ void onPause ()
สาธารณะ void onResume ()
สาธารณะ void onSaveInstanceState (Bundle outState)
พารามิเตอร์
outState |
---|
สาธารณะ void onStart ()
สาธารณะ void onStop ()
สาธารณะ void onTrimMemory (ระดับสี)
พารามิเตอร์
ระดับ |
---|
สาธารณะ void setCalloutInfoDisplayModeOverride (NavigationCalloutDisplayMode calloutInfoDisplayModeOverride)
ลบล้างโหมดการแสดงผลเริ่มต้นสำหรับไฮไลต์เวลาถึงโดยประมาณระหว่างการนำทาง การส่งผ่าน Null จะรีเซ็ตโหมดการแสดงผลเริ่มต้น
พารามิเตอร์
calloutInfoDisplayModeOverride | โหมดการแสดงผลใหม่ที่ต้องการ |
---|
สาธารณะ void setCalloutInfoFormatOverride (RouteCalloutInfoFormat calloutInfoFormatOverride)
ตั้งค่าโหมดรูปแบบข้อมูลไฮไลต์สำหรับไฮไลต์เส้นทาง หากไม่ได้เรียกใช้เมธอดนี้ ไฮไลต์จะเป็นไปตามลักษณะการทำงานตามที่กำหนดโดย Route calloutInfoFormat.DEFAULT
พารามิเตอร์
calloutInfoFormatOverride | รูปแบบไฮไลต์ใหม่ที่ต้องการ |
---|
สาธารณะ void setCompassEnabled (boolean enabled)
ตั้งค่าว่าจะให้มองเห็นเข็มทิศหรือไม่ เมธอดนี้ควรเรียกใช้ในเธรด UI เท่านั้น
พารามิเตอร์
เปิดใช้อยู่ |
---|
สาธารณะ void setCustomControl (ดูการควบคุม ตำแหน่ง CustomControlPosition)
ตั้งค่ามุมมองการควบคุมที่กำหนดเองซึ่งจะปรากฏในตำแหน่งที่กำหนดใน UI การนำทาง หากมีการควบคุมที่กำหนดเองอยู่แล้วในตำแหน่งที่กำหนด ระบบจะแทนที่การควบคุมดังกล่าว การเรียกใช้เมธอดนี้ที่มีค่าการควบคุมแบบ Null จะเป็นการนำการควบคุมที่กำหนดเองออกจากตำแหน่งที่ระบุ หากเพิ่มตัวควบคุมในตำแหน่งอื่นแล้วหรือมีระดับบนสุดอยู่แล้ว ระบบจะไม่สนใจการควบคุมดังกล่าว เมธอดนี้ควรเรียกใช้ในเธรด UI เท่านั้น
พารามิเตอร์
การควบคุม | มุมมองที่จะอยู่ใน UI การนำทาง |
---|---|
position | กำหนดตำแหน่งที่วางการควบคุมที่กำหนดเองใน UI ที่สัมพันธ์กับการควบคุมในตัว |
สาธารณะ void setEtaCardEnabled (boolean enabled)
ตั้งค่าว่าจะแสดงการ์ดเวลาถึงโดยประมาณระหว่างการนำทางหรือไม่ ควรเรียกใช้เมธอดนี้ในเธรด UI เท่านั้น
พารามิเตอร์
เปิดใช้อยู่ |
---|
สาธารณะ void setForceNightMode (int forceNightMode)
พารามิเตอร์
forceNightMode |
---|
สาธารณะ void setHeaderEnabled (boolean enabled)
ตั้งค่าว่าส่วนหัวการนำทางแบบเลี้ยวต่อเลี้ยวจะปรากฏระหว่างการนำทางหรือไม่ เมธอดนี้ควรเรียกใช้ในเธรด UI เท่านั้น
พารามิเตอร์
เปิดใช้อยู่ |
---|
สาธารณะ void setOnNightModeChangedListener (NavigationView.OnNightModeChangedListener)
ตั้งค่า Listener ซึ่งจะได้รับแจ้งเมื่อ UI เข้าหรือออกจากโหมดกลางคืน เมธอดนี้ควรเรียกใช้ในเธรด UI เท่านั้น
หมายเหตุ: เพื่อหลีกเลี่ยงการรั่วไหลของหน่วยความจำ ระบบควรเรียกใช้ setOnNightModeChangedListener(null)
เมื่อไม่จำเป็นต้องใช้ Listener อีกต่อไป
พารามิเตอร์
Listener | Listener ซึ่งจะได้รับการแจ้งเตือนเมื่อ UI เข้าหรือออกจากโหมดกลางคืน |
---|
สาธารณะ void setOnRecenterButtonClickedListener (NavigationView.OnRecenterButtonClickedListener Listener)
ตั้งค่าผู้ฟังซึ่งจะได้รับแจ้งเมื่อมีการคลิกปุ่มตัวล่าสุด เมธอดนี้ควรเรียกใช้ในเธรด UI เท่านั้น
หมายเหตุ: เพื่อหลีกเลี่ยงการรั่วไหลของหน่วยความจำ คุณควรเรียกใช้ setOnRecenterButtonClickedListener(null)
เมื่อไม่จำเป็นต้องใช้ Listener อีกต่อไป
พารามิเตอร์
Listener | ผู้ฟังซึ่งจะได้รับการแจ้งเตือนเมื่อมีการคลิกปุ่มจัดกึ่งกลางใหม่ |
---|
สาธารณะ void setRecenterButtonEnabled (boolean enabled)
ตั้งค่าว่าควรแสดงปุ่มกึ่งกลางใหม่หรือไม่ ควรเรียกใช้เมธอดนี้ในเธรด UI เท่านั้น
พารามิเตอร์
เปิดใช้อยู่ |
---|
สาธารณะ void setSpeedAlertOptions (SpeedAlertOptions SpeedAlertOptions)
ตั้งค่า SpeedAlertOptions
เพื่อปรับแต่งเกณฑ์ทริกเกอร์สำหรับ SpeedAlertSeverity
คุณสามารถใช้วิธีนี้เพื่อปรับแต่งเกณฑ์การทริกเกอร์การแจ้งเตือนความเร็วเป็นเปอร์เซ็นต์สำหรับทั้งการแจ้งเตือน MINOR
และ MAJOR
คุณยังใช้วิธีนี้เพื่อกำหนดค่าเวลาเป็นวินาทีที่จำเป็นต่อการอัปเกรดการแจ้งเตือนความเร็วจาก MINOR
เป็น MAJOR
ได้ด้วย
เมื่อตั้งค่า null
SpeedAlertOptions
หรือไม่ได้ตั้งค่า การแจ้งเตือนความเร็วเริ่มต้นของ NavSDK จะแสดงขึ้นมา โดยการแจ้งเตือนความเร็วจะแสดงข้อความสีแดงในพื้นหลังสีขาว/สีเข้มสำหรับโหมดกลางวัน/กลางคืนตามลำดับเมื่อมีความเร็วต่ำกว่า 5 ไมล์ต่อชั่วโมงหรือ 10 กิโลเมตรต่อชั่วโมง และแสดงข้อความสีขาวบนพื้นหลังสีแดงเมื่อเร่งความเร็วมากกว่า 5 ไมล์ต่อชั่วโมงหรือ 10 กิโลเมตรต่อชั่วโมง
พารามิเตอร์
speedAlertOptions |
---|
สาธารณะ void setSpeedLimitIconEnabled (boolean enabled)
ระบุว่าจะแสดงไอคอนการจำกัดความเร็วหรือไม่ เรียกใช้เมธอดนี้ในเธรด UI เท่านั้น
เมื่อเปิดใช้ ไอคอนขีดจำกัดความเร็วซึ่งระบุขีดจำกัดความเร็วของถนนจะปรากฏขึ้นที่มุมเริ่มต้นด้านล่างระหว่างการแนะนำ ไอคอนนี้จะปรากฏเฉพาะในพื้นที่ที่มีข้อมูลขีดจำกัดความเร็วที่เชื่อถือได้ เมื่อไอคอนมาตรวัดความเร็วปรากฏขึ้น แสดงว่ามีการแนบไอคอนวัดความเร็วไว้
หากเปิดใช้ปุ่มจัดกึ่งกลางใหม่ ไอคอนการจำกัดความเร็วจะซ่อนไว้ชั่วคราวเมื่อปุ่มจัดกึ่งกลางใหม่ปรากฏขึ้น
หมายเหตุ: คนขับต้องปฏิบัติตามป้ายที่ติดไว้ทั้งหมดบนถนน และใช้ไอคอนจำกัดความเร็วเป็นข้อมูลอ้างอิงเท่านั้น ไม่รับประกันความถูกต้องของข้อมูลขีดจำกัดความเร็ว คุณรายงานความไม่ถูกต้องของข้อมูลขีดจำกัดความเร็วได้โดยส่งเคสในพอร์ทัลการสนับสนุนของ Google Cloud
พารามิเตอร์
เปิดใช้อยู่ |
---|
สาธารณะ void setSpeedometerIconEnabled (boolean enabled)
ระบุว่าจะแสดงไอคอนมาตรวัดความเร็วหรือไม่ เรียกใช้เมธอดนี้ในเธรด UI เท่านั้น
เมื่อเปิดใช้ ไอคอนมาตรวัดความเร็วที่แสดงความเร็วของยานพาหนะจะปรากฏในมุมเริ่มต้นด้านล่างระหว่างการนำทาง เมื่อไอคอนจำกัดความเร็วปรากฏ ไอคอนดังกล่าวจะแนบอยู่ และมาตรวัดความเร็วอาจมีสีสำหรับข้อความและพื้นหลังได้ ทั้งนี้ขึ้นอยู่กับความรุนแรงที่เร่งให้เร็วขึ้น
การเปิดใช้ไอคอนตัวเร่งความเร็วจะทำให้ไอคอนจำกัดความเร็วเปลี่ยนไปด้วย แต่คุณจะใช้ setSpeedLimitIconEnabled(boolean)
เพื่อปิด/เปิดใช้ไอคอนจำกัดความเร็วแยกต่างหากได้
หากเปิดใช้ปุ่มจัดกึ่งกลางใหม่ ไอคอนมาตรวัดความเร็วจะซ่อนไว้ชั่วคราวเมื่อปุ่มตั้งจุดศูนย์กลางใหม่ปรากฏขึ้น
พารามิเตอร์
เปิดใช้อยู่ |
---|
สาธารณะ void setSpeedometerUiOptions (SpeedometerUiOptions SpeedAlertUiOptions)
กำหนดค่า UI ของเครื่องวัดความเร็ว SpeedometerUiOptions
ตาม SpeedAlertSeverity
เรียกใช้เมธอดนี้ในเธรด UI เท่านั้น
การตั้งค่า SpeedometerUiOptions
ของ null
หมายความว่าคุณจะล้างรายการก่อนหน้าหากตั้งค่าไว้ หากไม่ได้กำหนดค่า SpeedometerUiOptions
UI ของมาตรวัดความเร็วจะใช้การกำหนดค่าเริ่มต้นของ NavSDK สำหรับการแจ้งเตือนความเร็วของ SpeedAlertSeverity
ต่างๆ ดังนี้
พารามิเตอร์
speedAlertUiOptions |
---|
สาธารณะ void setStylingOptions (StylingOptions styleingOptions)
ตั้งค่าตัวเลือกการจัดรูปแบบสำหรับ UI การนำทาง ควรเรียกใช้เมธอดนี้ในเธรด UI เท่านั้น
พารามิเตอร์
stylingOptions |
---|
สาธารณะ void setTrafficIncidentCardsEnabled (boolean enabled)
ตั้งค่าว่าควรแสดงการ์ดปัญหาการจราจรหรือไม่ เมื่อผู้ใช้คลิกไอคอนเหตุการณ์การจราจร เมธอดนี้ควรเรียกใช้ในเธรด UI เท่านั้น
พารามิเตอร์
เปิดใช้อยู่ |
---|
สาธารณะ void setTrafficPromptsEnabled (boolean enabled)
ตั้งค่าว่าควรแสดงข้อความแจ้งเกี่ยวกับการจราจรหรือไม่ ข้อความแจ้งสภาพการจราจรจะปรากฏเพื่ออัปเดตให้ผู้ใช้ทราบเกี่ยวกับสภาพการจราจรในระหว่างการนำทาง ควรเรียกใช้เมธอดนี้ในเธรด UI เท่านั้น
พารามิเตอร์
เปิดใช้อยู่ |
---|