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

Общую информацию о работе транспортных средств в 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. Убедитесь, что идентификатор не содержит никакой личной информации, позволяющей идентифицировать личность, например, номер телефона водителя.

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

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

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

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

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

Что дальше?