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