Traffic - Get Traffic Incident

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

API предоставляет коллекцию функций GeoJSON для инцидентов дорожного движения. Каждый инцидент включает в себя две точки: расположение, в котором возникает инцидент, и конечное расположение дорожного происшествия, например конец строительной зоны. Сведения о охвате инцидентами дорожного движения по странам или регионам см. в .

GET https://atlas.microsoft.com/traffic/incident?api-version=2025-01-01&bbox={bbox}

GET https://atlas.microsoft.com/traffic/incident?api-version=2025-01-01&incidentType={incidentType}&bbox={bbox}

Параметры URI

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

Ответы

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

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

Области

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

GET https://atlas.microsoft.com/traffic/incident?api-version=2025-01-01&bbox=-104,37,-103,38

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "id": 18558549332008001,
      "geometry": {
        "type": "Point",
        "coordinates": [
          -103.5918059115,
          38.0005878581
        ]
      },
      "properties": {
        "startTime": "2025-09-12T09:31:37Z",
        "endTime": "2025-09-12T10:21:47Z",
        "description": "Accident W US Highway 50.",
        "title": "W US Highway 50",
        "incidentType": "Accident",
        "severity": 4,
        "delay": null,
        "lastModifiedTime": "2025-09-12T10:21:47Z",
        "endPoint": {
          "type": "Point",
          "coordinates": [
            -103.5918059115,
            38.0005878581
          ]
        },
        "isTrafficJam": false,
        "isRoadClosed": false
      }
    },
    {
      "type": "Feature",
      "id": 21366103288104000,
      "geometry": {
        "type": "Point",
        "coordinates": [
          -103.591850168,
          37.9995820453
        ]
      },
      "properties": {
        "startTime": "2025-09-12T09:42:32Z",
        "endTime": "2025-09-12T10:21:47Z",
        "description": "Accident Rogers Rd",
        "title": "Rogers Rd",
        "incidentType": "Accident",
        "severity": 4,
        "delay": 10,
        "lastModifiedTime": "2025-09-12T10:21:47Z",
        "endPoint": {
          "type": "Point",
          "coordinates": [
            -103.5918059115,
            38.0005878581
          ]
        },
        "isTrafficJam": true,
        "isRoadClosed": false
      }
    }
  ]
}

Определения

ErrorAdditionalInfo

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

ErrorDetail

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

ErrorResponse

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

FeaturesItemTypeEnum

Указывает тип GeoJSON. Единственным поддерживаемым типом объекта является Feature. Дополнительные сведения см. в RFC 7946.

FeatureTypeEnum

Указывает тип GeoJSON. Единственным поддерживаемым типом объекта является FeatureCollection. Дополнительные сведения см. в RFC 7946.

GeoJsonPoint

Допустимый тип геометрии GeoJSON Point. Дополнительные сведения см. в RFC 7946.

IncidentType

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

TrafficIncidentFeatureProperties

Указывает подробные сведения об инцидентах дорожного движения.

TrafficIncidentFeaturesItem

Указывает объект компонента GeoJSON дорожного движения, включая геометрию и дополнительные свойства.

TrafficIncidentResponse

Объект коллекции функций GeoJSON, содержащий список функций дорожного движения.