Render - Get Map Static Image

Služba:

Maps

Verze rozhraní API:

2024-04-01

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

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

• Připínáky jsou označené několika styly.
• Vykreslovat typy geometrie kruhu, dráhy a mnohoúhelníku.

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

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

Úroveň přiblížení	Minimální rozsah lonů	Max Lon Range	Minimální rozsah lat	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 : Rozhraní API musí být zadán parametr center nebo bbox .

GET https://atlas.microsoft.com/map/static?api-version=2024-04-01

S volitelnými parametry:

GET https://atlas.microsoft.com/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
api-version	query	True	string	Číslo verze rozhraní API služby Azure Maps Aktuální verze je 2024-04-01.
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' (v double). Poznámka: Požadované parametry jsou bbox nebo center. Vzájemně se vylučují. bbox by se neměl používat s výškou nebo šířkou. Maximální a minimální povolený rozsah 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 v double. Formát: 'lon,lat'. Rozsah zeměpisné délky: -180 až 180. Rozsah zeměpisné šířky: -90 až 90. Poznámka: Požadované parametry jsou střed nebo bbox. Vzájemně se vylučují.
height	query		integer int32	Výška výsledného obrázku v pixelech Rozsah od 80 do 1500. Výchozí hodnota je 512. Neměl by se používat s bboxem.
language	query		string	Jazyk, ve kterém se mají vrátit výsledky hledání. Měl 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 k dispozici, použije se výchozí jazyk. Podrobnosti najdete v části Podporované jazyky .
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ě zakódovat hodnoty url tohoto parametru, protože bude obsahovat vyhrazené znaky, jako jsou kanály a interpunkční znaména.) Parametr path se podporuje ve skladové položce účtu Azure Maps počínaje S1. Více instancí parametru path umožňuje zadat více geometrií pomocí jejich stylů. 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 na zeměpisné šířce 45°S a délkou 122°W pomocí výchozího stylu, přidejte parametr řetězce dotazů. 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 to bude vypadat takto: path=ra100%7C%7C-122+45 Všechny zde uvedené příklady pro přehlednost zobrazují parametr path bez kódování URL. Pokud chcete vykreslit čáru, oddělte každé umístění znakem čáry. Použijte například path=||-122 45|-119.5 43.2|-121.67 47.12 Mnohoúhelník je zadán s uzavřenou cestou, kde je první a poslední bod roven. Použijte například path=||-122 45|-119.5 43.2|-121.67 47.12|-122 45 Hodnota zeměpisné délky 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 meridián. 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ý dvoumísmenný název. Tyto zkrácené názvy pomáhají zkrátit délku adresy URL. Pokud chcete změnit barvu obrysu, použijte modifikátor stylu lc a určete barvu pomocí barevného formátu HTML/CSS RGB, což je šestimístné šestnáctkové číslo (třímístný formulář není podporován). Pokud chcete například použít tmavě růžovou barvu, kterou byste zadali jako #FF1493 v šablonách stylů CSS, použijte path=lcFF1493||-122 45|-119.5 43.2 Kombinací více modifikátorů stylu lze vytvořit složitější vizuální styl. 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 Popis Typ Rozsah Lc Barva čáry řetězec 000000 až FFFFFF Fc Barva výplně řetězec 000000 až FFFFFF předložka z francouzštiny Alfa čáry (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 (v metrech) float Větší než 0
pins	query		string[]	Styl a instance připínáčků. 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áčků a instance určují souřadnice připínáčků (dvojitě) a volitelné popisky pro každý špendlík. (Nezapomeňte správně zakódovat hodnoty adresy URL tohoto parametru, protože bude obsahovat vyhrazené znaky, jako jsou například kanály a interpunkční znaména.) Skladová položka účtu Azure Maps S0 podporuje pouze jednu instanci parametru pins. Jiné skladové položky umožňují více instancím parametru pins zadat více stylů připnutí. Pokud chcete vykreslit připínáčko při 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 to bude vypadat takto: pins=default%7C%7C-122+45 Ve všech zde uvedených příkladech se kvůli přehlednosti zobrazuje parametr pins bez kódování adresy URL. Pokud chcete vykreslit špendlík na více místech, oddělte každé umístění znakem svislé čáry. Například použijte pins=default||-122 45|-119.5 43.2|-121.67 47.12 Skladová položka účtu Azure Maps S0 umožňuje pouze pět připínáčků. Jiné skladové položky účtů 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í název se dvěma písmeny. Tyto zkrácené názvy pomáhají zkrátit délku 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 šestimístné šestnáctkové číslo (třímístná forma není podporována). Pokud chcete například použít tmavě růžovou barvu, kterou byste zadali jako #FF1493 v šablonách stylů CSS, použijte pins=default|coFF1493||-122 45 Popisky připínáčků Pokud chcete přidat popisek do špendlíků, 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 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. Třeba 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 popisky, 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 například chcete zvětšit velikost popisku na 12, použijte pins=default|ls12||'A'-122 45|'B'-119 43 Popisky jsou na středu připínáčku "ukotvení popisku". Umístění ukotvení je předdefinované pro předdefinované připínáky a je ve středu horní části vlastních připínáčků (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řipínáčku. Kladné hodnoty X posunou ukotvení doprava a kladné hodnoty Y posunou ukotvení dolů. Pokud chcete například umístit ukotvení popisků o 10 pixelů doprava a 4 pixely nad levý horní roh 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, jako název stylu připnutí použijte slovo "vlastní" a za informacemi o umístění a popisku zadejte adresu URL. Maximální povolená velikost pro přizpůsobený obrázek štítku je 65 536 pixelů. Pomocí dvou znaků svislé roury označte, že jste dokončili zadávání umístění a že začínáte adresu URL. Třeba 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í se vlastní obrázky připnutí nakreslují na střed na souřadnicích špendlíku. To obvykle není ideální, protože zakrývá umístění, které se pokoušíte zvýraznit. Pokud chcete přepsat umístění ukotvení obrázku připnutí, použijte modifikátor stylu "an". Používá se stejný formát jako modifikátor stylu ukotvení popisku "la". Pokud má například váš vlastní obrázek špendlíku špičku špendlíku v levém horním rohu obrázku, můžete na toto místo nastavit ukotvení pomocí pins=custom|an0 0||-122 45||http://contoso.com/pushpins/red.png Poznámka: Pokud použijete modifikátor barvy "co" s vlastním obrázkem připnutí, zadaná barva nahradí kanály RGB pixelů v obrázku, ale ponechá kanál alfa (neprůhlednost) beze změny. To se obvykle provádí pouze s vlastním obrázkem v plné barvě. Škálování, otočení a neprůhlednost Připínáky a jejich popisky můžete zvětšit nebo zmenšit pomocí modifikátoru stylu "sc". Jedná se o hodnotu větší než nula. Standardní měřítko je hodnota 1. Hodnoty větší než 1 zvětší špendlíky a hodnoty menší než 1 je zmenší. Pokud chcete například nakreslit připnutí o 50 % větší než obvykle, použijte pins=default|sc1.5||-122 45 Připínáky a jejich popisky můžete otáčet pomocí modifikátoru stylu rotace ro. Jedná se o několik stupňů otočení po směru hodinových ručiček. Záporné číslo použijte k otočení proti směru hodinových ručiček. 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 Zadáním modifikátoru stylu "al" alfa můžete částečně zprůhlednit připínáky a jejich popisky. Jedná se o číslo mezi 0 a 1 označující neprůhlednost připínáčků. Nula je činí zcela průhlednými (a nejsou viditelné) a 1 je zcela neprůhledné (což je výchozí nastavení). Pokud chcete například připínáky a jejich popisky použít pouze z 67 % neprůsažných, použijte pins=default|al.67||-122 45 Souhrn modifikátoru stylu Modifikátor Popis Typ Rozsah hliník Alfa (neprůhlednost) float 0 až 1 an Připnutí ukotvení <int32, int32> * co Barva připnutí řetězec 000000 až FFFFFF předložka z francouzštiny Ukotvení popisků <int32, int32> * Lc Barva popisku řetězec 000000 až FFFFFF ls Velikost popisku float Větší než 0 Ro Obměna float -360 až 360 Sc Měřítko 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 špendlíku.
tilesetId	query		TilesetId	Styl mapování, který se má vrátit. Možné hodnoty jsou microsoft.base.road, microsoft.base.darkgrey a microsoft.imagery. Výchozí hodnota je microsoft.base.road. Další informace najdete v tématu Render TilesetId.
trafficLayer	query		TrafficTilesetId	Volitelná hodnota označující, že výsledek obrázku nepřekryje žádný tok provozu. Možné hodnoty jsou microsoft.traffic.relative.main a none. Výchozí hodnota je žádná, což znamená, že se nevrátil žádný tok provozu. Pokud je k dispozici id dlaždice související s provozem, vrátí se obrázek mapy s odpovídající vrstvou provozu. Další informace najdete v tématu Render TilesetId.
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 geopoliticky sporné oblasti. Různé země nebo oblasti mají různá zobrazení těchto oblastí a parametr Zobrazení umožňuje, aby vaše aplikace splňovala zobrazení vyžadované zemí nebo oblastí, které bude vaše aplikace obsluhovat. Ve výchozím nastavení je parametr View nastavený na "Unified" i v případě, že jste ho v požadavku nedefinovali. Je na vás, abyste určili umístění uživatelů a pak pro toto umístění správně nastavili parametr View. Alternativně můžete nastavit View=Auto, která vrátí mapová data na základě IP adresy požadavku. Parametr Zobrazení ve službě Azure Maps se musí používat v souladu s platnými zákony, včetně těch, které se týkají mapování, země/oblasti, kde jsou mapy, obrázky a další data a obsah třetích stran, ke kterému máte oprávnění přistupovat prostřednictvím služby Azure Maps. Příklad: view=IN. Podrobnosti a dostupná zobrazení najdete v části Podporovaná zobrazení.
width	query		integer int32	Šířka výsledného obrázku v pixelech Rozsah je od 80 do 2000. Výchozí hodnota je 512. Neměl by se používat s bboxem.
zoom	query		integer int32	Požadovaná úroveň přiblížení mapy. Podpora rozsahu hodnot přiblíž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 tileetId je microsoft.imagery. Výchozí hodnota je 12. Další informace najdete v tématech Úrovně přiblížení a Mřížka dlaždic.

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 je možné ho načíst z rozhraní API účtu roviny správy Služby Azure Maps. Informace o použití zabezpečení Microsoft Entra ID v Azure Maps najdete v následujících článcích .
Accept		MediaType	Pole hlavičky Přijmout 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. Pokud není zadáno záhlaví Přijmout, vraťte obrázek v obrázku nebo png.

Odpovědi

Name	Typ	Description
200 OK	object	Tento obrázek se vrátí z úspěšného volání Get Map Static Image. Media Types: "image/jpeg", "image/png" Hlavičky Content-Type: string
Other Status Codes	ErrorResponse	Došlo k neočekávané chybě. Media Types: "image/jpeg", "image/png"

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 Azure Maps REST API. Ří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 složené z jednoho nebo několika 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 pro konkrétní rozhraní API a obory.

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. Můžete ho získat z rozhraní MAPS MANAGEMENT API.

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í sady Azure Maps Web SDK 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 vytváření prostředku Azure Maps prostřednictvím roviny správy Azure prostřednictvím webu Azure Portal, PowerShellu, rozhraní příkazového řádku, sad Azure SDK nebo rozhraní REST API.

S tímto klíčem má každá aplikace autorizaci pro přístup ke všem rozhraním REST API. Jinými slovy, ty je v současné době možné považovat za hlavní klíče k účtu, pro který jsou vystavené.

U veřejně vystavených aplikací doporučujeme použít přístup mezi servery k rozhraním REST API služby Azure Maps, kde je možné tento 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 List SAS 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 autorizaci pro přístup pomocí řízení přístupu na základě role v Azure a podrobnou kontrolu vypršení platnosti, četnosti a oblastí použití konkrétního tokenu. Jinými slovy, token SAS je možné použít k tomu, aby aplikace mohly řídit přístup zabezpečený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 účtu map , aby se omezilo zneužití vykreslování, a pravidelně obnovovat token SAS.

Typ: apiKey
V: header

Příklady

Successful Static Image Request

Ukázkový požadavek

HTTP

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ěď

Stavový kód:

200

Content-Type: image/png

"{file}"

Definice

Name	Description
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě
ErrorResponse	Chybová odpověď
LocalizedMapView	Parametr Zobrazení (označovaný také jako parametr "oblast uživatele") umožňuje zobrazit správné mapy pro určitou zemi nebo oblast pro geopoliticky sporné oblasti. Různé země nebo oblasti mají různá zobrazení těchto oblastí a parametr Zobrazení umožňuje, aby vaše aplikace splňovala zobrazení vyžadované zemí nebo oblastí, které bude vaše aplikace obsluhovat. Ve výchozím nastavení je parametr View nastavený na "Unified" i v případě, že jste ho v požadavku nedefinovali. Je na vás, abyste určili umístění uživatelů a pak pro toto umístění správně nastavili parametr View. Alternativně můžete nastavit View=Auto, která vrátí mapová data na základě IP adresy požadavku. Parametr Zobrazení ve službě Azure Maps se musí používat v souladu s platnými zákony, včetně těch, které se týkají mapování, země/oblasti, kde jsou mapy, obrázky a další data a obsah třetích stran, ke kterému máte oprávnění přistupovat prostřednictvím služby Azure Maps. Příklad: view=IN. Podrobnosti a dostupná zobrazení najdete v části Podporovaná zobrazení.
MediaType	Pole hlavičky Přijmout 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. Pokud není zadáno záhlaví Přijmout, vraťte obrázek v obrázku nebo png.
TilesetId	Styl mapování, který se má vrátit. Možné hodnoty jsou microsoft.base.road, microsoft.base.darkgrey a microsoft.imagery. Výchozí hodnota je microsoft.base.road. Další informace najdete v tématu Render TilesetId.
TrafficTilesetId	Volitelná hodnota označující, že výsledek obrázku nepřekryje žádný tok provozu. Možné hodnoty jsou microsoft.traffic.relative.main a none. Výchozí hodnota je žádná, což znamená, že se nevrátil žádný tok provozu. Pokud je k dispozici id dlaždice související s provozem, vrátí se obrázek mapy s odpovídající vrstvou provozu. Další informace najdete v tématu Render TilesetId.

ErrorAdditionalInfo

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

Name	Typ	Description
info	object	Další informace.
type	string	Typ další informace.

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

Chybová odpověď

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 geopoliticky sporné oblasti. Různé země nebo oblasti mají různá zobrazení těchto oblastí a parametr Zobrazení umožňuje, aby vaše aplikace splňovala zobrazení vyžadované zemí nebo oblastí, které bude vaše aplikace obsluhovat. Ve výchozím nastavení je parametr View nastavený na "Unified" i v případě, že jste ho v požadavku nedefinovali. Je na vás, abyste určili umístění uživatelů a pak pro toto umístění správně nastavili parametr View. Alternativně můžete nastavit View=Auto, která vrátí mapová data na základě IP adresy požadavku. Parametr Zobrazení ve službě Azure Maps se musí používat v souladu s platnými zákony, včetně těch, které se týkají mapování, země/oblasti, kde jsou mapy, obrázky a další data a obsah třetích stran, ke kterému máte oprávnění přistupovat prostřednictvím služby Azure Maps. Příklad: view=IN.

Podrobnosti a dostupná zobrazení najdete v části Podporovaná zobrazení.

Name	Typ	Description
AE	string	Spojené arabské emiráty (arabské zobrazení)
AR	string	Argentina (argentinský pohled)
Auto	string	Vrátí mapová data na základě IP adresy požadavku.
BH	string	Bahrajn (arabské zobrazení)
IN	string	Indie (indické zobrazení)
IQ	string	Irák (arabské zobrazení)
JO	string	Jordánsko (arabské zobrazení)
KW	string	Kuvajt (arabské zobrazení)
LB	string	Libanon (arabské zobrazení)
MA	string	Maroko (marocké zobrazení)
OM	string	Omán (arabské zobrazení)
PK	string	Pákistán (pákistánské zobrazení)
PS	string	Palestinská samospráva (arabské zobrazení)
QA	string	Katar (arabské zobrazení)
SA	string	Saúdská Arábie (arabské zobrazení)
SY	string	Sýrie (arabské zobrazení)
Unified	string	Sjednocené zobrazení (ostatní)
YE	string	Jemen (arabské zobrazení)

MediaType

Pole hlavičky Přijmout 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. Pokud není zadáno záhlaví Přijmout, vraťte obrázek v obrázku nebo png.

Name	Typ	Description
image/jpeg	string	Vrátit obrázek ve formátu JPEG.
image/png	string	Návratový obrázek ve formátu PNG

TilesetId

Styl mapování, který se má vrátit. Možné hodnoty jsou microsoft.base.road, microsoft.base.darkgrey a microsoft.imagery. Výchozí hodnota je microsoft.base.road. Další informace najdete v tématu Render TilesetId.

Name	Typ	Description
microsoft.base.darkgrey	string	TilesetId obsahuje všechny vrstvy s tmavě šedým stylem.
microsoft.base.road	string	TilesetId obsahuje všechny vrstvy s hlavním stylem vykreslování.
microsoft.imagery	string	TilesetId obsahuje kombinaci satelitních a leteckých snímků.

TrafficTilesetId

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

Name	Typ	Description
microsoft.traffic.relative.main	string	Podporovaná sada dlaždic souvisejících s provozem
none	string	Výchozí hodnota, žádné překrytí toku provozu