Tài liệu này mô tả cách cập nhật chuyến đi và quản lý trạng thái của chuyến đi, bao gồm 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 Động cơ của đội xe như mô tả trong 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 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 một chuyến đi, hãy gửi yêu cầu bằng gRPC và REST.
Sử dụng thông tin xác thực thích hợp cho tài khoản dịch vụ của dự án như mô tả trong phần Công cụ của đội xe: Vai trò của 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, thông thường, trước tiên, bạn sẽ tìm một xe rồi cập nhật trường vehicle_id của chuyến đi để liên kết chuyến đi đó với 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 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. Công cụ của Fleet sử dụng mặt nạ trường để cập nhật các trường trên tất cả 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 thành ARRIVED_AT_PICKUP, bạn sẽ cập nhật trạng thái chuyến đi trong Công cụ quản lý đội xe. Vòng đời chuyến đi luôn bắt đầu bằng giá trị trạng thái NEW và kết thúc bằng giá trị COMPLETE hoặc CANCELED.
Ví dụ về thông tin cập nhật về chuyến đi
Phần sau đây minh hoạ cách cập nhật trạng thái chuyến đi cho một chuyến đi liên tiếp trong Động cơ 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);
// 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 lỗi DEADLINE_EXCEEDED. Trong trường hợp này, trạng thái của Công cụ quản lý đội xe không xác định.
Để điều tra vấn đề này, trước tiên, hãy gọi lại CreateTrip bằng chính 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ề 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 lỗi mạng trong SDK dành cho người dùng, dành cho Android hoặc iOS.