Эта страница переведена с помощью Cloud Translation API.

Введение: Создание транспортных средств

Общую информацию о работе транспортных средств в Fleet Engine см. в следующих руководствах в разделе «Основы Fleet Engine»:

The documentation in this section describes how to create and manage vehicles in Fleet Engine. You create vehicles in the Fleet Engine server environment to mirror the actual vehicles in your real-world operation. Your Fleet Engine vehicles should also correspond to those used in your backend system that you use for vehicle assignments and routing.

Для создания ресурса транспортного средства используется метод `create`, либо с помощью gRPC, либо с помощью REST. Для простоты названия полей в этом руководстве используют нотацию gRPC.

Поездки по запросу

CreateVehicleRequest (gRPC)
providers.vehicle.create (REST)
Ресурсы Vehicle ( REST , gRPC )

Запланированные задачи

CreateDeliveryVehicleRequest (gRPC)
providers.deliveryVehicles.create (REST)
DeliveryVehicle ( REST , gRPC )

Запросы на транспортные средства

Как для задач по запросу, так и для задач по расписанию, создание и обновление транспортного средства осуществляется путем отправки запроса с полями, которые вкратце описываются следующим образом:

Родительский элемент : строка, связанная с идентификатором вашего проекта Google Cloud, используемая для заполнения поля имени экземпляра транспортного средства.
Идентификатор транспортного средства : уникальная строка, используемая для заполнения поля name транспортного средства.
Note: Vehicle ID strings have certain character restrictions. Avoid auto-incrementing IDs and ensure they contain no personally-identifiable information. For details on character restrictions, see the vehicle ID field for CreateVehicleRequest or CreateDeliveryVehicleRequest .
Экземпляр транспортного средства с необходимыми полями. Эти поля зависят от используемых вами возможностей Fleet Engine.

Информация в тексте запроса зависит от его характера. Подробности см. в соответствующих руководствах.

Токены аутентификации и авторизации

Запросы к Fleet Engine также должны содержать корректные учетные данные доступа. Примеры в этом руководстве основаны на следующих предположениях:

В примерах gRPC предполагается использование библиотеки Authorization для Java.
Примеры REST-запросов иллюстрируют заголовок HTTP-запроса, который должен содержать поле Authorization со значением Bearer <token> где <token> — это JSON Web Token, который вы выдаете .

Более подробную информацию см. в руководствах по настройке Fleet Engine .

Поля ресурсов транспортных средств

Ресурс транспортного средства имеет следующие типы полей:

Output only fields . Fields that are set by the service as an output of another method and cannot be directly set . An important field of this type is the name field. Fleet Engine ignores any supplied value for the name field of the vehicle per guidance from Google AIP for user-specified IDs . If you supply values for these fields, Fleet Engine returns an error.
Required fields . Vehicles created in the on-demand trip service require that certain fields be set on creation. Vehicles created in the scheduled tasks service have no required vehicle resource fields.
Необязательные поля . В обоих сервисах есть поля, которые можно задать при создании или позже. Их можно найти в соответствующем справочном руководстве для используемого вами сервиса.

Название транспортного средства (только для вывода)

Поле name абсолютно одинаково для поездок по требованию и плановых рейсов. Fleet Engine определяет это поле при создании транспортного средства на основе двух полей, которые вы задаете при создании транспортного средства:

The parent : a string associated with your Google Cloud project ID of the form providers/{provider} where {provider} is the ID of your Cloud project. Each vehicle you create for a given project will have the same parent path.
The Cloud project you reference here must also contain the Fleet Engine service account roles for the service you use. See Service Accounts for a list of those service accounts. Fleet Engine does not support access from multiple Google Cloud projects.
The ID for the vehicle , which must be unique across all vehicles in your fleet and be a valid Unicode string. This is the resource ID for the vehicle. Both on-demand trips and scheduled stops use this to associate a trip or a task with the vehicle that completes it.

В сервисах Google Cloud все API должны представлять ресурсы в виде строк. Дополнительные сведения см. в разделе «Именование ресурсов в Fleet Engine» .

Уникальные идентификаторы сущностей

The format and value of the unique entity identifiers used in resource calls are opaque to Fleet Engine. Make sure that the identifier does not contain any personally-identifiable information (PII), such as the driver's phone number.

повторное использование транспортных средств

After a vehicle completes all stops for a given itinerary, it remains available for re-use in Fleet Engine for 7 days, which means you can reuse a vehicle on subsequent business days without having to create a new one. Each time you reuse a vehicle, Fleet Engine resets its availability, at which point the 7-day countdown begins anew.

The recommended approach to keep a vehicle available in Fleet Engine is to update its location at regular intervals. Updates to most other fields in the Vehicle entity will also extend its life, provided that the new field value is different from the existing one.

ПРИМЕЧАНИЕ: Некоторые поля в сущности Vehicle , такие как device_settings содержат исключительно отладочную информацию и не сохраняются системой Fleet Engine. Их обновление не продлевает срок службы сущности Vehicle средство».

For improved system analytics, it's best to re-use the same driver-vehicle ID pairing from day to day. Do this by using the same vehicle ID associated with the driver for previous scheduled stops or on-demand trips.