Megosztás a következőn keresztül:

Traffic - Get Traffic Incident Tile

  • Referencia
Szolgáltatás:
Maps
API-verzió:
1.0

A használatával 256 x 256 képpontos csempéket jeleníthet meg a forgalmi incidensekről.

Az Traffic Incident Tile API egy HTTP-kérés GET , amely 256 x 256 képpontos csempéket ad vissza, amelyeken a forgalmi incidensek láthatók. Minden csempe ugyanazt a rácsrendszert használja. Mivel a forgalmi csempék átlátszó képeket használnak, a térképcsempék tetejére rétegezhetők, így összetett megjelenítést hozhatnak létre. A forgalmi csempék a megadott területen lévő utak forgalmát jelző ábrákat jelenítik meg.

GET https://atlas.microsoft.com/traffic/incident/tile/{format}?api-version=1.0&style={style}&zoom={zoom}&x={x}&y={y}
Opcionális paraméterekkel: 
GET https://atlas.microsoft.com/traffic/incident/tile/{format}?api-version=1.0&style={style}&zoom={zoom}&x={x}&y={y}&t={t}

URI-paraméterek

Name In Kötelező Típus Description
format
 path True

TileFormat

A válasz kívánt formátuma. A lehetséges értékek a png & pbf.
api-version
 query True

string

Az Azure Maps API verziószáma.
style
 query True

TrafficIncidentTileStyle

A csempe megjelenítéséhez használandó stílus. Ez a paraméter nem érvényes, ha a formátum pbf.
x
 query True

integer

int32

A csempe X koordinátája a nagyítási rácson. Az értéknek a [0, 2zoom -1] tartományban kell lennie.

Részletekért tekintse meg a Nagyítási szintek és a Csemperács című témakört.
y
 query True

integer

int32

A csempe Y koordinátája a nagyítási rácson. Az értéknek a [0, 2zoom -1] tartományban kell lennie.

Részletekért tekintse meg a Nagyítási szintek és a Csemperács című témakört.
zoom
 query True

integer

int32

A kívánt csempe nagyítási szintje. A rasztercsempék esetében az értéknek a következő tartományban kell lennie: 0-22 (a rasztercsempéket is beleértve). Vektorcsempék esetén az értéknek a következő tartományban kell lennie: 0-22 (a következőket is beleértve). Részletekért tekintse meg a Nagyítási szintek és a Csemperács című témakört.
t
 query

string

A forgalom adott időpontban történő állapotának referenciaértéke, amely a Viewport API-hívásból, trafficModelId attribútumból származik a trafficState mezőben. Percenként frissül, és két percig érvényes, mielőtt túllépi az időkorlátot. A -1 használatával lekérheti a legfrissebb forgalmi adatokat. Alapértelmezett: a legutóbbi forgalmi adatok.

Kérelem fejléce

Name Kötelező Típus Description
x-ms-client-id

string

Meghatározza, hogy melyik fiók legyen a Microsoft Entra ID biztonsági modellel együtt használva. Ez az Azure Maps-fiók egyedi azonosítóját jelöli, amely az Azure Maps felügyeleti sík fiók API-jából kérhető le. A Microsoft Entra ID security Azure Mapsben való használatához az alábbi cikkek nyújtanak útmutatást.

Válaszok

Name Típus Description
200 OK

object

Ezt az objektumot egy sikeres forgalmi incidenscsempe-hívás adja vissza

Media Types: "application/json", "image/jpeg", "image/png", "image/pbf", "application/vnd.mapbox-vector-tile"

Fejlécek

Content-Type: string
Other Status Codes

ErrorResponse

Váratlan hiba történt.

Media Types: "application/json", "image/jpeg", "image/png", "image/pbf", "application/vnd.mapbox-vector-tile"

Biztonság

AADToken

Ezek a Microsoft Entra OAuth 2.0-folyamatok . Az Azure-beli szerepköralapú hozzáférés-vezérléssel párosítva szabályozható az Azure Maps REST API-khoz való hozzáférés. Az Azure szerepköralapú hozzáférés-vezérlése egy vagy több Azure Maps-erőforrásfiókhoz vagy alerőforráshoz való hozzáférés kijelölésére szolgál. Bármely felhasználó, csoport vagy szolgáltatásnév hozzáférést kaphat egy beépített szerepkörrel vagy egy vagy több Azure Maps REST API-ra vonatkozó engedélyből álló egyéni szerepkörrel.

A forgatókönyvek implementálásához javasoljuk, hogy tekintse meg a hitelesítési fogalmakat. Összefoglalva, ez a biztonsági definíció megoldást nyújt az alkalmazás(ok) adott API-k és hatókörök hozzáférés-vezérlésére képes objektumokon keresztüli modellezésére.

Jegyzetek

  • Ehhez a biztonsági definícióhoz a x-ms-client-id fejléc használatával kell jelezni, hogy az alkalmazás melyik Azure Maps-erőforráshoz kér hozzáférést. Ez a Maps management API-ból szerezhető be.

A Authorization URL az Azure nyilvános felhőpéldányára vonatkozik. A szuverén felhők egyedi engedélyezési URL-címekkel és Microsoft Entra ID-konfigurációkkal rendelkeznek. * Az Azure-beli szerepköralapú hozzáférés-vezérlés az Azure felügyeleti síkjáról van konfigurálva az Azure Portalon, a PowerShellen, a parancssori felületen, az Azure SDK-kon vagy REST API-kon keresztül. * Az Azure Maps Web SDK használata lehetővé teszi egy alkalmazás konfigurációalapú beállítását több használati esetben.

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

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

subscription-key

Ez egy megosztott kulcs, amely akkor lesz kiépítve, ha Azure Maps-fiókot hoz létre az Azure Portalon, vagy PowerShell, CLI, Azure SDK-k vagy REST API használatával.

Ezzel a kulccsal bármely alkalmazás hozzáférhet az összes REST API-hoz. Más szóval ez a kulcs használható főkulcsként abban a fiókban, amelyben ki vannak adva.

Nyilvánosan közzétett alkalmazások esetében javasoljuk, hogy a bizalmas ügyfélalkalmazások megközelítését használja az Azure Maps REST API-k eléréséhez, hogy a kulcs biztonságosan tárolható legyen.

Típus: apiKey
In: query

SAS Token

Ez egy közös hozzáférésű jogosultságkód-jogkivonat az Azure Maps-erőforrás Sas listázása műveletéből jön létre az Azure felügyeleti síkon keresztül az Azure Portalon, a PowerShellen, a parancssori felületen, az Azure SDK-kon vagy REST API-kon keresztül.

Ezzel a jogkivonattal minden alkalmazás jogosult hozzáférni az Azure szerepköralapú hozzáférés-vezérlőihez, valamint az adott jogkivonathoz használt lejárati időhöz, sebességhez és régióhoz. Más szóval az SAS-jogkivonattal az alkalmazások a megosztott kulcsnál biztonságosabb módon szabályozhatják a hozzáférést.

Nyilvánosan közzétett alkalmazások esetében javasoljuk, hogy konfiguráljon egy adott listát az engedélyezett forrásokról a térképfiók-erőforráson a leképezési visszaélések korlátozásához és az SAS-jogkivonat rendszeres megújításához.

Típus: apiKey
In: header

Példák

Request a tile depicting a traffic incident

Mintakérelem

GET https://atlas.microsoft.com/traffic/incident/tile/png?api-version=1.0&style=night&zoom=10&x=175&y=408

Mintaválasz

Állapotkód:
200 
{}

Definíciók

Name Description
ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.
ErrorDetail

A hiba részletei.
ErrorResponse

Hibaválasz
TileFormat

A válasz kívánt formátuma. A lehetséges értékek a png & pbf.
TrafficIncidentTileStyle

A csempe megjelenítéséhez használandó stílus. Ez a paraméter nem érvényes, ha a formátum pbf.

ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

Name Típus Description
info

object

A további információk.
type

string

A további adattípus.

ErrorDetail

A hiba részletei.

Name Típus Description
additionalInfo

ErrorAdditionalInfo[]

A hiba további információi.
code

string

A hibakód.
details

ErrorDetail[]

A hiba részletei.
message

string

A hibaüzenet.
target

string

A hiba célja.

ErrorResponse

Hibaválasz

Name Típus Description
error

ErrorDetail

A hibaobjektum.

TileFormat

A válasz kívánt formátuma. A lehetséges értékek a png & pbf.

Name Típus Description
pbf

string

Vektorgrafika pbf formátumban. Támogatja a 0 és 22 közötti nagyítási szinteket.
png

string

PNG formátumú kép. Támogatja a 0 és 18 közötti nagyítási szinteket.

TrafficIncidentTileStyle

A csempe megjelenítéséhez használandó stílus. Ez a paraméter nem érvényes, ha a formátum pbf.

Name Típus Description
night

string

Éjszakai stílus.
s1

string

Forgalmi vonalakat hoz létre a súlyosságot jelző színes sávnyílokkal.
s2

string

Egyszerű vonalakat hoz létre bizonyos mértékű ragyogással.
s3

string

Az s2 stílustól eltérő, bizonyos fokú ragyogással rendelkező egyszerű vonalakat hoz létre.