RenderGetMapStaticImageQueryParamProperties interface

Pole ograniczenia jest definiowane przez dwie szerokości geograficzne i dwie długości geograficzne reprezentujące cztery boki prostokątnego obszaru na Ziemi. Format: "minLon, minLat, maxLon, maxLat" (w podwójnej).

Uwaga: pole bbox lub środek są wymaganymi parametrami. Wzajemnie się wykluczają. Bbox nie powinien być używany z wysokością ani szerokością.

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

bbox?: number[]

Wartość właściwości

Współrzędne punktu środkowego w podwójnej. Format: "lon,lat". Zakres długości geograficznej: -180 do 180. Zakres szerokości geograficznej: -90 do 90.

Uwaga: w środku lub w skrzynce odbiorczej wymagane są parametry. Wzajemnie się wykluczają.

center?: number[]

Wartość właściwości

Wysokość wynikowego obrazu w pikselach. Zakres od 80 do 1500. Wartość domyślna to 512. Nie należy jej używać ze skrzynką odbiorczą.

height?: number

Wartość właściwości

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. Jeśli 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

Styl ścieżki i lokalizacje (w podwójnej). 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. (Upewnij się, że poprawnie koduje wartości adresu URL tego parametru, ponieważ będzie zawierać znaki zarezerwowane, takie jak potoki i znaki interpunkcyjne).

Parametr ścieżki jest obsługiwany w jednostce SKU konta usługi Azure Maps, począwszy od S1. Wiele wystąpień parametru ścieżki umożliwia określenie wielu geometrii przy użyciu ich stylów. 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 jest wcześniejsza niż szerokość geograficzna. 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ć jasność.

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

Wielokąt jest określany przy użyciu zamkniętej ścieżki, gdzie pierwsze i ostatnie punkty są równe. Na przykład użyj polecenia

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

Wartość długości geograficznej dla lokalizacji linii i wielokątów może być 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 stylu. 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

Podsumowanie modyfikatora stylu

path?: string

Wartość właściwości

Styl i wystąpienia wypychania. Użyj tego parametru, aby opcjonalnie dodać pinezki push do obrazu. Styl wypychania opisuje wygląd pinezek, a wystąpienia określają współrzędne wypychań (w podwójnej) i opcjonalne etykiety dla każdego pinezki. (Upewnij się, że poprawnie koduje wartości adresu URL tego parametru, ponieważ będzie zawierać znaki zarezerwowane, takie jak potoki i znaki interpunkcyjne).

Jednostka SKU konta usługi Azure Maps S0 obsługuje tylko jedno wystąpienie parametru pins, a liczba lokalizacji jest ograniczona do 5 na pin. Inne jednostki SKU umożliwiają określenie wielu stylów pinezki do 25 wystąpień, a liczba lokalizacji jest ograniczona do 50 na pinezkę.

Aby renderować pinezki na szerokości geograficznej 45°N i długości geograficznej 122°W przy użyciu domyślnego wbudowanego stylu pushpin, 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, należy oddzielić 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 usługi Azure Maps S0 zezwala tylko na pięć wypychań. Inne jednostki SKU konta nie mają tego ograniczenia.

Modyfikatory stylów

Wygląd pinezek można modyfikować, dodając modyfikatory stylów. Są one dodawane po stylu, ale przed lokalizacjami i etykietami. Modyfikatory stylów mają nazwę dwuliterową. 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 określisz jako #FF1493 w arkuszu CSS, użyj polecenia

pins=default|coFF1493||-122 45

Etykiety wypychania

Aby dodać etykietę do pinezek, umieść etykietę w pojedynczych cudzysłowach tuż przed współrzędnymi. Unikaj używania znaku specjalnego, takiego jak | lub || w etykiecie. 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 pushpin o nazwie "none", który nie wyświetla obrazu pushpin. Możesz użyć tej opcji, jeśli chcesz wyświetlić etykiety bez żadnego obrazu pinezki. Na przykład

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

Aby zmienić kolor etykiet wypychania, użyj modyfikatora 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 pchnięciu "kotwica 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 pushpin. Dodatnie wartości X przenoszą kotwicę po prawej stronie, 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 pushpin, użyj słowa "custom" jako nazwy stylu pinezki, a następnie określ adres URL po informacjach o lokalizacji i etykiecie. Maksymalny dozwolony rozmiar obrazu niestandardowej etykiety to 65 536 pikseli. Użyj dwóch znaków potoku, aby wskazać, że skończysz określać lokalizacje i uruchamiać adres URL. Na przykład

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

Po kodowaniu adresu URL wyglądałoby to następująco:

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

Domyślnie niestandardowe obrazy pushpin są rysowane wyśrodkowane na współrzędnych pinezki. Zwykle nie jest to idealne rozwiązanie, ponieważ zaciemnia lokalizację, którą próbujesz wyróżnić. Aby zastąpić lokalizację kotwicy obrazu pinezki, użyj modyfikatora stylu "an". Używa 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 przy użyciu polecenia

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

Uwaga: jeśli używasz modyfikatora kolorów "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.

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 sprawią, że pinezki będą większe, a wartości mniejsze niż 1 będą mniejsze. Aby na przykład narysować pinezki 50% większe niż normalnie, użyj

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

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

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

Możesz ustawić odepchnięcia i ich etykiety 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 wartością domyślną). Aby na przykład zrobić pinezki i ich etykiety tylko 67% nieprzezroczyste, użyj

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

Podsumowanie modyfikatora stylu

• Współrzędne X i Y mogą znajdować się w dowolnym miejscu na obrazie pinezki lub na marginesie wokół niego. Rozmiar marginesu to minimalna szerokość i wysokość pinezki.

pins?: string

Wartość właściwości

Styl mapy, który ma zostać zwrócony. Możliwe wartości to microsoft.base.road, microsoft.base.darkgrey i microsoft.imagery. Wartość domyślna to microsoft.base.road. Aby uzyskać więcej informacji, zobacz 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"

Wartość właściwości

Opcjonalna wartość wskazująca brak nakładania przepływu ruchu na wynik obrazu. Możliwe wartości to microsoft.traffic.relative.main i brak. Wartość domyślna to brak wskazujący, że przepływ ruchu nie jest zwracany. Jeśli podano identyfikator kafelków powiązanych z ruchem, zostanie zwrócony obraz mapy z odpowiednią warstwą ruchu. Aby uzyskać więcej informacji, zobacz Render TilesetId.

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

Wartość właściwości

Parametr View (nazywany również parametrem "region użytkownika") umożliwia wyświetlanie poprawnych map dla określonego kraju/regionu dla regionów spornych geopolitycznie. Różne kraje/regiony mają różne widoki takich regionów, a parametr View umożliwia aplikacji zgodność z widokiem wymaganym przez kraj/region, który będzie obsługiwać aplikacja. Domyślnie parametr Widok jest ustawiony na wartość "Unified", nawet jeśli nie zdefiniowano go w żądaniu. Twoim zadaniem jest określenie lokalizacji użytkowników, a następnie poprawne ustawienie parametru Wyświetl dla tej lokalizacji. Alternatywnie możesz ustawić opcję "View=Auto", która zwróci dane mapy na podstawie adresu IP żądania. Parametr View w usłudze Azure Maps musi być używany zgodnie z obowiązującymi przepisami, w tym z przepisami dotyczącymi mapowania kraju/regionu, w którym udostępniane są mapy, obrazy i inne dane oraz zawartość innych firm, do których masz uprawnienia dostępu za pośrednictwem usługi Azure Maps. Przykład: view=IN.

Aby uzyskać szczegółowe informacje, zobacz Obsługiwane widoki, aby uzyskać szczegółowe informacje i wyświetlić dostępne widoki.

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

Wartość właściwości

Szerokość wynikowego obrazu w pikselach. Zakres od 80 do 2000. Wartość domyślna to 512. Nie należy jej używać z bbox.

width?: number

Wartość właściwości

Żądany poziom powiększenia mapy. Obsługa zakresu wartości powiększenia z zakresu od 0 do 20 (włącznie) dla parametrów tilesetId to microsoft.base.road lub microsoft.base.darkgrey. Obsługa zakresu wartości powiększenia z zakresu od 0 do 19 (włącznie) dla parametru tilesetId to microsoft.imagery. Wartość domyślna to 12.

Aby uzyskać więcej informacji, zobacz Poziomy powiększenia i Siatka kafelków.

zoom?: number

Wartość właściwości