Trip and Order Progress

Класс FleetEngineTripLocationProvider

google.maps.journeySharing . FleetEngineTripLocationProvider

Поставщик данных о месте поездки.

Этот класс расширяет PollingLocationProvider .

Доступ осуществляется путем вызова const {FleetEngineTripLocationProvider} = await google.maps.importLibrary("journeySharing") .
См. Библиотеки в Maps JavaScript API .

FleetEngineTripLocationProvider
FleetEngineTripLocationProvider(options)
Параметры:
Создает нового поставщика местоположения для поездки Fleet Engine.
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION(params)
Параметры:
Возвращаемое значение: нет
Функция настройки полилинии, которая раскрашивает активную полилинию в соответствии с показаниями скорости. Укажите эту функцию как FleetEngineTripLocationProviderOptions.activePolylineCustomization чтобы отрисовать полилинию с учётом дорожной ситуации для активной полилинии.
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION(params)
Параметры:
Возвращаемое значение: нет
Функция настройки полилинии, которая раскрашивает оставшуюся часть полилинии в соответствии с показаниями скорости. Укажите эту функцию как FleetEngineTripLocationProviderOptions.remainingPolylineCustomization , чтобы отрисовать полилинию с учётом дорожной ситуации для оставшейся части полилинии.
tripId
Тип: string
Идентификатор поездки, которую отслеживает этот поставщик местоположения. Заполните это поле, чтобы начать отслеживание.
Унаследовано: isPolling , pollingIntervalMillis
refresh
refresh()
Параметры: нет
Возвращаемое значение: void
Явно обновляет отслеживаемое местоположение.
Унаследовано: addListener
error
function(event)
Аргументы:
Событие, которое срабатывает, когда поставщик данных о местоположении обнаруживает ошибку.
update
function(event)
Аргументы:
Событие, которое запускается после завершения запроса на обновление данных Fleet Engine.
Унаследовано: ispollingchange

Интерфейс FleetEngineTripLocationProviderOptions

google.maps.journeySharing . FleetEngineTripLocationProviderOptions

Варианты выбора поставщика места поездки.

authTokenFetcher
Предоставляет JSON Web Tokens для аутентификации клиента в Fleet Engine.
projectId
Тип: string
Идентификатор проекта потребителя из Google Cloud Console.
activePolylineCustomization optional
Тип: (function( TripPolylineCustomizationFunctionParams ): void)| PolylineOptions optional
Настройка, примененная к активной ломаной линии. Активная ломаная линия соответствует участку маршрута, по которому в данный момент движется транспортное средство.

Используйте это поле для указания пользовательского стиля (например, цвета полилинии) и интерактивности (например, обработки щелчков).
  • Если указан объект PolylineOptions , указанные в нем изменения применяются к полилинии после ее создания, перезаписывая ее параметры по умолчанию, если они существуют.
  • Если функция указана, она вызывается один раз при создании полилинии. (При этом вызове параметр isNew в объекте параметров функции устанавливается в true .) Кроме того, эта функция вызывается при изменении координат полилинии или при получении поставщиком местоположения данных от Fleet Engine, независимо от того, изменились ли данные, соответствующие этой полилинии.

    Список предоставленных параметров и их использование см. в разделе TripPolylineCustomizationFunctionParams
destinationMarkerCustomization optional
Тип: (function( TripMarkerCustomizationFunctionParams ): void)| MarkerOptions optional
К маркеру назначения применена настройка.

Используйте это поле для указания пользовательского стиля (например, значка маркера) и интерактивности (например, обработки щелчков).
  • Если указан объект MarkerOptions , указанные в нем изменения применяются к маркеру после его создания, перезаписывая его параметры по умолчанию, если они существуют.
  • Если функция указана, она вызывается один раз при создании маркера, перед его добавлением в представление карты. (При этом вызове параметр isNew в объекте параметров функции устанавливается в true .) Кроме того, эта функция вызывается, когда поставщик местоположения получает данные от Fleet Engine, независимо от того, изменились ли данные, соответствующие этому маркеру.

    Список предоставленных параметров и их использование см. в разделе TripMarkerCustomizationFunctionParams
originMarkerCustomization optional
Тип: (function( TripMarkerCustomizationFunctionParams ): void)| MarkerOptions optional
К маркеру происхождения применена настройка.

Используйте это поле для указания пользовательского стиля (например, значка маркера) и интерактивности (например, обработки щелчков).
  • Если указан объект MarkerOptions , указанные в нем изменения применяются к маркеру после его создания, перезаписывая его параметры по умолчанию, если они существуют.
  • Если функция указана, она вызывается один раз при создании маркера, перед его добавлением в представление карты. (При этом вызове параметр isNew в объекте параметров функции устанавливается в true .) Кроме того, эта функция вызывается, когда поставщик местоположения получает данные от Fleet Engine, независимо от того, изменились ли данные, соответствующие этому маркеру.

    Список предоставленных параметров и их использование см. в разделе TripMarkerCustomizationFunctionParams
pollingIntervalMillis optional
Тип: number optional
Минимальное время между обновлениями местоположения в миллисекундах. Если обновление местоположения занимает больше времени, чем pollingIntervalMillis , следующее обновление местоположения не запустится, пока не завершится текущее.

Установка значения 0 отключает повторяющиеся обновления местоположения. Новое обновление местоположения загружается при изменении любого из параметров, отслеживаемых поставщиком местоположения.

Интервал опроса по умолчанию составляет 5000 миллисекунд (минимальный). Если задать меньшее значение, отличное от нуля, будет использоваться значение 5000 миллисекунд.
remainingPolylineCustomization optional
Тип: (function( TripPolylineCustomizationFunctionParams ): void)| PolylineOptions optional
Настройка применена к оставшейся части полилинии. Оставшаяся часть полилинии соответствует части маршрута, по которой транспортное средство ещё не начало движение.

Используйте это поле для указания пользовательского стиля (например, цвета полилинии) и интерактивности (например, обработки щелчков).
  • Если указан объект PolylineOptions , указанные в нем изменения применяются к полилинии после ее создания, перезаписывая ее параметры по умолчанию, если они существуют.
  • Если функция указана, она вызывается один раз при создании полилинии. (При этом вызове параметр isNew в объекте параметров функции устанавливается в true .) Кроме того, эта функция вызывается при изменении координат полилинии или при получении поставщиком местоположения данных от Fleet Engine, независимо от того, изменились ли данные, соответствующие этой полилинии.

    Список предоставленных параметров и их использование см. в разделе TripPolylineCustomizationFunctionParams
takenPolylineCustomization optional
Тип: (function( TripPolylineCustomizationFunctionParams ): void)| PolylineOptions optional
Настройка, примененная к выбранной ломаной линии. Выбранная ломаная линия соответствует части маршрута, по которому транспортное средство уже проехало.

Используйте это поле для указания пользовательского стиля (например, цвета полилинии) и интерактивности (например, обработки щелчков).
  • Если указан объект PolylineOptions , указанные в нем изменения применяются к полилинии после ее создания, перезаписывая ее параметры по умолчанию, если они существуют.
  • Если функция указана, она вызывается один раз при создании полилинии. (При этом вызове параметр isNew в объекте параметров функции устанавливается в true .) Кроме того, эта функция вызывается при изменении координат полилинии или при получении поставщиком местоположения данных от Fleet Engine, независимо от того, изменились ли данные, соответствующие этой полилинии.

    Список предоставленных параметров и их использование см. в разделе TripPolylineCustomizationFunctionParams
tripId optional
Тип: string optional
Идентификатор поездки для отслеживания сразу после создания экземпляра поставщика местоположения. Если не указан, поставщик местоположения не начнет отслеживать поездку; используйте FleetEngineTripLocationProvider.tripId , чтобы задать идентификатор и начать отслеживание.
vehicleMarkerCustomization optional
Тип: (function( TripMarkerCustomizationFunctionParams ): void)| MarkerOptions optional
Применена настройка к маркеру транспортного средства.

Используйте это поле для указания пользовательского стиля (например, значка маркера) и интерактивности (например, обработки щелчков).
  • Если указан объект MarkerOptions , указанные в нем изменения применяются к маркеру после его создания, перезаписывая его параметры по умолчанию, если они существуют.
  • Если функция указана, она вызывается один раз при создании маркера, перед его добавлением в представление карты. (При этом вызове параметр isNew в объекте параметров функции устанавливается в true .) Кроме того, эта функция вызывается, когда поставщик местоположения получает данные от Fleet Engine, независимо от того, изменились ли данные, соответствующие этому маркеру.

    Список предоставленных параметров и их использование см. в разделе TripMarkerCustomizationFunctionParams
waypointMarkerCustomization optional
Тип: (function( TripWaypointMarkerCustomizationFunctionParams ): void)| MarkerOptions optional
Настройка, примененная к маркеру путевой точки.

Используйте это поле для указания пользовательского стиля (например, значка маркера) и интерактивности (например, обработки щелчков).
  • Если указан объект MarkerOptions , указанные в нем изменения применяются к маркеру после его создания, перезаписывая его параметры по умолчанию, если они существуют.
  • Если функция указана, она вызывается один раз при создании маркера, перед его добавлением в представление карты. (При этом вызове параметр isNew в объекте параметров функции устанавливается в true .) Кроме того, эта функция вызывается, когда поставщик местоположения получает данные от Fleet Engine, независимо от того, изменились ли данные, соответствующие этому маркеру.

    Список предоставленных параметров и их использование см. в разделе TripWaypointMarkerCustomizationFunctionParams

Интерфейс FleetEngineTripLocationProviderUpdateEvent

google.maps.journeySharing . FleetEngineTripLocationProviderUpdateEvent

Объект события передается обработчику событий при возникновении события FleetEngineTripLocationProvider.update .

trip optional
Тип: Trip optional
Структура поездки, возвращаемая обновлением. Не подлежит изменению.