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

เอกสารนี้อธิบายกระบวนการตั้งค่า 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 เวอร์ชัน 5.15.5 ขึ้นไป หรือ Google Maps เวอร์ชัน 26.14 ขึ้นไป

เปิดใช้ตำแหน่งที่แน่นอนแล้ว

แจ้งให้คนขับเปิดสิทธิ์เข้าถึงตำแหน่งที่แน่นอนในอุปกรณ์ Waze และ Google Maps ต้องใช้ตำแหน่งที่แน่นอนเพื่อเริ่มการนำทาง

กล่องโต้ตอบความยินยอมของผู้ขับ

Navigation Connect กำหนดให้ผู้ขับขี่ต้องให้ความยินยอมในการแชร์ข้อมูลการเดินทาง คุณไม่จำเป็นต้องทริกเกอร์กล่องโต้ตอบความยินยอม เนื่องจาก Google Maps หรือ Waze จะจัดการอินเทอร์เฟซผู้ใช้นี้โดยอัตโนมัติ

ในการเดินทางครั้งแรกที่เริ่มต้นจากแอปของคุณ Google Maps หรือ Waze จะแจ้งให้คนขับ แชร์ข้อมูลการเดินทาง

  • หากคนขับแตะอนุญาต Navigation Connect จะเริ่มแชร์ข้อมูลตำแหน่งแบบเรียลไทม์และเวลาถึงโดยประมาณกับแบ็กเอนด์ของคุณ
  • หากคนขับแตะไม่อนุญาตหรือเพิกถอนความยินยอมในภายหลัง Google Maps หรือ Waze จะแสดงเส้นทางแบบเลี้ยวต่อเลี้ยว แต่ Navigation Connect จะไม่ส่ง ข้อมูล แบ็กเอนด์จะได้รับสถานะ CLIENT_ERROR ในเพย์โหลดข้อมูลการเดินทาง

ผู้ขับขี่ต้องยืนยันความยินยอมนี้อีกครั้งทุกๆ 12 เดือน

ขั้นตอนถัดไป

ขั้นตอนแรกในการตั้งค่า Navigation Connect API คือการสร้างและ กำหนดค่าโปรเจ็กต์ Google Cloud