Оформление карты

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

• Используйте облачную стилизацию карт
• Задайте параметры стиля карты непосредственно в вашем коде

Оформите карту с помощью облачных инструментов стилизации карт

Чтобы применить стиль карты к карте поездок JavaScript для совместного использования потребителями, укажите mapId и любые другие mapOptions при создании JourneySharingMapView .

В следующих примерах показано, как применить стиль карты с идентификатором карты.

const mapView = new google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  mapOptions: {
    mapId: 'YOUR_MAP_ID'
  }
  // Any other styling options.
});

const mapView = new google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  mapOptions: {
    mapId: 'YOUR_MAP_ID'
  }
  // Any other styling options.
});

Стилизуйте карты непосредственно в своем коде

Вы также можете настроить стиль карты, задав параметры при создании JourneySharingMapView . В следующих примерах показано, как настроить стиль карты с помощью параметров. Подробнее о доступных параметрах карты см. в разделе mapOptions справочника по JavaScript API Google Карт.

const mapView = new google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  mapOptions: {
    styles: [
      {
        "featureType": "road.arterial",
        "elementType": "geometry",
        "stylers": [
          { "color": "#CCFFFF" }
        ]
      }
    ]
  }
});

const mapView = new google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  mapOptions: {
    styles: [
      {
        "featureType": "road.arterial",
        "elementType": "geometry",
        "stylers": [
          { "color": "#CCFFFF" }
        ]
      }
    ]
  }
});

Управление видимостью данных задач в SDK

Вы можете контролировать видимость определенных объектов задач на карте с помощью правил видимости.

Видимость данных задачи по умолчанию

По умолчанию данные о задачах, назначенных транспортному средству, отображаются, когда транспортное средство находится в пределах 5 остановок от задачи . Отображение прекращается после завершения или отмены задачи.

В этой таблице показаны настройки видимости по умолчанию для каждого типа задач. Вы можете настроить видимость для многих задач, но не для всех. Подробнее о типах задач см. в разделе «Типы задач» руководства «Запланированные задачи» .

Настройте видимость открытых задач транспортного средства

Интерфейс TaskTrackingInfo предоставляет ряд элементов данных задачи, которые можно сделать видимыми с помощью Consumer SDK.

Параметры видимости для каждой задачи

Вы можете настроить конфигурацию видимости для каждой задачи, установив параметр TaskTrackingViewConfig при создании или обновлении задачи в Fleet Engine. Используйте следующие параметры видимости для создания критериев определения видимости элемента задачи:

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

Следующий пример показывает эту конфигурацию:

"taskTrackingViewConfig": {
  "routePolylinePointsVisibility": {
    "remainingStopCountThreshold": 3
  },
  "estimatedArrivalTimeVisibility": {
    "remainingDrivingDistanceMetersThreshold": 5000
  },
  "remainingStopCountVisibility": {
    "never": true
  }
}

Полилинии маршрута и правила видимости местоположения транспортных средств

Полилинии маршрута не могут быть видны, если также не видно местоположение транспортного средства; в противном случае местоположение транспортного средства можно определить по концу полилинии.

Эти рекомендации помогут вам обеспечить допустимое сочетание полилинии маршрута и параметров видимости местоположения транспортного средства.

    "taskTrackingViewConfig": {
      "routePolylinePointsVisibility": {
        "remainingStopCountThreshold": 3
      },
      "vehicleLocationVisibility": {
        "remainingStopCountThreshold": 5
      },
    }
    

  "taskTrackingViewConfig": {
    "routePolylinePointsVisibility": {
      "remainingStopCountThreshold": 3
    },
    "vehicleLocationVisibility": {
      "remainingDrivingDistanceMetersThreshold": 3000
    },
  }

Отключить автоматическую подгонку

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

const mapView = new
    google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  automaticViewportMode:
      google.maps.journeySharing
          .AutomaticViewportMode.NONE,
  ...
});

const mapView = new
    google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  automaticViewportMode:
      google.maps.journeySharing
          .AutomaticViewportMode.NONE,
  ...
});

Что дальше?

• Настроить маркеры
• Настроить полилинии