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