ภาพรวม Navigation Connect API

นักพัฒนาซอฟต์แวร์ในเขตเศรษฐกิจยุโรป (EEA)

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

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

เหตุใดจึงต้องใช้ Navigation Connect API

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

ตัวอย่างกรณีการใช้งานมีดังนี้

  • เพิ่มความโปร่งใสในการใช้บริการร่วมเดินทาง: ให้ข้อมูลอัปเดตที่ถูกต้องแบบเรียลไทม์แก่ลูกค้าและผู้โดยสารที่ใช้บริการร่วมเดินทางเกี่ยวกับตำแหน่งของคนขับและเวลาถึงจุดหมายโดยประมาณ
  • ปรับปรุงการติดตามการนำส่ง: แจ้งให้ลูกค้าทราบเวลาจัดส่งหรือเวลาจัดส่งอาหารที่ถูกต้องตามข้อมูลการจราจรแบบเรียลไทม์และการกำหนดเส้นทาง
  • ปรับปรุงการจัดการและการจัดส่งยานพาหนะ: ตัดสินใจจัดส่งยานพาหนะหรือทีมงานที่อยู่นอกสถานที่ซึ่งให้บริการแบบออนดีมานด์ (เช่น ความช่วยเหลือเมื่อรถเสีย การบำรุงรักษา หรือการขนส่ง) ได้อย่างมีข้อมูลโดยการติดตามตำแหน่งคนขับแบบเรียลไทม์

สิ่งที่คุณทำได้ด้วย Navigation Connect API

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

  • ติดตามการเดินทางโดยไม่รบกวน: ติดตามการเดินทางโดยไม่เปลี่ยนตัวเลือกของคนขับในการใช้ Google Maps หรือ Waze หรือแก้ไขประสบการณ์ของผู้ใช้
  • เข้าถึงข้อมูลตำแหน่งแบบเรียลไทม์: รับตำแหน่งของผู้ขับแบบเรียลไทม์ ระยะทางที่เหลือ และเวลาที่ผ่านไปอย่างต่อเนื่องตลอดการเดินทาง
  • ตรวจสอบวงจรการเดินทาง: กำหนดค่าความถี่ในการอัปเดตข้อมูลการเดินทางเพื่อติดตามสถานะที่แน่นอนของการเดินทาง และทราบทันทีเมื่อคนขับอยู่ระหว่างทาง มาถึง หรือระงับการเดินทาง
  • ใช้และแชร์ ETA: รับข้อมูลอัปเดต ETA ที่แม่นยำสูงซึ่งขับเคลื่อนโดยอัลกอริทึมการกำหนดเส้นทางแบบเรียลไทม์ของ Google
  • ติดตามเส้นทางและสภาพการจราจรที่เหลือ: รับ Polyline ของเส้นทางที่เหลือและสภาพการจราจรแบบเรียลไทม์จาก ตำแหน่งปัจจุบันของผู้ขับขี่ไปยังจุดหมายสุดท้าย เหมือนกับที่ แสดงใน Google Maps หรือ Waze ทุกประการ ฟีเจอร์นี้จะทริกเกอร์ Navigation Connect Enterprise SKU
    • การตัดแบบไดนามิก: เมื่อยานพาหนะเคลื่อนที่ Navigation Connect จะตัดเส้นหลายจุดของเส้นทางที่ใช้งานอยู่ของคนขับ (เส้นทางทั้งหมดที่นำทางในแอป) โดยอัตโนมัติเพื่อให้มั่นใจว่าคุณจะได้รับเฉพาะเส้นทางที่เหลือ (ส่วนจากตำแหน่งปัจจุบันของคนขับไปยังจุดหมาย)
    • ความถี่ในการอัปเดต: สภาพเส้นทางและการจราจรจะอัปเดตโดยอัตโนมัติเมื่อมีการคำนวณเส้นทางใหม่ การเปลี่ยนเส้นทางฝั่งไคลเอ็นต์เชิงรุก หรือการเปลี่ยนแปลงสภาพการจราจร
  • ติดตามการเบี่ยงเบนเส้นทาง (Waze เท่านั้น): ตรวจจับเมื่อคนขับออกนอกเส้นทาง ระบุตำแหน่งและเวลาที่แน่นอนของการเบี่ยงเบน และระบุว่า การเบี่ยงเบนเกิดจากคนขับ (เช่น เลี้ยวผิด) หรือ เกิดจากระบบ (เช่น การเปลี่ยนเส้นทางเพื่อหลีกเลี่ยงการจราจร) ฟีเจอร์นี้ จะทริกเกอร์ Navigation Connect Enterprise SKU
  • นำเข้าข้อมูลได้อย่างยืดหยุ่น: ใช้ข้อมูลการเดินทางแบบเรียลไทม์โดยใช้การเรียก REST API โดยตรง หรือสตรีมการอัปเดตอย่างมีประสิทธิภาพโดยใช้การสมัครใช้บริการ Google Cloud Pub/Sub

วิธีการทำงานของ Navigation Connect API

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

แหล่งข้อมูล

ตารางต่อไปนี้สรุปทรัพยากรที่พร้อมใช้งานผ่าน Navigation Connect API พร้อมกับข้อมูลที่ส่งคืน ดูรายละเอียดที่เฉพาะเจาะจงได้ในเอกสารอ้างอิง Navigation Connect API

แหล่งข้อมูล ข้อมูลที่แสดงผล

การตรวจสอบสิทธิ์และตัวระบุแอปบนอุปกรณ์เคลื่อนที่ในรูปแบบ JSON

ดูหัวข้อสร้างทริป

โทเค็นการเดินทางที่ไม่ซ้ำกันซึ่งใช้เพื่อเริ่มต้นการเชื่อมต่อใน Google Maps หรือ Waze

ดูหัวข้อเปิด Google Maps หรือ Waze

รหัสการเดินทางที่ไม่ซ้ำกันและเมธอด Pull หรือ Push ในรูปแบบ JSON

ดูดึงข้อมูลการเดินทาง

การวัดและส่งข้อมูลการเดินทางแบบเรียลไทม์ ซึ่งรวมถึง

  • สถานะการเดินทางและข้อมูลเมตา
  • ตำแหน่งปัจจุบัน (ละติจูด/ลองจิจูด)
  • เวลาถึงโดยประมาณ (ETA)
  • ระยะทางและเวลาที่เหลือ

ดูจัดการข้อมูลการเดินทาง

วิธีใช้ Navigation Connect API

1 เริ่มตั้งค่า เริ่มต้นด้วยตั้งค่าโปรเจ็กต์ Google Cloud และทําตามวิธีการที่ระบุไว้
2 สร้างทริป ส่งการเรียก Navigation Connect API เพื่อสร้างการเดินทางด้วยรหัสที่ไม่ซ้ำกัน แล้วบันทึกโทเค็น
3 เปิด Google Maps หรือ Waze ส่งโทเค็นการเดินทางและเปิด Google Maps หรือ Waze เพื่อเปิดใช้การแชร์ข้อมูลการเดินทาง
4 ดึงข้อมูลการเดินทาง ส่งการเรียกใช้ Navigation Connect API เพื่อดึงข้อมูลการเดินทาง สมัครรับข้อมูลอัปเดตโดยใช้ Google Cloud Pub/Sub (ไม่บังคับ)
5 จัดการข้อมูลการเดินทาง ทำความเข้าใจวิธีจัดการสถานะการเดินทางและข้อมูลการเดินทางอื่นๆ