ภาพรวมและข้อกำหนดในการตั้งค่า

เอกสารนี้อธิบายกระบวนการตั้งค่า Navigation Connect API และแสดงข้อกำหนดของอุปกรณ์คนขับสำหรับการใช้ Navigation Connect API

ขั้นตอนการตั้งค่า Navigation Connect

คุณต้องทำตามขั้นตอนการตั้งค่าต่อไปนี้ให้เสร็จสมบูรณ์ก่อนจึงจะใช้ Navigation Connect API ได้

  1. สร้างและกำหนดค่าโปรเจ็กต์ Google Cloud
  2. เปิดใช้ Navigation Connect API และยืนยันแอป
  3. ตั้งค่า OAuth เพื่อสร้างโทเค็น OAuth
  4. ตั้งค่าบัญชีบริการเพื่อเปิดใช้การสื่อสารระหว่างโครงสร้างพื้นฐานแบ็กเอนด์กับ 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