RenderGetMapImageOptionalParams interface

Balíček:

azure-maps-rest

Volitelné parametry.

Extends

RequestOptionsBase

Vlastnosti

bbox	Ohraničující rámeček. Použitá projekce - EPSG:3857. Formát: minLon, minLat, maxLon, maxLat. Poznámka: Požadované parametry jsou bbox nebo center. Vzájemně se vylučují. Neměl by se používat s výškou ani šířkou. Maximá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	Souřadnice středového bodu. Formát: 'lon,lat'. Použitá projekce EPSG:3857. Rozsah zeměpisné délky: -180 až 180. Rozsah zeměpisné šířky: -85 až 85. Poznámka: Požadované parametry jsou střed nebo bbox. Vzájemně se vylučují.
height	Výška výsledného obrázku v pixelech Rozsah je 1 až 8192. Výchozí hodnota je 512. Neměl by se používat s bboxem.
language	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 .
layer	Byla požadována vrstva mapy. Pokud je vrstva nastavená na popisky nebo hybridní, měl by být formát png. Mezi možné hodnoty patří: "basic", "hybrid", "labels".
path	Styl cesty a umístění. 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 adresy URL tohoto parametru, protože bude obsahovat vyhrazené znaky, jako jsou například 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í 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 na zeměpisné šířce 45°S a délkou 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 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í adresy URL. 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 Chcete-li vykreslit mnohoúhelník, musí být poslední umístění rovno počátečnímu umístění. Například použijte path=||-122 45|-119.5 43.2|-121.67 47.12|-122 45 Hodnoty zeměpisné délky a šířky pro umístění čar a mnohoúhelníků můžou být v rozsahu -360 až 360, aby bylo možné vykreslovat geometrie překračující anti-poledník. 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í 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 obrysu, použijte modifikátor stylu lc a zadejte 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í několika 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 Získání umístění cest z úložiště dat Azure Maps Pro všechny skladové položky účtu Azure Maps jiné než S0 je možné získat informace o umístění cesty z úložiště dat Azure Maps. Po nahrání dokumentu GeoJSON obsahujícího umístění cesty vrátí služba Data Storage jedinečné ID dat (UDID), které můžete použít k odkazování na data v parametru path. Pokud chcete použít geometrii bodů z nahraného dokumentu GeoJSON jako umístění cesty, zadejte identifikátor UDID v části locations parametru cesty. Třeba path=||udid-29dc105a-dee7-409f-a3f9-22b066ae4713 Všimněte si, že není povoleno kombinovat umístění cest ze služby Data Storage s umístěními zadanými v parametru path. Souhrn modifikátoru stylu Modifikátor Description Rozsah Lc Barva čáry 000000 až FFFFFF Fc Barva výplně 000000 až FFFFFF La Alfa řádku (neprůhlednost) 0 až 1 Dm Výplň alfa (neprůhlednost) 0 až 1 Lw Šířka čáry Větší než 0 Ra Poloměr kruhu (v metrech) Větší než 0
pins	Styl a instance připnutí. Pomocí tohoto parametru můžete volitelně přidat do image připínáky. Styl připnutí popisuje vzhled připínáčků a instance určují souřadnice připínáčků a volitelné popisky pro každý špendlík. (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.) Skladová položka S0 účtu Azure Maps podporuje pouze jednu instanci parametru pins. Jiné skladové položky umožňují více instancím parametru pins určit více stylů připnutí. Pokud chcete vykreslit připínák při zeměpisné šířce 45°S a zeměpisné 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 Všechny příklady tady zobrazují parametr pins 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 potrubí. Použijte například pins=default||-122 45|-119.5 43.2|-121.67 47.12 Skladová položka S0 Azure Maps účtu 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í každý dvoumísmenný název. 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 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 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. 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 Existuje předdefinovaný styl připnutí 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řipnutí, 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 velikosti popisků 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 jsou vycentrovány na připnutí "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 připnutí obrázku. Kladné hodnoty X posunou ukotvení doprava a kladné hodnoty Y posunou ukotvení dolů. Pokud například chcete umístit ukotvení popisku o 10 pixelů doprava a 4 pixely nad levým horním rohem obrázku, 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řipnutí, jako název stylu připnutí použijte slovo vlastní a pak zadejte adresu URL za informacemi o umístění a popisku. Pomocí dvou znaků roury označte, že jste dokončili zadá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ě. Získání připínáčků z úložiště dat Azure Maps Pro všechny skladové položky účtu Azure Maps kromě S0 je možné získat informace o připnutí a umístění ze služby Azure Maps Data Storage. Po nahrání připnutého obrázku nebo dokumentu GeoJSON obsahujícího umístění pinů vrátí služba Data Storage ID jedinečných dat (UDID), které můžete použít k odkazování na data v parametru pins. Pokud chcete použít vlastní obrázek připnutí z Azure Maps Data Storage, jako název stylu připnutí zadejte UDID s předponou udid-. Třeba pins=udid-fe22c504-3a81-4fcd-adc6-a3507ce866c1||-122 45 Pokud chcete jako umístění špendlíků použít geometrii bodů z nahraného dokumentu GeoJSON, zadejte UDID v části locations parametru pins. Třeba pins=default||udid-29dc105a-dee7-409f-a3f9-22b066ae4713 Všimněte si, že bude použita pouze geometrie bodů a více bodů, bodů a více bodů ze kolekcí geometrie a geometrie bodů z prvků. Geometrie linestringu a mnohoúhelníku budou ignorovány. Pokud bod pochází z funkce a funkce má vlastnost řetězce s názvem "label", hodnota této vlastnosti se použije jako popisek pro pin. Umístění připnutí můžete kombinovat z úložiště dat a umístění připnutí zadaná v parametru pins. Umístění kolíků oddělených potrubím může být zeměpisná délka a zeměpisná šířka nebo UDID. Třeba pins=default||-122 45|udid-29dc105a-dee7-409f-a3f9-22b066ae4713|-119 43 Š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 Description Rozsah Al Alfa (neprůhlednost) 0 až 1 an Připnutí ukotvení * co Barva připnutí 000000 až FFFFFF La Ukotvení popisků * Lc Barva popisku 000000 až FFFFFF ls Velikost popisku Větší než 0 Ro Obměna -360 až 360 Sc Měřítko Větší než 0 Souřadnice X a Y můžou být kdekoli v obrázku připnutí nebo na okraji kolem něj. Velikost okraje je minimální šířka a výška kolíku.
style	Styl mapování, který se má vrátit. V současné době je k dispozici pouze styl main. Mezi možné hodnoty patří: "main"
view	Parametr View určuje, která sada geopoliticky sporného obsahu se vrátí prostřednictvím Azure Maps služeb, včetně ohraničení a popisků zobrazených na mapě. Parametr View (označovaný také jako parametr oblasti uživatele) zobrazí správné mapy pro danou zemi nebo oblast. 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 Zobrazit v Azure Maps musí být použit v souladu s platnými zákony, včetně těch týkajících se mapování, země, 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 Azure Maps. Příklad: view=IN. Podrobnosti a dostupná zobrazení najdete v části Podporovaná zobrazení.
width	Šířka výsledného obrázku v pixelech Rozsah je 1 až 8192. Výchozí hodnota je 512. Neměl by se používat s bboxem.
zoom	Požadovaná úroveň přiblížení mapy. Hodnota přiblížení musí být v rozsahu 0–20 (včetně). Výchozí hodnota je 12. Podrobnosti najdete v tématech Úrovně přiblížení a Mřížka dlaždic .

Zděděné vlastnosti

abortSignal	Signál, který lze použít k přerušení požadavků.
customHeaders	{object} [customHeaders] Vlastní hlavičky požadavků definované uživatelem, které se použijí před odesláním požadavku.
onDownloadProgress	Zpětné volání, které se aktivuje při stahování.
onUploadProgress	Zpětné volání, které se aktivuje při průběhu nahrávání.
timeout	Počet milisekund, které může požadavek trvat, než se automaticky ukončí.

Podrobnosti vlastnosti

bbox

Ohraničující rámeček. Použitá projekce - EPSG:3857. Formát: minLon, minLat, maxLon, maxLat. Poznámka: Požadované parametry jsou bbox nebo center. Vzájemně se vylučují. Neměl by se používat s výškou ani šířkou.

Maximá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?: string

Hodnota vlastnosti

string

center

Souřadnice středového bodu. Formát: 'lon,lat'. Použitá projekce

• EPSG:3857. Rozsah zeměpisné délky: -180 až 180. Rozsah zeměpisné šířky: -85 až 85. Poznámka: Požadované parametry jsou střed nebo bbox. Vzájemně se vylučují.

center?: string

Hodnota vlastnosti

string

height

Výška výsledného obrázku v pixelech Rozsah je 1 až 8192. Výchozí hodnota je 512. Neměl by se používat s bboxem.

height?: number

Hodnota vlastnosti

number

language

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 .

language?: string

Hodnota vlastnosti

string

layer

Byla požadována vrstva mapy. Pokud je vrstva nastavená na popisky nebo hybridní, měl by být formát png. Mezi možné hodnoty patří: "basic", "hybrid", "labels".

layer?: StaticMapLayer

Hodnota vlastnosti

StaticMapLayer

path

Styl cesty a umístění. 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 adresy URL tohoto parametru, protože bude obsahovat vyhrazené znaky, jako jsou například 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í 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 na zeměpisné šířce 45°S a délkou 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 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í adresy URL.

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

Chcete-li vykreslit mnohoúhelník, musí být poslední umístění rovno počátečnímu umístění. Například použijte

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

Hodnoty zeměpisné délky a šířky pro umístění čar a mnohoúhelníků můžou být v rozsahu -360 až 360, aby bylo možné vykreslovat geometrie překračující anti-poledník.

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í 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 obrysu, použijte modifikátor stylu lc a zadejte 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í několika 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

Získání umístění cest z úložiště dat Azure Maps

Pro všechny skladové položky účtu Azure Maps jiné než S0 je možné získat informace o umístění cesty z úložiště dat Azure Maps. Po nahrání dokumentu GeoJSON obsahujícího umístění cesty vrátí služba Data Storage jedinečné ID dat (UDID), které můžete použít k odkazování na data v parametru path.

Pokud chcete použít geometrii bodů z nahraného dokumentu GeoJSON jako umístění cesty, zadejte identifikátor UDID v části locations parametru cesty. Třeba

path=||udid-29dc105a-dee7-409f-a3f9-22b066ae4713

Všimněte si, že není povoleno kombinovat umístění cest ze služby Data Storage s umístěními zadanými v parametru path.

Souhrn modifikátoru stylu

Modifikátor	Description	Rozsah
Lc	Barva čáry	000000 až FFFFFF
Fc	Barva výplně	000000 až FFFFFF
La	Alfa řádku (neprůhlednost)	0 až 1
Dm	Výplň alfa (neprůhlednost)	0 až 1
Lw	Šířka čáry	Větší než 0
Ra	Poloměr kruhu (v metrech)	Větší než 0

path?: string[]

Hodnota vlastnosti

string[]

pins

Styl a instance připnutí. Pomocí tohoto parametru můžete volitelně přidat do image připínáky. Styl připnutí popisuje vzhled připínáčků a instance určují souřadnice připínáčků a volitelné popisky pro každý špendlík. (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.) Skladová položka S0 účtu Azure Maps podporuje pouze jednu instanci parametru pins. Jiné skladové položky umožňují více instancím parametru pins určit více stylů připnutí.

Pokud chcete vykreslit připínák při zeměpisné šířce 45°S a zeměpisné 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

Všechny příklady tady zobrazují parametr pins 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 potrubí. Použijte například

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

Skladová položka S0 Azure Maps účtu 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í každý dvoumísmenný název. 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 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

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

Existuje předdefinovaný styl připnutí 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řipnutí, 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 velikosti popisků 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 jsou vycentrovány na připnutí "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 připnutí obrázku. Kladné hodnoty X posunou ukotvení doprava a kladné hodnoty Y posunou ukotvení dolů. Pokud například chcete umístit ukotvení popisku o 10 pixelů doprava a 4 pixely nad levým horním rohem obrázku, 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řipnutí, jako název stylu připnutí použijte slovo vlastní a pak zadejte adresu URL za informacemi o umístění a popisku. Pomocí dvou znaků roury označte, že jste dokončili zadá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ě.

Získání připínáčků z úložiště dat Azure Maps

Pro všechny skladové položky účtu Azure Maps kromě S0 je možné získat informace o připnutí a umístění ze služby Azure Maps Data Storage. Po nahrání připnutého obrázku nebo dokumentu GeoJSON obsahujícího umístění pinů vrátí služba Data Storage ID jedinečných dat (UDID), které můžete použít k odkazování na data v parametru pins.

Pokud chcete použít vlastní obrázek připnutí z Azure Maps Data Storage, jako název stylu připnutí zadejte UDID s předponou udid-. Třeba

pins=udid-fe22c504-3a81-4fcd-adc6-a3507ce866c1||-122 45

Pokud chcete jako umístění špendlíků použít geometrii bodů z nahraného dokumentu GeoJSON, zadejte UDID v části locations parametru pins. Třeba

pins=default||udid-29dc105a-dee7-409f-a3f9-22b066ae4713

Všimněte si, že bude použita pouze geometrie bodů a více bodů, bodů a více bodů ze kolekcí geometrie a geometrie bodů z prvků. Geometrie linestringu a mnohoúhelníku budou ignorovány. Pokud bod pochází z funkce a funkce má vlastnost řetězce s názvem "label", hodnota této vlastnosti se použije jako popisek pro pin.

Umístění připnutí můžete kombinovat z úložiště dat a umístění připnutí zadaná v parametru pins. Umístění kolíků oddělených potrubím může být zeměpisná délka a zeměpisná šířka nebo UDID. Třeba

pins=default||-122 45|udid-29dc105a-dee7-409f-a3f9-22b066ae4713|-119 43

Š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	Description	Rozsah
Al	Alfa (neprůhlednost)	0 až 1
an	Připnutí ukotvení	*
co	Barva připnutí	000000 až FFFFFF
La	Ukotvení popisků	*
Lc	Barva popisku	000000 až FFFFFF
ls	Velikost popisku	Větší než 0
Ro	Obměna	-360 až 360
Sc	Měřítko	Větší než 0

• Souřadnice X a Y můžou být kdekoli v obrázku připnutí nebo na okraji kolem něj. Velikost okraje je minimální šířka a výška kolíku.

pins?: string[]

Hodnota vlastnosti

string[]

style

Styl mapování, který se má vrátit. V současné době je k dispozici pouze styl main. Mezi možné hodnoty patří: "main"

style?: Style

Hodnota vlastnosti

Style

view

Parametr View určuje, která sada geopoliticky sporného obsahu se vrátí prostřednictvím Azure Maps služeb, včetně ohraničení a popisků zobrazených na mapě. Parametr View (označovaný také jako parametr oblasti uživatele) zobrazí správné mapy pro danou zemi nebo oblast. 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 Zobrazit v Azure Maps musí být použit v souladu s platnými zákony, včetně těch týkajících se mapování, země, 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 Azure Maps. Příklad: view=IN. Podrobnosti a dostupná zobrazení najdete v části Podporovaná zobrazení.

view?: string

Hodnota vlastnosti

string

width

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

width?: number

Hodnota vlastnosti

number

zoom

Požadovaná úroveň přiblížení mapy. Hodnota přiblížení musí být v rozsahu 0–20 (včetně). Výchozí hodnota je 12.

Podrobnosti najdete v tématech Úrovně přiblížení a Mřížka dlaždic .

zoom?: number

Hodnota vlastnosti

number

Podrobnosti zděděných vlastností

abortSignal

Signál, který lze použít k přerušení požadavků.

abortSignal?: AbortSignalLike

Hodnota vlastnosti

AbortSignalLike

Zděděno z RequestOptionsBase.abortSignal

customHeaders

{object} [customHeaders] Vlastní hlavičky požadavků definované uživatelem, které se použijí před odesláním požadavku.

customHeaders?: [key: string]: string

Hodnota vlastnosti

[key: string]: string

Zděděno z RequestOptionsBase.customHeaders

onDownloadProgress

Zpětné volání, které se aktivuje při stahování.

onDownloadProgress?: (progress: TransferProgressEvent) => void

Hodnota vlastnosti

(progress: TransferProgressEvent) => void

Zděděno z RequestOptionsBase.onDownloadProgress

onUploadProgress

Zpětné volání, které se aktivuje při průběhu nahrávání.

onUploadProgress?: (progress: TransferProgressEvent) => void

Hodnota vlastnosti

(progress: TransferProgressEvent) => void

Zděděno z RequestOptionsBase.onUploadProgress

timeout

Počet milisekund, které může požadavek trvat, než se automaticky ukončí.

timeout?: number

Hodnota vlastnosti

number

Zděděno z RequestOptionsBase.timeout