Để biết thông tin chung về cách hoạt động của xe trong Fleet Engine, hãy xem sau đây là các hướng dẫn trong phần thông tin cơ bản về Fleet Engine:
Tài liệu trong mục này mô tả cách tạo và quản lý xe trong Fleet Engine. Bạn tạo xe trong môi trường máy chủ Fleet Engine để phản chiếu xe thực tế trong hoạt động thực tế của bạn. Động cơ đội phương tiện vận chuyển xe cũng phải tương ứng với xe được sử dụng trong hệ thống phụ trợ mà bạn dùng để chỉ định và định tuyến xe.
Bạn dùng phương thức tạo để tạo tài nguyên xe bằng gRPC hoặc REST. Để đơn giản, các tên trường trong hướng dẫn này sử dụng ký hiệu gRPC.
Chuyến đi theo yêu cầu
CreateVehicleRequest
(gRPC)providers.vehicle.create
(REST)- Tài nguyên
Vehicle
(REST, gRPC)
Việc cần làm đã lên lịch
CreateDeliveryVehicleRequest
(gRPC)providers.deliveryVehicles.create
(REST)DeliveryVehicle
(REST, gRPC)
Yêu cầu về xe
Để có cả tính năng tác vụ theo yêu cầu và theo lịch biểu, bạn có thể tạo và cập nhật một xe bằng cách đưa ra một thông báo yêu cầu với các trường, được tóm tắt như sau:
- Tệp mẹ: một chuỗi liên kết với mã dự án trên Google Cloud của bạn, được dùng để điền vào trường tên cho thực thể xe.
Mã nhận dạng xe: một chuỗi duy nhất dùng để điền sẵn dữ liệu cho
name
trường của chiếc xe.Một thực thể xe với các trường bắt buộc. Các trường này phụ thuộc vào Chức năng Fleet Engine mà bạn sử dụng.
Thông tin trong nội dung yêu cầu sẽ khác nhau tuỳ theo tính chất của yêu cầu. Xem những thông tin đó theo hướng dẫn tương ứng.
Mã thông báo uỷ quyền và xác thực
Các yêu cầu gửi tới Fleet Engine cũng phải cung cấp thông tin xác thực truy cập chính xác. Các ví dụ trong hướng dẫn này có các giả định sau:
- Các ví dụ về gRPC giả định việc sử dụng Thư viện uỷ quyền cho Java.
- Các ví dụ REST minh hoạ tiêu đề của yêu cầu HTTP. Tiêu đề này phải chứa
trường
Authorization
có giá trịBearer <token>
, trong đó<token>
là một Mã thông báo web JSON mà bạn đưa ra.
Để biết thêm thông tin, hãy xem hướng dẫn Thiết lập Fleet Engine.
Trường tài nguyên xe
Tài nguyên xe có các loại trường sau đây:
- Các trường chỉ có đầu ra. Các trường do dịch vụ đặt làm dữ liệu đầu ra của
một phương thức khác và không thể đặt trực tiếp. Một trường quan trọng của trường này
là trường
name
. Fleet Engine bỏ qua mọi giá trị được cung cấp cho Trườngname
của xe cho mỗi hướng dẫn từ AIP của Google cho nội dung do người dùng chỉ định Mã nhận dạng. Nếu bạn cung cấp giá trị cho các trường này, Fleet Engine sẽ trả về một lỗi. - Trường bắt buộc. Xe được tạo trong dịch vụ chuyến đi theo yêu cầu cần có thiết lập một số trường khi tạo. Những chiếc xe được tạo trong lịch biểu dịch vụ nhiệm vụ không có trường tài nguyên xe bắt buộc.
- Trường không bắt buộc. Cả hai dịch vụ đều có các trường mà bạn có thể đặt khi tạo hoặc sau đó. Bạn có thể tìm thấy các tài liệu này trong hướng dẫn tham khảo tương ứng cho mà bạn sử dụng.
Tên xe (chỉ ở đầu ra)
Trường name
hoàn toàn giống nhau đối với chuyến đi theo yêu cầu và tác vụ đã lên lịch
luôn miễn phí. Fleet Engine xác định trường khi bạn tạo xe, dựa trên
2 trường bạn đặt khi tạo xe:
Tệp mẹ: một chuỗi liên kết với mã dự án trên Google Cloud của biểu mẫu
providers/{provider}
, trong đó{provider}
là mã nhận dạng đám mây của bạn dự án. Mỗi chiếc xe mà bạn tạo cho một dự án nhất định sẽ có cùng một đường dẫn mẹ.Dự án Cloud mà bạn tham chiếu ở đây cũng phải chứa Fleet Engine vai trò của tài khoản dịch vụ cho dịch vụ mà bạn sử dụng. Xem phần Tài khoản dịch vụ để danh sách các tài khoản dịch vụ đó. Fleet Engine không hỗ trợ truy cập từ nhiều dự án trên Google Cloud.
Mã nhận dạng xe, phải là mã riêng biệt trên tất cả các xe trong nhóm và là một chuỗi Unicode hợp lệ. Đây là mã tài nguyên cho phần chiếc xe. Cả các chuyến đi theo yêu cầu và điểm dừng được lên lịch đều sử dụng giá trị này để liên kết chuyến đi hoặc nhiệm vụ với chiếc xe hoàn thành chuyến đi đó.
Trong các dịch vụ trên Google Cloud, tất cả API phải biểu thị tài nguyên dưới dạng chuỗi. Xem phần Đặt tên tài nguyên trong Fleet Engine để biết thêm chi tiết.
Giá trị nhận dạng thực thể duy nhất
Định dạng và giá trị của giá trị nhận dạng thực thể duy nhất dùng trong các lệnh gọi tài nguyên không rõ ràng đối với Fleet Engine. Hãy đảm bảo rằng giá trị nhận dạng không chứa bất kỳ thông tin nhận dạng cá nhân (PII), chẳng hạn như số điện thoại của người lái xe.
Tái sử dụng xe
Sau khi một phương tiện hoàn tất tất cả điểm dừng của một hành trình cụ thể, bạn sẽ vẫn có xe đó để sử dụng lại trong Fleet Engine trong 7 ngày, tức là bạn có thể tái sử dụng một chiếc xe trên ngày làm việc tiếp theo mà không phải tạo ngày làm việc mới. Mỗi khi bạn sử dụng lại một chiếc xe, Fleet Engine sẽ đặt lại khả năng sử dụng của phương tiện, tại thời điểm đó Đếm ngược 7 ngày bắt đầu lại từ đầu.
Để duy trì phương tiện hoạt động trong Fleet Engine, bạn nên:
cập nhật vị trí của thiết bị theo định kỳ. Nội dung cập nhật đối với hầu hết các trường khác trong
Thực thể Vehicle
cũng sẽ kéo dài thời gian tồn tại, miễn là giá trị trường mới là
khác với đơn vị quảng cáo hiện có.
LƯU Ý: Một số trường trên thực thể Vehicle
như device_settings
chỉ đơn thuần là gỡ lỗi
những thông tin mà Fleet Engine không lưu giữ. Việc cập nhật họ sẽ không
kéo dài vòng đời của thực thể Vehicle
.
Để cải thiện số liệu phân tích hệ thống, tốt nhất bạn nên sử dụng lại cùng một mã nhận dạng xe của người lái ghép nối hằng ngày. Hãy làm việc này bằng cách sử dụng cùng một mã xe được liên kết với trình điều khiển cho các điểm dừng theo lịch trình trước đó hoặc các chuyến đi theo yêu cầu.