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í 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}
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[]

Je boundingbox reprezentován dvěma páry hodnot, které popisují jeho rohy (první pár pro levý dolní roh a druhý pro pravý horní roh). Páry lze určit pomocí některé z projectionníže uvedených hodnot (např. minY,minX,maxY,maxX) nebo dvěma páry zeměpisné šířky a délky (např . minLat,minLon,maxLat,maxLon).

POZNÁMKA: Pokud se používají páry zeměpisná šířka/délka, projection musí být parametr nastaven na "EPSG4326".
boundingZoom
 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

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.
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.
expandCluster
 query

boolean

Logická hodnota označující, jestli se mají vypsat všechny dopravní incidenty v clusteru zvlášť
geometries
 query

IncidentGeometryType

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ě.
originalPosition
 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

ProjectionStandard

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 dá se načíst z rozhraní API účtu roviny správy Služby Azure Maps. Informace o použití zabezpečení Microsoft Entra ID ve službě Azure Maps najdete v následujících článcích .

Odpovědi

Name Typ Description
200 OK

TrafficIncidentDetail

OK
Other Status Codes

ErrorResponse

Došlo k neočekávané chybě.

Zabezpečení

AADToken

Toto jsou toky Microsoft Entra 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 rozhraním REST API služby Azure Maps. Řízení přístupu na základě role v Azure slouží k určení přístupu k jednomu nebo několika úč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, která se skládá 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 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 k určitým rozhraním API a oborům.

Poznámky

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

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 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í.

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.

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žít pro přístup k rozhraním REST API služby Azure Maps přístup k důvěrným klientským aplikacím , aby se váš klíč mohl 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 List SAS v prostředku Azure Maps prostřednictvím roviny správy 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.

Typ: apiKey
V: header

Příklady

Request information about a traffic incident

Ukázkový požadavek

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

Odpověď na chybu
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
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.
IncidentGeometryType

Typ geometrie vektoru přidaný k incidentům (vrácený v elementu odpovědi).
Point

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

Projekce použitá k zadání 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í element odpovědi
TrafficIncidentDetail

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

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čito (používá se pro uzavírky a jiná časově neomezená zpoždění)

ErrorAdditionalInfo

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

Name Typ Description
info

object

Další informace.
type

string

Další typ informací.

ErrorDetail

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

Odpověď na chybu

Name Typ Description
error

ErrorDetail

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

Nehoda
10

Integer

Vítr
11

Integer

Záplava
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

Džem
7

Integer

Uzavřená dráha
8

Integer

Silnice uzavřena
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 šipkami označujícími závažnost.
s2

string

Vytvoří prosté čá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 geometrie vektoru přidaný k incidentům (vrácený v elementu odpovědi).

Name Typ Description
original

string

Místa incidentů přesně 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á 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

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

Name Typ Description
EPSG4326

string

EPSG4326
EPSG900913

string

EPSG900913

ResponseFormat

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

Name Typ Description
json

string

Formát výměny dat v zápisu objektů JavaScriptu
xml

string

Rozšiřitelný jazyk značek

Tm

Hlavní element odpovědi

Name Typ Description
@id

string

ID modelu provozu pro tento incident
poi

TrafficIncidentPointOfInterest[]

Jeden dopravní incident nebo cluster dopravních incidentů

TrafficIncidentDetail

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

Name Typ Description
tm

Tm

Hlavní element odpovědi

TrafficIncidentPointOfInterest

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

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

Zpoždění způsobené incidentem v sekundách (s výjimkou uzavírek)
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

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
id

string

ID dopravního incidentu
l

integer

Délka incidentu v metrech
p

Point

Bod, kde má být vykreslena 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 silnice.
r

string

Čísla silnic ovlivněná incidentem. Více čísel cest bude odděleno lomítky.
sd

string

Počáteční datum incidentu, pokud je k dispozici. Datum je popsáno ve formátu ISO8601.
t

string

To: název křižovatky nebo místa, kde končí provoz způsobený incidentem.
ty

DelayMagnitude

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