เอกสารในส่วนนี้แสดงวิธีสร้างและใช้งานการเดินทางโดยใช้บริการการเดินทางแบบออนดีมานด์ของ Google Maps Mobility โดยจะถือว่าคุณคุ้นเคยกับสิ่งต่อไปนี้
- Fleet Engine: คุณควรคุ้นเคยกับรายละเอียดการติดตั้งใช้งาน Fleet Engine , กลไกคำขอ และความปลอดภัย โปรดดูหัวข้อ บริการ Fleet Engine คืออะไร และหัวข้อความปลอดภัยในหัวข้อ ตั้งค่า Fleet Engine
- ข้อมูลเบื้องต้นเกี่ยวกับยานพาหนะ สำหรับบริการแบบออนดีมานด์ ดู หัวข้อข้อมูลเบื้องต้นเกี่ยวกับยานพาหนะ
- ข้อมูลเบื้องต้นเกี่ยวกับการเดินทาง สำหรับบริการแบบออนดีมานด์ ดูหัวข้อการเดินทางแบบออนดีมานด์
TripService ที่คุณจะใช้มีให้บริการสำหรับ gRPC และ REST
การอ้างอิงฟิลด์จะเป็นไปตามข้อกำหนดของ gRPC เพื่อความเรียบง่าย
ใน Fleet Engine สำหรับบริการแบบออนดีมานด์ การเดินทางคือการเดินทางประเภทหนึ่งที่จำลองการดำเนินการตามคำขอการจัดส่งอาหารหรือการเดินทางจากผู้บริโภค การเดินทางมีสถานะที่คุณรายงานไปยัง Fleet Engine เมื่อการเดินทางดำเนินไป เช่น NEW, ENROUTE_TO_PICKUP และอื่นๆ สถานะการเดินทางจะสอดคล้องกับจุดแวะพักที่มีตำแหน่งทางภูมิศาสตร์ซึ่งกำหนดให้กับยานพาหนะ และ Fleet Engine จะแก้ไขจุดแวะพักของยานพาหนะเหล่านี้เมื่อคุณอัปเดตการเดินทางแต่ละครั้ง ดูข้อมูลเพิ่มเติมเกี่ยวกับการเดินทางและความสัมพันธ์กับการเดินทางในหัวข้อการเดินทางแบบออนดีมานด์ในข้อมูลเบื้องต้นเกี่ยวกับ
Fleet Engine
วงจรการเดินทาง
หากต้องการติดตามการเดินทางแต่ละครั้งใน Fleet Engine คุณต้องสร้างเอนทิตี Trip ก่อน โปรดดู gRPC หรือ REST เพื่อใช้อ้างอิง
ตารางต่อไปนี้อธิบายขั้นตอนการเดินทางแบบครบวงจรที่สร้างขึ้นในระบบและขั้นตอนวงจรการใช้งานใน Fleet Engine โดยจะถือว่าคุณได้ตั้งค่า Fleet Engine และมียานพาหนะที่จะกำหนดให้กับการเดินทาง รวมถึงเปิดใช้การอัปเดตตำแหน่ง ในแอปคนขับแล้ว โปรดดู Driver SDK: การเดินทางแบบออนดีมานด์
| 1 | รับคำขอจอง | ก่อนที่การเดินทางของ Fleet Engine จะเริ่มต้น ระบบการจองของคุณจะได้รับคำขอการเดินทางหรือการจัดส่งจากผู้บริโภคผ่านแอปหรือระบบการจองอื่นๆ ก่อน จากนั้นระบบจะสร้างเอนทิตีการเดินทางโดยใช้
CreateTrip พร้อมฟิลด์ที่จำเป็น เช่น สถานที่รับ
นอกจากนี้ยังสามารถตั้งค่าฟิลด์อื่นๆ ในจุดนี้ได้ เช่น ผู้โดยสารและ
สถานที่ส่ง หรือรอจนกว่าจะกำหนดยานพาหนะ ดูหัวข้อ
สร้างการเดินทางแบบมีปลายทางเดียว |
| 2 | กำหนดยานพาหนะ | คุณสามารถกำหนดยานพาหนะให้กับการเดินทางได้โดยตรงภายในระบบ และรายงานการกำหนดไปยัง Fleet Engine หรือใช้ บริการค้นหายานพาหนะ เพื่อค้นหายานพาหนะ โดยกรองตามทั้งแอตทริบิวต์การเดินทางและยานพาหนะ เพื่อค้นหายานพาหนะที่ดีที่สุดสำหรับการเดินทาง ยานพาหนะออนไลน์ใดๆ ภายในรัศมีการค้นหาจะแจ้งให้ทราบถึงความใกล้เคียงผ่าน การอัปเดตตำแหน่งที่ Driver SDK ให้ไว้ เมื่อ |
| 3 | อัปเดตการเดินทาง | เมื่อคนขับยอมรับการเดินทางและเริ่มนำทางไปยังสถานที่รับ ระบบจะอัปเดตสถานะการเดินทางจาก NEW
เป็น ENROUTE_TO_PICKUP คุณจะยังคงสำรวจตำแหน่งยานพาหนะ
ตลอดการเดินทาง ไม่ว่าจะผ่านการเชื่อมต่อโดยตรงจาก
แอปไปยังแบ็กเอนด์ หรือโดยการสำรวจ Fleet Engine ซึ่งจะได้รับการอัปเดตตำแหน่งยานพาหนะอย่างต่อเนื่องจาก Driver SDK จากนั้นระบบจะรายงานเหตุการณ์สำคัญแต่ละรายการของการเดินทางไปยัง Fleet Engine ซึ่งจะอัปเดตรายการจุดแวะพักของยานพาหนะตามนั้น
|
| 4 | แชร์การเดินทางกับผู้บริโภค | Fleet Engine จะแสดงรายละเอียดการเดินทางและตำแหน่งยานพาหนะให้ Consumer SDK ซึ่งใช้ Listener เพื่อรับการอัปเดตการเดินทางและแสดงในแอปสำหรับผู้บริโภค Fleet Engine จะอัปเดตเวลาถึงโดยประมาณ ระยะทางที่เหลือ เส้นทาง และจุดแวะพักที่เหลือของยานพาหนะโดยอัตโนมัติ ดูข้อมูลเพิ่มเติมได้ที่หัวข้อ แชร์การเดินทางสำหรับการเดินทางแบบออนดีมานด์ |
| 5 | การเดินทางเสร็จสมบูรณ์ | เมื่อยานพาหนะไปถึงจุดแวะพักปลายทางของการเดินทางและคนขับระบุว่าการเดินทางเสร็จสมบูรณ์ ระบบจะตั้งค่า TripStatus เป็น COMPLETE ใน Fleet Engine โปรดทราบว่าเอนทิตีการเดินทางจะยังคงใช้งานได้ภายใน Fleet Engine เป็นเวลา 7 วันไม่ว่าจะมีสถานะใดก็ตาม จากนั้นระบบจะนำออก |
ขั้นตอนลำดับการเดินทาง
แผนภาพต่อไปนี้แสดงมุมมองโดยละเอียดเพิ่มเติมของขั้นตอนนี้
