Traffic - Get Traffic Incident Detail

Ссылка

Служба:: Maps

Версия API:: 1.0

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

API Traffic Incident Detail — это http-запрос GET, который предоставляет сведения об инцидентах трафика в заданном ограничивающем поле на основе текущего идентификатора модели трафика . Идентификатор модели трафика доступен для предоставления синхронизации данных между вызовами и API. Идентификатор модели трафика — это ключевое значение для определения валюты инцидентов дорожного движения. Он обновляется каждую минуту и действителен в течение двух минут до истечения времени ожидания. Он используется при отрисовке плитки инцидентов. Его можно получить из API viewport.

GET https://atlas.microsoft.com/traffic/incident/detail/{format}?api-version=1.0&style={style}&boundingbox={boundingbox}&boundingZoom={boundingZoom}&trafficmodelid={trafficmodelid}

С использованием необязательных параметров:

GET https://atlas.microsoft.com/traffic/incident/detail/{format}?api-version=1.0&style={style}&boundingbox={boundingbox}&boundingZoom={boundingZoom}&trafficmodelid={trafficmodelid}&language={language}&projection={projection}&geometries={geometries}&expandCluster={expandCluster}&originalPosition={originalPosition}

Параметры URI

Имя	В	Обязательно	Тип	Описание
format	path	True	ResponseFormat	Требуемый формат ответа. Значение может быть либо json, либо xml.
api-version	query	True	string	Номер версии API Azure Maps.
boundingbox	query	True	number[]	`boundingbox` представлена двумя парами значений, описывающими его угла (первая пара для нижнего левого угла и второй для верхнего правого). Пары можно указать с помощью любой из указанных ниже пар `projection`(например, minY,minX,maxY,maxX,maxX) или двумя парами широты и долготы (например, minLat,minLon,maxLat,maxLon). ПРИМЕЧАНИЕ. Если используются пары широты и долготы, параметр `projection` должен иметь значение "EPSG4326".
boundingZoom	query	True	integer (int32) minimum: 0 maximum: 22	Уровень масштабирования для требуемой плитки. От 0 до 22 для растровых плиток, от 0 до 22 для векторных плиток
style	query	True	IncidentDetailStyle	Стиль, который будет использоваться для отрисовки плитки в плитке "Трафик инцидентов" API. Это повлияет на координаты дорожно-транспортных инцидентов в ответе.
trafficmodelid	query	True	string	Число, ссылающееся на модель трафика. Это можно получить из API viewport. Он обновляется каждую минуту и действителен в течение двух минут до истечения времени ожидания. Если указан неправильный идентификатор модели трафика, правильный будет возвращен интерфейсом. Значение -1 всегда вызывает самую последнюю модель трафика.
expandCluster	query		boolean	Логическое значение, указывающее, следует ли перечислять все инциденты дорожного движения в кластере отдельно
geometries	query		IncidentGeometryType	Тип векторной геометрии, добавленной в инциденты (возвращенный в элементе ответа).
language	query		string	код ISO 639-1 для языка вывода. Поддерживаемые языки : ar, ca, cs, da, de, el, en, en-GB, en-US, es, es, fi, fr, he, hu, id, id, in*, it, lt, lv, nb, nl, no, pl, pt, ro, ru, sk, sv, th, tr, zh. Дополнительные сведения см. в поддерживаемых языках. Если недопустимый языковой код предоставляется, ответ возвращается на английском языке. Если причина инцидента или описание не имеют перевода, возвращается описание английского языка.
originalPosition	query		boolean	Boolean о том, следует ли вернуть исходную позицию инцидента (), а также один сместился в начало дорожной трубы ()
projection	query		ProjectionStandard	Проекция, используемая для указания координат в запросе и ответе. EPSG900913 (по умолчанию) или EPSG4326

Заголовок запроса

Имя	Обязательно	Тип	Описание
x-ms-client-id		string	Указывает, какая учетная запись предназначена для использования в сочетании с моделью безопасности идентификатора Microsoft Entra. Он представляет уникальный идентификатор учетной записи Azure Maps и может быть получен из API учетной записи уровня управления Azure Maps. Сведения о том, как использовать безопасность идентификатора Microsoft Entra в Azure Maps, см. в следующих статьях .

Ответы

Имя	Тип	Описание
200 OK	TrafficIncidentDetail	ХОРОШО
Other Status Codes	ErrorResponse	Произошла непредвиденная ошибка.

Безопасность

AADToken

Это потоки Microsoft Entra OAuth 2.0. При паре с доступом на основе ролей Azure его можно использовать для управления доступом к REST API Azure Maps. Управление доступом на основе ролей Azure используется для назначения доступа к одной или нескольким учетным записям ресурсов Azure Maps или вложенным ресурсам. Доступ к любому пользователю, группе или субъекту-службе можно предоставить через встроенную роль или пользовательскую роль, состоящую из одного или нескольких разрешений для REST API Azure Maps.

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

Примечания.

Для этого определения безопасности требуется использовать заголовок x-ms-client-id, чтобы указать, к какой ресурсу Azure Maps приложение запрашивает доступ. Это можно получить из API управления карт.

Authorization URL зависит от экземпляра общедоступного облака Azure. В национальных облаках есть уникальные URL-адреса авторизации и конфигурации идентификатора Microsoft Entra. * Управление доступом на основе ролей Azure настраивается с плоскости управления Azure с помощью портала Azure, PowerShell, CLI, пакетов SDK Azure или REST API. * Использование веб-пакета SDK Azure Maps позволяет настроить приложение на основе конфигурации для нескольких вариантов использования.

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

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
https://atlas.microsoft.com/.default	https://atlas.microsoft.com/.default

subscription-key

Это общий ключ, подготовленный при создания учетной записи Azure Maps на портале Azure или с помощью PowerShell, CLI, пакетов SDK Azure или REST API.

С помощью этого ключа любой приложение может получить доступ ко всем REST API. Другими словами, этот ключ можно использовать в качестве главного ключа в учетной записи, в которую они выданы.

Для общедоступных приложений мы рекомендуем использовать конфиденциальные клиентские приложения, подход для доступа к REST API Azure Maps, чтобы ваш ключ можно было безопасно хранить.

Тип: apiKey
В: query

SAS Token

Это маркер подписанного URL-адреса создается из операции SAS списка на ресурсе Azure Maps через плоскость управления Azure с помощью портала Azure, PowerShell, CLI, пакетов SDK Azure или REST API.

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

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

Тип: apiKey
В: header

Примеры

Request information about a traffic incident

Образец запроса

HTTP

GET https://atlas.microsoft.com/traffic/incident/detail/json?api-version=1.0&style=s3&boundingbox=6841263.950712,511972.674418,6886056.049288,582676.925582&boundingZoom=11&trafficmodelid=1335294634919

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

Код состояния:: 200

{
  "tm": {
    "@id": "1521671948910",
    "poi": [
      {
        "id": "europe_HD_NL_TTR116377227776064",
        "p": {
          "x": 538636.9,
          "y": 6842004.5
        },
        "ic": 9,
        "ty": 1,
        "cs": 0,
        "d": "roadworks",
        "c": "new roadworks layout",
        "f": "Amstelveen/Vinkeveen - N201 (N196)",
        "t": "Uithoorn-Centrum (N196)",
        "l": 220,
        "dl": 14,
        "r": "N196"
      },
      {
        "id": "europe_CLUSTER_11_-34959639",
        "p": {
          "x": 528668.6,
          "y": 6848897.9
        },
        "ic": 8,
        "ty": 0,
        "cbl": {
          "x": 528622.5,
          "y": 6848661.2
        },
        "ctr": {
          "x": 528714.7,
          "y": 6849134.6
        },
        "cs": 2,
        "l": 190
      },
      {
        "id": "europe_CLUSTER_11_-1540737434",
        "p": {
          "x": 518277,
          "y": 6852206.8
        },
        "ic": 9,
        "ty": 1,
        "cbl": {
          "x": 517421.3,
          "y": 6851776.4
        },
        "ctr": {
          "x": 519132.8,
          "y": 6852637.2
        },
        "cs": 2,
        "l": 1620
      },
      {
        "id": "europe_CLUSTER_11_-26712906",
        "p": {
          "x": 529902.2,
          "y": 6855622.4
        },
        "ic": 8,
        "ty": 0,
        "cbl": {
          "x": 529524.6,
          "y": 6855377.2
        },
        "ctr": {
          "x": 530279.9,
          "y": 6855867.7
        },
        "cs": 4,
        "l": 660
      },
      {
        "id": "europe_HD_NL_TTR116367997504816",
        "p": {
          "x": 568216,
          "y": 6851287.6
        },
        "ic": 9,
        "ty": 1,
        "cs": 0,
        "d": "roadworks",
        "c": "new roadworks layout",
        "f": "Ankeveen (N236)",
        "t": "Weesp (N236)",
        "l": 2760,
        "dl": 73,
        "r": "N236"
      },
      {
        "id": "europe_HD_NL_TTR116367997261488",
        "p": {
          "x": 561973.7,
          "y": 6854259.4
        },
        "ic": 9,
        "ty": 3,
        "cs": 0,
        "d": "roadworks",
        "c": "new roadworks layout",
        "f": "Weesp (N236)",
        "t": "Ankeveen (N236)",
        "l": 2650,
        "r": "N236"
      },
      {
        "id": "europe_HD_NL_TTR116331064819392",
        "p": {
          "x": 571268.5,
          "y": 6858435.4
        },
        "ic": 8,
        "ty": 4,
        "cs": 0,
        "d": "closed",
        "f": "IJsselmeerweg",
        "t": "A6",
        "l": 370
      },
      {
        "id": "europe_CLUSTER_11_-1442937814",
        "p": {
          "x": 563934,
          "y": 6859271.3
        },
        "ic": 9,
        "ty": 1,
        "cbl": {
          "x": 563726.1,
          "y": 6859250.4
        },
        "ctr": {
          "x": 564141.9,
          "y": 6859292.2
        },
        "cs": 2,
        "l": 460
      },
      {
        "id": "europe_CLUSTER_11_258400781",
        "p": {
          "x": 558055.6,
          "y": 6861147.1
        },
        "ic": 13,
        "ty": 1,
        "cbl": {
          "x": 557493.3,
          "y": 6860514.8
        },
        "ctr": {
          "x": 558618,
          "y": 6861779.4
        },
        "cs": 3,
        "l": 1030
      },
      {
        "id": "europe_HD_NL_TTR116100227865681",
        "p": {
          "x": 542665,
          "y": 6861959.7
        },
        "ic": 8,
        "ty": 4,
        "cs": 0,
        "d": "closed",
        "f": "Strawinskylaan",
        "t": "Matthijs Vermeulenpad",
        "l": 110
      },
      {
        "id": "europe_CLUSTER_11_1438243625",
        "p": {
          "x": 545058.7,
          "y": 6864571.6
        },
        "ic": 8,
        "ty": 0,
        "cbl": {
          "x": 543779.5,
          "y": 6864070.7
        },
        "ctr": {
          "x": 546337.8,
          "y": 6865072.6
        },
        "cs": 5,
        "l": 1590
      },
      {
        "id": "europe_HD_NL_TTR116081762316976",
        "p": {
          "x": 547507.8,
          "y": 6866259.3
        },
        "ic": 8,
        "ty": 4,
        "cs": 0,
        "d": "closed",
        "f": "Alexanderplein (s113)",
        "t": "Stadhouderskade",
        "l": 390,
        "r": "S100"
      },
      {
        "id": "europe_CLUSTER_11_691732516",
        "p": {
          "x": 541448.7,
          "y": 6867162.1
        },
        "ic": 8,
        "ty": 0,
        "cbl": {
          "x": 541160.1,
          "y": 6866710.7
        },
        "ctr": {
          "x": 541737.2,
          "y": 6867613.5
        },
        "cs": 4,
        "l": 430
      },
      {
        "id": "europe_CLUSTER_11_1582351486",
        "p": {
          "x": 534709.6,
          "y": 6865174.7
        },
        "ic": 8,
        "ty": 0,
        "cbl": {
          "x": 534562.2,
          "y": 6865025.3
        },
        "ctr": {
          "x": 534856.9,
          "y": 6865324.2
        },
        "cs": 2,
        "l": 380
      },
      {
        "id": "europe_CLUSTER_11_-2070222267",
        "p": {
          "x": 536813.1,
          "y": 6868188.3
        },
        "ic": 8,
        "ty": 0,
        "cbl": {
          "x": 536191.1,
          "y": 6867699.7
        },
        "ctr": {
          "x": 537435.1,
          "y": 6868677
        },
        "cs": 7,
        "l": 1380
      },
      {
        "id": "europe_CLUSTER_11_-496866890",
        "p": {
          "x": 516025.5,
          "y": 6871606.3
        },
        "ic": 8,
        "ty": 0,
        "cbl": {
          "x": 514115.1,
          "y": 6870216.9
        },
        "ctr": {
          "x": 517935.9,
          "y": 6872995.7
        },
        "cs": 7,
        "l": 1510
      },
      {
        "id": "europe_HD_NL_TTR115675492352160",
        "p": {
          "x": 517835.3,
          "y": 6883216.3
        },
        "ic": 8,
        "ty": 4,
        "cs": 0,
        "d": "closed",
        "f": "Amsterdamseweg",
        "t": "A22",
        "l": 710
      },
      {
        "id": "europe_CLUSTER_11_834920993",
        "p": {
          "x": 543803.8,
          "y": 6875659.8
        },
        "ic": 8,
        "ty": 0,
        "cbl": {
          "x": 543474.7,
          "y": 6875602.7
        },
        "ctr": {
          "x": 544133,
          "y": 6875716.9
        },
        "cs": 2,
        "l": 760
      }
    ]
  }
}

Определения

Имя	Описание
DelayMagnitude	Величина задержки, связанная с инцидентом. Эти значения соответствуют цветам инцидентов в плитках трафика
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Сведения об ошибке.
ErrorResponse	Ответ на ошибку
IconCategory	Категория значков, связанная с этим инцидентом. Значения являются числами в диапазоне 0-13, со следующими значениями: -- 0: Неизвестно, 1: Авария, 2: Туман, 3: Опасные условия, 4: Дождь, 5: Лед, 6: Джам, 7: Лейн Закрытый, 8: Дорога закрыта, 9: Дорожные работы, 10: Ветер, 11: Наводнение, 12: Detour, 13: Кластер
IncidentDetailStyle	Стиль, который будет использоваться для отрисовки плитки в плитке "Трафик инцидентов" API. Это повлияет на координаты дорожно-транспортных инцидентов в ответе.
IncidentGeometryType	Тип векторной геометрии, добавленной в инциденты (возвращенный в элементе ответа).
Point	Универсальное представление точки с координатами (x, y) в декартовой плоскости.
ProjectionStandard	Проекция, используемая для указания координат в запросе и ответе. EPSG900913 (по умолчанию) или EPSG4326
ResponseFormat	Требуемый формат ответа. Значение может быть либо json, либо xml.
Tm	Основной элемент ответа
TrafficIncidentDetail	Этот объект возвращается из успешного вызова сведений об инциденте трафика
TrafficIncidentPointOfInterest

DelayMagnitude

Перечисление

Величина задержки, связанная с инцидентом. Эти значения соответствуют цветам инцидентов в плитках трафика

Значение	Описание
0	Неизвестно
1	Несовершеннолетний
2	Умеренный
3	Майор
4	Неопределенный (используется для закрытия дорог и других неопределенных задержек)

ErrorAdditionalInfo

Object

Дополнительные сведения об ошибке управления ресурсами.

Имя	Тип	Описание
info	object	Дополнительные сведения.
type	string	Дополнительный тип сведений.

ErrorDetail

Object

Сведения об ошибке.

Имя	Тип	Описание
additionalInfo	ErrorAdditionalInfo[]	Дополнительные сведения об ошибке.
code	string	Код ошибки.
details	ErrorDetail[]	Сведения об ошибке.
message	string	Сообщение об ошибке.
target	string	Целевой объект ошибки.

ErrorResponse

Object

Ответ на ошибку

Имя	Тип	Описание
error	ErrorDetail	Объект ошибки.

IconCategory

Перечисление

Категория значков, связанная с этим инцидентом. Значения являются числами в диапазоне 0-13, со следующими значениями: -- 0: Неизвестно, 1: Авария, 2: Туман, 3: Опасные условия, 4: Дождь, 5: Лед, 6: Джам, 7: Лейн Закрытый, 8: Дорога закрыта, 9: Дорожные работы, 10: Ветер, 11: Наводнение, 12: Detour, 13: Кластер

Значение	Описание
0	Неизвестно
1	Accident
10	Ветровая
11	Затопление
12	Объезд
13	Кластер: возвращается, если кластер содержит инциденты с разными категориями значков.
14	Разбитый автомобиль
2	Туман
3	Опасные условия
4	Дождь
5	Ice
6	Джем
7	Полоса закрыта
8	Дорога закрыта
9	Дорожные работы

IncidentDetailStyle

Перечисление

Стиль, который будет использоваться для отрисовки плитки в плитке "Трафик инцидентов" API. Это повлияет на координаты дорожно-транспортных инцидентов в ответе.

Значение	Описание
night	Ночной стиль.
s1	Создает линии трафика с цветными шевронами, указывающими на серьезность.
s2	Создает обычные линии с определенной степенью свечения.
s3	Создает обычные линии с определенной степенью свечения, отличающейся от стиля s2.

IncidentGeometryType

Перечисление

Тип векторной геометрии, добавленной в инциденты (возвращенный в элементе ответа).

Значение	Описание
original	Место происшествий точно на дороге.
shifted	Немного перемещает инцидент (в зависимости от уровня масштабирования), чтобы указать определенные дорожные полосы.

Point

Object

Универсальное представление точки с координатами (x, y) в декартовой плоскости.

Имя	Тип	Описание
x	number	Координата x
y	number	Координата y

ProjectionStandard

Перечисление

Проекция, используемая для указания координат в запросе и ответе. EPSG900913 (по умолчанию) или EPSG4326

Значение	Описание
EPSG4326	EPSG4326
EPSG900913	EPSG900913

ResponseFormat

Перечисление

Требуемый формат ответа. Значение может быть либо json, либо xml.

Значение	Описание
json	формат обмена данными для объектов JavaScript
xml	расширяемый язык разметки

Tm

Object

Основной элемент ответа

Имя	Тип	Описание
@id	string	Идентификатор модели трафика для этого инцидента
poi	TrafficIncidentPointOfInterest[]	Один инцидент дорожного движения или кластер инцидентов дорожного движения

TrafficIncidentDetail

Object

Этот объект возвращается из успешного вызова сведений об инциденте трафика

Имя	Тип	Описание
tm	Tm	Основной элемент ответа

TrafficIncidentPointOfInterest

Object

Имя	Тип	Описание
c	string	Причина инцидента, в котором доступно, на языке, запрошенном
cbl	Point	Нижняя левая координата кластера в проекции запроса
cs	integer (int32)	Размер кластера: количество инцидентов в кластере
ctr	Point	Верхняя правая координата кластера в проекции запроса
d	string	Описание инцидента на языке, запрошенном
dl	integer (int32)	Задержка, вызванная инцидентом в секундах (за исключением закрытия дорог)
ed	string (date-time)	Предполагаемая дата окончания инцидента, если она доступна. Дата описана в формате ISO8601.
f	string	От: имя пересечения или расположения, в котором начинается трафик из-за инцидента
ic	IconCategory (int32)	Категория значков, связанная с этим инцидентом. Значения являются числами в диапазоне 0-13, со следующими значениями: -- 0: Неизвестно, 1: Авария, 2: Туман, 3: Опасные условия, 4: Дождь, 5: Лед, 6: Джам, 7: Лейн Закрытый, 8: Дорога закрыта, 9: Дорожные работы, 10: Ветер, 11: Наводнение, 12: Detour, 13: Кластер
id	string	Идентификатор инцидента дорожного движения
l	integer (int32)	Длина инцидента в метрах
p	Point	Точка, в которой должен быть нарисован значок кластера или необработанного инцидента, выраженный в запрошенной проекции. Это влияет на стиль движения, уровень масштабирования и тип дороги
r	string	Номера дорог, затронутые инцидентом. Несколько номеров дорог будут разделены косыми чертами
sd	string (date-time)	Дата начала инцидента, если она доступна. Дата описана в формате ISO8601.
t	string	To: имя пересечения или расположения, где трафик из-за инцидента заканчивается
ty	DelayMagnitude (int32)	Величина задержки, связанная с инцидентом. Эти значения соответствуют цветам инцидентов в плитках трафика

Поделиться через

Traffic - Get Traffic Incident Detail

Параметры URI

Заголовок запроса

Ответы

Безопасность

AADToken

Примечания.

Области

subscription-key

SAS Token

Примеры

Request information about a traffic incident

Образец запроса

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

Определения

DelayMagnitude

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

IconCategory

IncidentDetailStyle

IncidentGeometryType

Point

ProjectionStandard

ResponseFormat

Tm

TrafficIncidentDetail

TrafficIncidentPointOfInterest

Дополнительные ресурсы