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 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

Việc cần làm đã lên lịch

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:

  1. 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.

  2. 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.

  3. 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 đến 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:

Để 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ường name 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 mã 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 mã 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.

Các bước tiếp theo