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

Để 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 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. Các 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 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 phương tiện, bằng cách sử dụ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

Nhiệm vụ theo lịch

Yêu cầu về xe

Đối với cả chức năng tác vụ theo yêu cầu và theo lịch, bạn sẽ tạo và cập nhật một chiếc xe bằng cách gửi một 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 Google Cloud của bạn, dùng để điền vào trường tên của phiên bản xe.

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

  3. Một thực thể xe cùng 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ẽ thay đổi tuỳ theo tính chất của yêu cầu. Hãy xem những 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 đối với 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.

Các trường tài nguyên xe

Tài nguyên xe có các loại trường sau:

  • Chỉ có các trường đầ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 của 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 đòi hỏi bạn phải thiết lập 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ó cá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 hoàn toàn giống 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. 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 trên Google Cloud của bạn theo dạng providers/{provider}, trong đó {provider} là mã nhận dạng của dự án trên Cloud. 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 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ụ 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 trên Google Cloud.

  • Mã nhận dạng của xe, phải là mã riêng biệt cho tất cả xe trong đội xe của bạn và phải 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 một nhiệm vụ với chiếc 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 đều 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 duy nhất của thực thể

Đị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 người lái xe.

Tái sử dụng xe

Sau khi 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 sử dụng lại trong Fleet Engine trong 7 ngày. Điều này có nghĩa là bạn có thể sử dụng lại xe vào những ngày làm việc tiếp theo mà không cần tạo xe mới. Mỗi lần bạn sử dụng lại một chiếc xe, Fleet Engine sẽ đặt lại trạng thái sẵn sàng của chiếc xe đó. Lúc này, quy 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 sàng của xe trong Fleet Engine là 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 tồn tại 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, chẳng hạn như device_settings, hoàn toàn là thông tin gỡ lỗi mà Fleet Engine không duy trì. Việc cập nhật các thực thể này không kéo dài thời gian tồn tại 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 sử dụng lại cùng một cặp mã nhận dạng người lái xe – xe hằng ngày. Hãy làm 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 đã lên lịch trước đó hoặc các chuyến đi theo yêu cầu.

Bước tiếp theo