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

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

Документация в этом разделе описывает, как создавать и управлять транспортными средствами в Fleet Engine. Вы создаете транспортные средства в среде сервера Fleet Engine, чтобы отражать фактические транспортные средства в вашей реальной работе. Ваши транспортные средства Fleet Engine также должны соответствовать тем, которые используются в вашей бэкэнд-системе, которую вы используете для назначения транспортных средств и маршрутизации.

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

Поездки по требованию

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

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

Для задач по требованию и запланированных задач вы создаете и обновляете транспортное средство, отправляя сообщение-запрос с полями, которые можно резюмировать следующим образом:

  1. Родительский элемент : строка, связанная с вашим идентификатором проекта Google Cloud, используемая для заполнения поля имени экземпляра транспортного средства.

  2. Идентификатор транспортного средства : уникальная строка, используемая для заполнения поля name транспортного средства.

  3. Экземпляр транспортного средства с его обязательными полями. Эти поля зависят от возможностей Fleet Engine, которые вы используете.

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

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

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

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

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

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

  • Только выходные поля . Поля, которые устанавливаются службой как выходные данные другого метода и не могут быть установлены напрямую . Важным полем этого типа является поле name . Fleet Engine игнорирует любое предоставленное значение для поля name транспортного средства в соответствии с указаниями Google AIP для указанных пользователем идентификаторов . Если вы предоставляете значения для этих полей, Fleet Engine возвращает ошибку.
  • Обязательные поля . Транспортные средства, созданные в службе поездок по требованию, требуют установки определенных полей при создании. Транспортные средства, созданные в службе запланированных задач, не имеют обязательных полей ресурсов транспортных средств.
  • Необязательные поля . У обоих сервисов есть поля, которые можно задать при создании или после. Их можно найти в соответствующем справочном руководстве для используемого вами сервиса.

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

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

  • Родитель : строка, связанная с вашим идентификатором проекта Google Cloud в форме providers/{provider} , где {provider} — это идентификатор вашего проекта Cloud. Каждое транспортное средство, которое вы создаете для данного проекта, будет иметь тот же родительский путь.

    Проект Cloud, на который вы ссылаетесь здесь, также должен содержать роли учетной записи службы Fleet Engine для используемой вами службы. Список учетных записей служб см. в разделе Учетные записи служб. Fleet Engine не поддерживает доступ из нескольких проектов Google Cloud.

  • Идентификатор транспортного средства , который должен быть уникальным для всех транспортных средств в вашем парке и представлять собой допустимую строку Unicode. Это идентификатор ресурса для транспортного средства. Как поездки по требованию, так и запланированные остановки используют его для связывания поездки или задачи с транспортным средством, которое ее выполняет.

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

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

Формат и значение уникальных идентификаторов сущностей, используемых в вызовах ресурсов, непрозрачны для Fleet Engine. Убедитесь, что идентификатор не содержит никакой персонально идентифицируемой информации (PII), например, номера телефона водителя.

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

После того, как транспортное средство завершает все остановки по заданному маршруту, оно остается доступным для повторного использования в Fleet Engine в течение 7 дней, что означает, что вы можете повторно использовать транспортное средство в последующие рабочие дни без необходимости создавать новое. Каждый раз, когда вы повторно используете транспортное средство, Fleet Engine сбрасывает его доступность, и в этот момент 7-дневный отсчет начинается заново.

Рекомендуемый подход к поддержанию доступности транспортного средства в Fleet Engine — это регулярное обновление его местоположения. Обновления большинства других полей в сущности Vehicle также продлят срок его службы, при условии, что новое значение поля отличается от существующего.

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

Для улучшения аналитики системы лучше всего повторно использовать одну и ту же пару идентификаторов водителя и транспортного средства изо дня в день. Используйте тот же идентификатор транспортного средства, связанный с водителем для предыдущих запланированных остановок или поездок по требованию.

Что дальше?