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