เอกสารประกอบในส่วนนี้จะแสดงวิธีสร้างและจัดการการเดินทางโดยใช้บริการการเดินทางแบบออนดีมานด์ของ 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
เครื่องยนต์
วงจรของการเดินทาง
หากต้องการติดตามการเดินทางแต่ละครั้งใน 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 โปรดทราบว่าเช่นเดียวกับยานพาหนะ ข้อมูลการเดินทางจะยังคงอยู่ในเครื่องยนต์ของ FFleet เป็นเวลา 7 วันไม่ว่าจะมีสถานะใดก็ตาม หลังจากนั้นระบบจะนำข้อมูลออก |
ขั้นตอนการเรียงลำดับการเดินทาง
แผนภาพต่อไปนี้แสดงมุมมองโดยละเอียดยิ่งขึ้นของขั้นตอนนี้
