Method: providers.vehicles.create

Tạo bản sao của một xe mới được liên kết với một nhà cung cấp dịch vụ đi chung xe hoặc giao hàng theo yêu cầu. Mỗi Vehicle phải có một mã nhận dạng xe duy nhất.

Các trường Vehicle sau là bắt buộc khi tạo Vehicle:

  • vehicleState
  • supportedTripTypes
  • maximumCapacity
  • vehicleType

Các trường Vehicle sau đây sẽ bị bỏ qua khi tạo Vehicle:

  • name
  • currentTrips
  • availableCapacity
  • currentRouteSegment
  • currentRouteSegmentEndPoint
  • currentRouteSegmentVersion
  • currentRouteSegmentTraffic
  • route
  • waypoints
  • waypointsVersion
  • remainingDistanceMeters
  • remainingTimeSeconds
  • eta_to_next_waypoint
  • navigationStatus

Tất cả các trường khác là không bắt buộc và được sử dụng nếu được cung cấp.

Yêu cầu HTTP

POST https://fleetengine.googleapis.com/v1/{parent=providers/*}/vehicles

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
parent

string

Bắt buộc. Phải ở định dạng providers/{provider}. Nhà cung cấp phải là Mã dự án (ví dụ: sample-cloud-project) của Dự án Google Cloud mà tài khoản dịch vụ thực hiện lệnh gọi này là thành viên.

Tham số truy vấn

Thông số
header

object (RequestHeader)

Tiêu đề yêu cầu thông thường của Công cụ của đội xe.

vehicleId

string

Bắt buộc. Mã nhận dạng xe duy nhất. Chịu sự hạn chế sau:

  • Phải là một chuỗi Unicode hợp lệ.
  • Giới hạn độ dài tối đa là 64 ký tự.
  • Được chuẩn hoá theo Dạng chuẩn hoá Unicode C.
  • Không được chứa bất kỳ ký tự ASCII nào sau đây: '/', ':', '?', ',' hoặc '#'.

Nội dung yêu cầu

Nội dung yêu cầu chứa một bản sao của Vehicle.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một thực thể Vehicle mới tạo.