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

เอกสารนี้อธิบายกระบวนการตั้งค่า 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