Traffic - Get Traffic Incident Detail

Referentie

Service:: Maps

API-versie:: 1.0

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

De Traffic Incident Detail-API is een HTTP-GET-aanvraag die informatie biedt over verkeersincidenten binnen een bepaald begrenzingsvak, op basis van de huidige Traffic Model ID. De verkeersmodel-id is beschikbaar voor het verlenen van synchronisatie van gegevens tussen aanroepen en API's. De verkeersmodel-id is een belangrijke waarde voor het bepalen van de valuta van verkeersincidenten. Deze wordt elke minuut bijgewerkt en is twee minuten geldig voordat er een time-out optreedt. Deze 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 linkerbenedenhoek en 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 lengtegraadparen (bijvoorbeeld minLat,minLon,maxLat,maxLon). OPMERKING: Als breedtegraad/lengtegraadparen worden gebruikt, moet de parameter `projection` worden ingesteld op 'EPSG4326'.
boundingZoom	query	True	integer (int32) minimum: 0 maximum: 22	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 Traffic Incident Tile API. Dit heeft gevolgen voor de coördinaten van verkeersincidenten in het antwoord.
trafficmodelid	query	True	string	Het nummer waarnaar wordt verwezen naar het verkeersmodel. Dit kan worden verkregen via de Viewport-API. Deze 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. Een waarde van -1 roept altijd het meest recente verkeersmodel aan
expandCluster	query		boolean	Booleaanse waarde die aangeeft of alle verkeersincidenten in een cluster afzonderlijk moeten worden weergegeven
geometries	query		IncidentGeometryType	Het type vectorgeometrie 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 ongeldige taalcode wordt opgegeven, wordt een antwoord geretourneerd in het Engels. Wanneer de oorzaak of beschrijving van het incident geen vertaling heeft, wordt de Engelse beschrijving geretourneerd.
originalPosition	query		boolean	Booleaanse waarde voor het retourneren van de oorspronkelijke positie van het incident () en de positie die is verschoven naar het begin van de verkeersbuis ()
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 Account-API van het Azure Maps-beheervlak. Zie de volgende artikelen voor hulp voor het gebruik van Microsoft Entra ID-beveiliging in Azure Maps.

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 Flows. Wanneer deze is gekoppeld aan 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 aan te wijzen tot een of meer Azure Maps-resourceaccounts of subresources. 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 om verificatieconceptente bekijken. Kortom, deze beveiligingsdefinitie biedt een oplossing voor het modelleren van toepassingen via objecten die toegangsbeheer kunnen uitvoeren voor specifieke API's en bereiken.

Opmerkingen

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

De Authorization URL is specifiek voor het exemplaar van de openbare Azure-cloud. Onafhankelijke clouds hebben unieke autorisatie-URL's en Microsoft Entra ID-configuraties. * Het op rollen gebaseerde 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 configuratiegebaseerde installatie van een toepassing mogelijk voor meerdere gebruiksscenario's.

Zie Overzicht van Microsoft Identity Platformvoor meer informatie over het 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 maken 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 worden uitgegeven.

Voor openbaar blootgestelde toepassingen is het raadzaam om de vertrouwelijke clienttoepassingen te gebruiken benadering 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 wordt gemaakt op basis van de bewerking List SAS 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 voor toegang met op rollen gebaseerd toegangsbeheer van Azure en gedetailleerd beheer tot de vervaldatum, snelheid en regio(s) van gebruik voor het specifieke token. Met andere woorden, het SAS-token kan worden gebruikt om toepassingen toe te staan toegang op een veiligere manier te beheren dan de gedeelde sleutel.

Voor openbaar blootgestelde toepassingen wordt aangeraden een specifieke lijst met toegestane origins te configureren voor de resource van het Account toewijzen om het genereren van misbruik 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 samenhangt met 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 aan dit incident is gekoppeld. 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: Wegenwerken, 10: Wind, 11: Overstroming, 12: Omweg, 13: Cluster
IncidentDetailStyle	De stijl die wordt gebruikt om de tegel weer te geven in Traffic Incident Tile API. Dit heeft gevolgen voor de coördinaten van verkeersincidenten in het antwoord.
IncidentGeometryType	Het type vectorgeometrie 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. De waarde kan json- of xml-zijn.
Tm	Hoofdantwoordelement
TrafficIncidentDetail	Dit object wordt geretourneerd door een geslaagde aanroep verkeersincidentdetail
TrafficIncidentPointOfInterest

DelayMagnitude

Inventarisatie

De omvang van de vertraging die samenhangt met incident. Deze waarden komen overeen met incidentkleuren in de verkeerstegels

Waarde	Description
0	Onbekend
1	Minderjarige
2	Gematigd
3	Majoor
4	Onbepaald (gebruikt voor wegsluitingen en andere onbepaalde vertragingen)

ErrorAdditionalInfo

Object

Aanvullende informatie over de resourcebeheerfout.

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

ErrorDetail

Object

De foutdetails.

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

ErrorResponse

Object

Foutreactie

Name	Type	Description
error	ErrorDetail	Het foutobject.

IconCategory

Inventarisatie

De pictogramcategorie die aan dit incident is gekoppeld. 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: Wegenwerken, 10: Wind, 11: Overstroming, 12: Omweg, 13: Cluster

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

IncidentDetailStyle

Inventarisatie

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

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

IncidentGeometryType

Inventarisatie

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

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

Point

Object

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

Inventarisatie

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

Waarde	Description
EPSG4326	EPSG4326
EPSG900913	EPSG900913

ResponseFormat

Inventarisatie

Gewenste indeling van het antwoord. De waarde kan json- of xml-zijn.

Waarde	Description
json	De Notatie Data Interchange-indeling voor JavaScript-objecten
xml	De uitbreidbare opmaaktaal

Tm

Object

Hoofdantwoordelement

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

TrafficIncidentDetail

Object

Dit object wordt geretourneerd door een geslaagde aanroep verkeersincidentdetail

Name	Type	Description
tm	Tm	Hoofdantwoordelement

TrafficIncidentPointOfInterest

Object

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 (int32)	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 (int32)	Vertraging veroorzaakt door het incident in seconden (met uitzondering van wegsluitingen)
ed	string (date-time)	Geschatte einddatum van het incident, indien beschikbaar. De datum wordt beschreven in de indeling ISO8601.
f	string	Van: de naam van het snijpunt of de locatie waar het verkeer door het incident begint
ic	IconCategory (int32)	De pictogramcategorie die aan dit incident is gekoppeld. 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: Wegenwerken, 10: Wind, 11: Overstroming, 12: Omweg, 13: Cluster
id	string	Id van het verkeersincident
l	integer (int32)	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 verkeersstijl, zoomniveau en wegtype
r	string	Het wegnummer(en) dat door het incident is getroffen. Meerdere wegnummers worden gescheiden door slashes
sd	string (date-time)	Begindatum van het incident, indien beschikbaar. De datum wordt beschreven in de indeling ISO8601.
t	string	Aan: de naam van het snijpunt of de locatie waar het verkeer door het incident eindigt
ty	DelayMagnitude (int32)	De omvang van de vertraging die samenhangt met incident. Deze waarden komen overeen met incidentkleuren in de verkeerstegels

Delen via

Traffic - Get Traffic Incident Detail

URI-parameters

Aanvraagkoptekst

Antwoorden

Beveiliging

AADToken

Opmerkingen

Bereiken

subscription-key

SAS Token

Voorbeelden

Request information about a traffic incident

Voorbeeldaanvraag

Voorbeeldrespons

Definities

DelayMagnitude

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

IconCategory

IncidentDetailStyle

IncidentGeometryType

Point

ProjectionStandard

ResponseFormat

Tm

TrafficIncidentDetail

TrafficIncidentPointOfInterest

Aanvullende resources