Traffic - Get Traffic Incident Detail

Reference

Služba:: Maps

Verze rozhraní API:: 1.0

Slouží k získání informací o dopravních incidentech uvnitř daného ohraničujícího rámečku.

Rozhraní API Traffic Incident Detail je požadavek HTTP GET, který poskytuje informace o incidentech provozu uvnitř daného ohraničujícího pole na základě aktuálního ID modelu provozu . ID modelu provozu je k dispozici pro udělení synchronizace dat mezi voláními a rozhraním API. ID modelu provozu je klíčovou hodnotou pro určení měny incidentů provozu. Aktualizuje se každou minutu a platí po dobu dvou minut, než vyprší časový limit. Používá se při vykreslování dlaždic incidentů. Lze ho získat z rozhraní API Viewport.

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

S volitelnými parametry:

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}

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
format	path	True	ResponseFormat	Požadovaný formát odpovědi Hodnota může být json nebo xml.
api-version	query	True	string	Číslo verze rozhraní API služby Azure Maps
boundingbox	query	True	number[]	`boundingbox` jsou reprezentovány dvěma páry hodnot popisujícími jeho rohy (první dvojice pro levý dolní roh a druhá pro pravé horní). Tyto páry je možné zadat buď pomocí některého z níže zadaných `projection`(např. minY,minX,maxY,maxY,maxX) nebo dvěma páry zeměpisné délky (např. minLat,minLon,maxLat,maxLon). POZNÁMKA: Pokud se používají páry zeměpisné šířky a délky, musí být parametr `projection` nastaven na "EPSG4326".
boundingZoom	query	True	integer (int32) minimum: 0 maximum: 22	Úroveň přiblížení požadované dlaždice 0 až 22 pro rastrové dlaždice, 0 až 22 pro vektorové dlaždice
style	query	True	IncidentDetailStyle	Styl, který se použije k vykreslení dlaždice v rozhraní API traffic incidentu. To bude mít vliv na souřadnice incidentů provozu v odpovědi.
trafficmodelid	query	True	string	Číslo odkazující na model provozu Můžete ho získat z rozhraní API Viewport. Aktualizuje se každou minutu a platí po dobu dvou minut, než vyprší časový limit. Pokud je zadáno nesprávné ID modelu provozu, rozhraní vrátí správné ID modelu provozu. Hodnota -1 vždy vyvolá nejnovější model provozu.
expandCluster	query		boolean	Logická hodnota označující, jestli se mají vypsat všechny incidenty provozu v clusteru samostatně
geometries	query		IncidentGeometryType	Typ geometrie vektoru přidaný do incidentů (vrácený v prvku odpovědi).
language	query		string	kód ISO 639-1 pro výstupní jazyk. Podporované jazyky jsou 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. Podrobnosti najdete v podporovaných jazycích. Pokud je zadaný neplatný kód jazyka, vrátí se odpověď v angličtině. Pokud příčina incidentu nebo popis neobsahuje překlad, vrátí se anglický popis.
originalPosition	query		boolean	Logická hodnota, zda se má vrátit původní pozice incidentu () i ta, která se přesunula na začátek dopravní trubice ()
projection	query		ProjectionStandard	Projekce použitá k určení souřadnic v požadavku a odpovědi. EPSG900913 (výchozí) nebo EPSG4326

Hlavička požadavku

Name	Vyžadováno	Typ	Description
x-ms-client-id		string	Určuje, který účet je určený pro použití ve spojení s modelem zabezpečení Microsoft Entra ID. Představuje jedinečné ID pro účet Azure Maps a dá se načíst z rozhraní API účtu roviny správy Azure Maps. Informace o používání zabezpečení Microsoft Entra ID v Azure Maps najdete v následujících článcích s pokyny.

Odpovědi

Name	Typ	Description
200 OK	TrafficIncidentDetail	OK
Other Status Codes	ErrorResponse	Došlo k neočekávané chybě.

Zabezpečení

AADToken

Jedná se o Microsoft Entra OAuth 2.0 Flow. Při spárování s přístupu na základě role Azure se dá řídit přístup k rozhraním REST API služby Azure Maps. Řízení přístupu na základě role Azure slouží k určení přístupu k jednomu nebo více účtům prostředků Nebo dílčím prostředkům Azure Maps. Každému uživateli, skupině nebo instančnímu objektu je možné udělit přístup prostřednictvím předdefinované role nebo vlastní role složené z jednoho nebo více oprávnění k rozhraním REST API služby Azure Maps.

Pokud chcete implementovat scénáře, doporučujeme zobrazit koncepty ověřování . Stručně řečeno, tato definice zabezpečení poskytuje řešení pro modelování aplikací prostřednictvím objektů schopných řízení přístupu pro konkrétní rozhraní API a rozsahy.

Poznámky

Tato definice zabezpečení vyžaduje použití hlavičky x-ms-client-id k označení, ke kterému prostředku Azure Maps aplikace žádá o přístup. Můžete ho získat z rozhraní API pro správu Maps.

Authorization URL je specifická pro instanci veřejného cloudu Azure. Suverénní cloudy mají jedinečné adresy URL autorizace a konfigurace MICROSOFT Entra ID. * Řízení přístupu na základě role Azure se konfiguruje z roviny správy Azure prostřednictvím webu Azure Portal, PowerShellu, rozhraní příkazového řádku, sad AZURE SDK nebo rozhraní REST API. * Použití webové sady SDK služby Azure Maps umožňuje nastavení aplikace na základě konfigurace pro více případů použití.

Další informace o platformě Microsoft Identity Platform najdete v tématu Přehled platformy Microsoft Identity Platform.

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

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

subscription-key

Jedná se o sdílený klíč, který se zřídí při vytvoření účtu Azure Maps na webu Azure Portal nebo pomocí PowerShellu, rozhraní příkazového řádku, sad Azure SDK nebo rozhraní REST API.

Díky tomuto klíči má každá aplikace přístup ke všem rozhraní REST API. Jinými slovy, tento klíč lze použít jako hlavní klíč v účtu, ve který jsou vydány.

U veřejně vystavených aplikací doporučujeme používat důvěrných klientských aplikací přístup k rozhraním REST API služby Azure Maps, aby bylo možné klíč bezpečně uložit.

Typ: apiKey
V: query

SAS Token

Jedná se o token sdíleného přístupového podpisu, který se vytvoří z operace Vypsat SAS v prostředku Azure Maps prostřednictvím roviny správy Azure prostřednictvím webu Azure Portal, PowerShellu, rozhraní příkazového řádku, sad SDK Azure nebo rozhraní REST API.

S tímto tokenem má každá aplikace oprávnění k přístupu pomocí řízení přístupu na základě role Azure a jemně odstupňované řízení vypršení platnosti, rychlosti a oblastí použití pro konkrétní token. Jinými slovy, token SAS lze použít k tomu, aby aplikace mohly řídit přístup bezpečnějším způsobem než sdílený klíč.

U veřejně vystavených aplikací doporučujeme nakonfigurovat konkrétní seznam povolených zdrojů na prostředku účtu Map omezit zneužití vykreslování a pravidelně obnovovat token SAS.

Typ: apiKey
V: header

Příklady

Request information about a traffic incident

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:: 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
      }
    ]
  }
}

Definice

Name	Description
DelayMagnitude	Velikost zpoždění spojeného s incidentem. Tyto hodnoty odpovídají barvám incidentů na dlaždicích provozu.
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď
IconCategory	Kategorie ikony přidružená k tomuto incidentu. Hodnoty jsou čísla v rozsahu 0–13, s následujícími významy -- 0: Neznámá, 1: Nehoda, 2: Mlha, 3: Nebezpečné podmínky, 4: Déšť, 5: Led, 6: Jam, 7: Uzavřená dráha, 8: Silnice uzavřena, 9: Práce na silnici, 10: Vítr, 11: Zaplavení, 12: Objížďka, 13: Shluk
IncidentDetailStyle	Styl, který se použije k vykreslení dlaždice v rozhraní API traffic incidentu. To bude mít vliv na souřadnice incidentů provozu v odpovědi.
IncidentGeometryType	Typ geometrie vektoru přidaný do incidentů (vrácený v prvku odpovědi).
Point	Obecná reprezentace bodu se souřadnicemi (x, y) v kartézské rovině.
ProjectionStandard	Projekce použitá k určení souřadnic v požadavku a odpovědi. EPSG900913 (výchozí) nebo EPSG4326
ResponseFormat	Požadovaný formát odpovědi Hodnota může být json nebo xml.
Tm	Hlavní prvek odpovědi
TrafficIncidentDetail	Tento objekt se vrátí z úspěšného volání podrobností o incidentu provozu.
TrafficIncidentPointOfInterest

DelayMagnitude

Výčet

Velikost zpoždění spojeného s incidentem. Tyto hodnoty odpovídají barvám incidentů na dlaždicích provozu.

Hodnota	Description
0	Neznámý
1	Nezletilý
2	Mírný
3	Hlavní
4	Neurčité (používané pro uzavírky silnic a další neomezená zpoždění)

ErrorAdditionalInfo

Objekt

Další informace o chybě správy prostředků

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

ErrorDetail

Objekt

Podrobnosti o chybě.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby.
details	ErrorDetail[]	Podrobnosti o chybě.
message	string	Chybová zpráva.
target	string	Cíl chyby.

ErrorResponse

Objekt

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

IconCategory

Výčet

Kategorie ikony přidružená k tomuto incidentu. Hodnoty jsou čísla v rozsahu 0–13, s následujícími významy -- 0: Neznámá, 1: Nehoda, 2: Mlha, 3: Nebezpečné podmínky, 4: Déšť, 5: Led, 6: Jam, 7: Uzavřená dráha, 8: Silnice uzavřena, 9: Práce na silnici, 10: Vítr, 11: Zaplavení, 12: Objížďka, 13: Shluk

Hodnota	Description
0	Neznámý
1	Nehoda
10	Větrná
11	Záplava
12	Objížďka
13	Cluster: Vráceno, pokud cluster obsahuje incidenty s různými kategoriemi ikon.
14	Rozčleněné vozidlo
2	Mlha
3	Nebezpečné podmínky
4	Déšť
5	Ice
6	Džem
7	Pruh zavřený
8	Cesta uzavřená
9	Silniční práce

IncidentDetailStyle

Výčet

Styl, který se použije k vykreslení dlaždice v rozhraní API traffic incidentu. To bude mít vliv na souřadnice incidentů provozu v odpovědi.

Hodnota	Description
night	Noční styl.
s1	Vytvoří čáry provozu s barevnými dvojitými šipkami označujícími závažnost.
s2	Vytvoří jednoduché čáry s určitým stupněm záře.
s3	Vytvoří jednoduché čáry s určitým stupněm záře, které se liší od stylu s2.

IncidentGeometryType

Výčet

Typ geometrie vektoru přidaný do incidentů (vrácený v prvku odpovědi).

Hodnota	Description
original	Umístí incidenty přesně na silnici.
shifted	Přesune incident mírně (v závislosti na úrovni přiblížení) a označí konkrétní jízdní pruhy.

Point

Objekt

Obecná reprezentace bodu se souřadnicemi (x, y) v kartézské rovině.

Name	Typ	Description
x	number	souřadnice x
y	number	Souřadnice y

ProjectionStandard

Výčet

Projekce použitá k určení souřadnic v požadavku a odpovědi. EPSG900913 (výchozí) nebo EPSG4326

Hodnota	Description
EPSG4326	EPSG4326
EPSG900913	EPSG900913

ResponseFormat

Výčet

Požadovaný formát odpovědi Hodnota může být json nebo xml.

Hodnota	Description
json	formát výměny dat javascriptového objektu
xml	rozšiřitelného jazyka značek

Tm

Objekt

Hlavní prvek odpovědi

Name	Typ	Description
@id	string	ID modelu provozu pro tento incident
poi	TrafficIncidentPointOfInterest[]	Jeden incident provozu nebo cluster incidentů provozu

TrafficIncidentDetail

Objekt

Tento objekt se vrátí z úspěšného volání podrobností o incidentu provozu.

Name	Typ	Description
tm	Tm	Hlavní prvek odpovědi

TrafficIncidentPointOfInterest

Objekt

Name	Typ	Description
c	string	Příčina incidentu, pokud je k dispozici, v požadovaném jazyce
cbl	Point	Levá dolní souřadnice clusteru v projekci požadavku
cs	integer (int32)	Velikost clusteru: počet incidentů v clusteru
ctr	Point	Pravá horní souřadnice clusteru v projekci požadavku
d	string	Popis incidentu v požadovaném jazyce
dl	integer (int32)	Zpoždění způsobené incidentem v sekundách (s výjimkou uzavření silnic)
ed	string (date-time)	Odhadované koncové datum incidentu, pokud je k dispozici. Datum je popsáno ve formátu ISO8601.
f	string	Od: název průsečíku nebo místa, kde se provoz kvůli incidentu spouští.
ic	IconCategory (int32)	Kategorie ikony přidružená k tomuto incidentu. Hodnoty jsou čísla v rozsahu 0–13, s následujícími významy -- 0: Neznámá, 1: Nehoda, 2: Mlha, 3: Nebezpečné podmínky, 4: Déšť, 5: Led, 6: Jam, 7: Uzavřená dráha, 8: Silnice uzavřena, 9: Práce na silnici, 10: Vítr, 11: Zaplavení, 12: Objížďka, 13: Shluk
id	string	ID incidentu provozu
l	integer (int32)	Délka incidentu v metrech
p	Point	Bod, kde by se měla vykreslit ikona clusteru nebo nezpracovaného incidentu vyjádřená v požadované projekci. To je ovlivněno stylem provozu, úrovní přiblížení a typem silničního provozu.
r	string	Čísla silnic ovlivněná incidentem. Více čísel cest bude odděleno lomítky.
sd	string (date-time)	Počáteční datum incidentu, pokud je k dispozici. Datum je popsáno ve formátu ISO8601.
t	string	To: název průsečíku nebo umístění, kde se provoz kvůli incidentu ukončí.
ty	DelayMagnitude (int32)	Velikost zpoždění spojeného s incidentem. Tyto hodnoty odpovídají barvám incidentů na dlaždicích provozu.

Sdílet prostřednictvím

Traffic - Get Traffic Incident Detail

Parametry identifikátoru URI

Hlavička požadavku

Odpovědi

Zabezpečení

AADToken

Poznámky

Rozsahy

subscription-key

SAS Token

Příklady

Request information about a traffic incident

Ukázkový požadavek

Ukázková odpověď

Definice

DelayMagnitude

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

IconCategory

IncidentDetailStyle

IncidentGeometryType

Point

ProjectionStandard

ResponseFormat

Tm

TrafficIncidentDetail

TrafficIncidentPointOfInterest

Další materiály