เอกสารนี้อธิบายวิธีสร้างการเดินทางแบบต่อเนื่อง ตั้งค่าช่องที่ถูกต้อง และกำหนดให้กับยานพาหนะเพื่อดำเนินการ บทแนะนำนี้ถือว่าคุณได้ตั้งค่า Fleet Engine, สร้างยานพาหนะ, มีแอปคนขับที่ใช้งานได้ และ (ไม่บังคับ) แอปผู้บริโภคแล้ว นอกจากนี้ คุณควรคุ้นเคยกับสถานการณ์การเดินทางต่างๆ ที่มีให้สำหรับการเดินทางแบบออนดีมานด์ด้วย ดูคำแนะนำที่เกี่ยวข้องต่อไปนี้สำหรับ ซึ่ง:
- ตั้งค่า Fleet Engine
- สร้างยานพาหนะ
- สถานการณ์การเดินทางในภาพรวมการเดินทางแบบออนดีมานด์
ข้อมูลเบื้องต้นเกี่ยวกับการสร้างการเดินทาง
ส่วนนี้จะอธิบายรายละเอียดคำขอที่จำเป็นสำหรับการสร้างการเดินทางในฟีเจอร์ Fleet Engine คุณส่งคำขอสร้างโดยใช้ gRPC และ REST
ฟิลด์การเดินทาง
ใช้ช่องต่อไปนี้เพื่อสร้างการเดินทางใน Fleet Engine คุณสามารถใช้ ช่องสำหรับการเดินทางประเภทต่างๆ ได้แก่ จุดหมายเดียวหรือหลายปลายทาง การติดต่อกลับหรือการเดินทางร่วมกัน คุณ สามารถใส่ช่องที่ไม่บังคับเมื่อสร้างการเดินทาง หรือคุณสามารถตั้งค่า ภายหลังเมื่อคุณอัปเดตการเดินทาง
ชื่อ | จำเป็นหรือไม่ | คำอธิบาย |
---|---|---|
parent | ใช่ | สตริงที่มีรหัสโปรเจ็กต์ รหัสนี้ต้องเป็นรหัสเดียวกับที่ใช้ในการผสานรวม 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 ยานพาหนะรับผู้บริโภคสำหรับการเดินทาง กแล้ว และระหว่างทางไปยังจุดส่งผู้โดยสาร คนขับได้รับคำขอให้ไปรับผู้บริโภคอีกรายสำหรับการเดินทางครั้งถัดไป ซึ่งก็คือการเดินทาง ข
- การเรียกใช้
getVehicle()
จะส่งคืนremainingWaypoints
ที่มี:
การออก → B การรับสินค้า → B การออก getTrip()
หรือonTripRemainingWaypointsUpdated
ของ Trip A จะแสดงผลremainingWaypoints
ที่มี
จุดส่งผู้โดยสารgetTrip()
หรือonTripRemainingWaypointsUpdated
Callback สำหรับ การเดินทาง B กลับมาแล้วremainingWaypoints
ที่มี:
การออกจาก → B การรับสินค้า → และ B การออก