เมื่อเปิดใช้การนําทาง Navigation SDK สําหรับ Android จะแสดงตัวควบคุมความเร็วที่จำกัดที่มุมล่างซ้ายของแผนที่ ซึ่งจะแสดงความเร็วที่จำกัดในปัจจุบัน หากผู้ใช้ขับรถเร็วเกินขีดจำกัด ตัวควบคุมจะขยายเพื่อแสดงมาตรความเร็วข้างจอแสดงขีดจำกัดความเร็ว และทริกเกอร์การแจ้งเตือนเมื่อความเร็วถึงเกณฑ์ที่กำหนด
โดยค่าเริ่มต้น Navigation SDK จะทริกเกอร์การแจ้งเตือนความเร็วเล็กน้อยเมื่อผู้ใช้ขับรถเร็วกว่าที่กฎหมายกำหนด 5 mph (หรือ 10 kph) และเปลี่ยนสีข้อความของมาตรความเร็วเป็นสีแดง โดยจะทริกเกอร์การแจ้งเตือนความเร็วที่สำคัญเมื่อผู้ใช้ขับรถเร็วกว่าที่กําหนด 10 ไมล์ต่อชั่วโมง (หรือ 20 กิโลเมตรต่อชั่วโมง) และเปลี่ยนสีพื้นหลังของมาตรความเร็วเป็นสีแดง
คุณสามารถปรับแต่งทั้งเกณฑ์ในการเรียกให้ระบบแจ้งเตือน รวมถึงข้อความและสีพื้นหลังที่หน้าปัดแสดง นอกจากนี้ คุณยังใช้ Navigation SDK เพื่อแสดงข้อมูลความเร็วของผู้ใช้ตามเกณฑ์ที่ตั้งไว้ได้ด้วย เช่น คุณอาจแสดงข้อมูลความเร็วแก่ผู้ให้บริการรถร่วมเดินทางเพื่อช่วยกระตุ้นให้ผู้ใช้ปฏิบัติตามขีดจำกัดความเร็วและปรับปรุงความปลอดภัย
ปรับแต่งเกณฑ์สำหรับการแจ้งเตือนความเร็ว
คุณปรับแต่งเกณฑ์การแจ้งเตือนความเร็วทั้งการแจ้งเตือนความเร็วเล็กน้อยและการแจ้งเตือนความเร็วมากเป็นเปอร์เซ็นต์ที่เกินขีดจำกัดความเร็วของความเร็วปัจจุบันได้ นอกจากนี้ คุณยังระบุระยะเวลาที่ค่าเกินเกณฑ์ก่อนที่แผนที่จะแสดงการแจ้งเตือนได้ด้วย
ตัวอย่างโค้ดต่อไปนี้ตั้งค่าเกณฑ์สำหรับการแจ้งเตือนความเร็วเล็กน้อยเป็น 5 เปอร์เซ็นต์เกินขีดจำกัดความเร็ว และตั้งค่าเกณฑ์สำหรับการแจ้งเตือนความเร็วมากเป็น 10 เปอร์เซ็นต์เกินขีดจำกัดความเร็ว ซึ่งระบุว่าแผนที่จะแสดงการแจ้งเตือนหลังจากที่มีการใช้งานเกินเกณฑ์การแจ้งเตือนเป็นเวลา 5 วินาที
float minorSpeedAlertThresholdPercentage = 5; float
majorSpeedAlertThresholdPercentage = 10; double severityUpgradeDurationSeconds =
5;
// Configure SpeedAlertOptions SpeedAlertOptions.Builder
speedAlertOptionsBuilder = new SpeedAlertOptions.Builder();
speedAlertOptionsBuilder.setSpeedAlertThresholdPercentage(
SpeedAlertSeverity.MINOR, minorSpeedAlertThresholdPercentage);
speedAlertOptionsBuilder.setSpeedAlertThresholdPercentage(
SpeedAlertSeverity.MAJOR, majorSpeedAlertThresholdPercentage);
speedAlertOptionsBuilder.setSeverityUpgradeDurationSeconds(severityUpgradeDurationSeconds);
// Set SpeedAlertOptions to Navigator.
navigator.setSpeedAlertOptions(speedAlertOptionsBuilder.build());
ปรับแต่งวิธีที่เครื่องวัดความเร็วแสดงการแจ้งเตือนความเร็ว
หากต้องการให้การแจ้งเตือนความเร็วดึงดูดความสนใจมากขึ้น คุณสามารถปรับแต่งสีของจอแสดงผลมาตรความเร็วสำหรับระดับการแจ้งเตือนแต่ละระดับได้
ตารางต่อไปนี้แสดงสีเริ่มต้นสำหรับการแจ้งเตือนความเร็วในคลาส NavigationView
| องค์ประกอบ | สี |
|---|---|
| MinorSpeedAlertBackgroundColorDayMode | 0xffffff(สีขาว) |
| MinorSpeedAlertBackgroundColorNightMode | 0x000000 |
| MinorSpeedAlertTextColorDayMode | 0xd93025 |
| MinorSpeedAlertTextColorNightMode | 0xd93025 |
| MajorSpeedAlertBackgroundColorDayMode | 0xd93025 |
| MajorSpeedAlertBackgroundColorNightMode | 0xd93025 |
| MajorSpeedAlertTextColorDayMode | 0xffffff(white) |
| MajorSpeedAlertTextColorNightMode | 0xffffff(white) |
คุณสามารถระบุข้อความและสีพื้นหลังของมาตรความเร็วสำหรับทั้งการแจ้งเตือนความเร็วเล็กน้อยและการแจ้งเตือนความเร็วมาก ดังนี้
SpeedometerUiOptions speedometerUiOptions = new SpeedometerUiOptions.Builder()
.setBackgroundColorDayMode(MINOR, some_color)
.setBackgroundColorNightMode(MINOR, some_color) .setTextColorDayMode(MINOR,
some_color) .setTextColorNightMode(MINOR, some_color)
.setBackgroundColorDayMode(MAJOR, some_color)
.setBackgroundColorNightMode(MAJOR, some_color) .setTextColorDayMode(MAJOR,
some_color) .setTextColorNightMode(MAJOR, some_color) .build();
// Set SpeedometerUiOptions to NavigationView.
navigationView.setSpeedometerUiOptions(speedometerUiOptionsBuilder.build());
navigationView.setSpeedometerEnabled(true);
// Set SpeedometerUiOptions to SupportNavigationFragment.
supportNavigationFragment.setSpeedometerUiOptions(speedometerUiOptionsBuilder.build());
supportNavigationFragment.setSpeedometerEnabled(true);
รับข้อมูลความเร็วจากผู้ใช้
หากแอปพลิเคชันของคุณกำหนดให้ต้องแชร์ข้อมูลเกี่ยวกับความเร็วของผู้ใช้ คุณก็ใช้ Navigation SDK เพื่อแสดงข้อมูลความเร็วของผู้ใช้ได้ด้วย ตัวอย่างเช่น ฟีเจอร์นี้อาจมีประโยชน์สําหรับแอปพลิเคชันการแชร์รถซึ่งผู้ให้บริการอาจต้องการตรวจสอบการขับรถเร็วเกินกำหนดของผู้ใช้เพื่อปรับปรุงความปลอดภัย นอกจากนี้ คุณยังดำเนินการนี้ได้โดยไม่จำเป็นต้องแสดงผลมุมมองการนำทางต่อผู้ใช้ในแอป
ตัวอย่างเช่น ตัวอย่างต่อไปนี้จะแชร์ข้อมูลความเร็วเมื่อความเร็วสูงกว่าขีดจำกัดความเร็วเป็นเปอร์เซ็นต์ที่ระบุ
// Existing flow for creating Navigator. NavigationApi.getNavigator();
// Set the SpeedAlertOptions for the MAJOR and MINOR alerts. (Note that the //
severityUpgradeDurationSeconds field is by design not used in this flow.)
SpeedAlertOptions speedAlertOptions = ...;
navigator.setSpeedAlertOptions(speedAlertOptions);
// Implement SpeedingListener. SpeedingListener speedingListener = new
SpeedingListener() { @Override public void onSpeedingUpdated(float
percentageAboveLimit, SpeedAlertSeverity speedAlertSeverity) { ... } };
// Set speedingListener to Navigator.
navigator.setSpeedingListener(speedingListener);