เอกสารในส่วนนี้จะแสดงวิธีสร้างและทำงานกับการเดินทางโดยใช้ บริการการเดินทางตามสั่งของ Google Maps Mobility โดยถือว่ามีความคุ้นเคยกับ ดังต่อไปนี้
- Fleet Engine: คุณควรคุ้นเคยกับการใช้งาน Fleet Engine รายละเอียด กลไกคำขอ และความปลอดภัย ดูรายละเอียดได้ที่ What is the Fleet บริการเครื่องมือค้นหาและหัวข้อความปลอดภัยในตั้งค่า Fleet Engine
- ข้อมูลเบื้องต้นเกี่ยวกับยานพาหนะสำหรับบริการแบบออนดีมานด์ โปรดดู ข้อมูลเบื้องต้นเกี่ยวกับยานพาหนะ
- ข้อมูลเบื้องต้นเกี่ยวกับการเดินทางสำหรับบริการแบบออนดีมานด์ ดูการเดินทางแบบออนดีมานด์
TripService
ที่คุณจะใช้ได้ใน gRPC และ REST
เพื่อความเรียบง่าย การอ้างอิงฟิลด์เป็นไปตามแบบแผน gRPC
ใน Fleet Engine สำหรับบริการแบบออนดีมานด์ การเดินทางคือการเดินทางประเภทหนึ่งที่โมเดล
การดำเนินการตามคำขอส่งอาหารหรือเรียกรถจากผู้บริโภคของคุณ การเดินทาง
มีสถานะที่คุณรายงานไปยัง Fleet Engine เมื่อเส้นทางเปลี่ยนแปลงไป เช่น
NEW
, ENROUTE_TO_PICKUP
และอื่นๆ สถานะการเดินทางสอดคล้องกับตำแหน่งทางภูมิศาสตร์
จุดอ้างอิงที่กำหนดให้กับยานพาหนะ และ Fleet Engine จะปรับเปลี่ยนยานพาหนะเหล่านี้
ของการอัปเดตการเดินทางแต่ละครั้ง ดูการเดินทางแบบออนดีมานด์ในยานพาหนะ
ข้อมูลสำคัญเกี่ยวกับเครื่องยนต์สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการเดินทางและความสัมพันธ์กับยานพาหนะ
ชีวิตการเดินทาง
คุณต้องสร้าง Trip
ก่อน จึงจะติดตามการเดินทางแต่ละครั้งใน Fleet Engine ได้
เอนทิตี โปรดดู 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 แสดงรายละเอียดการเดินทางและตำแหน่งยานพาหนะให้กับ SDK สำหรับผู้บริโภคซึ่งใช้ Listener เพื่อรับข้อมูลอัปเดตการเดินทางและแสดงข้อมูล ในแอปสำหรับผู้บริโภค Fleet Engine จะอัปเดตเวลาถึงโดยประมาณโดยอัตโนมัติ เหลืออยู่ ระยะทาง เส้นทาง และจุดอ้างอิงของยานพาหนะที่เหลืออยู่ โปรดดู แชร์เส้นทางสำหรับการเดินทางแบบออนดีมานด์เพื่อดูข้อมูลเพิ่มเติม |
5 | ทั้งการเดินทาง | เมื่อรถไปถึงจุดหมายของการเดินทางและ
คนขับระบุว่าการเดินทางนั้นประสบความสำเร็จ ระบบของคุณจะตั้งค่า
TripStatus ไปยัง COMPLETE ใน Fleet Engine เก็บใน
โปรดทราบว่าเอนทิตีการเดินทางจะยังคงทำงานอยู่ภายใน Fleet Engine เช่นเดียวกับยานพาหนะ
เป็นเวลา 7 วันโดยไม่คำนึงถึงสถานะ และหลังจากนั้นจะถูกนําออก |
ลำดับของการเดินทาง
แผนภาพต่อไปนี้จะแสดงมุมมองที่ละเอียดยิ่งขึ้นของขั้นตอนนี้