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