Traffic - Get Traffic Flow Tile

Služba:

Maps

Verze rozhraní API:

1.0

Umožňuje získat dlaždice o rozměrech 256 × 256 pixelů zobrazující tok provozu.

Poznámka:

Vyřazení služby Azure Maps Traffic v1

Služba Azure Maps Traffic v1 je nyní zastaralá a bude vyřazena 31. 3. 28. Aby nedocházelo k přerušení služby, bude nutné všechna volání služby Traffic v1 aktualizovat do 31.3.28. Další informace najdete v tématu Migrace rozhraní API Azure Maps Traffic 1.0.

Rozhraní API Traffic Flow Tile je požadavek HTTP GET, který vrací informace o provozních podmínkách v reálném čase v dlaždicích 256 x 256 pixelů, které zobrazují tok provozu. Všechny dlaždice používají stejný systém mřížky. Vzhledem k tomu, že dlaždice provozu používají průhledné obrázky, dají se vrstvit nad dlaždicemi mapy a vytvořit složený displej. Dlaždice Flow používají barvy k označení rychlosti provozu v různých segmentech silničního provozu nebo rozdílu mezi danou rychlostí a rychlostí volného toku v daném segmentu silnice.

GET https://atlas.microsoft.com/traffic/flow/tile/{format}?api-version=1.0&style={style}&zoom={zoom}&x={x}&y={y}

S volitelnými parametry:

GET https://atlas.microsoft.com/traffic/flow/tile/{format}?api-version=1.0&style={style}&zoom={zoom}&x={x}&y={y}&thickness={thickness}

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
format	path	True	TileFormat	Požadovaný formát odpovědi Možné hodnoty jsou png & pbf.
api-version	query	True	string	Číslo verze rozhraní API služby Azure Maps
style	query	True	TrafficFlowTileStyle	Styl, který se má použít k vykreslení dlaždice.
x	query	True	integer (int32)	Souřadnice X dlaždice v mřížce lupy Hodnota musí být v rozsahu [0, 2zoom -1]. Podrobnosti najdete v tématu úrovně přiblížení a mřížky dlaždic.
y	query	True	integer (int32)	Souřadnice Y dlaždice v mřížce lupy Hodnota musí být v rozsahu [0, 2zoom -1]. Podrobnosti najdete v tématu úrovně přiblížení a mřížky dlaždic.
zoom	query	True	integer (int32)	Úroveň přiblížení požadované dlaždice U rastrových dlaždic musí být hodnota v rozsahu: 0–22 (včetně). U vektorových dlaždic musí být hodnota v rozsahu: 0–22 (včetně). Podrobnosti najdete v tématu úrovně přiblížení a mřížky dlaždic.
thickness	query		integer (int32) minimum: 1 maximum: 20	Hodnota šířky čáry představující provoz. Tato hodnota je násobitel a přijímané hodnoty jsou v rozsahu od 1 do 20. Výchozí hodnota je 10. Tento parametr není platný, pokud je formát pbf.

Hlavička požadavku

Name	Vyžadováno	Typ	Description
x-ms-client-id		string	Označuje účet určený pro použití s modelem zabezpečení Microsoft Entra ID. Toto jedinečné ID pro účet Azure Maps lze získat z rozhraní API účtu roviny správy Azure Maps. Další informace o používání zabezpečení Microsoft Entra ID v Azure Maps najdete v tématu Správa ověřování v Azure Maps.

Odpovědi

Name	Typ	Description
200 OK	object	Tato image se vrátí z úspěšného volání dlaždice toku provozu. Media Types: "application/json", "image/jpeg", "image/png", "image/pbf", "application/vnd.mapbox-vector-tile" Hlavičky Content-Type: string
Other Status Codes	ErrorResponse	Došlo k neočekávané chybě. Media Types: "application/json", "image/jpeg", "image/png", "image/pbf", "application/vnd.mapbox-vector-tile"

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 tile depicting the traffic flow

Ukázkový požadavek

HTTP

GET https://atlas.microsoft.com/traffic/flow/tile/png?api-version=1.0&style=absolute&zoom=12&x=2044&y=1360

Ukázková odpověď

Stavový kód:

200

"binary string image"

Definice

Name	Description
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď
TileFormat	Požadovaný formát odpovědi Možné hodnoty jsou png & pbf.
TrafficFlowTileStyle	Styl, který se má použít k vykreslení dlaždice.

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.

TileFormat

Výčet

Požadovaný formát odpovědi Možné hodnoty jsou png & pbf.

Hodnota	Description
png	Obrázek ve formátu png. Podporuje úrovně přiblížení 0 až 18.
pbf	Vektorová grafika ve formátu pbf Podporuje úrovně přiblížení 0 až 22.

TrafficFlowTileStyle

Výčet

Styl, který se má použít k vykreslení dlaždice.

Hodnota	Description
absolute	Barvy budou odrážet absolutní naměřenou rychlost. Absolutní rychlost je schopnost přistupovat k plné rychlosti.
relative	To je rychlost vzhledem k volnému toku a zvýrazňuje oblasti zahlcení vizualizací toku provozu. Volný tok odkazuje na podmínky, kdy nedojde k zahlcení a provoz může dodržovat limity rychlosti. Nejčastěji se používá možnost vizualizace toku provozu na mapě.
relative-delay	Zobrazí relativní barvy pouze tam, kde se liší od rychlosti volného toku. Tato možnost pouze zvýrazní oblasti zahlcení.
reduced-sensitivity	Zobrazí relativní barvy, ale větší rozdíl od volného toku je nutný pro změnu barvy segmentů. Tento režim je platný pouze v případě, že je formát png.