Запрос информации о трафике на ломаной линии

API Routes Preferred предоставляет возможность запрашивать информацию о дорожной обстановке вдоль полилинии. Дорожная обстановка выражается в категориях скорости (NORMAL, SLOW, TRAFFIC_JAM), применимых к заданному интервалу полилинии ответа. Интервалы определяются индексами их начальной (включительно) и конечной (исключительно) точек полилинии.

Пример запроса

Функция полилинии с учетом дорожной ситуации доступна как на уровне маршрута, так и на уровне отдельных участков. На уровне маршрута информация о скорости движения предоставляется в виде параметра SpeedReadingIntervals в поле ответа RouteTravelAdvisory . Чтобы получать информацию о дорожной ситуации вместе с полилинией маршрута, необходимо включить в маску поля ответа как polyline , так и speedReadingIntervals .

Если в поле mask указано routes.legs.travelAdvisory.speedReadingIntervals , то ответ будет содержать данные о трафике на уровне участков маршрута в поле RouteLegTravelAdvisory .

X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline,routes.travelAdvisory.speedReadingIntervals,routes.legs.polyline.encodedPolyline,routes.legs.travelAdvisory.speedReadingIntervals

Для получения дополнительной информации о задании маски поля ответа посетите раздел «Выбор полей для возврата» .

Пример ответа

Если speedReadingIntervals запрашиваются через маску поля, они заполняются в routes.travelAdvisory.speedReadingIntervals . Информация о трафике на уровне сегментов доступна в routes.legs.travelAdvisory.speedReadingIntervals . Каждый интервал описывается его startPolylinePointIndex , endPolylinePointIndex и соответствующей категорией скорости. Обратите внимание, что отсутствие начального индекса в интервале соответствует индексу 0 в соответствии с практиками proto3 .

{
  "routes": [
    {
      "legs": {
        "polyline": {
          "encodedPolyline": "}boeF~zbjVAg@EmB`GWHlD"
        },
        "travelAdvisory": {
          "speedReadingIntervals": [
            {
              "endPolylinePointIndex": 1,
              "speed": "NORMAL"
            },
            {
              "startPolylinePointIndex": 1,
              "endPolylinePointIndex": 2,
              "speed": "SLOW"
            },
            {
              "startPolylinePointIndex": 2,
              "endPolylinePointIndex": 4,
              "speed": "NORMAL"
            }
          ] 
        }
      },
      "polyline": {
        "encodedPolyline": "}boeF~zbjVAg@EmB`GWHlD"
      },
      "travelAdvisory": {
        "speedReadingIntervals": [
          {
            "endPolylinePointIndex": 1,
            "speed": "NORMAL"
          },
          {
            "startPolylinePointIndex": 1,
            "endPolylinePointIndex": 2,
            "speed": "SLOW"
          },
          {
            "startPolylinePointIndex": 2,
            "endPolylinePointIndex": 4,
            "speed": "NORMAL"
          }
        ] 
      }
    }
  ]
}

Отображение полилиний с учетом дорожной ситуации с помощью Maps SDK

Мы рекомендуем отображать на карте полилинии с учетом дорожной ситуации, используя различные функции, предлагаемые SDK Google Maps, включая пользовательскую раскраску, обводку и узоры вдоль участков полилиний. Более подробную информацию об использовании полилиний см. в разделах «Функции полилиний для Android» и «Функции полилиний для iOS» .

Пример визуализации полилинии

Пользователи Maps SDK имеют возможность определять собственную логику сопоставления между категориями скорости и схемами отрисовки полилиний. Например, можно отобразить «НОРМАЛЬНУЮ» скорость толстой синей линией на карте, а «МЕДЛЕННУЮ» — толстой оранжевой линией и так далее.

Следующие фрагменты кода добавляют толстую синюю ломаную линию с геодезическими сегментами от Мельбурна до Перта. Для получения дополнительной информации см. раздел «Настройка внешнего вида» (для Android) и «Настройка ломаной линии» (для iOS).

Android

Java

Polyline line = map.addPolyline(new PolylineOptions()
    .add(new LatLng(-37.81319, 144.96298), new LatLng(-31.95285, 115.85734))
    .width(25)
    .color(Color.BLUE)
    .geodesic(true));

Котлин

val line: Polyline = map.addPolyline(
  PolylineOptions()
    .add(LatLng(-37.81319, 144.96298), LatLng(-31.95285, 115.85734))
    .width(25f)
    .color(Color.BLUE)
    .geodesic(true)
)

iOS

Objective-C

GMSMutablePath *path = [GMSMutablePath path];
[path addLatitude:-37.81319 longitude:144.96298];
[path addLatitude:-31.95285 longitude:115.85734];
GMSPolyline *polyline = [GMSPolyline polylineWithPath:path];
polyline.strokeWidth = 10.f;
polyline.strokeColor = .blue;
polyline.geodesic = YES;
polyline.map = mapView;

Быстрый

let path = GMSMutablePath()
path.addLatitude(-37.81319, longitude: 144.96298)
path.addLatitude(-31.95285, longitude: 115.85734)
let polyline = GMSPolyline(path: path)
polyline.strokeWidth = 10.0
polyline.geodesic = true
polyline.map = mapView