Traffic - Get Traffic Flow Tile

  • Reference
Service:
Maps
API Version:
1.0

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

Rozhraní Traffic Flow Tile API je požadavek HTTP GET , který vrací informace o podmínkách provozu v reálném čase na dlaždicích o rozměrech 256 × 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, je možné je vrstvit na dlaždicích map a vytvořit tak složené zobrazení. Dlaždice Flow používají barvy k označení buď rychlosti provozu v různých segmentech silnic, nebo rozdílu mezi danou rychlostí a rychlostí volného toku v daném segmentu silnic.

GET https://atlas.microsoft.com/traffic/flow/tile/{format}?api-version=1.0&style={style}&zoom={zoom}&x={x}&y={y}
With optional parameters: 
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 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řížka 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řížka 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řížka dlaždic .
thickness
 query

integer

int32

Hodnota šířky čáry představující provoz. Tato hodnota je násobitel a přijaté 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

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 Azure Maps roviny správy. Pokud chcete použít zabezpečení Microsoft Entra ID v Azure Maps pokyny najdete v následujících článcích.

Odpovědi

Name Typ Description
200 OK

object

Tento obrázek 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"

Headers

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

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, která se skládá 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 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í Azure Maps prostředku, 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 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í.

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 vytvoření úč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 tile depicting the traffic flow

Sample Request

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

Sample Response

Status code:
200 
"binary string image"

Definice

Name Description
ErrorAdditionalInfo

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

Podrobnosti o chybě.
ErrorResponse

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

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.

TileFormat

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

Name Typ Description
pbf

string

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

string

Obrázek ve formátu png. Podporuje úrovně přiblížení 0 až 18.

TrafficFlowTileStyle

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

Name Typ Description
absolute

string

Barvy budou odrážet absolutní naměřenou rychlost. Absolutní rychlost je schopnost přístupu k plné rychlosti.
reduced-sensitivity

string

Zobrazí relativní barvy, ale k tomu, aby segmenty měnily barvu, vyžaduje větší rozdíl od volného toku. Tento režim platí jenom v případě, že je formát png.
relative

string

Jedná se o rychlost vzhledem k volnému toku, která zvýrazňuje oblasti zahlcení a vizualizuje tok provozu. Volný tok označuje podmínky, kdy nedochází k zahlcení a provoz může dodržovat rychlostní limity. Nejpoužívanější možnost pro vizualizaci toku provozu na mapě
relative-delay

string

Zobrazí relativní barvy jenom tam, kde se liší od rychlosti volného toku. Tato možnost zvýrazní pouze oblasti zahlcení.