Fleet Tracking - On Demand Rides & Delivery

Класс FleetEngineVehicleLocationProvider

google.maps.journeySharing . FleetEngineVehicleLocationProvider

Поставщик данных о местоположении транспортного средства.

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

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

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

Интерфейс FleetEngineVehicleLocationProviderOptions

google.maps.journeySharing . FleetEngineVehicleLocationProviderOptions

Варианты для поставщика данных о местоположении транспортного средства.

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

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

    Список предоставленных параметров и их применение см. в разделе VehiclePolylineCustomizationFunctionParams
destinationMarkerCustomization optional
Настройка применена к маркеру пункта назначения поездки транспортного средства.

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

    Список предоставленных параметров и их применение см. в разделе VehicleWaypointMarkerCustomizationFunctionParams
intermediateDestinationMarkerCustomization optional
Настройка применена к маркерам промежуточных пунктов назначения поездки транспортного средства.

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

    Список предоставленных параметров и их применение см. в разделе VehicleWaypointMarkerCustomizationFunctionParams
originMarkerCustomization optional
Настройка применена к маркеру начала поездки транспортного средства.

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

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

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

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

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

    Список предоставленных параметров и их применение см. в разделе VehiclePolylineCustomizationFunctionParams
staleLocationThresholdMillis optional
Тип: number optional
Пороговое значение для устаревшего местоположения транспортного средства. Если последнее обновлённое местоположение транспортного средства старше этого порогового значения, транспортное средство не будет отображаться. Значение по умолчанию — 24 часа в миллисекундах. Если пороговое значение меньше 0 или бесконечности , оно будет игнорироваться, и местоположение транспортного средства не будет считаться устаревшим.
takenPolylineCustomization optional
Тип: (function( VehiclePolylineCustomizationFunctionParams ): void)| PolylineOptions optional
Настройка, примененная к выбранной ломаной линии. Выбранная ломаная линия соответствует части маршрута, по которому транспортное средство уже проехало.

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

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

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

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

Интерфейс FleetEngineVehicleLocationProviderUpdateEvent

google.maps.journeySharing . FleetEngineVehicleLocationProviderUpdateEvent

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

trips optional
Тип: Array < Trip > optional
Список поездок, совершённых этим транспортным средством. Не подлежит изменению.
vehicle optional
Тип: Vehicle optional
Структура данных транспортного средства, возвращаемая обновлением. Не подлежит изменению.

Класс FleetEngineFleetLocationProvider

google.maps.journeySharing . FleetEngineFleetLocationProvider

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

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

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

FleetEngineFleetLocationProvider
FleetEngineFleetLocationProvider(options)
Параметры:
Создает нового поставщика местоположения для транспортных средств, отслеживаемых Fleet Engine.
locationRestriction
Тип: LatLngBounds | LatLngBoundsLiteral optional
Границы, в пределах которых отслеживаются транспортные средства. Если границы не заданы, отслеживаться не будут. Чтобы отслеживать все транспортные средства независимо от их местоположения, установите границы, эквивалентные всей территории Земли.
staleLocationThresholdMillis
Тип: number
Это поле доступно только для чтения. Пороговое значение для устаревшего местоположения транспортного средства. Если последнее обновлённое местоположение транспортного средства старше этого порогового значения, транспортное средство не будет отображаться.
vehicleFilter
Тип: string optional
Фильтр, применяемый при выборке транспортных средств.
Унаследовано: isPolling , pollingIntervalMillis
Унаследовано: addListener
update
function(event)
Аргументы:
Событие, которое запускается после завершения запроса на обновление данных Fleet Engine.
Унаследовано: ispollingchange

Интерфейс FleetEngineFleetLocationProviderOptions

google.maps.journeySharing . FleetEngineFleetLocationProviderOptions

Варианты для поставщика данных о местоположении автопарка.

authTokenFetcher
Предоставляет JSON Web Tokens для аутентификации клиента в Fleet Engine.
projectId
Тип: string
Идентификатор проекта потребителя из Google Cloud Console.
locationRestriction optional
Тип: LatLngBounds | LatLngBoundsLiteral optional
Границы широты/долготы, в пределах которых будут отслеживаться транспортные средства сразу после создания экземпляра поставщика местоположения. Если не заданы, поставщик местоположения не начнет отслеживать транспортные средства; используйте FleetEngineFleetLocationProvider.locationRestriction , чтобы задать границы и начать отслеживание. Чтобы отслеживать все транспортные средства независимо от местоположения, установите границы, эквивалентные всей поверхности Земли.
staleLocationThresholdMillis optional
Тип: number optional
Пороговое значение для устаревшего местоположения транспортного средства. Если последнее обновлённое местоположение транспортного средства старше этого порогового значения, транспортное средство не будет отображаться. Значение по умолчанию — 24 часа в миллисекундах. Если пороговое значение меньше нуля или бесконечности , оно будет игнорироваться, и местоположение транспортного средства не будет считаться устаревшим.
vehicleFilter optional
Тип: string optional
Фильтрующий запрос, применяемый при поиске транспортных средств. Этот фильтр передаётся непосредственно в Fleet Engine.

Поддерживаемые форматы см. в ListVehiclesRequest.filter .

Обратите внимание, что допустимые фильтры для атрибутов должны иметь префикс «attributes». Например, attributes.x = "y" или attributes."x y" = "z" .
vehicleMarkerCustomization optional
Тип: function( VehicleMarkerCustomizationFunctionParams ): void optional
Настройка маркера транспортного средства.

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

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

Интерфейс FleetEngineFleetLocationProviderUpdateEvent

google.maps.journeySharing . FleetEngineFleetLocationProviderUpdateEvent

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

vehicles optional
Тип: Array < Vehicle > optional
Список транспортных средств, возвращаемых запросом. Не подлежит изменению.