Общую информацию о том, как транспортные средства работают в Fleet Engine, см. в следующих руководствах в разделе «Основные сведения о Fleet Engine»:
В документации в этом разделе описывается, как создавать транспортные средства и управлять ими в Fleet Engine. Вы создаете транспортные средства в среде сервера Fleet Engine, чтобы отражать реальные транспортные средства, используемые в вашей реальной работе. Ваши транспортные средства Fleet Engine также должны соответствовать тем, которые используются в вашей серверной системе, которую вы используете для назначения транспортных средств и маршрутизации.
Вы используете метод 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
транспортного средства.Экземпляр транспортного средства с обязательными полями. Эти поля зависят от используемых вами возможностей Fleet Engine.
Информация в теле запроса зависит от характера запроса. Подробности см. в соответствующих руководствах.
Токены аутентификации и авторизации
Запросы к Fleet Engine также должны предоставлять правильные учетные данные для доступа. Примеры в этом руководстве основаны на следующих предположениях:
- Примеры gRPC предполагают использование библиотеки авторизации для Java.
- Примеры REST иллюстрируют заголовок HTTP-запроса, который должен содержать поле
Authorization
со значениемBearer <token>
, где<token>
— это выданный вами веб-токен JSON .
Дополнительные сведения см. в руководствах по настройке Fleet Engine .
Поля ресурсов транспортных средств
Ресурс транспортного средства имеет следующие виды полей:
- Выводить только поля . Поля, которые задаются службой как выходные данные другого метода и не могут быть заданы напрямую . Важным полем этого типа является поле
name
. Fleet Engine игнорирует любое указанное значение в полеname
транспортного средства в соответствии с рекомендациями Google AIP для идентификаторов, указанных пользователем . Если вы укажете значения для этих полей, Fleet Engine вернет ошибку. - Обязательные поля . Транспортные средства, созданные в сервисе поездок по требованию, требуют установки определенных полей при создании. Транспортные средства, созданные в сервисе запланированных задач, не имеют обязательных полей ресурсов транспортных средств.
- Необязательные поля . Обе службы имеют поля, которые вы можете настроить при создании или впоследствии. Их можно найти в соответствующем справочном руководстве для используемой вами службы.
Название автомобиля (только вывод)
Поле name
одинаково для поездок по требованию и служб запланированных задач. Fleet Engine определяет поле при создании транспортного средства на основе двух полей, которые вы задаете при создании транспортного средства:
Родитель : строка, связанная с идентификатором вашего проекта Google Cloud в форме
providers/{provider}
где{provider}
— это идентификатор вашего облачного проекта. Каждое транспортное средство, которое вы создаете для данного проекта, будет иметь один и тот же родительский путь.Проект Cloud, на который вы ссылаетесь здесь, также должен содержать роли учетной записи службы Fleet Engine для используемой вами службы. Список этих учетных записей служб см. в разделе «Учетные записи служб ». Fleet Engine не поддерживает доступ из нескольких проектов Google Cloud.
Идентификатор автомобиля , который должен быть уникальным для всех автомобилей в вашем парке и представлять собой действительную строку Юникода. Это идентификатор ресурса для транспортного средства. И поездки по требованию, и запланированные остановки используют это, чтобы связать поездку или задачу с транспортным средством, которое ее выполняет.
В облачных сервисах Google все API должны представлять ресурсы в виде строк. Дополнительные сведения см. в разделе Именование ресурсов в Fleet Engine .
Уникальные идентификаторы объектов
Формат и значение уникальных идентификаторов объектов, используемых в вызовах ресурсов, непрозрачны для Fleet Engine. Убедитесь, что идентификатор не содержит никакой личной информации (PII), например номера телефона водителя.
Повторное использование автомобиля
После того как транспортное средство совершает все остановки по заданному маршруту, оно остается доступным для повторного использования в Fleet Engine в течение 7 дней. Это означает, что вы можете повторно использовать транспортное средство в последующие рабочие дни без необходимости создания нового. Каждый раз, когда вы повторно используете транспортное средство, Fleet Engine сбрасывает его доступность, после чего 7-дневный обратный отсчет начинается заново.
Рекомендуемый подход к обеспечению доступности транспортного средства в Fleet Engine — регулярно обновлять его местоположение. Обновления большинства других полей сущности Vehicle
» также продлевают срок ее службы при условии, что новое значение поля отличается от существующего.
ПРИМЕЧАНИЕ. Некоторые поля объекта Vehicle
, такие как device_settings
представляют собой чисто отладочную информацию, которая не сохраняется в Fleet Engine. Их обновление не продлевает срок службы сущности Vehicle
».
Для улучшения системного анализа лучше всего изо дня в день повторно использовать одну и ту же пару идентификаторов водителя и транспортного средства. Для этого используйте тот же идентификатор транспортного средства, который был связан с водителем для предыдущих запланированных остановок или поездок по требованию.