Tài liệu này mô tả cách cập nhật một chuyến đi và quản lý trạng thái của chuyến đi, bao gồm cả việc sử dụng mặt nạ trường để đặt các trường liên quan cho chuyến đi. Giả sử bạn đã thiết lập Công cụ quản lý đội xe như mô tả trên trang web này và đang làm việc với một xe được chỉ định cho một chuyến đi.
Kiến thức cơ bản về thông tin cập nhật về chuyến đi
Hệ thống của bạn sử dụng Công cụ quản lý đội xe để cập nhật chuyến đi trong các trường hợp sau:
- Khi chỉ định xe cho một chuyến đi sau khi chuyến đi đó được tạo.
- Khi trạng thái của chuyến đi thay đổi; ví dụ: khi xe đi qua các điểm trung gian.
- Khi bạn cập nhật các trường của chuyến đi, chẳng hạn như số lượng hành khách và điểm trả khách.
Để cập nhật chuyến đi, hãy gửi yêu cầu bằng gRPC và REST.
Hãy sử dụng thông tin đăng nhập phù hợp cho tài khoản dịch vụ của dự án như mô tả trong bài viết Fleet Engine: Vai trò trong tài khoản dịch vụ.
Cập nhật các trường chuyến đi
Bạn có thể cập nhật bất kỳ trường chuyến đi nào được mô tả trong phần Trường chuyến đi trong phần Tạo chuyến đi đến một điểm đến. Ví dụ: sau khi bạn tạo một chuyến đi, trước tiên, bạn nên tìm một chiếc xe rồi cập nhật trường vehicle_id của chuyến đi để liên kết trường đó với chiếc xe sẽ thực hiện chuyến đi.
Sử dụng mặt nạ trường
Mặt nạ trường là một cách để phương thức gọi API liệt kê các trường mà yêu cầu sẽ cập nhật hoặc cập nhật. Việc sử dụng FieldMask sẽ giúp tránh các công việc không cần thiết và cải thiện hiệu suất. Fleet Engine sử dụng mặt nạ trường để cập nhật các trường trên mọi tài nguyên.
Cập nhật chuyến đi bằng mã nhận dạng xe
Bạn phải định cấu hình chuyến đi bằng mã nhận dạng xe để Công cụ quản lý đội xe có thể theo dõi xe dọc theo tuyến đường của xe. Mã mẫu sau đây minh hoạ cách cập nhật chuyến đi bằng mã nhận dạng xe.
static final String PROJECT_ID = "my-rideshare-co-gcp-project";
static final String TRIP_ID = "trip-8241890";
String tripName = "providers/" + PROJECT_ID + "/trips/" + TRIP_ID;
TripServiceBlockingStub tripService = TripService.newBlockingStub(channel);
// The trip settings to update.
Trip trip = Trip.newBuilder()
.setVehicleId("8241890")
.build();
// The trip update request.
UpdateTripRequest updateTripRequest =
UpdateTripRequest.newBuilder() // No need for the header.
.setName(tripName)
.setTrip(trip)
.setUpdateMask(FieldMask.newBuilder().addPaths("vehicle_id"))
.build();
// Error handling.
// If the Fleet Engine has both a trip and vehicle with IDs, and if the
// credentials validate, then the service updates the trip.
try {
Trip updatedTrip = tripService.updateTrip(updateTripRequest);
} catch (StatusRuntimeException e) {
Status s = e.getStatus();
switch (s.getCode()) {
case NOT_FOUND: // Neither the trip nor vehicle exist.
break;
case PERMISSION_DENIED:
break;
}
return;
}
Quản lý trạng thái chuyến đi cho các chuyến đi
Bạn chỉ định trạng thái của một chuyến đi bằng cách sử dụng một trong các giá trị liệt kê TripStatus. Khi trạng thái của một chuyến đi thay đổi (ví dụ: từ ENROUTE_TO_PICKUP đến ARRIVED_AT_PICKUP), bạn sẽ cập nhật trạng thái chuyến đi trong Fleet Engine. Vòng đời chuyến đi luôn bắt đầu bằng giá trị trạng thái là NEW và kết thúc bằng giá trị là COMPLETE hoặc CANCELED.
Ví dụ về thông tin cập nhật chuyến đi
Nội dung sau đây minh hoạ cách cập nhật trạng thái chuyến đi cho chuyến đi khứ hồi trong Fleet Engine.
static final String PROJECT_ID = "my-rideshare-co-gcp-project";
static final String TRIP_ID = "trip-8241890";
String tripName = "providers/" + PROJECT_ID + "/trips/" + TRIP_ID;
TripServiceBlockingStub tripService = TripService.newBlockingStub(channel);
// Trip settings to be updated.
Trip trip = Trip.newBuilder()
.setTripStatus(TripStatus.ARRIVED_AT_PICKUP)
.build();
// Trip update request
UpdateTripRequest updateTripRequest = UpdateTripRequest.newBuilder()
.setName(tripName)
.setTrip(trip)
.setUpdateMask(FieldMask.newBuilder().addPaths("trip_status"))
.build();
// Error handling.
try {
Trip updatedTrip = tripService.updateTrip(updateTripRequest);
} catch (StatusRuntimeException e) {
Status s = e.getStatus();
switch (s.getCode()) {
case NOT_FOUND: // The trip doesn't exist.
break;
case FAILED_PRECONDITION: // The given trip status is invalid.
break;
case PERMISSION_DENIED:
break;
}
return;
}
Bạn có thể xem các ví dụ khác về cách cập nhật chuyến đi trong mục Các loại chuyến đi khác.
Xử lý lỗi chuyến đi
Khi cập nhật hoặc tìm các chuyến đi hiện có, bạn có thể gặp phải lỗi DEADLINE_EXCEEDED, tức là không xác định được trạng thái của Fleet Engine.
Để điều tra vấn đề này, trước tiên, hãy gọi lại CreateTrip bằng cùng một mã chuyến đi mà bạn đang cố gắng cập nhật hoặc theo dõi. Thao tác này sẽ trả về lỗi 201 (ĐÃ TẠO) hoặc 409 (Xung đột). Trong trường hợp sau, yêu cầu trước đó đã thành công trước khi DEADLINE_EXCEEDED.
Xem danh sách các lỗi mạng trong SDK người tiêu dùng, dành cho Android hoặc iOS.