เอกสารนี้อธิบายกระบวนการตั้งค่า Navigation Connect API และแสดงข้อกำหนดของอุปกรณ์คนขับสำหรับการใช้ Navigation Connect API
ขั้นตอนการตั้งค่า Navigation Connect
คุณต้องทำตามขั้นตอนการตั้งค่าต่อไปนี้ให้เสร็จสมบูรณ์ก่อนจึงจะใช้ Navigation Connect API ได้
- สร้างและกำหนดค่าโปรเจ็กต์ Google Cloud
- เปิดใช้ Navigation Connect API และยืนยันแอป
- ตั้งค่า OAuth เพื่อสร้างโทเค็น OAuth
- ตั้งค่าบัญชีบริการเพื่อเปิดใช้การสื่อสารระหว่างโครงสร้างพื้นฐานแบ็กเอนด์กับ Google Maps หรือ Waze
ข้อกำหนดขั้นต่ำของอุปกรณ์สำหรับการใช้ Navigation Connect
ข้อกำหนดเหล่านี้จำเป็นสำหรับอุปกรณ์ของคนขับเพื่อให้เซสชัน Navigation Connect ทำงานได้สำเร็จ เซสชันจะใช้ Navigation Connect API เพื่อส่งข้อมูลการเดินทางแบบเรียลไทม์ เช่น ตำแหน่งและเวลาถึงโดยประมาณ ไปยังเซิร์ฟเวอร์แบ็กเอนด์
เวอร์ชันของแอปที่รองรับ
อุปกรณ์ต้องติดตั้ง Waze หรือ Google Maps สำหรับ Android ตารางต่อไปนี้แสดงเวอร์ชันขั้นต่ำของแต่ละแอปสำหรับ Navigation Connect และสำหรับฟีเจอร์ที่ต้องใช้เวอร์ชันที่ใหม่กว่า
| แอป | เวอร์ชันต่ำสุด | การรายงานเส้นทางที่เหลือ | การรายงานการออกนอกเส้นทาง |
|---|---|---|---|
| Waze สำหรับ Android | 5.15.5 | 5.20.0.2 | 5.22 |
| Waze สำหรับ iOS | 5.15.5 | 5.20.0.1 | 5.22 |
| Google แผนที่สำหรับแอนดรอยด์ | 26.14 | 26.27 | ไม่รองรับ |
เปิดใช้ตำแหน่งที่แน่นอนแล้ว
แจ้งให้คนขับเปิดสิทธิ์เข้าถึงตำแหน่งที่แน่นอนในอุปกรณ์ Waze และ Google Maps ต้องใช้ตำแหน่งที่แน่นอนเพื่อเริ่มการนำทาง
ความยินยอมของคนขับ
Navigation Connect ต้องได้รับความยินยอมจากคนขับเพื่อแชร์ข้อมูลการเดินทาง คุณไม่จำเป็นต้องเรียกใช้กล่องโต้ตอบความยินยอม เนื่องจาก Google Maps หรือ Waze จะจัดการอินเทอร์เฟซผู้ใช้นี้โดยอัตโนมัติ
ในการเดินทางครั้งแรกที่เริ่มต้นจากแอปของคุณ Google Maps หรือ Waze จะแจ้งให้คนขับแชร์ข้อมูลการเดินทาง
- หากคนขับแตะอนุญาต Navigation Connect จะเริ่มแชร์ข้อมูลตำแหน่งแบบเรียลไทม์และ ETA กับแบ็กเอนด์ของคุณ
- หากคนขับแตะไม่อนุญาตหรือเพิกถอนความยินยอมในภายหลัง Google Maps หรือ Waze จะแสดงเส้นทางแบบเลี้ยวต่อเลี้ยว แต่ Navigation Connect จะไม่ส่งข้อมูล แบ็กเอนด์ของคุณจะได้รับสถานะ
CLIENT_ERRORในเพย์โหลดข้อมูลการเดินทาง
คนขับต้องยืนยันความยินยอมนี้อีกครั้งทุกๆ 12 เดือน
ขั้นตอนถัดไป
ขั้นตอนแรกในการตั้งค่า Navigation Connect API คือการสร้างและกำหนดค่าโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google