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