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 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ủ 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 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 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 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. Đối tượng mẹ: một chuỗi được liên kết với mã dự án trên Google Cloud, 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 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.

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ể đặ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 bắt buộc 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ỉ đầ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ụ theo lịch trình. Fleet Engine xác định trường khi bạn tạo phương tiện, dựa trên hai trường bạn thiết lập khi tạo phương tiện:

  • Phần tử cha: một chuỗi liên kết với ID dự án Google Cloud của bạn có dạng providers/{provider}, trong đó {provider} là ID của dự án Cloud của bạn. Mỗi phương tiện 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ụ 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à ID tài nguyên cho 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 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 mã định danh thực thể duy nhất được sử dụng trong các cuộc gọi tài nguyên 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 đó. Tại thời điểm này, quy trình đếm ngược 7 ngày sẽ bắt đầu lại.

Cách tiếp cận được khuyến nghị để duy trì trạng thái 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ể đó, với điều kiện 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, chỉ là thông tin gỡ lỗi mà Fleet Engine không duy trì. Việc cập nhật các đối tượng 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