RenderGetMapStaticImageQueryParamProperties interface

A határolókeretet két szélesség és két hosszúság határozza meg, amelyek egy téglalap alakú terület négy oldalát jelölik a Földön. Formátum: 'minLon, minLat, maxLon, maxLat' (dupla).

Megjegyzés: A bbox vagy a center paraméter szükséges. Kölcsönösen kizárják egymást. A bbox nem használható magassággal vagy szélességgel.

A Lat és a Lon maximális és minimális megengedett tartományai az oldal tetején található táblázat minden nagyítási szintjéhez meg vannak határozva.

bbox?: number[]

Tulajdonság értéke

A középpont koordinátái dupla értékben. Formátum: 'lon,lat'. Hosszúsági tartomány: -180 180-ra. Szélességi tartomány: -90–90.

Megjegyzés: A középső vagy a bbox paraméter szükséges. Kölcsönösen kizárják egymást.

center?: number[]

Tulajdonság értéke

Az eredményként kapott kép magassága képpontban. 80 és 1500 közötti tartomány. Az alapértelmezett érték 512. Nem szabad a bboxhoz használni.

height?: number

Tulajdonság értéke

Az a nyelv, amelyben a keresési eredményeket vissza kell adni. A támogatott IETF nyelvi címkék egyikének kell lennie, a kis- és nagybetűk nem érzéketlenek. Ha a megadott nyelven lévő adatok nem érhetők el egy adott mezőhöz, a rendszer az alapértelmezett nyelvet használja.

Részletekért tekintse meg támogatott nyelvek.

language?: string

Tulajdonság értéke

Útvonalstílus és helyek (dupla). Ezzel a paraméterrel igény szerint vonalakat, sokszögeket vagy köröket adhat a képhez. Az elérési út stílusa a vonal és a kitöltés megjelenését írja le. (Ügyeljen arra, hogy a paraméter URL-kódolási értékei megfelelően legyenek kódolva, mivel fenntartott karaktereket, például csöveket és írásjeleket fog tartalmazni.)

Az Elérési út paraméter az Azure Maps-fiók termékváltozatában támogatott az S1-től kezdve. Az elérési út paraméter több példánya lehetővé teszi több geometria megadását a stílusukkal. A paraméterek száma kérelemenként legfeljebb 10, a helyek száma pedig útvonalonként legfeljebb 100 lehet.

Ha egy 100 méter sugarú kört és középpontot szeretne megjeleníteni a 45°N szélességnél és a hosszúság 122°W-nál az alapértelmezett stílus használatával, adja hozzá a lekérdezéslánc paramétert

path=ra100||-122 45

Vegye figyelembe, hogy a hosszúság a szélesség előtt van. Az URL-kódolás után ez a következőképpen fog kinézni:

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

Az alábbi példák url-kódolás nélkül mutatják be az elérésiút-paramétert, hogy egyértelmű legyen.

Egy vonal megjelenítéséhez különítse el az egyes helyeket egy csőkarakercstel. Például:

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

A sokszög zárt elérési úttal van megadva, ahol az első és az utolsó pont egyenlő. Például:

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

A vonalak és sokszögek helyének hosszúsági értéke a -360 és a 360 közötti tartományban lehet, hogy lehetővé tegye az anti-meridiánon áthaladó geometriák renderelését.

Stílusmódosítók

Az elérési út megjelenését stílusmódosítók hozzáadásával módosíthatja. Ezek a helyek előtt lesznek hozzáadva. A stílusmódosítók mindegyike kétbetűs névvel rendelkezik. Ezek a rövidített nevek segítenek csökkenteni az URL-cím hosszát.

A körvonal színének módosításához használja az "lc" stílusmódosítót, és adja meg a színt a HTML/CSS RGB színformátummal, amely egy hatjegyű hexadecimális szám (a háromjegyű űrlap nem támogatott). Ha például egy mély rózsaszín színt szeretne használni, amelyet #FF1493 a CSS-ben, használja a

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

Összetettebb vizuális stílus létrehozásához több stílusmódosító is kombinálható.

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

Stílusmódosító összegzése

path?: string

Tulajdonság értéke

Pushpin stílus és példányok. Ezzel a paraméter használatával igény szerint hozzáadhat leküldéses műveletet a képhez. A leküldéses stílus a leküldéses tűk megjelenését írja le, a példányok pedig a leküldéses (dupla) és a nem kötelező címkék koordinátáit adják meg az egyes tűkhöz. (Ügyeljen arra, hogy a paraméter URL-kódolási értékei megfelelően legyenek kódolva, mivel fenntartott karaktereket, például csöveket és írásjeleket fog tartalmazni.)

Az Azure Maps-fiók S0 termékváltozata csak a pin-kód paraméter egyetlen példányát támogatja, és a helyek száma pin-kódonként legfeljebb 5 lehet. Más termékváltozatok esetén a pin-kód paraméter legfeljebb 25 példánya adhat meg több kitűzőstílust, a helyek száma pedig pin-kódonként legfeljebb 50 lehet.

Ha az alapértelmezett beépített leküldési stílussal szeretné megjeleníteni a leküldéses 45°N szélességű és 122°W hosszúságú leküldést, adja hozzá a lekérdezési paramétert

pins=default||-122 45

Vegye figyelembe, hogy a hosszúság a szélesség előtt van. Az URL-kódolás után ez a következőképpen fog kinézni:

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

Az összes példa URL-kódolás nélkül jeleníti meg a pins paramétert, hogy egyértelmű legyen.

Ha több helyen szeretne megjeleníteni egy tűt, különítse el az egyes helyeket egy pipa karakterrel. Például:

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

Az S0 Azure Maps-fiók termékváltozata csak öt pushpint engedélyez. Más fiók-termékváltozatok nem rendelkeznek ezzel a korlátozásokkal.

Stílusmódosítók

A tűk megjelenését stílusmódosítók hozzáadásával módosíthatja. Ezek a stílus után, de a helyek és címkék előtt jelennek meg. A stílusmódosítók mindegyike kétbetűs névvel rendelkezik. Ezek a rövidített nevek segítenek csökkenteni az URL-cím hosszát.

A leküldés színének módosításához használja a "co" stílusmódosítót, és adja meg a színt a HTML/CSS RGB színformátummal, amely egy hatjegyű hexadecimális szám (a háromjegyű űrlap nem támogatott). Ha például egy mély rózsaszín színt szeretne használni, amelyet #FF1493 a CSS-ben, használja a

pins=default|coFF1493||-122 45

Leküldéses címkék

Ha címkét szeretne hozzáadni a tűkhöz, tegye a címkét egy idézőjelbe a koordináták előtt. Ne használjon speciális karaktereket, például | vagy || címkében. Ha például az "1", a "2" és a "3" értékekkel szeretne megjelölni három tűt, használja a

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

Van egy "none" nevű beépített pushpin stílus, amely nem jelenít meg pushpin képet. Ezt akkor használhatja, ha a címkéket pin-kód nélkül szeretné megjeleníteni. Például

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

A leküldéses címkék színének módosításához használja az "lc" címke színstílus-módosítóját. Ha például rózsaszín, fekete címkékkel ellátott pushpineket szeretne használni, használja a

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

A címkék méretének módosításához használja az "ls" címkeméret-módosítót. A címke mérete képpontban kifejezi a címke szövegének hozzávetőleges magasságát. Ha például a címke méretét 12-esre szeretné növelni, használja a

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

A címkék a "címkehorgony" nyomócsúszda közepén vannak. A horgonyhely előre definiálva van a beépített leküldéses pontokhoz, és az egyéni leküldéses pontok tetején található (lásd alább). A címkehorgony felülbírálásához használja a "la" stílusmódosítót, és adjon meg X és Y képpont koordinátákat a horgonyhoz. Ezek a koordináták a leküldéses kép bal felső sarkához viszonyítva találhatók. A pozitív X értékek jobbra mozgatják a horgonyt, a pozitív Y értékek pedig lefelé mozgatják a horgonyt. Ha például a címkehorgonyt 10 képponttal jobbra és 4 képponttal a leküldéses kép bal felső sarkában szeretné elhelyezni, használja a

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

Egyéni leküldéses vezérlők

Egyéni leküldéses kép használatához használja az "egyéni" szót a tűstílus neveként, majd adjon meg egy URL-címet a hely és a címke adatai után. A testreszabott címkeképek maximális mérete 65 536 képpont. Két pipa karakter használatával jelezheti, hogy befejezte a helyek megadását, és elindítja az URL-címet. Például

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

Az URL-kódolás után ez a következőképpen nézne ki:

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

Alapértelmezés szerint az egyéni leküldéses képek középre vannak húzva a kitűző koordinátáinál. Ez általában nem ideális, mivel elhomályosítja a kiemelni kívánt helyet. A rögzítési kép horgonyhelyének felülbírálásához használja az "an" stílusmódosítót. Ez ugyanazt a formátumot használja, mint a "la" címke horgonystílus-módosítóját. Ha például az egyéni kitűző képe a kép bal felső sarkában található, a horgonyt erre a pontra állíthatja a

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

Megjegyzés: Ha a "co" színmódosítót egyéni leküldéses képpel használja, a megadott szín lecseréli a kép képpontjainak RGB-csatornáit, de az alfa (átlátszatlanság) csatornát változatlanul hagyja. Ez általában csak egyszínű egyéni képpel történik.

Méretezés, elforgatás és átlátszatlanság

Az "sc" skálázási stílusmódosítóval méretezheti vagy kicsinyítheti a nyomócsúcsokat és a címkéket. Ez egy nullánál nagyobb érték. Az 1 érték a standard skálázás. Az 1-nél nagyobb értékek nagyobbak lesznek, az 1-nél kisebb értékek pedig kisebbek lesznek. Ha például a normálnál 50% nagyobb nyomócsúcsot szeretne rajzolni, használja a

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

A "ro" rotációs stílusmódosítóval elforgathatja a nyomócsúcsokat és a címkéket. Ez az óramutató járásával megegyező irányban történő elforgatás több foka. Az óramutató járásával ellentétes irányban elforgathat negatív számot. Ha például az óramutató járásával megegyező irányban 90 fokkal szeretné elforgatni a tolócsuklókat, használja a

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

Az "al" alfastílus-módosító megadásával részlegesen áttetszővé teheti a pushpineket és azok címkéit. Ez egy 0 és 1 közötti szám, amely a pushpinek átlátszatlanságát jelzi. A nulla teljesen átlátszóvá teszi őket (és nem látható), az 1 pedig teljesen átlátszatlansá teszi őket (ez az alapértelmezett). Ha például csak 67% átlátszatlannak szeretné tenni a nyomócsúcsokat és a címkéket, használja a

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

Stílusmódosító összegzése

• Az X és az Y koordináták bárhol lehetnek a kitűző képében vagy a körülöttük lévő margón belül. A margó mérete a tű szélességének és magasságának minimuma.

pins?: string

Tulajdonság értéke

A visszaadandó leképezési stílus. Lehetséges értékek a microsoft.base.road, a microsoft.base.darkgrey és a microsoft.imagery. Az alapértelmezett érték a microsoft.base.road értékre van állítva. További információ: Render TilesetId.

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"

Tulajdonság értéke

Nem kötelező érték, amely azt jelzi, hogy a rendszerkép eredményén nincs túlterjedt forgalom. Lehetséges értékek: microsoft.traffic.relative.main és none. Az alapértelmezett érték nincs, ami azt jelzi, hogy nincs visszaadott forgalom. Ha a forgalommal kapcsolatos tilesetId van megadva, a rendszer visszaadja a térképképet a megfelelő forgalmi réteggel. További információ: Render TilesetId.

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

Tulajdonság értéke

A View paraméter (más néven "felhasználói régió" paraméter) lehetővé teszi egy adott ország/régió megfelelő térképeinek megjelenítését a geopolitikailag vitatott régiókhoz. A különböző országok/régiók különböző nézetekkel rendelkeznek az ilyen régiókról, és a Nézet paraméter lehetővé teszi, hogy az alkalmazás megfeleljen az alkalmazás által kiszolgálni kívánt ország/régió által megkövetelt nézetnek. Alapértelmezés szerint a View paraméter akkor is "Egyesített" értékre van állítva, ha még nem definiálta a kérésben. Az Ön felelőssége meghatározni a felhasználók helyét, majd helyesen beállítani a View paramétert az adott helyhez. Másik lehetőségként beállíthatja a "View=Auto" beállítást, amely a kérés IP-címe alapján adja vissza a térképadatokat. Az Azure Maps View paraméterét a vonatkozó jogszabályoknak megfelelően kell használni, beleértve a leképezésre vonatkozókat is, azon ország/régió tekintetében, ahol a térképek, képek és egyéb adatok, valamint az Azure Mapsen keresztüli hozzáférésre jogosult harmadik féltől származó tartalom elérhetővé válik. Példa: view=IN.

A részletekért tekintse meg támogatott nézeteket, és tekintse meg az elérhető nézeteket.

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

Tulajdonság értéke

Az eredményként kapott kép szélessége képpontban. 80 és 2000 közötti tartomány. Az alapértelmezett érték 512. A bbox nem használható.

width?: number

Tulajdonság értéke

A térkép kívánt nagyítási szintje. A 0 és 20 közötti nagyítási érték támogatása (beleértve) a microsoft.base.road vagy a microsoft.base.darkgrey csempéket. A 0 és 19 közötti nagyítási értéktartomány támogatása (beleértve) a microsoft.imagery csempék azonosítóját. Az alapértelmezett érték 12.

További információ: Nagyítási szintek és Csemperács.

zoom?: number

Tulajdonság értéke