Giới thiệu: Tạo phương tiện di chuyển

Để biết thông tin chung về cách xe hoạt động trong Fleet Engine, hãy xem các hướng dẫn sau đây trong phần Thông tin 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ủ Fleet Engine để phản ánh các xe thực tế trong hoạt động thực tế của mình. Xe trong Fleet Engine cũng phải tương ứng với những xe được dùng trong hệ thống phụ trợ mà bạn sử dụng để chỉ định xe và định tuyến.

Bạn sử dụng phương thức tạo để tạo tài nguyên xe, bằng gRPC hoặc REST. Tên trường trong hướng dẫn này sử dụng ký hiệu gRPC để đơn giản hoá.

Chuyến đi theo yêu cầu

Nhiệm vụ đã lên lịch

Yêu cầu về xe

Đối với cả tính năng theo yêu cầu và tính năng nhiệm vụ đã lên lịch, bạn sẽ tạo và cập nhật xe bằng cách gửi thông báo yêu cầu có các trường, được tóm tắt như sau:

  1. Phần tử mẹ: một chuỗi được liên kết với mã dự án trên đám mây của Google Cloud, dùng để điền vào trường tên của thực thể xe.

  2. Mã nhận dạng của xe: một chuỗi riêng biệt dùng để điền vào name trường của xe.

  3. Thực thể xe có các trường bắt buộc. Các trường này phụ thuộc vào tính 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 bản chất của yêu cầu. Hãy xem thông tin chi tiết đó trong các 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 Fleet Engine cũng phải cung cấp thông tin đăng nhập chính xác. Các ví dụ trong hướng dẫn này có những giả định sau:

Để biết thêm thông tin chi tiết, 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:

  • 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ể đặt trực tiếp. Một trường quan trọng thuộc loại này là trường name. Fleet Engine bỏ qua mọi giá trị được cung cấp cho trường name của xe theo hướng dẫn của Google AIP cho 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, Fleet Engine sẽ trả về lỗi.
  • Trường bắt buộc. Các xe được tạo trong dịch vụ chuyến đi theo yêu cầu yêu cầu phải đặt một số trường khi tạo. Các xe được tạo trong dịch vụ nhiệm vụ đã lên 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 trường 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 hoàn toàn giống nhau đối với các chuyến đi theo yêu cầu và dịch vụ nhiệm vụ đã lên lịch. Fleet Engine xác định trường này khi bạn tạo xe, dựa trên 2 trường mà bạn đặt khi tạo xe:

  • Phần tử mẹ: một chuỗi được liên kết với mã dự án Google Cloud của bạn theo mẫu providers/{provider} trong đó {provider} là mã nhận dạng của dự án Cloud. Mỗi xe mà bạn tạo cho một dự án nhất định sẽ có cùng đường dẫn mẹ.

    Dự án trên đám mây mà bạn tham chiếu ở đây cũng phải chứa các vai trò tài khoản dịch vụ Fleet Engine 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ụ đó. Fleet Engine không hỗ trợ quyền truy cập từ nhiều dự án Google Cloud.

  • Mã nhận dạng của xe. Mã này phải là duy nhất trên tất cả các xe trong đội xe của bạn và phải là 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 đã lên lịch đều sử dụng mã này để liên kết một chuyến đi hoặc một nhiệm vụ với xe hoàn thành chuyến đi hoặc nhiệm vụ đó.

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 các lệnh gọi tài nguyên là không rõ ràng đối với Fleet Engine. Đả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 tài xế.

Tái sử dụng xe

Sau khi một xe hoàn thành 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 tái sử dụng trong Fleet Engine trong 7 ngày. Điều này có nghĩa là bạn có thể tái sử dụng một 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 tái sử dụng một xe, Fleet Engine sẽ đặt lại trạng thái sẵn có của xe đó. Tại thời điểm đó, quá trình đếm ngược 7 ngày sẽ bắt đầu lại.

Phương pháp được đề xuất để duy trì trạng thái sẵn có của xe trong Fleet Engine là cập nhật vị trí của xe theo khoảng thời gian thường xuyên. 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 mà Fleet Engine không lưu giữ. Việc cập nhật các trường này không kéo dài thời gian hoạt động của thực thể Vehicle.

Để cải thiện hoạt động phân tích hệ thống, tốt nhất là bạn nên tái sử dụng cùng một cặp mã nhận dạng tài xế-xe từ ngày này sang ngày khác. Hãy 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 tài xế cho các điểm dừng đã lên lịch trước đó hoặc các chuyến đi theo yêu cầu.

Bước tiếp theo