RenderGetMapStaticImageQueryParamProperties interface

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.

bbox?: number[]

Hodnota vlastnosti

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í.

center?: number[]

Hodnota vlastnosti

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.

height?: number

Hodnota vlastnosti

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.

language?: string

Hodnota vlastnosti

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 cesty se podporuje ve skladové posadě SKU účtu Azure Maps počínaje 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

path?: string

Hodnota vlastnosti

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.)

Skladová položka účtu Azure Maps podporuje pouze jednu instanci parametru špendlíků a počet umístění je omezený na 5 míst 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

Skladová položka účtu S0 Azure Maps umožňuje pouze pět připínáků. 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. Napří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. Napří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

• 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.

pins?: string

Hodnota vlastnosti

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.

tilesetId?: "microsoft.base" | "microsoft.base.labels" | "microsoft.base.hybrid" | "microsoft.terra.main" | "microsoft.base.road" | "microsoft.base.darkgrey" | "microsoft.base.labels.road" | "microsoft.base.labels.darkgrey" | "microsoft.base.hybrid.road" | "microsoft.base.hybrid.darkgrey" | "microsoft.imagery" | "microsoft.weather.radar.main" | "microsoft.weather.infrared.main" | "microsoft.traffic.absolute" | "microsoft.traffic.absolute.main" | "microsoft.traffic.relative" | "microsoft.traffic.relative.main" | "microsoft.traffic.relative.dark" | "microsoft.traffic.delay" | "microsoft.traffic.delay.main" | "microsoft.traffic.reduced.main" | "microsoft.traffic.incident"

Hodnota vlastnosti

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.

trafficLayer?: "microsoft.traffic.relative.main" | "none"

Hodnota vlastnosti

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 Zobrazení ve službě Azure Maps se musí používat v souladu s příslušnými zákony, včetně těch týkajících se 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 přes Azure Maps, je zpřístupněn. Příklad: view=IN.

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

view?: "AE" | "AR" | "BH" | "IN" | "IQ" | "JO" | "KW" | "LB" | "MA" | "OM" | "PK" | "PS" | "QA" | "SA" | "SY" | "YE" | "Auto" | "Unified"

Hodnota vlastnosti

Šíř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.

width?: number

Hodnota vlastnosti

Desired zoom level of the map. 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.

zoom?: number

Hodnota vlastnosti