Traffic - Get Traffic Incident Detail

Referentie

Service:: Maps

API-versie:: 1.0

Gebruik deze optie om informatie op te halen over verkeersincidenten in een bepaald begrenzingsvak.

De Traffic Incident Detail API is een HTTP-aanvraag GET die informatie biedt over verkeersincidenten in een bepaald begrenzingsvak, op basis van de huidige verkeersmodel-id. De verkeersmodel-id is beschikbaar om synchronisatie van gegevens tussen aanroepen en API's toe te kennen. De verkeersmodel-id is een belangrijke waarde voor het bepalen van de valuta van verkeersincidenten. Het wordt elke minuut bijgewerkt en is twee minuten geldig voordat er een time-out optreedt. Het wordt gebruikt bij het weergeven van incidenttegels. Deze kan worden verkregen via de Viewport-API .

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

Met optionele parameters:

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-parameters

Name	In	Vereist	Type	Description
format	path	True	ResponseFormat	Gewenste indeling van het antwoord. De waarde kan json of xml zijn.
api-version	query	True	string	Versienummer van Azure Maps-API.
boundingbox	query	True	number[]	De `boundingbox` wordt vertegenwoordigd door twee waardeparen die de hoeken beschrijven (eerste paar voor de linkerbenedenhoek en het tweede voor rechtsboven). De paren kunnen worden opgegeven met behulp van een van de `projection`'s die hieronder zijn opgegeven (bijvoorbeeld minY,minX,maxY,maxX) of door twee breedtegraad-lengtegraadparen (bijvoorbeeld minLat, minLon, maxLat, maxLon). OPMERKING: Als breedte-/lengtegraadparen worden gebruikt, moet de `projection` parameter worden ingesteld op 'EPSG4326'.
boundingZoom	query	True	integer int32	Zoomniveau voor de gewenste tegel. 0 tot 22 voor rastertegels, 0 tot en met 22 voor vectortegels
style	query	True	IncidentDetailStyle	De stijl die wordt gebruikt om de tegel weer te geven in de Tegel-API voor verkeersincidenten. Dit heeft invloed op de coördinaten van verkeersincidenten in het antwoord.
trafficmodelid	query	True	string	Het verkeersmodel dat naar een getal verwijst. Deze kan worden verkregen via de Viewport-API . Het wordt elke minuut bijgewerkt en is twee minuten geldig voordat er een time-out optreedt. Als de verkeerde verkeersmodel-id is opgegeven, wordt de juiste id geretourneerd door de interface. Met de waarde -1 wordt altijd het meest recente verkeersmodel aangeroepen
expandCluster	query		boolean	Booleaanse waarde om aan te geven of alle verkeersincidenten in een cluster afzonderlijk moeten worden vermeld
geometries	query		IncidentGeometryType	Het type vectorgeometrie dat is toegevoegd aan incidenten (geretourneerd in het element van het antwoord).
language	query		string	ISO 639-1-code voor de uitvoertaal. Ondersteunde talen zijn ar, ca, cs, da, de, el, en, en-GB, en-US, es, et, fi, fr, he, hu, id, in*, it, lt, lv, nb, nl, no, pl, pt, ro, ru, sk, sv, th, tr, zh. Raadpleeg Ondersteunde talen voor meer informatie. Wanneer er een ongeldige taalcode wordt opgegeven, wordt het antwoord in het Engels geretourneerd. Wanneer de oorzaak of beschrijving van het incident geen vertaling bevat, wordt de Engelse beschrijving geretourneerd.
originalPosition	query		boolean	Booleaanse waarde voor het retourneren van de oorspronkelijke positie van het incident () en de positie die naar het begin van de verkeersbuis is verschoven ()
projection	query		ProjectionStandard	De projectie die wordt gebruikt om de coördinaten in de aanvraag en het antwoord op te geven. EPSG900913 (standaard) of EPSG4326

Aanvraagkoptekst

Name	Vereist	Type	Description
x-ms-client-id		string	Hiermee geeft u op welk account is bedoeld voor gebruik in combinatie met het Microsoft Entra ID-beveiligingsmodel. Het vertegenwoordigt een unieke id voor het Azure Maps-account en kan worden opgehaald uit de Azure Maps-beheervlak Account-API. Als u Microsoft Entra ID-beveiliging in Azure Maps wilt gebruiken, raadpleegt u de volgende artikelen voor hulp.

Antwoorden

Name	Type	Description
200 OK	TrafficIncidentDetail	OK
Other Status Codes	ErrorResponse	Er is een onverwachte fout opgetreden.

Beveiliging

AADToken

Dit zijn de Microsoft Entra OAuth 2.0-stromen . Wanneer het wordt gekoppeld met op rollen gebaseerd toegangsbeheer van Azure , kan het worden gebruikt om de toegang tot Azure Maps REST API's te beheren. Op rollen gebaseerd toegangsbeheer van Azure wordt gebruikt om toegang tot een of meer Azure Maps-resourceaccounts of subresources aan te wijzen. Elke gebruiker, groep of service-principal kan toegang krijgen via een ingebouwde rol of een aangepaste rol die bestaat uit een of meer machtigingen voor Azure Maps REST API's.

Voor het implementeren van scenario's raden we u aan verificatieconcepten te bekijken. Samengevat biedt deze beveiligingsdefinitie een oplossing voor het modelleren van toepassingen via objecten die toegangsbeheer kunnen hebben voor specifieke API's en bereiken.

Notities

Voor deze beveiligingsdefinitie is het gebruik van de x-ms-client-id header vereist om aan te geven tot welke Azure Maps-resource de toepassing toegang aanvraagt. Dit kan worden verkregen via de Kaarten-beheer-API .

De Authorization URL is specifiek voor het azure-exemplaar van de openbare cloud. Onafhankelijke clouds hebben unieke autorisatie-URL's en Microsoft Entra ID-configuraties. * Op rollen gebaseerd toegangsbeheer van Azure wordt geconfigureerd vanuit het Azure-beheervlak via Azure Portal, PowerShell, CLI, Azure SDK's of REST API's. * Gebruik van de Azure Maps Web SDK maakt configuratie van een toepassing mogelijk voor meerdere use cases.

Zie Overzicht van Microsoft Identity Platform voor meer informatie over Microsoft Identity Platform.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

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

subscription-key

Dit is een gedeelde sleutel die wordt ingericht wanneer u een Azure Maps-account maakt in Azure Portal of met behulp van PowerShell, CLI, Azure SDK's of REST API.

Met deze sleutel heeft elke toepassing toegang tot alle REST API's. Met andere woorden, deze sleutel kan worden gebruikt als een hoofdsleutel in het account waarin ze zijn uitgegeven.

Voor openbaar beschikbare toepassingen wordt aanbevolen om de benadering vertrouwelijke clienttoepassingen te gebruiken voor toegang tot Azure Maps REST API's, zodat uw sleutel veilig kan worden opgeslagen.

Type: apiKey
In: query

SAS Token

Dit is een shared access signature-token dat is gemaakt op basis van de SAS-bewerking List op de Azure Maps-resource via het Azure-beheervlak via Azure Portal, PowerShell, CLI, Azure SDK's of REST API's.

Met dit token is elke toepassing gemachtigd om toegang te krijgen met op rollen gebaseerd toegangsbeheer van Azure en fijnmazige controle over het verloop, de snelheid en de gebruiksregio(s) voor het specifieke token. Met andere woorden, het SAS-token kan worden gebruikt om toepassingen in staat te stellen toegang op een veiligere manier te beheren dan de gedeelde sleutel.

Voor openbaar beschikbaar gemaakte toepassingen wordt aanbevolen om een specifieke lijst met toegestane oorsprongen te configureren op de resource Van het account toewijzen om misbruik van het genereren te beperken en het SAS-token regelmatig te vernieuwen.

Type: apiKey
In: header

Voorbeelden

Request information about a traffic incident

Voorbeeldaanvraag

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

Voorbeeldrespons

Statuscode:: 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
      }
    ]
  }
}

Definities

Name	Description
DelayMagnitude	De omvang van de vertraging die is gekoppeld aan het incident. Deze waarden komen overeen met incidentkleuren in de verkeerstegels
ErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
ErrorDetail	De foutdetails.
ErrorResponse	Foutreactie
IconCategory	De pictogramcategorie die is gekoppeld aan dit incident. Waarden zijn getallen in het bereik 0-13, met de volgende betekenissen : 0: Onbekend, 1: Ongeval, 2: Mist, 3: Gevaarlijke omstandigheden, 4: Regen, 5: Ijs, 6: Jam, 7: Baan gesloten, 8: Weg gesloten, 9: Wegwerkzaamheden, 10: Wind, 11: Overstroming, 12: Omleiding, 13: Cluster
IncidentDetailStyle	De stijl die wordt gebruikt om de tegel weer te geven in de Traffic Incident Tile-API . Dit heeft invloed op de coördinaten van verkeersincidenten in het antwoord.
IncidentGeometryType	Het type vectorgeometrie dat is toegevoegd aan incidenten (geretourneerd in het element van het antwoord).
Point	Algemene weergave van een punt met coördinaten (x, y) in het Cartesische vlak.
ProjectionStandard	De projectie die wordt gebruikt om de coördinaten in de aanvraag en het antwoord op te geven. EPSG900913 (standaard) of EPSG4326
ResponseFormat	Gewenste indeling van het antwoord. Waarde kan json of xml zijn.
Tm	Hoofdantwoordelement
TrafficIncidentDetail	Dit object wordt geretourneerd na een geslaagde detailoproep voor verkeersincidenten
TrafficIncidentPointOfInterest

DelayMagnitude

De omvang van de vertraging die is gekoppeld aan het incident. Deze waarden komen overeen met incidentkleuren in de verkeerstegels

Name	Type	Description
0	Integer	Onbekend
1	Integer	Secundair
2	Integer	Matig
3	Integer	Primair
4	Integer	Onbepaald (gebruikt voor wegsluitingen en andere onbepaalde vertragingen)

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

Name	Type	Description
info	object	De aanvullende informatie.
type	string	Het type aanvullende informatie.

ErrorDetail

De foutdetails.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Aanvullende informatie over de fout.
code	string	De foutcode.
details	ErrorDetail[]	De foutdetails.
message	string	Het foutbericht.
target	string	Het foutdoel.

ErrorResponse

Foutreactie

Name	Type	Description
error	ErrorDetail	Het foutobject.

IconCategory

De pictogramcategorie die is gekoppeld aan dit incident. Waarden zijn getallen in het bereik 0-13, met de volgende betekenissen : 0: Onbekend, 1: Ongeval, 2: Mist, 3: Gevaarlijke omstandigheden, 4: Regen, 5: Ijs, 6: Jam, 7: Baan gesloten, 8: Weg gesloten, 9: Wegwerkzaamheden, 10: Wind, 11: Overstroming, 12: Omleiding, 13: Cluster

Name	Type	Description
0	Integer	Onbekend
1	Integer	Ongeluk
10	Integer	Wind
11	Integer	Overstromingen
12	Integer	Omweg
13	Integer	Cluster: wordt geretourneerd als een cluster incidenten met verschillende pictogramcategorieën bevat.
14	Integer	Uitgesplitst voertuig
2	Integer	Mist
3	Integer	Gevaarlijke omstandigheden
4	Integer	Regen
5	Integer	Ice
6	Integer	Jam
7	Integer	Rijstrook gesloten
8	Integer	Weg gesloten
9	Integer	Wegenwerken

IncidentDetailStyle

De stijl die wordt gebruikt om de tegel weer te geven in de Traffic Incident Tile-API . Dit heeft invloed op de coördinaten van verkeersincidenten in het antwoord.

Name	Type	Description
night	string	Nachtstijl.
s1	string	Hiermee maakt u verkeerslijnen met gekleurde punthaken die de ernst aangeven.
s2	string	Hiermee maakt u gewone lijnen met een bepaalde mate van gloed.
s3	string	Hiermee maakt u gewone lijnen met een bepaalde mate van gloed, anders dan de stijl s2.

IncidentGeometryType

Het type vectorgeometrie dat is toegevoegd aan incidenten (geretourneerd in het element van het antwoord).

Name	Type	Description
original	string	Plaatst incidenten precies op de weg.
shifted	string	Verplaatst het incident enigszins (afhankelijk van het zoomniveau) om specifieke rijstroken aan te geven.

Point

Algemene weergave van een punt met coördinaten (x, y) in het Cartesische vlak.

Name	Type	Description
x	number	x-coördinaat
y	number	y-coördinaat

ProjectionStandard

De projectie die wordt gebruikt om de coördinaten in de aanvraag en het antwoord op te geven. EPSG900913 (standaard) of EPSG4326

Name	Type	Description
EPSG4326	string	EPSG4326
EPSG900913	string	EPSG900913

ResponseFormat

Gewenste indeling van het antwoord. Waarde kan json of xml zijn.

Name	Type	Description
json	string	De JavaScript Object Notation Data Interchange-indeling
xml	string	De uitbreidbare opmaaktaal

Tm

Hoofdantwoordelement

Name	Type	Description
@id	string	Id van het verkeersmodel voor dit incident
poi	TrafficIncidentPointOfInterest[]	Eén verkeersincident of een cluster van verkeersincidenten

TrafficIncidentDetail

Dit object wordt geretourneerd na een geslaagde detailoproep voor verkeersincidenten

Name	Type	Description
tm	Tm	Hoofdantwoordelement

TrafficIncidentPointOfInterest

Name	Type	Description
c	string	Oorzaak van het incident, indien beschikbaar, in de aangevraagde taal
cbl	Point	Coördinaat linksonder van het cluster in de projectie van de aanvraag
cs	integer	Clustergrootte: het aantal incidenten in het cluster
ctr	Point	Coördinaat rechtsboven van het cluster in de projectie van de aanvraag
d	string	Beschrijving van het incident in de aangevraagde taal
dl	integer	Vertraging veroorzaakt door het incident in seconden (behalve bij wegsluitingen)
ed	string	Geschatte einddatum van het incident, indien beschikbaar. De datum wordt beschreven in de indeling ISO8601.
f	string	Van: de naam van het kruispunt of de locatie waar het verkeer vanwege het incident begint
ic	IconCategory	De pictogramcategorie die is gekoppeld aan dit incident. Waarden zijn getallen in het bereik 0-13, met de volgende betekenissen : 0: Onbekend, 1: Ongeval, 2: Mist, 3: Gevaarlijke omstandigheden, 4: Regen, 5: Ijs, 6: Jam, 7: Baan gesloten, 8: Weg gesloten, 9: Wegwerkzaamheden, 10: Wind, 11: Overstroming, 12: Omleiding, 13: Cluster
id	string	Id van het verkeersincident
l	integer	Lengte van het incident in meters
p	Point	Het punt waar een pictogram van het cluster- of onbewerkte incident moet worden getekend, uitgedrukt in de aangevraagde projectie. Dit wordt beïnvloed door de verkeersstijl, het zoomniveau en het wegtype
r	string	De wegnummers die door het incident zijn beïnvloed. Meerdere wegnummers worden gescheiden door slashes
sd	string	Begindatum van het incident, indien beschikbaar. De datum wordt beschreven in de indeling ISO8601.
t	string	Aan: de naam van het kruispunt of de locatie waar het verkeer vanwege het incident eindigt
ty	DelayMagnitude	De omvang van de vertraging die is gekoppeld aan het incident. Deze waarden komen overeen met incidentkleuren in de verkeerstegels

Delen via