เอกสารนี้อธิบายวิธีการสร้างการเดินทางขากลับ ตั้งค่า แล้วกำหนดให้กับยานพาหนะเพื่อดำเนินการตามคำสั่งซื้อ โดยจะถือว่าคุณได้ตั้งค่า Fleet แล้ว เครื่องยนต์ คุณได้สร้างยานพาหนะ มีแอปคนขับที่ใช้งานได้ และ (ไม่บังคับ) เป็นแอปสำหรับผู้บริโภค นอกจากนี้คุณควรทำความคุ้นเคยกับ สถานการณ์ที่ใช้ได้สำหรับการเดินทางแบบออนดีมานด์ ดูคำแนะนำที่เกี่ยวข้องต่อไปนี้สำหรับ ซึ่ง:
- ตั้งค่า Fleet Engine
- สร้างพาหนะ
- สถานการณ์การเดินทางในภาพรวมการเดินทางแบบออนดีมานด์
ข้อมูลเบื้องต้นเกี่ยวกับการสร้างการเดินทาง
ส่วนนี้จะอธิบายรายละเอียดคำขอที่จำเป็นสำหรับการสร้างการเดินทางใน Fleet Engine คุณส่งคำขอสร้างโดยใช้ gRPC และ REST
ช่องสำหรับการเดินทาง
ใช้ช่องต่อไปนี้เพื่อสร้างการเดินทางใน Fleet Engine คุณสามารถใช้ ช่องสำหรับการเดินทางประเภทต่างๆ ได้แก่ จุดหมายเดียวหรือหลายปลายทาง การติดต่อกลับหรือการเดินทางร่วมกัน คุณ สามารถใส่ช่องที่ไม่บังคับเมื่อสร้างการเดินทาง หรือจะตั้งค่าฟิลด์เหล่านั้น ภายหลังเมื่อคุณอัปเดตการเดินทาง
ชื่อ | จำเป็นหรือไม่ | คำอธิบาย |
---|---|---|
หลัก | ใช่ | สตริงที่มีรหัสโปรเจ็กต์ รหัสนี้ต้องเป็นรหัสเดียวกับที่ใช้ ในการผสานรวม Fleet Engine ทั้งหมดด้วยบัญชีบริการเดียวกัน บทบาทใหม่ |
trip_id | ใช่ | สตริงที่คุณสร้างซึ่งระบุการเดินทางนี้โดยไม่ซ้ำกัน รหัสการเดินทางมี ข้อจำกัดบางอย่างตามที่ระบุไว้ในข้อมูลอ้างอิง |
trip_type | ใช่ | ตั้งค่า TripType ให้เป็นค่าต่อไปนี้สำหรับประเภทการเดินทางที่กำลังสร้าง
|
pickup_point | ใช่ | จุดเริ่มต้นของการเดินทาง |
ปลายทางขั้นกลาง | ใช่ | การเดินทางที่มีหลายปลายทางเท่านั้น: รายการจุดหมายระดับกลางที่คนขับเข้าชมระหว่างทาง
การรับส่ง เช่นเดียวกับ |
vehicle_waypoints | ใช่ | การเดินทางแบบแชร์ร่วมกันเท่านั้น: ช่องนี้รองรับการสลับจุดระหว่างการเดินทางจากหลายการเดินทาง
ซึ่งประกอบด้วยจุดอ้างอิงที่เหลืออยู่ทั้งหมดสำหรับยานพาหนะที่กำหนด
เป็นจุดอ้างอิงจุดรับส่งสำหรับการเดินทางนี้ คุณสามารถตั้งค่าช่องนี้ได้
โดยโทรไปที่ |
number_of_passengers | ไม่ได้ | จำนวนผู้โดยสารในการเดินทาง |
dropoff_point | ไม่ได้ | จุดหมายของการเดินทาง |
vehicle_id | ไม่ได้ | รหัสของพาหนะที่กำหนดการเดินทาง |
ตัวอย่าง: สร้างการเดินทางขากลับ
ข้อมูลต่อไปนี้จะแสดงวิธีสร้างการเดินทางแบบต่อเนื่องและกําหนดให้กับ ยานพาหนะ ในสถานการณ์นี้ การสร้างการเดินทางจะเหมือนกับสําหรับจุดหมายเดียว เพียงแต่คุณจะต้องสร้างการเดินทางอีกครั้งและกำหนดการเดินทางดังกล่าวให้กับยานพาหนะ ด้วยการเดินทางที่ใช้งานอยู่แล้ว
// A vehicle with ID 'my-vehicle' is already created and it is assigned to a trip with ID 'current-trip'.
static final String PROJECT_ID = "my-rideshare-co-gcp-project";
static final String VEHICLE_ID =" my-vehicle";
static final String TRIP_ID = "back-to-back-trip");
TripServiceBlockingStub tripService = TripService.newBlockingStub(channel);
String parent = "providers/" + PROJECT_ID;
Trip trip = Trip.newBuilder()
.setTripType(TripType.EXCLUSIVE)
.setPickupPoint(
TerminalLocation.newBuilder().setPoint(
LatLng.newBuilder()
.setLatitude(-6.195139).setLongitude(106.820826)))
.setDropoffPoint(
TerminalLocation.newBuilder().setPoint(
LatLng.newBuilder()
.setLatitude(-6.1275).setLongitude(106.6537)))
.setVehicleId(VEHICLE_ID)
.build();
// Create trip request
CreateTripRequest createTripRequest = CreateTripRequest.newBuilder()
.setParent(parent)
.setTripId(TRIP_ID)
.setTrip(trip)
.build();
// Error handling.
try {
// Fleet Engine automatically assigns a 'waypoints' list to the trip containing
// the vehicle's current trip waypoints.
Trip createdTrip =
tripService.createTrip(createTripRequest);
} catch (StatusRuntimeException e) {
Status s = e.getStatus();
switch (s.getCode()) {
case ALREADY_EXISTS:
break;
case PERMISSION_DENIED:
break;
}
return;
}
อัปเดตการเดินทางขาไป
เมื่อคุณกำหนดยานพาหนะสำหรับการเดินทางไปกลับ คุณได้กำหนดการเดินทางให้กับ แม้ว่าจะมีการระบุให้กับยานพาหนะแล้วก็ตาม
การเดินทางที่สร้างขึ้นใน Fleet Engine ต้องกำหนดให้กับยานพาหนะเพื่อ Fleet Engine เพื่อคำนวณเวลาถึงโดยประมาณและติดตามการเดินทาง คุณสามารถดำเนินการได้ในระหว่าง การสร้างการเดินทางหรือภายหลังเมื่อคุณอัปเดตการเดินทาง
หลังจากที่คุณกำหนดการเดินทางให้กับยานพาหนะแล้ว Fleet Engine จะเพิ่ม
จุดอ้างอิงที่เชื่อมโยงกับการเดินทางไป-กลับที่จุดอ้างอิงของยานพาหนะ
ด้วย ช่อง remainingWaypoints
ของการเดินทางจะมีรายการ
จุดอ้างอิง รวมถึงจุดจากการเดินทางอื่นๆ ที่จะเยี่ยมชมก่อนหน้านี้
การเดินทางออก
เช่น ลองพิจารณาการเดินทางไปกลับ 2 แบบ ได้แก่ การเดินทาง A และการเดินทาง B รถจอดรับผู้บริโภคแล้ว สำหรับการเดินทาง A และระหว่างทางไปยังจุดส่ง พนักงานขับรถจะได้รับคำขอให้ไปรับผู้บริโภครายอื่น การเดินทางถัดไปคือ การเดินทาง B
- การเรียกใช้
getVehicle()
จะส่งคืนremainingWaypoints
ที่มี:
การออก → B การรับสินค้า → B การออก getTrip()
หรือonTripRemainingWaypointsUpdated
Callback สำหรับ การเดินทาง A กลับมาแล้วremainingWaypoints
ที่มีสิ่งต่อไปนี้
ก การออกgetTrip()
หรือonTripRemainingWaypointsUpdated
Callback สำหรับ การเดินทาง B กลับมาแล้วremainingWaypoints
ที่มี:
การออกจาก → B การรับสินค้า → และ B การออก