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

Общую информацию о работе транспортных средств в 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 все API должны представлять ресурсы в виде строк. Подробнее см. в разделе «Именование ресурсов в Fleet Engine» .

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

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

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

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

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

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

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

Что дальше?