Render - Get Map Static Image

Usługa:

Maps

Wersja interfejsu API:

2024-04-01

Ten interfejs API renderowania tworzy statyczne, rasteryzowane widoki map dla obszaru zdefiniowanego przez użytkownika. Jest ona odpowiednia dla lekkich aplikacji internetowych, gdy wymagane środowisko użytkownika nie wymaga interaktywnych kontrolek mapy lub gdy przepustowość jest ograniczona. Ten interfejs API jest również przydatny do osadzania map w aplikacjach spoza przeglądarki, w usługach zaplecza, generowaniu raportów lub aplikacjach klasycznych.

Ten interfejs API zawiera parametry dla podstawowej wizualizacji danych:

• Oznaczone szpilkami w wielu stylach.
• Renderuj typy geometrii okręgu, ścieżki i wielokąta.

Aby uzyskać więcej informacji i szczegółowych przykładów, zobacz Renderowanie danych niestandardowych na mapie rasterowej.

Wymiary parametru bbox są ograniczone w zależności od poziomu powiększenia. Gwarantuje to, że wynikowy obraz ma odpowiedni poziom szczegółowości.

Poziom powiększenia	Minimalny zakres lonów	Maksymalny zakres lonów	Minimalny zakres lat	Maksymalny zakres lat
0	56.25	360.0	30.1105585173	180.0
1	28.125	360.0	14.87468995	180.0
2	14.063	351.5625	7.4130741851	137.9576312246
3	7.03125	175.78125	3.7034501005	73.6354071932
4	3.515625	87.890625	1.8513375155	35.4776115315
5	1.7578125	43.9453125	0.925620264	17.4589959239
6	0.87890625	21.97265625	0.4628040687	8.6907788223
7	0.439453125	10.986328125	0.2314012764	4.3404320789
8	0.2197265625	5.4931640625	0.1157005434	2.1695927024
9	0.1098632812	2.7465820312	0.0578502599	1.0847183194
10	0.0549316406	1.3732910156	0.0289251285	0.5423494021
11	0.0274658203	0.6866455078	0.014462564	0.2711734813
12	0.0137329102	0.3433227539	0.007231282	0.1355865882
13	0.0068664551	0.171661377	0.003615641	0.067793275
14	0.0034332275	0.0858306885	0.0018078205	0.0338966351
15	0.0017166138	0.0429153442	0.0009039102	0.0169483173
16	0.0008583069	0.0214576721	0.0004519551	0.0084741586
17	0.0004291534	0.0107288361	0.0002259776	0.0042370793
18	0.0002145767	0.005364418	0.0001129888	0.0021185396
19	0.0001072884	0.002682209	5.64944E-05	0.0010592698
20	5.36442E-05	0.0013411045	2.82472E-05	0.0005296349

Uwaga : parametr środkowy lub bbox musi zostać dostarczony do interfejsu API.

GET https://atlas.microsoft.com/map/static?api-version=2024-04-01

Z parametrami opcjonalnymi:

GET https://atlas.microsoft.com/map/static?api-version=2024-04-01&tilesetId={tilesetId}&trafficLayer={trafficLayer}&zoom={zoom}&center={center}&bbox={bbox}&height={height}&width={width}&language={language}&view={view}&pins={pins}&path={path}

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
api-version	query	True	string	Numer wersji interfejsu API usługi Azure Maps. Bieżąca wersja to 2024-04-01.
bbox	query		number[]	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: bbox lub środek są wymaganymi parametrami. Wzajemnie się wykluczają. Pole bbox nie powinno być używane z wysokością ani szerokością. Maksymalne i minimalne dozwolone zakresy dla lat i Lon są definiowane dla każdego poziomu powiększenia w tabeli w górnej części tej strony.
center	query		number[]	Współrzędne punktu środkowego w podwójnej. Format: 'lon,lat'. Zakres długości geograficznej: -180 do 180. Zakres szerokości geograficznej: od -90 do 90. Uwaga: środkowe lub skrzynka odbiorcza są wymaganymi parametrami. Wzajemnie się wykluczają.
height	query		integer int32	Wysokość wynikowego obrazu w pikselach. Zakres od 80 do 1500. Wartość domyślna to 512. Nie należy go używać z bbox.
language	query		string	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, zapoznaj się z tematem Obsługiwane języki .
path	query		string[]	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. (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 usługi 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 Wielokąt jest określony z zamkniętą ścieżką, 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 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 Podsumowanie modyfikatora stylu Modyfikator Opis Typ Zakres Lc Kolor linii ciąg 000000 do FFFFFF Fc Kolor wypełnienia ciąg 000000 do FFFFFF la Linia alfa (nieprzezroczystość) float Od 0 do 1 Fa Wypełnienie alfa (nieprzezroczystość) float Od 0 do 1 Lw Szerokość linii int32 (0, 50] Ra Promień okręgu (mierniki) float Większe niż 0
pins	query		string[]	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 (w podwójnej) 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 usługi Azure Maps S0 obsługuje tylko jedno wystąpienie parametru pinezek. 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 usługi Azure Maps S0 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. 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 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. Maksymalny dozwolony rozmiar niestandardowego obrazu etykiety to 65 536 pikseli. 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 pushpin są rysowane 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ę zakotwiczenia obrazu pinezki, użyj modyfikatora stylu "an". Używa to 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 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ć szpilki 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ć szpilki 50% większe niż normalnie, użyj polecenia pins=default|sc1.5||-122 45 Przy użyciu modyfikatora stylu rotacji "ro" można obracać szpilki i ich etykiety. Jest to wiele stopni obrotu zgodnie z ruchem wskazówek zegara. Użyj liczby ujemnej, aby obracać licznik zgodnie z ruchem wskazówek zegara. Na przykład, aby obracać szpilki 90 stopni w ruchem wskazówek zegara i podwoić ich rozmiar, użyj pins=default|ro90|sc2||-122 45 Można tworzyć szpilki 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ść szpilek. 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 tworzyć szpilki pushpin i ich etykiety tylko 67% nieprzezroczyste, użyj polecenia pins=default|al.67||-122 45 Podsumowanie modyfikatora stylu Modyfikator Opis Typ Zakres Al Alfa (nieprzezroczystość) float Od 0 do 1 an Przypinanie kotwicy <int32, int32> * co Kolor pinezki ciąg 000000 do FFFFFF la Kotwica etykiety <int32, int32> * Lc Kolor etykiety ciąg 000000 do FFFFFF ls Rozmiar etykiety float Większe niż 0 Ro Wymiana float -360 do 360 Sc Skalowanie float 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.
tilesetId	query		TilesetId	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 (Identyfikator zestawu kafelków renderowania).
trafficLayer	query		TrafficTilesetId	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, co oznacza, że żaden przepływ ruchu nie został zwrócony. 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 (Identyfikator zestawu kafelków renderowania).
view	query		LocalizedMapView	Parametr View (nazywany również parametrem "region użytkownika") umożliwia wyświetlanie prawidłowych map dla określonego kraju/regionu dla spornych geopolitycznie regionów. Różne kraje/regiony mają różne widoki takich regionów, a parametr Wyświetl umożliwia aplikacji zachowanie zgodności 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 i wyświetlić dostępne widoki, zapoznaj się z tematem Obsługiwane widoki .
width	query		integer int32	Szerokość obrazu wynikowego w pikselach. Zakres od 80 do 2000. Wartość domyślna to 512. Nie należy jej używać z bbox.
zoom	query		integer int32	Żądany poziom powiększenia mapy. Obsługa zakresu wartości powiększenia 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 od 0 do 19 (włącznie) dla elementu tilesetId to microsoft.imagery. Wartość domyślna to 12. Aby uzyskać więcej informacji, zobacz Poziomy powiększenia i Siatka kafelków.

Nagłówek żądania

Nazwa	Wymagane	Typ	Opis
x-ms-client-id		string	Określa, które konto jest przeznaczone do użycia w połączeniu z modelem zabezpieczeń Microsoft Entra ID. Reprezentuje unikatowy identyfikator konta usługi Azure Maps i można go pobrać z interfejsu API konta płaszczyzny zarządzania usługi Azure Maps. Aby użyć zabezpieczeń microsoft Entra ID w usłudze Azure Maps, zobacz następujące artykuły , aby uzyskać wskazówki.
Accept		MediaType	Pole Zaakceptuj nagłówek może służyć do określania preferencji dotyczących typów nośników odpowiedzi. Dozwolone typy multimediów obejmują obraz/jpeg i obraz/png. Zwraca obraz w obrazie/png, jeśli nie określono nagłówka Accept.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	object	Ten obraz jest zwracany z pomyślnego wywołania pobierz statyczny obraz mapy. Media Types: "image/jpeg", "image/png" Nagłówki Content-Type: string
Other Status Codes	ErrorResponse	Wystąpił nieoczekiwany błąd. Media Types: "image/jpeg", "image/png"

Zabezpieczenia

AADToken

Są to przepływy protokołu Microsoft Entra OAuth 2.0 . W połączeniu z kontrolą dostępu opartą na rolach platformy Azure może służyć do kontrolowania dostępu do interfejsów API REST usługi Azure Maps. Mechanizmy kontroli dostępu oparte na rolach platformy Azure służą do wyznaczania dostępu do co najmniej jednego konta zasobów usługi Azure Maps lub zasobów podrzędnych. Każdy użytkownik, grupa lub jednostka usługi może mieć dostęp za pośrednictwem wbudowanej roli lub roli niestandardowej składającej się z co najmniej jednego uprawnienia do interfejsów API REST usługi Azure Maps.

Aby zaimplementować scenariusze, zalecamy wyświetlenie pojęć dotyczących uwierzytelniania. Podsumowując, ta definicja zabezpieczeń udostępnia rozwiązanie do modelowania aplikacji za pośrednictwem obiektów, które mogą kontrolować dostęp do określonych interfejsów API i zakresów.

Uwagi

• Ta definicja zabezpieczeń wymaga użycia nagłówka x-ms-client-id , aby wskazać, do którego zasobu usługi Azure Maps aplikacja żąda dostępu. Można to uzyskać za pomocą interfejsu API zarządzania mapami.

Element Authorization URL jest specyficzny dla wystąpienia chmury publicznej platformy Azure. Suwerenne chmury mają unikatowe adresy URL autoryzacji i konfiguracje identyfikatorów entra firmy Microsoft. * Kontrola dostępu oparta na rolach platformy Azure jest konfigurowana z płaszczyzny zarządzania platformy Azure za pośrednictwem witryny Azure Portal, programu PowerShell, interfejsu wiersza polecenia, zestawów AZURE SDK lub interfejsów API REST. * Użycie zestawu Sdk sieci Web usługi Azure Maps umożliwia konfigurację opartą na konfiguracji aplikacji w wielu przypadkach użycia.

• Aby uzyskać więcej informacji na temat platformy tożsamości firmy Microsoft, zobacz Omówienie platformy tożsamości firmy Microsoft.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
https://atlas.microsoft.com/.default	https://atlas.microsoft.com/.default

subscription-key

Jest to klucz wspólny aprowizowany podczas tworzenia zasobu usługi Azure Maps za pośrednictwem płaszczyzny zarządzania platformy Azure za pośrednictwem witryny Azure Portal, programu PowerShell, interfejsu wiersza polecenia, zestawów SDK platformy Azure lub interfejsów API REST.

Przy użyciu tego klucza każda aplikacja jest autoryzowana do uzyskiwania dostępu do wszystkich interfejsów API REST. Innymi słowy, mogą one być obecnie traktowane jako klucze główne do konta, dla którego są wystawiane.

W przypadku publicznie uwidocznionych aplikacji naszym zaleceniem jest użycie dostępu serwera do serwera interfejsów API REST usługi Azure Maps, w których ten klucz może być bezpiecznie przechowywany.

Typ: apiKey
W: header

SAS Token

Jest to token sygnatury dostępu współdzielonego tworzony na podstawie operacji listy sygnatur dostępu współdzielonego w zasobie usługi Azure Maps za pośrednictwem płaszczyzny zarządzania platformy Azure za pośrednictwem witryny Azure Portal, programu PowerShell, interfejsu wiersza polecenia, zestawów SDK platformy Azure lub interfejsów API REST.

Przy użyciu tego tokenu każda aplikacja jest autoryzowana do uzyskiwania dostępu za pomocą kontroli dostępu opartej na rolach platformy Azure i szczegółowej kontroli wygaśnięcia, szybkości i regionów użycia dla określonego tokenu. Innymi słowy, token sygnatury dostępu współdzielonego może służyć do umożliwienia aplikacjom kontrolowania dostępu w bardziej bezpieczny sposób niż klucz wspólny.

W przypadku publicznie uwidocznionych aplikacji zalecamy skonfigurowanie określonej listy dozwolonych źródeł w zasobie konta mapy w celu ograniczenia nadużyć renderowania i regularnego odnawiania tokenu SYGNATURy dostępu współdzielonego.

Typ: apiKey
W: header

Przykłady

Successful Static Image Request

Przykładowe żądanie

HTTP

GET https://atlas.microsoft.com/map/static?api-version=2024-04-01&tilesetId=microsoft.base.road&zoom=10&center=-122.177621,47.613079

Przykładowa odpowiedź

Kod stanu:

200

Content-Type: image/png

"{file}"

Definicje

Nazwa	Opis
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail	Szczegóły błędu.
ErrorResponse	Odpowiedź na błąd
LocalizedMapView	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 aplikacja będzie obsługiwać. 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 usłudze Azure Maps musi być używany zgodnie z obowiązującymi przepisami, w tym z tymi dotyczącymi mapowania, kraju/regionu, 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 usługi Azure Maps. Przykład: view=IN. Aby uzyskać szczegółowe informacje, zapoznaj się z tematem Obsługiwane widoki i zobacz dostępne widoki.
MediaType	Pole Zaakceptuj nagłówek może służyć do określania preferencji dotyczących typów nośników odpowiedzi. Dozwolone typy multimediów obejmują obraz/jpeg i obraz/png. Zwraca obraz w obrazie/png, jeśli nie określono nagłówka Accept.
TilesetId	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 jest ustawiona na wartość microsoft.base.road. Aby uzyskać więcej informacji, zobacz Render TilesetId (Render TilesetId).
TrafficTilesetId	Opcjonalna wartość wskazująca, że żaden przepływ ruchu nie jest nakładany na wynik obrazu. Możliwe wartości to microsoft.traffic.relative.main i brak. Wartość domyślna nie jest żadna, co oznacza, że nie jest zwracany żaden przepływ ruchu. 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 (Render TilesetId).

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa	Typ	Opis
info	object	Dodatkowe informacje.
type	string	Dodatkowy typ informacji.

ErrorDetail

Szczegóły błędu.

Nazwa	Typ	Opis
additionalInfo	ErrorAdditionalInfo[]	Dodatkowe informacje o błędzie.
code	string	Kod błędu.
details	ErrorDetail[]	Szczegóły błędu.
message	string	Komunikat o błędzie.
target	string	Element docelowy błędu.

ErrorResponse

Odpowiedź na błąd

Nazwa	Typ	Opis
error	ErrorDetail	Obiekt błędu.

LocalizedMapView

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 aplikacja będzie obsługiwać. 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 usłudze Azure Maps musi być używany zgodnie z obowiązującymi przepisami, w tym z tymi dotyczącymi mapowania, kraju/regionu, 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 usługi Azure Maps. Przykład: view=IN.

Aby uzyskać szczegółowe informacje, zapoznaj się z tematem Obsługiwane widoki i zobacz dostępne widoki.

Nazwa	Typ	Opis
AE	string	Zjednoczone Emiraty Arabskie (widok arabski)
AR	string	Argentyna (widok argentyński)
Auto	string	Zwróć dane mapy na podstawie adresu IP żądania.
BH	string	Bahrajn (widok arabski)
IN	string	Indie (Widok indyjski)
IQ	string	Irak (widok arabski)
JO	string	Jordania (widok arabski)
KW	string	Kuwejt (widok arabski)
LB	string	Liban (widok arabski)
MA	string	Maroko (widok marokański)
OM	string	Oman (widok arabski)
PK	string	Pakistan (Widok pakistanu)
PS	string	Autonomia Palestyńska (widok arabski)
QA	string	Katar (widok arabski)
SA	string	Arabia Saudyjska (widok arabski)
SY	string	Syria (widok arabski)
Unified	string	Ujednolicony widok (inne)
YE	string	Jemen (widok arabski)

MediaType

Pole Zaakceptuj nagłówek może służyć do określania preferencji dotyczących typów nośników odpowiedzi. Dozwolone typy multimediów obejmują obraz/jpeg i obraz/png. Zwraca obraz w obrazie/png, jeśli nie określono nagłówka Accept.

Nazwa	Typ	Opis
image/jpeg	string	Zwraca obraz w formacie jpeg.
image/png	string	Zwraca obraz w formacie png.

TilesetId

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 jest ustawiona na wartość microsoft.base.road. Aby uzyskać więcej informacji, zobacz Render TilesetId (Render TilesetId).

Nazwa	Typ	Opis
microsoft.base.darkgrey	string	TilesetId zawiera wszystkie warstwy z naszym ciemnym szarym stylem.
microsoft.base.road	string	TilesetId zawiera wszystkie warstwy z renderowaniem głównego stylu.
microsoft.imagery	string	TilesetId zawiera kombinację zdjęć satelitarnych i lotniczych.

TrafficTilesetId

Opcjonalna wartość wskazująca, że żaden przepływ ruchu nie jest nakładany na wynik obrazu. Możliwe wartości to microsoft.traffic.relative.main i brak. Wartość domyślna nie jest żadna, co oznacza, że nie jest zwracany żaden przepływ ruchu. 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 (Render TilesetId).

Nazwa	Typ	Opis
microsoft.traffic.relative.main	string	Obsługiwane identyfikatory kafelków powiązanych z ruchem.
none	string	Wartość domyślna, brak nakładki przepływu ruchu.