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

Общие сведения о том, как транспортные средства работают в Fleet Engine, можно найти в следующих руководствах в разделе "Основы Fleet Engine":

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

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

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

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

Запросы на автомобили

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

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

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

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

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

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

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

Подробнее о том, как настроить Fleet Engine…

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

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

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

Название автомобиля (только для вывода)

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

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

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

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

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

Уникальные идентификаторы объектов

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

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

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

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

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

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

Дальнейшие действия