การเดินทางแบบออนดีมานด์คืออะไร

เอกสารในส่วนนี้แสดงวิธีสร้างและจัดการการเดินทางโดยใช้บริการการเดินทางแบบออนดีมานด์ของ 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 เมื่อ SearchVehicle แสดงยานพาหนะที่ตรงกับการเดินทางแล้ว ระบบจะเรียกใช้ปลายทาง UpdateTrip เพื่อรายงานรหัสยานพาหนะที่คุณกำหนดให้กับการเดินทาง NEW
3	อัปเดตการเดินทาง	เมื่อคนขับยอมรับการเดินทางและเริ่มนำทางไปยัง จุดรับ ระบบจะอัปเดตสถานะการเดินทางจาก NEW เป็น ENROUTE_TO_PICKUP คุณจะยังคงสำรวจตำแหน่งของยานพาหนะตลอดการเดินทาง ไม่ว่าจะผ่านการเชื่อมต่อโดยตรงจากแอปไปยังแบ็กเอนด์ หรือโดยการสำรวจ Fleet Engine ซึ่งจะได้รับสตรีมการอัปเดตตำแหน่งของยานพาหนะอย่างต่อเนื่องจาก Driver SDK จากนั้นระบบจะรายงานเหตุการณ์สำคัญของการเดินทางแต่ละครั้งไปยัง Fleet Engine ซึ่งจะอัปเดตรายการจุดแวะพักของยานพาหนะตามนั้น
4	แชร์เส้นทางกับผู้บริโภค	Fleet Engine ช่วยให้ Consumer SDK สามารถเข้าถึงรายละเอียดการเดินทางและตำแหน่งของยานพาหนะได้ ซึ่งใช้ตัวรับฟังเพื่อรับการอัปเดตการเดินทางและแสดงข้อมูลดังกล่าวในแอปพลิเคชันของผู้บริโภค Fleet Engine จะอัปเดตเวลาถึงโดยประมาณ (ETA) ระยะทางที่เหลือ เส้นทาง และจุดแวะพักของยานพาหนะที่เหลืออยู่โดยอัตโนมัติ ดูข้อมูลเพิ่มเติมได้ที่แชร์การเดินทางสำหรับการเดินทางตามความต้องการ
5	ทริปที่สมบูรณ์แบบ	เมื่อยานพาหนะถึงจุดสิ้นสุดการเดินทางและคนขับแจ้งว่าการเดินทางสำเร็จ ระบบจะตั้งค่า TripStatus เป็น COMPLETE ใน Fleet Engine โปรดทราบว่าเอนทิตีการเดินทางจะยังคงใช้งานได้ภายใน Fleet Engine เป็นเวลา 7 วันไม่ว่าสถานะจะเป็นอย่างไร จากนั้นระบบจะนำเอนทิตีออก

ลำดับการเดินทาง

แผนภาพต่อไปนี้แสดงมุมมองที่ละเอียดยิ่งขึ้นของโฟลว์นี้

ขั้นตอนถัดไป

• สร้างทริปแบบมีจุดหมายปลายทางเดียว