Traffic - Get Traffic Incident Detail
Slouží k získání informací o dopravních incidentech uvnitř daného ohraničujícího rámečku.
Rozhraní Traffic Incident Detail
API je požadavek HTTP GET
, který poskytuje informace o incidentech provozu uvnitř daného ohraničujícího rámečku 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ími API. ID modelu provozu je klíčovou hodnotou pro určení měny dopravních incidentů. Aktualizuje se každou minutu a platí dvě minuty, než vyprší jeho časový limit. Používá se při vykreslování dlaždic incidentů. Můžete 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}
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 |
Požadovaný formát odpovědi. Hodnota může být json nebo xml. |
|
api-version
|
query | True |
string |
Číslo verze rozhraní API Azure Maps. |
boundingbox
|
query | True |
number[] |
Je |
bounding
|
query | True |
integer int32 |
Ú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 |
Styl, který se použije k vykreslení dlaždice v rozhraní API pro dlaždici dopravního incidentu . To bude mít vliv na souřadnice dopravních incidentů v odpovědi. |
|
trafficmodelid
|
query | True |
string |
Číslo odkazující na model provozu. To je možné získat z rozhraní VIEWPORT API. Aktualizuje se každou minutu a platí dvě minuty, než vyprší jeho č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. |
expand
|
query |
boolean |
Logická hodnota označující, jestli se mají vypsat všechny dopravní incidenty v clusteru zvlášť |
|
geometries
|
query |
Typ geometrie vektoru přidaný k incidentům (vrácený v elementu 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 části Podporované jazyky . Při zadání neplatného kódu jazyka se vrátí odpověď v angličtině. Pokud příčina nebo popis incidentu neobsahuje překlad, vrátí se popis v angličtině. |
|
original
|
query |
boolean |
Logická hodnota o tom, zda se má vrátit původní poloha incidentu () a také pozice posunutá na začátek dopravního potrubí () |
|
projection
|
query |
Projekce použitá k zadání 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 účtu Azure Maps a je možné ho načíst z rozhraní API účtu roviny správy Azure Maps. Pokud chcete použít Microsoft Entra ID zabezpečení v Azure Maps pokyny najdete v následujících článcích. |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Došlo k neočekávané chybě. |
Zabezpečení
AADToken
Toto jsou Microsoft Entra toky OAuth 2.0. Při spárování s řízením přístupu na základě role v Azure se dá použít k řízení přístupu k Azure Maps rozhraní REST API. Řízení přístupu na základě role v Azure slouží k určení přístupu k jednomu nebo několika Azure Maps účtu prostředku nebo dílčím prostředkům. 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 Azure Maps rozhraní REST API.
Pokud chcete implementovat scénáře, doporučujeme zobrazit si koncepty ověřování. Souhrnně ř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 obory.
Poznámky
- Tato definice zabezpečení vyžaduje použití hlavičky
x-ms-client-id
k označení Azure Maps prostředku, ke kterému aplikace žádá o přístup. Můžete ho získat z rozhraní MAPS MANAGEMENT API.
Je Authorization URL
specifický pro instanci veřejného cloudu Azure. Suverénní cloudy mají jedinečné autorizační adresy URL a konfigurace Microsoft Entra ID.
* Řízení přístupu na základě role v Azure se konfiguruje z roviny správy Azure prostřednictvím Azure Portal, PowerShellu, rozhraní příkazového řádku, sad Azure SDK nebo rozhraní REST API.
* Použití sady Azure Maps Web SDK umožňuje nastavení aplikace na základě konfigurace pro více případů použití.
- Další informace o Microsoft identity platform najdete v přehledu Microsoft identity platform.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
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 Create účtu Azure Maps v Azure Portal nebo pomocí PowerShellu, rozhraní příkazového řádku, sad Azure SDK nebo rozhraní REST API.
S tímto klíčem má každá aplikace přístup ke všem rozhraním REST API. Jinými slovy, tento klíč se dá použít jako hlavní klíč v účtu, ve který je vystavený.
U veřejně vystavených aplikací doporučujeme používat pro přístup k rozhraním REST API Azure Maps přístup k důvěrným klientským aplikacím, aby se váš klíč mohl bezpečně uložit.
Type:
apiKey
In:
query
SAS Token
Jedná se o token sdíleného přístupového podpisu, který se vytvoří z operace List SAS prostředku Azure Maps prostřednictvím roviny správy Azure prostřednictvím Azure Portal, PowerShellu, rozhraní příkazového řádku, sad Azure SDK 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 v Azure a podrobného řízení k vypršení platnosti, četnosti a oblastem použití konkrétního tokenu. Jinými slovy, token SAS je možné 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ů v prostředku mapového účtu , aby se omezilo zneužití vykreslování a pravidelně obnovovali token SAS.
Type:
apiKey
In:
header
Příklady
Request information about a traffic incident
Sample Request
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
Sample Response
{
"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 |
---|---|
Delay |
Velikost zpoždění spojeného s incidentem. Tyto hodnoty odpovídají barvám incidentů na dlaždicích provozu. |
Error |
Další informace o chybě správy prostředků |
Error |
Podrobnosti o chybě |
Error |
Chybová odpověď |
Icon |
Kategorie ikony přidružené k tomuto incidentu Hodnoty jsou čísla v rozsahu 0-13, s následujícím významem -- 0: Neznámý, 1: Nehoda, 2: Mlha, 3: Nebezpečné podmínky, 4: Déšť, 5: Led, 6: Jam, 7: Lane Closed, 8: Road Closed, 9: Road Works, 10: Wind, 11: Flooding, 12: Detour, 13: Cluster |
Incident |
Styl, který se použije k vykreslení dlaždice v rozhraní API pro dlaždici dopravního incidentu . To bude mít vliv na souřadnice dopravních incidentů v odpovědi. |
Incident |
Typ vektorové geometrie přidané k incidentům (vrácený v elementu odpovědi). |
Point |
Obecné znázornění bodu se souřadnicemi (x, y) v kartézské rovině |
Projection |
Projekce použitá k určení souřadnic v požadavku a odpovědi. EPSG900913 (výchozí) nebo EPSG4326 |
Response |
Požadovaný formát odpovědi Hodnota může být json nebo xml. |
Tm |
Hlavní element odpovědi |
Traffic |
Tento objekt se vrátí z úspěšného volání Podrobnosti dopravního incidentu. |
Traffic |
DelayMagnitude
Velikost zpoždění spojeného s incidentem. Tyto hodnoty odpovídají barvám incidentů na dlaždicích provozu.
Name | Typ | Description |
---|---|---|
0 |
Integer |
Neznámý |
1 |
Integer |
Vedlejší |
2 |
Integer |
Pokročilé |
3 |
Integer |
Hlavní |
4 |
Integer |
Neurčité (používá se pro uzavírky silnic a další časově neomezená zpoždění) |
ErrorAdditionalInfo
Další informace o chybě správy prostředků
Name | Typ | Description |
---|---|---|
info |
object |
Další informace. |
type |
string |
Typ další informace. |
ErrorDetail
Podrobnosti o chybě
Name | Typ | Description |
---|---|---|
additionalInfo |
Další informace o chybě. |
|
code |
string |
Kód chyby |
details |
Podrobnosti o chybě. |
|
message |
string |
Chybová zpráva |
target |
string |
Cíl chyby. |
ErrorResponse
Chybová odpověď
Name | Typ | Description |
---|---|---|
error |
Objekt chyby. |
IconCategory
Kategorie ikony přidružené k tomuto incidentu Hodnoty jsou čísla v rozsahu 0-13, s následujícím významem -- 0: Neznámý, 1: Nehoda, 2: Mlha, 3: Nebezpečné podmínky, 4: Déšť, 5: Led, 6: Jam, 7: Lane Closed, 8: Road Closed, 9: Road Works, 10: Wind, 11: Flooding, 12: Detour, 13: Cluster
Name | Typ | Description |
---|---|---|
0 |
Integer |
Neznámý |
1 |
Integer |
Nehody |
10 |
Integer |
Vítr |
11 |
Integer |
Záplavy |
12 |
Integer |
Objížďka |
13 |
Integer |
Cluster: Vrátí se, pokud cluster obsahuje incidenty s různými kategoriemi ikon. |
14 |
Integer |
Rozbité vozidlo |
2 |
Integer |
Mlha |
3 |
Integer |
Nebezpečné podmínky |
4 |
Integer |
Déšť |
5 |
Integer |
Ice |
6 |
Integer |
Jam |
7 |
Integer |
Uzavřená jízdní dráha |
8 |
Integer |
Cesta uzavřená |
9 |
Integer |
Road Works |
IncidentDetailStyle
Styl, který se použije k vykreslení dlaždice v rozhraní API pro dlaždici dopravního incidentu . To bude mít vliv na souřadnice dopravních incidentů v odpovědi.
Name | Typ | Description |
---|---|---|
night |
string |
Noční styl. |
s1 |
string |
Vytvoří dopravní čáry s barevnými dvojitými šipkami označujícími závažnost. |
s2 |
string |
Vytvoří jednoduché čáry s určitým stupněm záře. |
s3 |
string |
Vytvoří jednoduché čáry s určitým stupněm záře, které se liší od stylu s2. |
IncidentGeometryType
Typ vektorové geometrie přidané k incidentům (vrácený v elementu odpovědi).
Name | Typ | Description |
---|---|---|
original |
string |
Places incidenty právě na silnici. |
shifted |
string |
Mírně posune incident (v závislosti na úrovni přiblížení) a označí konkrétní jízdní pruhy. |
Point
Obecné znázornění bodu se souřadnicemi (x, y) v kartézské rovině
Name | Typ | Description |
---|---|---|
x |
number |
souřadnice x |
y |
number |
Souřadnice y |
ProjectionStandard
Projekce použitá k určení souřadnic v požadavku a odpovědi. EPSG900913 (výchozí) nebo EPSG4326
Name | Typ | Description |
---|---|---|
EPSG4326 |
string |
|
EPSG900913 |
string |
ResponseFormat
Požadovaný formát odpovědi Hodnota může být json nebo xml.
Name | Typ | Description |
---|---|---|
json |
string |
|
xml |
string |
Tm
Hlavní element odpovědi
Name | Typ | Description |
---|---|---|
@id |
string |
ID modelu provozu pro tento incident |
poi |
Jeden dopravní incident nebo cluster dopravních incidentů |
TrafficIncidentDetail
Tento objekt se vrátí z úspěšného volání Podrobnosti dopravního incidentu.
Name | Typ | Description |
---|---|---|
tm |
Hlavní element odpovědi |
TrafficIncidentPointOfInterest
Name | Typ | Description |
---|---|---|
c |
string |
Příčina incidentu, pokud je k dispozici, v požadovaném jazyce |
cbl |
Levá dolní souřadnice clusteru v projekci požadavku |
|
cs |
integer |
Velikost clusteru: počet incidentů v clusteru. |
ctr |
Pravá horní souřadnice clusteru v projekci požadavku |
|
d |
string |
Popis incidentu v požadovaném jazyce |
dl |
integer |
Zpoždění způsobené incidentem v sekundách (s výjimkou uzavírek silnic) |
ed |
string |
Odhadované datum ukončení incidentu, pokud je k dispozici. Datum je popsáno ve formátu ISO8601. |
f |
string |
Od: název křižovatky nebo místa, kde začíná provoz způsobený incidentem. |
ic |
Kategorie ikony přidružené k tomuto incidentu Hodnoty jsou čísla v rozsahu 0-13, s následujícím významem -- 0: Neznámý, 1: Nehoda, 2: Mlha, 3: Nebezpečné podmínky, 4: Déšť, 5: Led, 6: Jam, 7: Lane Closed, 8: Road Closed, 9: Road Works, 10: Wind, 11: Flooding, 12: Detour, 13: Cluster |
|
id |
string |
ID dopravního incidentu |
l |
integer |
Délka incidentu v metrech |
p |
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 dopravy, úrovní přiblížení a typem silnice. |
|
r |
string |
Čísla silnic ovlivněná incidentem. Více čísel cest se oddělí lomítky. |
sd |
string |
Počáteční datum incidentu, pokud je k dispozici. Datum je popsáno ve formátu ISO8601. |
t |
string |
Do: název křižovatky nebo místa, kde končí provoz způsobený incidentem. |
ty |
Velikost zpoždění spojeného s incidentem. Tyto hodnoty odpovídají barvám incidentů na dlaždicích provozu. |