Traffic - Get Traffic Incident

L'API Eventi imprevisti del traffico fornisce incidenti di traffico come costruzione, congestione del traffico e incidenti e così via all'interno di un rettangolo di selezione. Fornisce inoltre metadati del traffico per informazioni dettagliate su ogni evento imprevisto.

L'API fornisce una raccolta di funzionalità GeoJSON degli eventi imprevisti del traffico. Ogni evento imprevisto include due caratteristiche di punto: la posizione in cui si verifica l'evento imprevisto e la posizione finale di un evento imprevisto del traffico, ad esempio la fine di una zona di costruzione. Per la copertura degli incidenti stradali per paese/area geografica, vedere Copertura del traffico.

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}

Parametri dell'URI

Intestazione della richiesta

Risposte

Sicurezza

AADToken

Questi sono i flussi Microsoft Entra OAuth 2.0. Quando abbinata al controllo Azure basato su ruolo può essere utilizzata per controllare l'accesso alle API REST di Azure Maps. I controlli di accesso basati su ruoli di Azure sono utilizzati per designare l'accesso a uno o più account o sottorisorse risorse di Azure Maps. Qualsiasi utente, gruppo o principale di servizio può ricevere l'accesso tramite un ruolo integrato o un ruolo personalizzato composto da uno o più permessi alle API REST di Azure Maps.

Per implementare scenari, è consigliabile visualizzare concetti di autenticazione. In sintesi, questa definizione di sicurezza offre una soluzione per la modellazione di applicazioni tramite oggetti in grado di controllare l'accesso su API e ambiti specifici.

Note

• Questa definizione di sicurezza richiede l'uso dell'intestazione x-ms-client-id per indicare a quale Azure Maps risorsa l'applicazione richiede accesso. Questa operazione può essere acquisita dall'API di gestione Maps.

Il Authorization URL è specifico per l'istanza Azure cloud pubblico. I cloud sovrani hanno URL di autorizzazione unici e configurazioni Microsoft Entra ID. * Il controllo accessi basato sul ruolo Azure è configurato dal piano di gestione Azure tramite Azure portale, PowerShell, CLI, Azure SDKs o API REST. * L'uso del Web SDK Azure Maps consente la configurazione di un'applicazione per più casi d'uso.

• Per altre informazioni su Microsoft Identity Platform, vedere panoramica di Microsoft Identity Platform.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

subscription-key

Questa è una chiave condivisa che viene fornita quando Crea un account Azure Maps nel portale Azure o usando PowerShell, CLI, Azure SDKs o API REST.

Con questa chiave, qualsiasi applicazione può accedere a tutte le API REST. In altre parole, questa chiave può essere usata come chiave master nell'account in cui vengono rilasciati.

Per le applicazioni pubblicamente esposte, la nostra raccomandazione è di utilizzare l'approccio confidenziali per accedere alle API REST Azure Maps così che la tua chiave possa essere memorizzata in modo sicuro.

Tipo: apiKey
In: query

SAS Token

Questo è un token di firma di accesso condiviso creato dall'operazione List SAS sulla risorsa Azure Maps tramite il piano di gestione Azure tramite Azure portale, PowerShell, CLI, Azure SDKs o API REST.

Con questo token, qualsiasi applicazione è autorizzata ad accedere tramite Azure ai controlli di accesso basati su ruoli e a un controllo fine della scadenza, del tasso e delle regioni di utilizzo per il particolare token. In altre parole, il token di firma di accesso condiviso può essere usato per consentire alle applicazioni di controllare l'accesso in modo più protetto rispetto alla chiave condivisa.

Per le applicazioni esposte pubblicamente, è consigliabile configurare un elenco specifico di origini consentite nella risorsa account mappa per limitare l'abuso di rendering e rinnovare regolarmente il token di firma di accesso condiviso.

Tipo: apiKey
In: header

Esempio

Request information about a traffic incident

GET https://atlas.microsoft.com/traffic/incident?api-version=2025-01-01&bbox=-122.22,47.44,-122.19,47.61

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "id": 125193835200120000,
      "geometry": {
        "type": "Point",
        "coordinates": [
          -122.20148,
          47.609058
        ]
      },
      "properties": {
        "incidentType": "Congestion",
        "startTime": "2025-05-01T18:47:00.0000000Z",
        "endTime": "2025-05-01T20:50:41.3340000Z",
        "lastModifiedTime": "2025-05-01T18:50:41.3340000Z",
        "description": "Stationary traffic on Bellevue Way SE from SE 3rd St to Bellevue Way NE / Main St.",
        "severity": 1,
        "isRoadClosed": false,
        "title": "Bellevue Way SE",
        "isTrafficJam": true,
        "delay": 125,
        "endPoint": {
          "type": "Point",
          "coordinates": [
            -122.202707,
            47.610156
          ]
        }
      }
    },
    {
      "type": "Feature",
      "id": 125453508966320000,
      "geometry": {
        "type": "Point",
        "coordinates": [
          -122.195563,
          47.499877
        ]
      },
      "properties": {
        "incidentType": "Congestion",
        "startTime": "2025-05-01T18:47:00.0000000Z",
        "endTime": "2025-05-01T19:19:00.0000000Z",
        "lastModifiedTime": "2025-05-01T18:50:41.3340000Z",
        "description": "Slow traffic on I-405 N from Sunset Blvd NE exit [5] to exit [7].",
        "severity": 1,
        "isRoadClosed": false,
        "title": "I-405 N",
        "isTrafficJam": true,
        "delay": 141,
        "endPoint": {
          "type": "Point",
          "coordinates": [
            -122.196893,
            47.531893
          ]
        }
      }
    }
  ]
}

Definizioni

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

ErrorDetail

Dettagli dell'errore.

ErrorResponse

Risposta di errore

FeaturesItemTypeEnum

Specifica il tipo di GeoJSON. L'unico tipo di oggetto supportato è Feature. Per altre informazioni, vedere RFC 7946.

FeatureTypeEnum

Specifica il tipo di GeoJSON. L'unico tipo di oggetto supportato è FeatureCollection. Per altre informazioni, vedere RFC 7946.

GeoJsonPoint

Tipo geometry GeoJSON Point valido. Per informazioni dettagliate, vedere RFC 7946.

IncidentType

Specifica il tipo di evento imprevisto del traffico. Può essere usato per richiedere e distinguere tra vari tipi di eventi imprevisti.

TrafficIncidentFeatureProperties

Specifica informazioni dettagliate sugli eventi imprevisti del traffico.

TrafficIncidentFeaturesItem

Specifica l'oggetto funzionalità GeoJSON dell'evento imprevisto del traffico, inclusa la geometria e le proprietà aggiuntive.

TrafficIncidentResponse

Oggetto raccolta di funzionalità GeoJSON che contiene un elenco di funzionalità degli eventi imprevisti del traffico.