Traffic - Get Traffic Incident

Referencia

Szolgáltatás:: Maps

API-verzió:: 2025-01-01

A Traffic Incident API olyan közlekedési incidenseket biztosít, mint az építkezés, a forgalmi torlódások és a balesetek stb. a határolókereten belül. Emellett forgalmi metaadatokat is biztosít az egyes incidensekre vonatkozó részletes információkhoz.

Az API a forgalmi incidensek GeoJSON-funkciógyűjteményét biztosítja. Minden incidens két ponttal rendelkezik: az incidens helyszíne és egy közlekedési incidens végpontja, például egy építési zóna vége. A forgalmi incidensek ország/régió szerinti lefedettségét lásd forgalomlefedettségi.

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

Opcionális paraméterekkel:

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
api-version	query	True	string	Az Azure Maps API verziószáma.
bbox	query	True	number[]	Egy téglalap alakú terület a Föld érdekes területéhez. A téglalapok oldalait hosszúsági és szélességi értékek határozzák meg. Meg kell felelnie a GeoJSON formátumnak [minLon, minLat, maxLon, maxLat]. További információ: RFC 7946, 5. szakasz. A határolókeret magassága vagy szélessége legalább 12 m lehet, és nem haladhatja meg az 500 000 m-t. A maximális szélességi vagy magassági korlát 30 fok. (maxLon - minLon kell <= 30 és maxLat - minLat kell <= 30). Példa: bbox=-105,37,-94,45
incidentType	query		IncidentType	Megadja a visszaadandó forgalmi incidens típusát. Egyetlen kérésen belül több incidenstípus is támogatott. Ha nincs megadva, az eredmények az összes incidenstípust tartalmazzák a megadott határolókereten belül. Példa: '&incidentType=Accident" vagy "&incidentType=Accident,Construction".

Name

Kötelező

Típus

Description

api-version

query

True

string

Az Azure Maps API verziószáma.

bbox

query

True

number[]

Egy téglalap alakú terület a Föld érdekes területéhez. A téglalapok oldalait hosszúsági és szélességi értékek határozzák meg. Meg kell felelnie a GeoJSON formátumnak [minLon, minLat, maxLon, maxLat]. További információ: RFC 7946, 5. szakasz.

A határolókeret magassága vagy szélessége legalább 12 m lehet, és nem haladhatja meg az 500 000 m-t. A maximális szélességi vagy magassági korlát 30 fok. (maxLon - minLon kell <= 30 és maxLat - minLat kell <= 30).

Példa: bbox=-105,37,-94,45

incidentType

query

IncidentType

Megadja a visszaadandó forgalmi incidens típusát. Egyetlen kérésen belül több incidenstípus is támogatott. Ha nincs megadva, az eredmények az összes incidenstípust tartalmazzák a megadott határolókereten belül.

Példa: '&incidentType=Accident" vagy "&incidentType=Accident,Construction".

Kérelem fejléce

Name	Kötelező	Típus	Description
x-ms-client-id		string	Megadja, hogy melyik fiók legyen az Azure AD biztonsági modellel együtt használva. Az Azure Maps-fiók egyedi azonosítóját jelöli, amely az Azure Maps felügyeleti sík fiók API-jából kérhető le. Az Azure AD-biztonság Azure Mapsben való használatához az alábbi cikkeket útmutatásért.
Accept-Language		string	Az a nyelv, amelyben a forgalmi incidensek eredményeit vissza kell adni. További információ: Támogatott nyelvek.

Name

Kötelező

Típus

Description

x-ms-client-id

string

Megadja, hogy melyik fiók legyen az Azure AD biztonsági modellel együtt használva. Az Azure Maps-fiók egyedi azonosítóját jelöli, amely az Azure Maps felügyeleti sík fiók API-jából kérhető le. Az Azure AD-biztonság Azure Mapsben való használatához az alábbi cikkeket útmutatásért.

Accept-Language

string

Az a nyelv, amelyben a forgalmi incidensek eredményeit vissza kell adni.

További információ: Támogatott nyelvek.

Válaszok

Name	Típus	Description
200 OK	TrafficIncidentResponse	OKÉ
Other Status Codes	ErrorResponse	Váratlan hiba történt.

Biztonság

AADToken

Ezek a Microsoft Entra OAuth 2.0 folyamatok . Ha Azure-beli szerepköralapú hozzáférés- vezérléssel párosítva szabályozható az Azure Maps REST API-khoz való hozzáférés. Az Azure szerepköralapú hozzáférés-vezérlői egy vagy több Azure Maps-erőforrásfiókhoz vagy alerőforrásokhoz való hozzáférés kijelölésére szolgálnak. Bármely felhasználó, csoport vagy szolgáltatásnév hozzáférést kaphat egy beépített szerepkörön vagy egy vagy több Azure Maps REST API-ra vonatkozó engedélyből álló egyéni szerepkörön keresztül.

Forgatókönyvek implementálásához javasoljuk, hogy tekintse meg hitelesítési fogalmakat. Összefoglalva, ez a biztonsági definíció megoldást kínál az alkalmazások modellezésére olyan objektumokon keresztül, amelyek hozzáférés-vezérlésre képesek adott API-kon és hatókörökön.

Jegyzetek

Ez a biztonsági definíciós megköveteli, hogy a x-ms-client-id fejléc használatával jelezze, hogy melyik Azure Maps-erőforráshoz kér hozzáférést az alkalmazás. Ez a Maps felügyeleti API-ból szerezhető be.

A Authorization URL az Azure nyilvános felhőpéldányára jellemző. A szuverén felhők egyedi engedélyezési URL-címekkel és Microsoft Entra-azonosító konfigurációkkal rendelkeznek. * Az Azure szerepköralapú hozzáférés-vezérlés a Azure felügyeleti síkjáról van konfigurálva, az Azure Portalon, a PowerShellen, a parancssori felületen, az Azure SDK-kon vagy REST API-kon keresztül. * Az Azure Maps Web SDK használata lehetővé teszi egy alkalmazás konfigurációalapú beállítását több használati esethez.

További információ a Microsoft identitásplatformról: Microsoft Identitásplatform áttekintése.

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name	Description
https://atlas.microsoft.com/.default	https://atlas.microsoft.com/.default

subscription-key

Ez egy megosztott kulcs, amely akkor lesz kiépítve, ha Azure Maps-fiók létrehozása az Azure Portalon, vagy PowerShell, CLI, Azure SDK vagy REST API használatával.

Ezzel a kulccsal bármely alkalmazás hozzáférhet az összes REST API-hoz. Más szóval ez a kulcs használható főkulcsként abban a fiókban, amelyben ki vannak adva.

A nyilvánosan közzétett alkalmazások esetében javasoljuk, hogy használja a bizalmas ügyfélalkalmazásokat, megközelítést az Azure Maps REST API-k eléréséhez, hogy a kulcs biztonságosan tárolható legyen.

Típus: apiKey
In: query

SAS Token

Ez egy közös hozzáférésű jogosultságkód-jogkivonat a listázási SAS műveletből jön létre a Azure Maps-erőforráson az Azure felügyeleti síkon keresztül az Azure Portalon, a PowerShellen, a parancssori felületen, az Azure SDK-kon vagy a REST API-kon keresztül.

Ezzel a jogkivonattal minden alkalmazás jogosult az Azure szerepköralapú hozzáférés-vezérlőivel való hozzáférésre, valamint az adott jogkivonat lejáratának, sebességének és régióinak részletes szabályozására. Más szóval az SAS-jogkivonat segítségével az alkalmazások biztonságosabban szabályozhatják a hozzáférést, mint a megosztott kulcs.

A nyilvánosan közzétett alkalmazások esetében javasoljuk, hogy konfigurálja a -fiók erőforrás- engedélyezett forrásainak listáját a renderelési visszaélések korlátozása és az SAS-jogkivonat rendszeres megújítása érdekében.

Típus: apiKey
In: header

Példák

Request information about a traffic incident

Mintakérelem

HTTP

GET https://atlas.microsoft.com/traffic/incident?api-version=2025-01-01&bbox=-105,37,-94,45

Mintaválasz

Állapotkód:: 200

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "id": 18558549332008001,
      "geometry": {
        "type": "Point",
        "coordinates": [
          -104.939053,
          39.682642
        ]
      },
      "properties": {
        "startTime": "2025-09-12T09:31:37Z",
        "endTime": "2025-09-12T10:21:47Z",
        "description": "At CO 2/Colorado Boulevard (Denver) at Mile Point 204. Two right lanes are closed due to a crash.",
        "title": "I-25 N / US-87 N",
        "incidentType": "Accident",
        "severity": 4,
        "delay": null,
        "lastModifiedTime": "2025-09-12T10:21:47Z",
        "endPoint": {
          "type": "Point",
          "coordinates": [
            -104.940412,
            39.68307
          ]
        },
        "isTrafficJam": false,
        "isRoadClosed": false
      }
    },
    {
      "type": "Feature",
      "id": 21366103288104000,
      "geometry": {
        "type": "Point",
        "coordinates": [
          -94.38411355,
          39.04460549
        ]
      },
      "properties": {
        "startTime": "2025-09-12T09:42:32Z",
        "endTime": "2025-09-12T10:21:47Z",
        "description": "Accident on I-70 E from S Lees Summit Rd/Exit 14 (I-70) to I-470/MO-291/Exit 15 (I-70).",
        "title": "I-70 E",
        "incidentType": "Accident",
        "severity": 4,
        "delay": 10,
        "lastModifiedTime": "2025-09-12T10:21:47Z",
        "endPoint": {
          "type": "Point",
          "coordinates": [
            -94.35559355,
            39.04075549
          ]
        },
        "isTrafficJam": true,
        "isRoadClosed": false
      }
    }
  ]
}

Definíciók

Name	Description
ErrorAdditionalInfo	Az erőforrás-kezelési hiba további információi.
ErrorDetail	A hiba részletei.
ErrorResponse	Hibaválasz
FeaturesItemTypeEnum	Megadja a `GeoJSON` típusát. Az egyetlen támogatott objektumtípus a Funkció. További információ: RFC 7946.
FeatureTypeEnum	Megadja a `GeoJSON` típusát. Az egyetlen támogatott objektumtípus a `FeatureCollection`. További információ: RFC 7946.
GeoJsonPoint	Érvényes `GeoJSON Point` geometriatípus. Részletekért tekintse meg RFC 7946.
IncidentType	Megadja a forgalmi incidens típusát. Ez különböző típusú incidensek kérésére és megkülönböztetésére használható.
TrafficIncidentFeatureProperties	A forgalmi incidensekkel kapcsolatos részletes információkat adja meg.
TrafficIncidentFeaturesItem	Megadja a forgalmi incidens GeoJSON-funkcióobjektumát, beleértve a geometriát és a további tulajdonságokat.
TrafficIncidentResponse	Egy GeoJSON-funkciógyűjteményi objektum, amely a forgalmi incidensek funkcióinak listáját tartalmazza.

ErrorAdditionalInfo

Objektum

Az erőforrás-kezelési hiba további információi.

Name	Típus	Description
info	object	A további információk.
type	string	A további információtípus.

ErrorDetail

Objektum

A hiba részletei.

Name	Típus	Description
additionalInfo	ErrorAdditionalInfo[]	A hiba további információi.
code	string	A hibakód.
details	ErrorDetail[]	A hiba részletei.
message	string	A hibaüzenet.
target	string	A hibacél.

ErrorResponse

Objektum

Hibaválasz

Name	Típus	Description
error	ErrorDetail	A hibaobjektum.

FeaturesItemTypeEnum

Enumerálás

Megadja a GeoJSON típusát. Az egyetlen támogatott objektumtípus a Funkció. További információ: RFC 7946.

Érték	Description
Feature	Megadja a `GeoJSON` funkcióobjektum típusát.

FeatureTypeEnum

Enumerálás

Megadja a GeoJSON típusát. Az egyetlen támogatott objektumtípus a FeatureCollection. További információ: RFC 7946.

Érték	Description
FeatureCollection	A `GeoJSONFeatureCollection` objektumtípust adja meg.

GeoJsonPoint

Objektum

Érvényes GeoJSON Point geometriatípus. Részletekért tekintse meg RFC 7946.

Name	Típus	Description
coordinates	number[] (double)	A `Position` két vagy több elemet tartalmazó számtömb. Az első két elem hosszúsági és szélességi, pontosan ebben a sorrendben. magassági/magassági nem kötelező harmadik elem. Részletekért tekintse meg RFC 7946.
type	string	Pontként adja meg a GeoJSON típust.

IncidentType

Enumerálás

Megadja a forgalmi incidens típusát. Ez különböző típusú incidensek kérésére és megkülönböztetésére használható.

Érték	Description
Accident	Baleset
Alert	Figyelmeztetés
Congestion	Torlódás
Construction	Építés
DisabledVehicle	DisabledVehicle
MassTransit	MassTransit
Miscellaneous	Egyéb
OtherNews	Egyébhírek
PlannedEvent	PlannedEvent
RoadHazard	RoadHazard
Weather	Időjárás

TrafficIncidentFeatureProperties

Objektum

A forgalmi incidensekkel kapcsolatos részletes információkat adja meg.

Name	Típus	Description
delay	number (double)	Az incidens által másodpercek alatt okozott késés. Ha nincs késés vagy nem alkalmazható, nulla értéket ad vissza.
description	string	Az incidens leírása, amely tartalmazza az út nevét és a forgalmat befolyásoló eseményt. Példák: • W 95th St között Switzer Rd és Bluejacket Dr - építési • WB Johnson Dr az I-435 - híd javítása
endPoint	object	Egy GeoJson-pont objektum, amely meghatározta egy közlekedési incidens, például egy építési zóna végét. Ez a hely az incidens tulajdonságai objektum része, és alapértelmezés szerint nem értelmezhető elemzők a térképen való megjelenítéshez.
endTime	string	A forgalmi incidens befejezésének dátuma és időpontja UTC-ben, dátum/idő értékként formázva RFC 3339, 5.6 szakasz.
incidentType	IncidentType	Megadja a forgalmi incidens típusát. Ez különböző típusú incidensek kérésére és megkülönböztetésére használható.
isRoadClosed	boolean	A `true` értéke azt jelzi, hogy útlezárás van.
isTrafficJam	boolean	A `true` értéke azt jelzi, hogy az incidens által érintett útterület rendellenes forgalmi körülményeket tapasztal, ami nem jellemző késéseket eredményez.
lastModifiedTime	string	Az incidensadatok utolsó frissítésének dátuma és időpontja UTC-ben, dátum/idő értékként formázva RFC 3339, 5.6 szakasz.
severity	integer (int32)	Meghatározza az incidens fontossági szintjét. 1: LowImpact 2: Alverzió 3: Mérsékelt 4: Komoly
startTime	string	Az incidens bekövetkezésének dátuma és időpontja UTC-ben, dátum/idő értékként formázva az RFC 3339 5.6 szakaszában.
title	string	Meghatározza az érintett utak útnevét és irányát.

TrafficIncidentFeaturesItem

Objektum

Megadja a forgalmi incidens GeoJSON-funkcióobjektumát, beleértve a geometriát és a további tulajdonságokat.

Name	Típus	Description
geometry	GeoJsonPoint	Érvényes `GeoJSON Point` geometriatípus. Részletekért tekintse meg RFC 7946.
id	integer (int64)	Az incidens egyedi azonosítója.
properties	TrafficIncidentFeatureProperties	A forgalmi incidensekkel kapcsolatos részletes információkat adja meg.
type	FeaturesItemTypeEnum	Megadja a `GeoJSON` típusát. Az egyetlen támogatott objektumtípus a Funkció. További információ: RFC 7946.

TrafficIncidentResponse

Objektum

Egy GeoJSON-funkciógyűjteményi objektum, amely a forgalmi incidensek funkcióinak listáját tartalmazza.

Name	Típus	Description
features	TrafficIncidentFeaturesItem[]	`GeoJSON` geometriai objektumot és további tulajdonságokat tartalmazó funkcióobjektumot. A részletekért tekintse meg RFC 7946 3.2 szakaszát.
type	FeatureTypeEnum	Megadja a `GeoJSON` típusát. Az egyetlen támogatott objektumtípus a `FeatureCollection`. További információ: RFC 7946.

Megosztás a következőn keresztül:

Traffic - Get Traffic Incident

URI-paraméterek

Kérelem fejléce

Válaszok

Biztonság

AADToken

Jegyzetek

Hatókörök

subscription-key

SAS Token

Példák

Request information about a traffic incident

Mintakérelem

Mintaválasz

Definíciók

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

FeaturesItemTypeEnum

FeatureTypeEnum

GeoJsonPoint

IncidentType

TrafficIncidentFeatureProperties

TrafficIncidentFeaturesItem

TrafficIncidentResponse