RenderGetMapImageOptionalParams interface

Pakiet:

azure-maps-rest

Parametry opcjonalne.

Extends

RequestOptionsBase

Właściwości

bbox	Obwiedni. Używane projekcje — EPSG:3857. Format: "minLon, minLat, maxLon, maxLat". Uwaga: bbox lub środek są wymaganymi parametrami. Wzajemnie się wykluczają. Nie należy jej używać z wysokością ani szerokością. Maksymalne dozwolone zakresy dla lat i Lon są definiowane dla każdego poziomu powiększenia w tabeli w górnej części tej strony.
center	Współrzędne punktu środkowego. Format: "lon,lat". Używane projekcje EPSG:3857. Zakres długości geograficznej: -180 do 180. Zakres szerokości geograficznej: -85 do 85. Uwaga: w środku lub w skrzynce odbiorczej są wymagane parametry. Wzajemnie się wykluczają.
height	Wysokość wynikowego obrazu w pikselach. Zakres wynosi od 1 do 8192. Wartość domyślna to 512. Nie należy jej używać z usługą bbox.
language	Język, w którym powinny być zwracane wyniki wyszukiwania. Powinien być jednym z obsługiwanych tagów języka IETF, bez uwzględniania wielkości liter. Gdy dane w określonym języku nie są dostępne dla określonego pola, używany jest język domyślny. Aby uzyskać szczegółowe informacje, zobacz Obsługiwane języki .
layer	Zażądano warstwy mapy. Jeśli warstwa jest ustawiona na etykiety lub hybrydę, format powinien być png. Możliwe wartości to: "basic", "hybrid", "labels"
path	Styl ścieżki i lokalizacje. Użyj tego parametru, aby opcjonalnie dodać linie, wielokąty lub okręgi do obrazu. Styl ścieżki opisuje wygląd linii i wypełnienia. (Pamiętaj, aby poprawnie kodować wartości adresu URL tego parametru, ponieważ będzie zawierać zastrzeżone znaki, takie jak potoki i znaki interpunkcyjne). Parametr ścieżki jest obsługiwany w jednostce SKU konta Azure Maps począwszy od S1. Wiele wystąpień parametru ścieżki umożliwia określenie wielu geometrii ze swoimi stylami. Liczba parametrów na żądanie jest ograniczona do 10, a liczba lokalizacji jest ograniczona do 100 na ścieżkę. Aby renderować okrąg z promieniem 100 metrów i punktem środkowym na szerokości geograficznej 45°N i długości geograficznej 122°W przy użyciu stylu domyślnego, dodaj parametr ciągu zapytania path=ra100||-122 45 Należy pamiętać, że długość geograficzna przypada przed szerokością geograficzną. Po kodowaniu adresu URL będzie to wyglądać następująco: path=ra100%7C%7C-122+45 Wszystkie przykłady w tym miejscu pokazują parametr ścieżki bez kodowania adresu URL, aby uzyskać przejrzystość. Aby renderować linię, należy oddzielić każdą lokalizację znakiem potoku. Na przykład użyj polecenia path=||-122 45|-119.5 43.2|-121.67 47.12 Aby renderować wielokąt, ostatnia lokalizacja musi być równa lokalizacji początkowej. Na przykład użyj polecenia path=||-122 45|-119.5 43.2|-121.67 47.12|-122 45 Wartości długości geograficznej i szerokości geograficznej dla lokalizacji linii i wielokątów mogą mieścić się w zakresie od -360 do 360, aby umożliwić renderowanie geometrii przekraczających anty-południk. Modyfikatory stylów Wygląd ścieżki można zmodyfikować, dodając modyfikatory stylów. Są one dodawane przed lokalizacjami. Modyfikatory stylów mają nazwę dwuliterową. Te skrócone nazwy są używane do zmniejszenia długości adresu URL. Aby zmienić kolor konturu, użyj modyfikatora stylu "lc" i określ kolor przy użyciu formatu koloru HTML/CSS RGB, który jest sześciocyfrową liczbą szesnastkową (formularz trzycyfrowy nie jest obsługiwany). Aby na przykład użyć głębokiego różowego koloru, który określisz jako #FF1493 w arkuszu CSS, użyj polecenia path=lcFF1493||-122 45|-119.5 43.2 W celu utworzenia bardziej złożonego stylu można połączyć wiele modyfikatorów stylów. 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 Pobieranie lokalizacji ścieżki z magazynu danych Azure Maps Dla wszystkich jednostek SKU konta Azure Maps innych niż S0 można uzyskać informacje o lokalizacji ścieżki z usługi Azure Maps Data Storage. Po przekazaniu dokumentu GeoJSON zawierającego lokalizacje ścieżki usługa Data Storage zwraca unikatowy identyfikator danych (UDID), którego można użyć do odwołwania się do danych w parametrze path. Aby użyć geometrii punktu z przekazanego dokumentu GeoJSON jako lokalizacji ścieżki, określ identyfikator UDID w sekcji lokalizacji parametru ścieżki. Na przykład path=||udid-29dc105a-dee7-409f-a3f9-22b066ae4713 Zwróć uwagę, że nie można mieszać lokalizacji ścieżek z magazynu danych z lokalizacjami określonymi w parametrze path. Podsumowanie modyfikatora stylu Modyfikator Opis Zakres Lc Kolor linii 000000 do FFFFFF Fc Kolor wypełnienia 000000 do FFFFFF La Linia alfa (nieprzezroczystość) Od 0 do 1 Fa Wypełnienie alfa (nieprzezroczystość) Od 0 do 1 Lw Szerokość linii Większe niż 0 Ra Promień okręgu (mierniki) Większe niż 0
pins	Styl i wystąpienia wypychania. Użyj tego parametru, aby opcjonalnie dodać pinezki do obrazu. Styl pinezki opisuje wygląd pinezek, a wystąpienia określają współrzędne pinezek i opcjonalne etykiety dla każdego pinezki. (Pamiętaj, aby poprawnie kodować wartości adresu URL tego parametru, ponieważ będzie zawierać zastrzeżone znaki, takie jak potoki i znaki interpunkcyjne). Jednostka SKU konta Azure Maps S0 obsługuje tylko jedno wystąpienie parametru wyprowadzeń. Inne jednostki SKU zezwalają na wiele wystąpień parametru pinezki w celu określenia wielu stylów pinezki. Aby renderować pinezki na szerokości geograficznej 45°N i długości geograficznej 122°W przy użyciu domyślnego wbudowanego stylu pinezki, dodaj parametr querystring pins=default||-122 45 Należy pamiętać, że długość geograficzna jest wcześniejsza niż szerokość geograficzna. Po kodowaniu adresu URL będzie to wyglądać następująco: pins=default%7C%7C-122+45 Wszystkie przykłady w tym miejscu pokazują parametr pins bez kodowania adresu URL, aby uzyskać jasność. Aby renderować pinezkę w wielu lokalizacjach, oddziel każdą lokalizację znakiem potoku. Na przykład użyj polecenia pins=default||-122 45|-119.5 43.2|-121.67 47.12 Jednostka SKU konta S0 Azure Maps zezwala tylko na pięć wypychań. Inne jednostki SKU konta nie mają tego ograniczenia. Modyfikatory stylu Wygląd pinezek można modyfikować, dodając modyfikatory stylu. Są one dodawane po stylu, ale przed lokalizacjami i etykietami. Modyfikatory stylów mają dwie litery. Te skrócone nazwy są używane do zmniejszenia długości adresu URL. Aby zmienić kolor pinezki, użyj modyfikatora stylu "co" i określ kolor przy użyciu formatu koloru HTML/CSS RGB, który jest sześciocyfrową liczbą szesnastkową (formularz trzycyfrowy nie jest obsługiwany). Aby na przykład użyć głębokiego różowego koloru, który należy określić jako #FF1493 w css, użyj polecenia pins=default|coFF1493||-122 45 Etykiety wypychania Aby dodać etykietę do pinezek, umieść etykietę w apostrofach tuż przed współrzędnymi. Aby na przykład oznaczyć trzy pinezki wartościami "1", "2" i "3", użyj polecenia pins=default||'1'-122 45|'2'-119.5 43.2|'3'-121.67 47.12 Istnieje wbudowany styl pinezki o nazwie "none", który nie wyświetla obrazu pinezki. Możesz użyć tej opcji, jeśli chcesz wyświetlać etykiety bez żadnego obrazu pinezki. Na przykład pins=none||'A'-122 45|'B'-119.5 43.2 Aby zmienić kolor etykiet pinezki, użyj modyfikatora stylu koloru etykiety "lc". Aby na przykład użyć różowych pinezki z czarnymi etykietami, użyj polecenia pins=default|coFF1493|lc000000||-122 45 Aby zmienić rozmiar etykiet, użyj modyfikatora stylu etykiet "ls". Rozmiar etykiety reprezentuje przybliżoną wysokość tekstu etykiety w pikselach. Aby na przykład zwiększyć rozmiar etykiety do 12, użyj polecenia pins=default|ls12||'A'-122 45|'B'-119 43 Etykiety są wyśrodkowane na odepchnięciu "kotwicy etykiety". Lokalizacja zakotwiczenia jest wstępnie zdefiniowana dla wbudowanych pinezki i znajduje się w górnej części niestandardowych pinezki (zobacz poniżej). Aby zastąpić kotwicę etykiety, użyj modyfikatora stylu "la" i podaj współrzędne X i Y pikseli dla kotwicy. Te współrzędne są względne względem lewego górnego rogu obrazu pinezki. Dodatnie wartości X przenoszą kotwicę w prawo, a dodatnie wartości Y przenoszą kotwicę w dół. Aby na przykład umieścić etykietę kotwicę 10 pikseli w prawo i 4 piksele powyżej lewego górnego rogu obrazu pushpin, użyj polecenia pins=default|la10 -4||'A'-122 45|'B'-119 43 Niestandardowe pinezki Aby użyć niestandardowego obrazu pinezki, użyj wyrazu "custom" jako nazwy stylu pinezki, a następnie określ adres URL po informacjach o lokalizacji i etykiecie. Użyj dwóch znaków potoku, aby wskazać, że zakończono określanie lokalizacji i rozpoczynasz adres URL. Na przykład pins=custom||-122 45||http://contoso.com/pushpins/red.png Po kodowaniu adresu URL będzie to wyglądać następująco: pins=custom%7C%7C-122+45%7C%7Chttp%3A%2F%2Fcontoso.com%2Fpushpins%2Fred.png Domyślnie niestandardowe obrazy wypychania są rysowane wyśrodkowane na współrzędnych pinezki. Zwykle nie jest to idealne rozwiązanie, ponieważ ukrywa lokalizację, którą próbujesz wyróżnić. Aby zastąpić lokalizację kotwicy obrazu pinezki, użyj modyfikatora stylu "an". Korzysta to z tego samego formatu co modyfikator stylu kotwicy etykiety "la". Jeśli na przykład niestandardowy obraz pinezki zawiera końcówkę pinezki w lewym górnym rogu obrazu, możesz ustawić kotwicę na to miejsce, używając polecenia pins=custom|an0 0||-122 45||http://contoso.com/pushpins/red.png Uwaga: jeśli używasz modyfikatora koloru "co" z niestandardowym obrazem pushpin, określony kolor zastąpi kanały RGB pikseli na obrazie, ale pozostawi kanał alfa (nieprzezroczystość) bez zmian. Zwykle odbywa się to tylko przy użyciu obrazu niestandardowego w kolorze stałym. Pobieranie wypychań z usługi Azure Maps Data Storage Dla wszystkich jednostek SKU konta Azure Maps innych niż S0 można uzyskać informacje o obrazie i lokalizacji wypychania z usługi Azure Maps Data Storage. Po przekazaniu obrazu wypychania lub dokumentu GeoJSON zawierającego lokalizacje pinezki usługa Data Storage zwraca unikatowy identyfikator danych (UDID), którego można użyć do odwołwania się do danych w parametrze pins. Aby użyć niestandardowego obrazu pushpin z usługi Azure Maps Data Storage, określ prefiks UDID poprzedzony ciągiem "udid-" jako nazwę stylu pinezki. Na przykład pins=udid-fe22c504-3a81-4fcd-adc6-a3507ce866c1||-122 45 Aby użyć geometrii punktu z przekazanego dokumentu GeoJSON jako lokalizacji pinezki, określ identyfikator UDID w sekcji lokalizacji parametru pins. Na przykład pins=default||udid-29dc105a-dee7-409f-a3f9-22b066ae4713 Należy pamiętać, że zostanie użyta tylko geometria punktów i wielopunktów, punktów i punktów z kolekcji geometrycznych oraz geometria punktów z funkcji. Ciągi liniowe i geometria wielokąta zostaną zignorowane. Jeśli punkt pochodzi z funkcji, a funkcja ma właściwość ciągu o nazwie "label", wartość tej właściwości będzie używana jako etykieta pinezki. Lokalizacje numerów PIN można mieszać z magazynu danych i lokalizacji numerów PIN określonych w parametrze pins. Dowolna lokalizacja wyprowadzenia rozdzielanego potokiem może być długością geograficzną i szerokością geograficzną lub identyfikatorem UDID. Na przykład pins=default||-122 45|udid-29dc105a-dee7-409f-a3f9-22b066ae4713|-119 43 Skalowanie, rotacja i nieprzezroczystość Przy użyciu modyfikatora stylu skalowania "sc" można tworzyć pinezki i ich etykiety większe lub mniejsze. Jest to wartość większa niż zero. Wartość 1 to standardowa skala. Wartości większe niż 1 spowodują, że pinezki będą większe, a wartości mniejsze niż 1 będą mniejsze. Aby na przykład narysować pinezki o rozmiarze 50% większym niż normalnie, użyj polecenia pins=default|sc1.5||-122 45 Możesz obracać pinezki i ich etykiety przy użyciu modyfikatora stylu rotacji "ro". Jest to wiele stopni obrotu zgodnie z ruchem wskazówek zegara. Użyj liczby ujemnej, aby obrócić licznik zgodnie z ruchem wskazówek zegara. Na przykład, aby obrócić pchnięcia 90 stopni zgodnie z ruchem wskazówek zegara i podwoić ich rozmiar, użyj pins=default|ro90|sc2||-122 45 Wypychania i ich etykiety można częściowo przezroczyste, określając modyfikator stylu alfa "al". Jest to liczba z zakresu od 0 do 1 wskazująca nieprzezroczystość odepchnięć. Zero sprawia, że są całkowicie przezroczyste (i niewidoczne), a 1 sprawia, że są całkowicie nieprzezroczyste (co jest ustawieniem domyślnym). Na przykład, aby wypychać i ich etykiety tylko 67% nieprzezroczyste, użyj pins=default|al.67||-122 45 Podsumowanie modyfikatora stylu Modyfikator Opis Zakres Al Alfa (nieprzezroczystość) Od 0 do 1 an Przypinanie kotwicy * co Kolor pinezki Od 000000 do FFFFFF La Kotwica etykiety * Lc Kolor etykiety Od 000000 do FFFFFF ls Rozmiar etykiety Większe niż 0 Ro Wymiana -360 do 360 Sc Skalowanie Większe niż 0 Współrzędne X i Y mogą być w dowolnym miejscu w obrębie obrazu pinezki lub marginesu wokół niego. Rozmiar marginesu to minimalna szerokość i wysokość pinezki.
style	Styl mapy, który ma zostać zwrócony. Obecnie dostępny jest tylko styl główny. Możliwe wartości to: "main"
view	Parametr Widok określa, który zestaw geopolitycznie spornej zawartości jest zwracany za pośrednictwem usług Azure Maps, w tym obramowań i etykiet wyświetlanych na mapie. Parametr View (nazywany również "parametrem regionu użytkownika") pokaże poprawne mapy dla tego kraju/regionu. Domyślnie parametr Widok jest ustawiony na "Unified", nawet jeśli nie zdefiniowano go w żądaniu. Twoim zadaniem jest określenie lokalizacji użytkowników, a następnie poprawne ustawienie parametru View dla tej lokalizacji. Alternatywnie możesz ustawić opcję "View=Auto", która zwróci dane mapy na podstawie adresu IP żądania. Parametr View w Azure Maps musi być używany zgodnie z obowiązującymi przepisami, w tym z tymi dotyczącymi mapowania, kraju, w którym są udostępniane mapy, obrazy i inne dane oraz zawartość innych firm, do których masz uprawnienia dostępu za pośrednictwem Azure Maps. Przykład: view=IN. Aby uzyskać szczegółowe informacje, zapoznaj się z tematem Obsługiwane widoki i zobacz dostępne widoki.
width	Szerokość wynikowego obrazu w pikselach. Zakres wynosi od 1 do 8192. Wartość domyślna to 512. Nie należy jej używać z usługą bbox.
zoom	Żądany poziom powiększenia mapy. Wartość powiększenia musi być w zakresie: 0–20 (włącznie). Wartość domyślna to 12. Aby uzyskać szczegółowe informacje, zobacz Poziomy powiększenia i Siatka kafelków .

Właściwości dziedziczone

abortSignal	Sygnał, który może służyć do przerwania żądań.
customHeaders	{object} [customHeaders] Nagłówki żądań niestandardowych zdefiniowane przez użytkownika, które zostaną zastosowane przed wysłaniem żądania.
onDownloadProgress	Wywołanie zwrotne, które jest uruchamiane po postępie pobierania.
onUploadProgress	Wywołanie zwrotne, które jest uruchamiane po postępie przekazywania.
timeout	Liczba milisekund żądania może potrwać przed automatycznym kończeniem.

Szczegóły właściwości

bbox

Obwiedni. Używane projekcje — EPSG:3857. Format: "minLon, minLat, maxLon, maxLat". Uwaga: bbox lub środek są wymaganymi parametrami. Wzajemnie się wykluczają. Nie należy jej używać z wysokością ani szerokością.

Maksymalne dozwolone zakresy dla lat i Lon są definiowane dla każdego poziomu powiększenia w tabeli w górnej części tej strony.

bbox?: string

Wartość właściwości

string

center

Współrzędne punktu środkowego. Format: "lon,lat". Używane projekcje

• EPSG:3857. Zakres długości geograficznej: -180 do 180. Zakres szerokości geograficznej: -85 do 85. Uwaga: w środku lub w skrzynce odbiorczej są wymagane parametry. Wzajemnie się wykluczają.

center?: string

Wartość właściwości

string

height

Wysokość wynikowego obrazu w pikselach. Zakres wynosi od 1 do 8192. Wartość domyślna to 512. Nie należy jej używać z usługą bbox.

height?: number

Wartość właściwości

number

language

Język, w którym powinny być zwracane wyniki wyszukiwania. Powinien być jednym z obsługiwanych tagów języka IETF, bez uwzględniania wielkości liter. Gdy dane w określonym języku nie są dostępne dla określonego pola, używany jest język domyślny. Aby uzyskać szczegółowe informacje, zobacz Obsługiwane języki .

language?: string

Wartość właściwości

string

layer

Zażądano warstwy mapy. Jeśli warstwa jest ustawiona na etykiety lub hybrydę, format powinien być png. Możliwe wartości to: "basic", "hybrid", "labels"

layer?: StaticMapLayer

Wartość właściwości

StaticMapLayer

path

Styl ścieżki i lokalizacje. Użyj tego parametru, aby opcjonalnie dodać linie, wielokąty lub okręgi do obrazu. Styl ścieżki opisuje wygląd linii i wypełnienia. (Pamiętaj, aby poprawnie kodować wartości adresu URL tego parametru, ponieważ będzie zawierać zastrzeżone znaki, takie jak potoki i znaki interpunkcyjne). Parametr ścieżki jest obsługiwany w jednostce SKU konta Azure Maps począwszy od S1. Wiele wystąpień parametru ścieżki umożliwia określenie wielu geometrii ze swoimi stylami. Liczba parametrów na żądanie jest ograniczona do 10, a liczba lokalizacji jest ograniczona do 100 na ścieżkę.

Aby renderować okrąg z promieniem 100 metrów i punktem środkowym na szerokości geograficznej 45°N i długości geograficznej 122°W przy użyciu stylu domyślnego, dodaj parametr ciągu zapytania

path=ra100||-122 45

Należy pamiętać, że długość geograficzna przypada przed szerokością geograficzną. Po kodowaniu adresu URL będzie to wyglądać następująco:

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

Wszystkie przykłady w tym miejscu pokazują parametr ścieżki bez kodowania adresu URL, aby uzyskać przejrzystość.

Aby renderować linię, należy oddzielić każdą lokalizację znakiem potoku. Na przykład użyj polecenia

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

Aby renderować wielokąt, ostatnia lokalizacja musi być równa lokalizacji początkowej. Na przykład użyj polecenia

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

Wartości długości geograficznej i szerokości geograficznej dla lokalizacji linii i wielokątów mogą mieścić się w zakresie od -360 do 360, aby umożliwić renderowanie geometrii przekraczających anty-południk.

Modyfikatory stylów

Wygląd ścieżki można zmodyfikować, dodając modyfikatory stylów. Są one dodawane przed lokalizacjami. Modyfikatory stylów mają nazwę dwuliterową. Te skrócone nazwy są używane do zmniejszenia długości adresu URL.

Aby zmienić kolor konturu, użyj modyfikatora stylu "lc" i określ kolor przy użyciu formatu koloru HTML/CSS RGB, który jest sześciocyfrową liczbą szesnastkową (formularz trzycyfrowy nie jest obsługiwany). Aby na przykład użyć głębokiego różowego koloru, który określisz jako #FF1493 w arkuszu CSS, użyj polecenia

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

W celu utworzenia bardziej złożonego stylu można połączyć wiele modyfikatorów stylów.

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

Pobieranie lokalizacji ścieżki z magazynu danych Azure Maps

Dla wszystkich jednostek SKU konta Azure Maps innych niż S0 można uzyskać informacje o lokalizacji ścieżki z usługi Azure Maps Data Storage. Po przekazaniu dokumentu GeoJSON zawierającego lokalizacje ścieżki usługa Data Storage zwraca unikatowy identyfikator danych (UDID), którego można użyć do odwołwania się do danych w parametrze path.

Aby użyć geometrii punktu z przekazanego dokumentu GeoJSON jako lokalizacji ścieżki, określ identyfikator UDID w sekcji lokalizacji parametru ścieżki. Na przykład

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

Zwróć uwagę, że nie można mieszać lokalizacji ścieżek z magazynu danych z lokalizacjami określonymi w parametrze path.

Podsumowanie modyfikatora stylu

Modyfikator	Opis	Zakres
Lc	Kolor linii	000000 do FFFFFF
Fc	Kolor wypełnienia	000000 do FFFFFF
La	Linia alfa (nieprzezroczystość)	Od 0 do 1
Fa	Wypełnienie alfa (nieprzezroczystość)	Od 0 do 1
Lw	Szerokość linii	Większe niż 0
Ra	Promień okręgu (mierniki)	Większe niż 0

path?: string[]

Wartość właściwości

string[]

pins

Styl i wystąpienia wypychania. Użyj tego parametru, aby opcjonalnie dodać pinezki do obrazu. Styl pinezki opisuje wygląd pinezek, a wystąpienia określają współrzędne pinezek i opcjonalne etykiety dla każdego pinezki. (Pamiętaj, aby poprawnie kodować wartości adresu URL tego parametru, ponieważ będzie zawierać zastrzeżone znaki, takie jak potoki i znaki interpunkcyjne). Jednostka SKU konta Azure Maps S0 obsługuje tylko jedno wystąpienie parametru wyprowadzeń. Inne jednostki SKU zezwalają na wiele wystąpień parametru pinezki w celu określenia wielu stylów pinezki.

Aby renderować pinezki na szerokości geograficznej 45°N i długości geograficznej 122°W przy użyciu domyślnego wbudowanego stylu pinezki, dodaj parametr querystring

pins=default||-122 45

Należy pamiętać, że długość geograficzna jest wcześniejsza niż szerokość geograficzna. Po kodowaniu adresu URL będzie to wyglądać następująco:

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

Wszystkie przykłady w tym miejscu pokazują parametr pins bez kodowania adresu URL, aby uzyskać jasność.

Aby renderować pinezkę w wielu lokalizacjach, oddziel każdą lokalizację znakiem potoku. Na przykład użyj polecenia

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

Jednostka SKU konta S0 Azure Maps zezwala tylko na pięć wypychań. Inne jednostki SKU konta nie mają tego ograniczenia.

Modyfikatory stylu

Wygląd pinezek można modyfikować, dodając modyfikatory stylu. Są one dodawane po stylu, ale przed lokalizacjami i etykietami. Modyfikatory stylów mają dwie litery. Te skrócone nazwy są używane do zmniejszenia długości adresu URL.

Aby zmienić kolor pinezki, użyj modyfikatora stylu "co" i określ kolor przy użyciu formatu koloru HTML/CSS RGB, który jest sześciocyfrową liczbą szesnastkową (formularz trzycyfrowy nie jest obsługiwany). Aby na przykład użyć głębokiego różowego koloru, który należy określić jako #FF1493 w css, użyj polecenia

pins=default|coFF1493||-122 45

Etykiety wypychania

Aby dodać etykietę do pinezek, umieść etykietę w apostrofach tuż przed współrzędnymi. Aby na przykład oznaczyć trzy pinezki wartościami "1", "2" i "3", użyj polecenia

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

Istnieje wbudowany styl pinezki o nazwie "none", który nie wyświetla obrazu pinezki. Możesz użyć tej opcji, jeśli chcesz wyświetlać etykiety bez żadnego obrazu pinezki. Na przykład

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

Aby zmienić kolor etykiet pinezki, użyj modyfikatora stylu koloru etykiety "lc". Aby na przykład użyć różowych pinezki z czarnymi etykietami, użyj polecenia

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

Aby zmienić rozmiar etykiet, użyj modyfikatora stylu etykiet "ls". Rozmiar etykiety reprezentuje przybliżoną wysokość tekstu etykiety w pikselach. Aby na przykład zwiększyć rozmiar etykiety do 12, użyj polecenia

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

Etykiety są wyśrodkowane na odepchnięciu "kotwicy etykiety". Lokalizacja zakotwiczenia jest wstępnie zdefiniowana dla wbudowanych pinezki i znajduje się w górnej części niestandardowych pinezki (zobacz poniżej). Aby zastąpić kotwicę etykiety, użyj modyfikatora stylu "la" i podaj współrzędne X i Y pikseli dla kotwicy. Te współrzędne są względne względem lewego górnego rogu obrazu pinezki. Dodatnie wartości X przenoszą kotwicę w prawo, a dodatnie wartości Y przenoszą kotwicę w dół. Aby na przykład umieścić etykietę kotwicę 10 pikseli w prawo i 4 piksele powyżej lewego górnego rogu obrazu pushpin, użyj polecenia

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

Niestandardowe pinezki

Aby użyć niestandardowego obrazu pinezki, użyj wyrazu "custom" jako nazwy stylu pinezki, a następnie określ adres URL po informacjach o lokalizacji i etykiecie. Użyj dwóch znaków potoku, aby wskazać, że zakończono określanie lokalizacji i rozpoczynasz adres URL. Na przykład

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

Po kodowaniu adresu URL będzie to wyglądać następująco:

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

Domyślnie niestandardowe obrazy wypychania są rysowane wyśrodkowane na współrzędnych pinezki. Zwykle nie jest to idealne rozwiązanie, ponieważ ukrywa lokalizację, którą próbujesz wyróżnić. Aby zastąpić lokalizację kotwicy obrazu pinezki, użyj modyfikatora stylu "an". Korzysta to z tego samego formatu co modyfikator stylu kotwicy etykiety "la". Jeśli na przykład niestandardowy obraz pinezki zawiera końcówkę pinezki w lewym górnym rogu obrazu, możesz ustawić kotwicę na to miejsce, używając polecenia

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

Uwaga: jeśli używasz modyfikatora koloru "co" z niestandardowym obrazem pushpin, określony kolor zastąpi kanały RGB pikseli na obrazie, ale pozostawi kanał alfa (nieprzezroczystość) bez zmian. Zwykle odbywa się to tylko przy użyciu obrazu niestandardowego w kolorze stałym.

Pobieranie wypychań z usługi Azure Maps Data Storage

Dla wszystkich jednostek SKU konta Azure Maps innych niż S0 można uzyskać informacje o obrazie i lokalizacji wypychania z usługi Azure Maps Data Storage. Po przekazaniu obrazu wypychania lub dokumentu GeoJSON zawierającego lokalizacje pinezki usługa Data Storage zwraca unikatowy identyfikator danych (UDID), którego można użyć do odwołwania się do danych w parametrze pins.

Aby użyć niestandardowego obrazu pushpin z usługi Azure Maps Data Storage, określ prefiks UDID poprzedzony ciągiem "udid-" jako nazwę stylu pinezki. Na przykład

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

Aby użyć geometrii punktu z przekazanego dokumentu GeoJSON jako lokalizacji pinezki, określ identyfikator UDID w sekcji lokalizacji parametru pins. Na przykład

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

Należy pamiętać, że zostanie użyta tylko geometria punktów i wielopunktów, punktów i punktów z kolekcji geometrycznych oraz geometria punktów z funkcji. Ciągi liniowe i geometria wielokąta zostaną zignorowane. Jeśli punkt pochodzi z funkcji, a funkcja ma właściwość ciągu o nazwie "label", wartość tej właściwości będzie używana jako etykieta pinezki.

Lokalizacje numerów PIN można mieszać z magazynu danych i lokalizacji numerów PIN określonych w parametrze pins. Dowolna lokalizacja wyprowadzenia rozdzielanego potokiem może być długością geograficzną i szerokością geograficzną lub identyfikatorem UDID. Na przykład

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

Skalowanie, rotacja i nieprzezroczystość

Przy użyciu modyfikatora stylu skalowania "sc" można tworzyć pinezki i ich etykiety większe lub mniejsze. Jest to wartość większa niż zero. Wartość 1 to standardowa skala. Wartości większe niż 1 spowodują, że pinezki będą większe, a wartości mniejsze niż 1 będą mniejsze. Aby na przykład narysować pinezki o rozmiarze 50% większym niż normalnie, użyj polecenia

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

Możesz obracać pinezki i ich etykiety przy użyciu modyfikatora stylu rotacji "ro". Jest to wiele stopni obrotu zgodnie z ruchem wskazówek zegara. Użyj liczby ujemnej, aby obrócić licznik zgodnie z ruchem wskazówek zegara. Na przykład, aby obrócić pchnięcia 90 stopni zgodnie z ruchem wskazówek zegara i podwoić ich rozmiar, użyj

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

Wypychania i ich etykiety można częściowo przezroczyste, określając modyfikator stylu alfa "al". Jest to liczba z zakresu od 0 do 1 wskazująca nieprzezroczystość odepchnięć. Zero sprawia, że są całkowicie przezroczyste (i niewidoczne), a 1 sprawia, że są całkowicie nieprzezroczyste (co jest ustawieniem domyślnym). Na przykład, aby wypychać i ich etykiety tylko 67% nieprzezroczyste, użyj

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

Podsumowanie modyfikatora stylu

Modyfikator	Opis	Zakres
Al	Alfa (nieprzezroczystość)	Od 0 do 1
an	Przypinanie kotwicy	*
co	Kolor pinezki	Od 000000 do FFFFFF
La	Kotwica etykiety	*
Lc	Kolor etykiety	Od 000000 do FFFFFF
ls	Rozmiar etykiety	Większe niż 0
Ro	Wymiana	-360 do 360
Sc	Skalowanie	Większe niż 0

• Współrzędne X i Y mogą być w dowolnym miejscu w obrębie obrazu pinezki lub marginesu wokół niego. Rozmiar marginesu to minimalna szerokość i wysokość pinezki.

pins?: string[]

Wartość właściwości

string[]

style

Styl mapy, który ma zostać zwrócony. Obecnie dostępny jest tylko styl główny. Możliwe wartości to: "main"

style?: Style

Wartość właściwości

Style

view

Parametr Widok określa, który zestaw geopolitycznie spornej zawartości jest zwracany za pośrednictwem usług Azure Maps, w tym obramowań i etykiet wyświetlanych na mapie. Parametr View (nazywany również "parametrem regionu użytkownika") pokaże poprawne mapy dla tego kraju/regionu. Domyślnie parametr Widok jest ustawiony na "Unified", nawet jeśli nie zdefiniowano go w żądaniu. Twoim zadaniem jest określenie lokalizacji użytkowników, a następnie poprawne ustawienie parametru View dla tej lokalizacji. Alternatywnie możesz ustawić opcję "View=Auto", która zwróci dane mapy na podstawie adresu IP żądania. Parametr View w Azure Maps musi być używany zgodnie z obowiązującymi przepisami, w tym z tymi dotyczącymi mapowania, kraju, w którym są udostępniane mapy, obrazy i inne dane oraz zawartość innych firm, do których masz uprawnienia dostępu za pośrednictwem Azure Maps. Przykład: view=IN. Aby uzyskać szczegółowe informacje, zapoznaj się z tematem Obsługiwane widoki i zobacz dostępne widoki.

view?: string

Wartość właściwości

string

width

Szerokość wynikowego obrazu w pikselach. Zakres wynosi od 1 do 8192. Wartość domyślna to 512. Nie należy jej używać z usługą bbox.

width?: number

Wartość właściwości

number

zoom

Żądany poziom powiększenia mapy. Wartość powiększenia musi być w zakresie: 0–20 (włącznie). Wartość domyślna to 12.

Aby uzyskać szczegółowe informacje, zobacz Poziomy powiększenia i Siatka kafelków .

zoom?: number

Wartość właściwości

number

Szczegóły właściwości dziedziczonej

abortSignal

Sygnał, który może służyć do przerwania żądań.

abortSignal?: AbortSignalLike

Wartość właściwości

AbortSignalLike

Dziedziczone z RequestOptionsBase.abortSignal

customHeaders

{object} [customHeaders] Nagłówki żądań niestandardowych zdefiniowane przez użytkownika, które zostaną zastosowane przed wysłaniem żądania.

customHeaders?: [key: string]: string

Wartość właściwości

[key: string]: string

Dziedziczone z RequestOptionsBase.customHeaders

onDownloadProgress

Wywołanie zwrotne, które jest uruchamiane po postępie pobierania.

onDownloadProgress?: (progress: TransferProgressEvent) => void

Wartość właściwości

(progress: TransferProgressEvent) => void

Dziedziczone z RequestOptionsBase.onDownloadProgress

onUploadProgress

Wywołanie zwrotne, które jest uruchamiane po postępie przekazywania.

onUploadProgress?: (progress: TransferProgressEvent) => void

Wartość właściwości

(progress: TransferProgressEvent) => void

Dziedziczone z RequestOptionsBase.onUploadProgress

timeout

Liczba milisekund żądania może potrwać przed automatycznym kończeniem.

timeout?: number

Wartość właściwości

number

Dziedziczone z RequestOptionsBase.timeout