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

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

ขั้นตอนการเดินทาง

แผนภาพต่อไปนี้แสดงมุมมองโดยละเอียดเพิ่มเติมของขั้นตอนการทำงานนี้

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

• สร้างการเดินทางแบบมีปลายทางเดียว