Render - Get Map Static Image

Toto rozhraní API pro vykreslování vytváří statická rastrová zobrazení mapy uživatelem definované oblasti. Je vhodný pro jednoduché webové aplikace, pokud požadované uživatelské prostředí nevyžaduje interaktivní ovládací prvky mapy nebo je-li šířka pásma omezená. Toto rozhraní API je také užitečné pro vkládání map do aplikací mimo prohlížeč, v back-endových službách, generování sestav nebo desktopových aplikacích.

Toto rozhraní API obsahuje parametry pro základní vizualizaci dat:

  • Popisky připínáků ve více stylech
  • Vykreslujte kruh, cestu a typy geometrie mnohoúhelníku.

Další informace a podrobné příklady najdete v tématu Vykreslení vlastních dat na rastrové mapě.

Rozměry parametru bboxu jsou omezené v závislosti na úrovni přiblížení. Tím zajistíte, že výsledný obrázek má odpovídající úroveň podrobností.

|Úroveň Zoom | Min Lon Range | Max Lon Range | Min Lat Range| Max Lat Range|

|:----------|:----------------|:----------------|:----------------|:-------------| |0 | 56,25 | 360,0 | 30.1105585173 | 180,0 | |1 | 28.125 | 360,0 | 14.87468995 | 180,0 | |2 | 14.063 | 351.5625 | 7.4130741851 | 137.9576312246 | |3 | 7.03125 | 175.78125 | 3.7034501005 | 73.6354071932 | |4 | 3.515625 | 87.890625 | 1.8513375155 | 35.4776115315 | |5 | 1.7578125 | 43.9453125 | 0,925620264 | 17.4589959239 | |6 | 0,87890625 | 21.97265625 | 0.4628040687 | 8.6907788223 | |7 | 0,439453125 | 10.986328125 | 0.2314012764 | 4.3404320789 | |8 | 0.2197265625 | 5.4931640625 | 0.1157005434 | 2.1695927024 | |9 | 0.1098632812 | 2.7465820312 | 0,0578502599 | 1.0847183194 | |10 | 0,0549316406 | 1.3732910156 | 0.0289251285 | 0,5423494021 | |11 | 0.0274658203 | 0,6866455078 | 0.014462564 | 0.2711734813 | |12 | 0.0137329102 | 0,3433227539 | 0,007231282 | 0,1355865882 | |13 | 0.0068664551 | 0.171661377 | 0.003615641 | 0.067793275 | |14 | 0.0034332275 | 0,0858306885 | 0.0018078205 | 0.0338966351 | |15 | 0.0017166138 | 0,0429153442 | 0.0009039102 | 0.0169483173 | |16 | 0,0008583069 | 0.0214576721 | 0.0004519551 | 0,0084741586 | |17 | 0.0004291534 | 0.0107288361 | 0.0002259776 | 0.0042370793 | |18 | 0.0002145767 | 0.005364418 | 0.0001129888 | 0.0021185396 | |19 | 0.0001072884 | 0.002682209 | 5.64944E-05 | 0.0010592698 | |20 | 5.36442E-05 | 0.0013411045 | 2.82472E-05 | 0.0005296349 |

Poznámka: Do rozhraní API musí být zadán střed nebo bbox parametr.

GET {endpoint}/map/static?api-version=2024-04-01
GET {endpoint}/map/static?api-version=2024-04-01&tilesetId={tilesetId}&trafficLayer={trafficLayer}&zoom={zoom}&center={center}&bbox={bbox}&height={height}&width={width}&language={language}&view={view}&pins={pins}&path={path}

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
endpoint
path True

string (uri)

Hostname služby Azure Maps. Použijte https://atlas.microsoft.com pro Azure veřejný cloud. Pro cílení na konkrétní Azure Maps geografii nebo suverénní cloud viz Azure Maps geografický rozsah.

api-version
query True

string

minLength: 1

Verze rozhraní API, která se má použít pro tuto operaci.

bbox
query

number[]

Ohraničující rámeček je definován dvěma zeměpisnými šířkami a dvěma délkami, které představují čtyři strany obdélníkové oblasti na Zemi. Formát: "minLon, minLat, maxLon, maxLat" (ve dvou).

Poznámka: Požadované parametry jsou bbox nebo střed. Vzájemně se vylučují. Bbox by neměl být použit s výškou ani šířkou.

Maximální a minimální povolené rozsahy pro Lat a Lon jsou definovány pro každou úroveň přiblížení v tabulce v horní části této stránky.

center
query

number[]

Souřadnice středového bodu ve dvou. Formát: 'lon,lat'. Zeměpisná délka: -180 až 180. Rozsah zeměpisné šířky: -90 až 90.

Poznámka: Požadované parametry jsou buď uprostřed, nebo bbox. Vzájemně se vylučují.

height
query

integer (int32)

minimum: 80
maximum: 1500

Výška výsledného obrázku v pixelech Rozsah od 80 do 1500. Výchozí hodnota je 512. Nemělo by se používat s bboxem.

language
query

string

Jazyk, ve kterém mají být vráceny výsledky hledání. Měla by být jednou z podporovaných značek jazyka IETF, nerozlišují se malá a velká písmena. Pokud data v zadaném jazyce nejsou pro konkrétní pole dostupná, použije se výchozí jazyk.

Podrobnosti najdete v podporovaných jazycích.

path
query

string[]

Styl cesty a umístění (ve dvou). Pomocí tohoto parametru můžete do obrázku volitelně přidat čáry, mnohoúhelníky nebo kruhy. Styl cesty popisuje vzhled čáry a výplně. (Nezapomeňte správně kódovat adresy URL hodnoty tohoto parametru, protože bude obsahovat rezervované znaky, jako jsou kanály a interpunkce.)

Parametr path je podporován v účtu Azure Maps SKU od S1. Více instancí parametru cesty umožňuje zadat více geometrií s jejich styly. Počet parametrů na požadavek je omezený na 10 a počet umístění je omezený na 100 na cestu.

Pokud chcete vykreslit kruh s poloměrem 100 metrů a středovým bodem v zeměpisné šířce 45°N a délce 122°W pomocí výchozího stylu, přidejte parametr řetězce dotazu.

path=ra100||-122 45

Všimněte si, že zeměpisná délka předchází zeměpisné šířce. Po kódování adresy URL bude vypadat takto:

path=ra100%7C%7C-122+45

Všechny zde uvedené příklady ukazují parametr cesty bez kódování adresy URL, aby bylo jasné.

Pokud chcete vykreslit čáru, oddělte každé umístění znakem svislé čáry. Například použijte

path=||-122 45|-119.5 43.2|-121.67 47.12

Mnohoúhelník je určen uzavřenou cestou, kde jsou první a poslední body stejné. Například použijte

path=||-122 45|-119.5 43.2|-121.67 47.12|-122 45

Zeměpisná délka pro umístění čar a mnohoúhelníku může být v rozsahu od -360 do 360, aby bylo možné vykreslovat geometrie překračující anti-meridian.

Modifikátory stylu

Vzhled cesty můžete upravit přidáním modifikátorů stylu. Ty se přidají před umístění. Modifikátory stylu mají každý název se dvěma písmeny. Tyto zkrácené názvy slouží ke snížení délky adresy URL.

Pokud chcete změnit barvu obrysu, použijte modifikátor stylu "lc" a zadejte barvu pomocí barevného formátu HTML/CSS RGB, což je šesticiferné šestnáctkové číslo (třímístný formulář není podporován). Pokud chcete například použít hlubokou růžovou barvu, kterou byste zadali jako #FF1493 v šabloně stylů CSS, použijte

path=lcFF1493||-122 45|-119.5 43.2

K vytvoření složitějšího vizuálního stylu lze kombinovat více modifikátorů stylu.

lc0000FF|lw3|la0.60|fa0.50||-122.2 47.6|-122.2 47.7|-122.3 47.7|-122.3 47.6|-122.2 47.6

Souhrn modifikátoru stylu

Modifikátor Description Typ Rozmezí
Lc Barva čáry řetězec 000000 až FFFFFF
fc Barva výplně řetězec 000000 až FFFFFF
la Čára alfa (neprůhlednost) float 0 až 1
fa Výplň alfa (neprůhlednost) float 0 až 1
Lw Šířka čáry int32 (0, 50]
Ra Poloměr kruhu (měřiče) float Větší než 0
pins
query

string[]

Styl a instance připínáku. Tento parametr použijte k volitelnému přidání připínáků do image. Styl připínáčku popisuje vzhled připínáčku a instance určují souřadnice připínáčku (v dvojitém) a volitelné popisky pro každý kolík. (Nezapomeňte správně kódovat adresy URL hodnoty tohoto parametru, protože bude obsahovat rezervované znaky, jako jsou kanály a interpunkce.)

S0 SKU účtu Azure Maps podporuje pouze jednu instanci parametru pinů a počet míst je omezen na 5 na pin. Ostatní skladové položky umožňují zadat více stylů špendlíků až 25 instancí parametru pinů a počet umístění je omezený na 50 míst na špendlík.

Pokud chcete vykreslit připínák v zeměpisné šířce 45°N a délce 122°W pomocí výchozího integrovaného stylu připnutí, přidejte parametr řetězce dotazu.

pins=default||-122 45

Všimněte si, že zeměpisná délka předchází zeměpisné šířce. Po kódování adresy URL bude vypadat takto:

pins=default%7C%7C-122+45

Všechny zde uvedené příklady ukazují parametr špendlíků bez kódování adresy URL, aby bylo jasné.

Pokud chcete vykreslit špendlík na více místech, oddělte každé umístění znakem svislé roury. Například použijte

pins=default||-122 45|-119.5 43.2|-121.67 47.12

Účet S0 Azure Maps SKU umožňuje pouze pět pushpinů. Jiné skladové položky účtu toto omezení nemají.

Modifikátory stylu

Vzhled špendlíků můžete upravit přidáním modifikátorů stylu. Ty se přidají za styl, ale před umístění a popisky. Modifikátory stylu mají každý název se dvěma písmeny. Tyto zkrácené názvy slouží ke snížení délky adresy URL.

Pokud chcete změnit barvu připínáku, použijte modifikátor stylu "co" a zadejte barvu pomocí barevného formátu HTML/CSS RGB, což je šesticiferné šestnáctkové číslo (tříciferný formulář není podporován). Pokud chcete například použít hlubokou růžovou barvu, kterou byste zadali jako #FF1493 v šabloně stylů CSS, použijte

pins=default|coFF1493||-122 45

Popisky připínáku

Pokud chcete k špendlíkům přidat popisek, vložte ho do jednoduchých uvozovek těsně před souřadnice. Nepoužívejte speciální znak, například | nebo || v popisku. Pokud chcete například označit tři špendlíky s hodnotami 1, 2 a 3, použijte

pins=default||'1'-122 45|'2'-119.5 43.2|'3'-121.67 47.12

K dispozici je integrovaný styl připínáku s názvem none, který nezobrazuje obrázek připínáku. Tuto možnost můžete použít, pokud chcete zobrazit popisky bez připnutí obrázku. Příklad:

pins=none||'A'-122 45|'B'-119.5 43.2

Pokud chcete změnit barvu popisků připínáku, použijte modifikátor stylu barvy popisku "lc". Pokud chcete například použít růžové připínáky s černými štítky, použijte

pins=default|coFF1493|lc000000||-122 45

Pokud chcete změnit velikost popisků, použijte modifikátor stylu velikosti popisku "ls". Velikost popisku představuje přibližnou výšku textu popisku v pixelech. Pokud chcete například zvětšit velikost popisku na 12, použijte

pins=default|ls12||'A'-122 45|'B'-119 43

Popisky se zacentrují na připínáč "ukotvení popisku". Umístění ukotvení je předdefinované pro předdefinované připínáky a je v horní části vlastního připínáku (viz níže). Pokud chcete přepsat ukotvení popisku, použijte modifikátor stylu "la" a zadejte souřadnice X a Y pixelů pro ukotvení. Tyto souřadnice jsou relativní vzhledem k levému hornímu rohu obrázku připnutí. Kladné hodnoty X přesunou ukotvení doprava a kladné hodnoty Y přesunou ukotvení dolů. Pokud chcete například umístit ukotvení popisku o 10 pixelů doprava a 4 pixely nad levým horním rohem obrázku připínáčku, použijte

pins=default|la10 -4||'A'-122 45|'B'-119 43

Vlastní připínáky

Pokud chcete použít vlastní obrázek připínáčku, použijte jako název stylu připnutí slovo "vlastní" a za informace o umístění a popisku zadejte adresu URL. Maximální povolená velikost obrázku přizpůsobeného štítku je 65 536 pixelů. Použijte dva znaky svislé znaky k označení, že jste dokončili zadávání umístění a spouštíte adresu URL. Příklad:

pins=custom||-122 45||http://contoso.com/pushpins/red.png

Po kódování adresy URL by to vypadalo takto:

pins=custom%7C%7C-122+45%7C%7Chttp%3A%2F%2Fcontoso.com%2Fpushpins%2Fred.png

Ve výchozím nastavení jsou vlastní obrázky připínáčku nakreslené na střed na souřadnicích kolíku. Obvykle to není ideální, protože zakrývá umístění, které se snažíte zvýraznit. Pokud chcete přepsat umístění ukotvení obrázku špendlíku, použijte modifikátor stylu "an". Používá se stejný formát jako modifikátor stylu ukotvení popisku "la". Pokud má například obrázek vlastního špendlíku v levém horním rohu obrázku špičku, můžete ukotvení nastavit na toto místo pomocí příkazu .

pins=custom|an0 0||-122 45||http://contoso.com/pushpins/red.png

Poznámka: Pokud použijete modifikátor barev "co" s vlastním obrázkem připnutí, zadaná barva nahradí kanály RGB pixelů na obrázku, ale ponechá alfa (neprůhledný) kanál beze změny. Obvykle by se to provádělo jenom s vlastním obrázkem s plnou barvou.

Škálování, otočení a neprůhlednost

Pomocí modifikátoru stylu měřítka sc můžete zvětšit nebo zmenšit popisky a jejich popisky. Jedná se o hodnotu větší než nula. Hodnota 1 je standardní měřítko. Hodnoty větší než 1 zvětší špendlíky a hodnoty menší než 1 je zmenší. Pokud chcete například nakreslit čepy 50% větší než normální, použijte

pins=default|sc1.5||-122 45

Pomocí modifikátoru stylu otočení "ro" můžete otočit připínáče a jejich popisky. Jedná se o řadu stupňů otočení po směru hodinových ručiček. K otočení proti směru hodinových ručiček použijte záporné číslo. Pokud chcete například otočit připínáky o 90 stupňů po směru hodinových ručiček a zdvojnásobit jejich velikost, použijte

pins=default|ro90|sc2||-122 45

Pomocí modifikátoru alfa "al" můžete nastavit částečně průhledné připínáky a jejich popisky. Jedná se o číslo v rozmezí od 0 do 1 označující neprůhlednost připínáku. Nula z nich dělá zcela průhledné (a není viditelné) a 1 je zcela neprůhledné (což je výchozí nastavení). Pokud například chcete, aby se připínáky a jejich popisky používaly pouze 67% neprůrůznamné, použijte

pins=default|al.67||-122 45

Souhrn modifikátoru stylu

Modifikátor Description Typ Rozmezí
hliník Alfa (neprůhlednost) float 0 až 1
an Připnout ukotvení <int32, int32> *
co Barva pinu řetězec 000000 až FFFFFF
la Ukotvení popisku <int32, int32> *
Lc Barva popisku řetězec 000000 až FFFFFF
ls Velikost popisku float Větší než 0
ro Rotace float -360 až 360
sc Scale float Větší než 0
  • Souřadnice X a Y můžou být kdekoli v rámci připnutí obrázku nebo okraje kolem něj. Velikost okraje je minimální šířka a výška kolíku.
tilesetId
query

Tileset

Styl mapy, který se má vrátit Možné hodnoty jsou microsoft.base.road, microsoft.base.darkgrey a microsoft.imagery. Výchozí hodnota je nastavená na microsoft.base.road. Další informace najdete v tématu Vykreslit id sady dlaždic.

trafficLayer
query

TrafficTilesetId

Nepovinná hodnota označující, že výsledek obrázku nepřekryje žádný tok provozu. Možné hodnoty jsou microsoft.traffic.relative.main a žádné. Výchozí hodnota není žádná, což znamená, že se nevrátí žádný tok provozu. Pokud je k dispozici id sady dlaždic souvisejících s provozem, vrátí se obrázek mapy s odpovídající vrstvou provozu. Další informace najdete v tématu Vykreslit id sady dlaždic.

view
query

LocalizedMapView

Parametr Zobrazení (označovaný také jako parametr "oblast uživatele") umožňuje zobrazit správné mapy pro určitou zemi nebo oblast pro geopolitické sporné oblasti. Různé země/oblasti mají různá zobrazení těchto oblastí a parametr View umožňuje vaší aplikaci dodržovat zobrazení vyžadované zemí nebo oblastí, kterou bude vaše aplikace obsluhovat. Ve výchozím nastavení je parametr View nastavený na Sjednocený, i když jste ho v požadavku nedefinovali. Je vaší zodpovědností určit umístění uživatelů a pak nastavit parametr View správně pro dané umístění. Alternativně máte možnost nastavit View=Auto, která vrátí mapová data na základě IP adresy požadavku. Parametr Zobrazit v Azure Maps musí být používán v souladu s platnými zákony, včetně těch týkajících se mapování, země/regionu, kde jsou mapy, obrázky a další data a obsah třetích stran, ke kterým máte oprávnění přistupovat prostřednictvím Azure Maps, zpřístupněn. Příklad: view=IN.

Podrobnosti a dostupné zobrazení najdete v podporovaných zobrazeních.

width
query

integer (int32)

minimum: 80
maximum: 2000

Šířka výsledného obrázku v pixelech Rozsah od 80 do 2000. Výchozí hodnota je 512. Neměl by se používat s bboxem.

zoom
query

integer (int32)

maximum: 20

Požadovaná úroveň přiblížení mapy. Podpora rozsahu hodnot zvětšení od 0 do 20 (včetně) pro tilesetId je microsoft.base.road nebo microsoft.base.darkgrey. Podpora rozsahu hodnot přiblížení od 0 do 19 (včetně) pro tilesetId je microsoft.imagery. Výchozí hodnota je 12.

Další informace najdete v tématu úrovně přiblížení a mřížky dlaždic.

Hlavička požadavku

Name Vyžadováno Typ Description
x-ms-client-id

string

Označuje účet určený pro použití s bezpečnostním modelem Microsoft Entra ID. Toto jedinečné ID pro účet Azure Maps lze získat z API účtu Azure Maps management plane. Pro více informací o používání Microsoft Entra ID bezpečnosti v Azure Maps viz Spravovat autentizaci v Azure Maps.

Accept

MediaType

Pole záhlaví Accept lze použít k určení předvoleb týkajících se typů médií odpovědí. Mezi povolené typy médií patří image/jpeg a image/png. Vraťte obrázek do image/png, pokud není zadáno záhlaví Přijmout.

Odpovědi

Name Typ Description
200 OK

file

Požadavek byl úspěšný.

Media Types: "image/png", "image/jpeg", "application/json"

Other Status Codes

ErrorResponse

Neočekávaná chybová odpověď

Media Types: "image/png", "image/jpeg", "application/json"

Zabezpečení

AadToken

Jsou to Microsoft Entra OAuth 2.0 Flows. V kombinaci s Azure řízením přístupu založeného na rolích lze použít k řízení přístupu k Azure Maps REST API. Role Azure kontroly přístupu se používají k určení přístupu k jednomu nebo více účtům nebo podzdrojů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.

Note

  • 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. To lze získat z rozhraní API pro správu Maps.
  • Authorization URL je specifická pro instanci veřejného cloudu Azure. Suverénní cloudy mají unikátní autorizační URL 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

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: header

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

Successful Static Image Request

Ukázkový požadavek

GET https://atlas.microsoft.com/map/static?api-version=2024-04-01&tilesetId=microsoft.base.road&zoom=10&center=-122.177621,47.613079

Ukázková odpověď

Content-Type: image/png
"{file}"

Definice

Name Description
ErrorAdditionalInfo

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

ErrorDetail

Podrobnosti o chybě.

ErrorResponse

Běžná chybová odpověď pro všechna API Azure Resource Manager pro vrácení chybových údajů o neúspěšných operacích. (To se také řídí formátem odpovědi na chybu OData.)

LocalizedMapView

Parametr Zobrazení (označovaný také jako parametr "oblast uživatele") umožňuje zobrazit správné mapy pro určitou zemi nebo oblast pro geopolitické sporné oblasti. Různé země/oblasti mají různá zobrazení těchto oblastí a parametr View umožňuje vaší aplikaci dodržovat zobrazení vyžadované zemí nebo oblastí, kterou bude vaše aplikace obsluhovat. Ve výchozím nastavení je parametr View nastavený na Sjednocený, i když jste ho v požadavku nedefinovali. Je vaší zodpovědností určit umístění uživatelů a pak nastavit parametr View správně pro dané umístění. Alternativně máte možnost nastavit View=Auto, která vrátí mapová data na základě IP adresy požadavku. Parametr Zobrazit v Azure Maps musí být používán v souladu s platnými zákony, včetně těch týkajících se mapování, země/regionu, kde jsou mapy, obrázky a další data a obsah třetích stran, ke kterým máte oprávnění přistupovat prostřednictvím Azure Maps, zpřístupněn. Příklad: view=IN.

Podrobnosti a dostupné zobrazení najdete v podporovaných zobrazeních.

MediaType

Požadovaný typ média odpovědi.

Tileset

Sada dlaždic je kolekce rastrových nebo vektorových dat rozdělených do jednotné mřížky čtvercových dlaždic na přednastavených úrovních přiblížení. Každá sada dlaždic má tilesetId použít při provádění požadavků. Připravené tilesety dodané Azure Maps jsou uvedeny níže. Například microsoft.base.

TrafficTilesetId

Hodnota označující netok provozu je překryta na výsledku obrázku.

ErrorAdditionalInfo

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

Name Typ Description
info

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

Běžná chybová odpověď pro všechna API Azure Resource Manager pro vrácení chybových údajů o neúspěšných operacích. (To se také řídí formátem odpovědi na chybu OData.)

Name Typ Description
error

ErrorDetail

Objekt chyby.

LocalizedMapView

Parametr Zobrazení (označovaný také jako parametr "oblast uživatele") umožňuje zobrazit správné mapy pro určitou zemi nebo oblast pro geopolitické sporné oblasti. Různé země/oblasti mají různá zobrazení těchto oblastí a parametr View umožňuje vaší aplikaci dodržovat zobrazení vyžadované zemí nebo oblastí, kterou bude vaše aplikace obsluhovat. Ve výchozím nastavení je parametr View nastavený na Sjednocený, i když jste ho v požadavku nedefinovali. Je vaší zodpovědností určit umístění uživatelů a pak nastavit parametr View správně pro dané umístění. Alternativně máte možnost nastavit View=Auto, která vrátí mapová data na základě IP adresy požadavku. Parametr Zobrazit v Azure Maps musí být používán v souladu s platnými zákony, včetně těch týkajících se mapování, země/regionu, kde jsou mapy, obrázky a další data a obsah třetích stran, ke kterým máte oprávnění přistupovat prostřednictvím Azure Maps, zpřístupněn. Příklad: view=IN.

Podrobnosti a dostupné zobrazení najdete v podporovaných zobrazeních.

Hodnota Description
AE

Spojené arabské emiráty (zobrazení arabštiny)

AR

Argentina (argentinský pohled)

BH

Arabština (zobrazení arabštiny)

IN

Indie (indické zobrazení)

IQ

Irák (arabské zobrazení)

JO

Jordánsko (arabské zobrazení)

KW

Kuvajt (arabské zobrazení)

LB

Libanon (zobrazení arabštiny)

MA

Maroko (marocký pohled)

OM

Omán (zobrazení arabštiny)

PK

Pákistán (pákistánské zobrazení)

PS

Palestinská autorita (arabské zobrazení)

QA

Katar (zobrazení arabštiny)

SA

Saúdská Arábie (zobrazení arabštiny)

SY

Sýrie (zobrazení arabštiny)

US

Spojené státy americké

YE

Jemen (arabské zobrazení)

Auto

Vrátí data mapy na základě IP adresy požadavku.

Unified

Jednotné zobrazení (ostatní)

MediaType

Požadovaný typ média odpovědi.

Hodnota Description
image/png

Návratový obrázek ve formátu PNG.

image/jpeg

Návratový obrázek ve formátu jpeg.

Tileset

Sada dlaždic je kolekce rastrových nebo vektorových dat rozdělených do jednotné mřížky čtvercových dlaždic na přednastavených úrovních přiblížení. Každá sada dlaždic má tilesetId použít při provádění požadavků. Připravené tilesety dodané Azure Maps jsou uvedeny níže. Například microsoft.base.

Hodnota Description
microsoft.base.road

microsoft.base.road

microsoft.base.darkgrey

microsoft.base.darkgrey

microsoft.imagery

microsoft.imagery

TrafficTilesetId

Hodnota označující netok provozu je překryta na výsledku obrázku.

Hodnota Description
microsoft.traffic.relative.main

Podporovaný provoz související s tilesetId.

none

Výchozí hodnota, žádné překrytí toku provozu.