Render - Get Map Static Image

Referensi

Layanan:: Maps

Versi API:: 2024-04-01

API penyajian ini menghasilkan tampilan peta statis dan raster dari area yang ditentukan pengguna. Ini cocok untuk aplikasi web ringan, ketika pengalaman pengguna yang diinginkan tidak memerlukan kontrol peta interaktif, atau ketika bandwidth terbatas. API ini juga berguna untuk menyematkan peta dalam aplikasi di luar browser, di layanan backend, pembuatan laporan, atau aplikasi desktop.

API ini mencakup parameter untuk visualisasi data dasar:

Pin pendorongan berlabel dalam beberapa gaya.
Merender jenis geometri lingkaran, jalur, dan poligon.

Untuk informasi selengkapnya dan contoh terperinci, lihat Merender data kustom pada peta raster.

Dimensi parameter bbox dibatasi, tergantung pada tingkat zoom. Ini memastikan gambar yang dihasilkan memiliki tingkat detail yang sesuai.

Tingkat Zoom	Rentang Lon Min	Rentang Lon Maks	Rentang Laju Min	Rentang Laju Maks
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

Catatan : Parameter pusat atau bbox harus disediakan ke API.

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

Dengan parameter opsional:

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}

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi

api-version

query

True

string

Nomor versi API Azure Maps. Versi saat ini adalah 2024-04-01.

bbox

query

number[]

Kotak pembatas didefinisikan oleh dua garis lintang dan dua bujur yang mewakili empat sisi area persegi panjang di Bumi. Format : 'minLon, minLat, maxLon, maxLat' (dalam ganda).

Catatan: Baik bbox atau tengah adalah parameter yang diperlukan. Mereka saling eksklusif. bbox tidak boleh digunakan dengan tinggi atau lebar.

Rentang maksimum dan minimum yang diizinkan untuk Lat dan Lon ditentukan untuk setiap tingkat pembesaran tampilan dalam tabel di bagian atas halaman ini.

center

query

number[]

Koordinat titik tengah dalam ganda. Format: 'lon,lat'. Rentang garis bujur: -180 hingga 180. Rentang garis lintang: -90 hingga 90.

Catatan: Baik tengah atau bbox adalah parameter yang diperlukan. Mereka saling eksklusif.

height

query

integer

int32

Tinggi gambar yang dihasilkan dalam piksel. Rentang dari 80 hingga 1500. Defaultnya adalah 512. Ini tidak boleh digunakan dengan bbox.

language

query

string

Bahasa di mana hasil pencarian harus dikembalikan. Harus menjadi salah satu tag bahasa IETF yang didukung, tidak peka huruf besar/kecil. Saat data dalam bahasa tertentu tidak tersedia untuk bidang tertentu, bahasa default digunakan.

Silakan merujuk ke Bahasa yang Didukung untuk detailnya.

path

query

string[]

Gaya dan lokasi jalur (ganda). Gunakan parameter ini untuk menambahkan garis, poligon, atau lingkaran secara opsional ke gambar. Gaya jalur menjelaskan tampilan garis dan isi. (Pastikan untuk mengodekan nilai url dengan benar dari parameter ini karena akan berisi karakter yang dipesan seperti pipa dan tanda baca.)

Parameter jalur didukung di SKU akun Azure Maps yang dimulai dengan S1. Beberapa instans parameter jalur memungkinkan untuk menentukan beberapa geometri dengan gayanya. Jumlah parameter per permintaan dibatasi hingga 10 dan jumlah lokasi dibatasi hingga 100 per jalur.

Untuk merender lingkaran dengan radius 100 meter dan titik tengah pada garis lintang 45°N dan bujur 122°W menggunakan gaya default, tambahkan parameter querystring

path=ra100||-122 45

Perhatikan bahwa bujur datang sebelum garis lintang. Setelah pengodean URL, ini akan terlihat seperti

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

Semua contoh di sini menunjukkan parameter jalur tanpa pengodean URL, untuk kejelasan.

Untuk merender garis, pisahkan setiap lokasi dengan karakter pipa. Misalnya, gunakan

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

Poligon ditentukan dengan jalur tertutup, di mana titik pertama dan terakhir sama. Misalnya, gunakan

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

Nilai bujur untuk lokasi garis dan poligon dapat berada dalam kisaran -360 hingga 360 untuk memungkinkan penyajian geometri yang melintasi anti-meridian.

Pengubah Gaya

Anda dapat memodifikasi tampilan jalur dengan menambahkan pengubah gaya. Ini ditambahkan sebelum lokasi. Pengubah gaya masing-masing memiliki nama dua huruf. Nama singkatan ini digunakan untuk membantu mengurangi panjang URL.

Untuk mengubah warna kerangka, gunakan pengubah gaya 'lc' dan tentukan warna menggunakan format warna HTML/CSS RGB yang merupakan angka heksadesimal enam digit (bentuk tiga digit tidak didukung). Misalnya, untuk menggunakan warna merah muda mendalam yang akan Anda tentukan sebagai #FF1493 di CSS, gunakan

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

Pengubah beberapa gaya dapat digabungkan untuk membuat gaya visual yang lebih kompleks.

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

Ringkasan Pengubah Gaya

Pengubah	Deskripsi	Jenis	Rentang
Lc	Warna garis	string	000000 ke FFFFFF
Fc	Warna isian	string	000000 ke FFFFFF
la	Alfa garis (opasitas)	float	0 hingga 1
fa	Isi alfa (opasitas)	float	0 hingga 1
Lw	Lebar garis	int32	(0, 50]
Ra	Radius lingkaran (meter)	float	Lebih besar dari 0

pins

query

string[]

Gaya dan instans pushpin. Gunakan parameter ini untuk menambahkan pushpin secara opsional ke gambar. Gaya pushpin menjelaskan tampilan pushpin, dan instans menentukan koordinat pushpin (dalam label ganda) dan opsional untuk setiap pin. (Pastikan untuk mengodekan nilai url parameter ini dengan benar karena akan berisi karakter khusus seperti pipa dan tanda baca.)

SKU S0 akun Azure Maps hanya mendukung satu instans parameter pin. SKU lainnya memungkinkan beberapa instans parameter pin untuk menentukan beberapa gaya pin.

Untuk merender pushpin pada garis lintang 45°N dan bujur 122°W menggunakan gaya pushpin bawaan default, tambahkan parameter querystring

pins=default||-122 45

Perhatikan bahwa bujur datang sebelum garis lintang. Setelah pengodean URL, ini akan terlihat seperti

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

Semua contoh di sini menunjukkan parameter pin tanpa pengodean URL, untuk kejelasan.

Untuk merender pin di beberapa lokasi, pisahkan setiap lokasi dengan karakter pipa. Misalnya, gunakan

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

SKU akun S0 Azure Maps hanya mengizinkan lima pushpin. SKU akun lain tidak memiliki batasan ini.

Pengubah Gaya

Anda dapat memodifikasi tampilan pin dengan menambahkan pengubah gaya. Ini ditambahkan setelah gaya tetapi sebelum lokasi dan label. Pengubah gaya masing-masing memiliki nama dua huruf. Nama yang disingkat ini digunakan untuk membantu mengurangi panjang URL.

Untuk mengubah warna pushpin, gunakan pengubah gaya 'co' dan tentukan warna menggunakan format warna HTML/CSS RGB yang merupakan angka heksadesimal enam digit (bentuk tiga digit tidak didukung). Misalnya, untuk menggunakan warna merah muda dalam yang akan Anda tentukan sebagai #FF1493 di CSS, gunakan

pins=default|coFF1493||-122 45

Label Pushpin

Untuk menambahkan label ke pin, letakkan label dalam tanda kutip tunggal tepat sebelum koordinat. Hindari menggunakan karakter khusus seperti | atau || di label. Misalnya, untuk memberi label tiga pin dengan nilai '1', '2', dan '3', gunakan

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

Ada gaya pushpin bawaan yang disebut 'none' yang tidak menampilkan gambar pushpin. Anda dapat menggunakan ini jika Anda ingin menampilkan label tanpa gambar pin apa pun. Misalnya,

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

Untuk mengubah warna label pushpin, gunakan pengubah gaya warna label 'lc'. Misalnya, untuk menggunakan pink pushpin dengan label hitam, gunakan

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

Untuk mengubah ukuran label, gunakan pengubah gaya ukuran label 'ls'. Ukuran label menunjukkan perkiraan tinggi teks label dalam piksel. Misalnya, untuk meningkatkan ukuran label menjadi 12, gunakan

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

Label dipusatkan di pushpin 'jangkar label.' Lokasi jangkar telah ditentukan sebelumnya untuk pushpin bawaan dan berada di pusat atas pushpin kustom (lihat di bawah). Untuk mengganti jangkar label, gunakan pengubah gaya 'la' dan menyediakan koordinat piksel X dan Y untuk jangkar. Koordinat ini relatif terhadap sudut kiri atas gambar pushpin. Nilai X positif memindahkan jangkar ke kanan, dan nilai Y positif memindahkan jangkar ke bawah. Misalnya, untuk memosisikan jangkar label 10 piksel ke kanan dan 4 piksel di atas sudut kiri atas gambar pushpin, gunakan

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

Pushpin Kustom

Untuk menggunakan gambar pushpin kustom, gunakan kata 'kustom' sebagai nama gaya pin, lalu tentukan URL setelah informasi lokasi dan label. Ukuran maksimum yang diizinkan untuk gambar label yang disesuaikan adalah 65.536 piksel. Gunakan dua karakter pipa untuk menunjukkan bahwa Anda selesai menentukan lokasi dan memulai URL. Misalnya,

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

Setelah pengodean URL, ini akan terlihat seperti

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

Secara default, gambar pushpin kustom digambar di tengah pada koordinat pin. Ini biasanya tidak ideal karena mengaburkan lokasi yang coba Anda sorot. Untuk mengganti lokasi jangkar gambar pin, gunakan pengubah gaya 'an'. Ini menggunakan format yang sama dengan pengubah gaya jangkar label 'la'. Misalnya, jika gambar pin kustom Anda memiliki ujung pin di sudut kiri atas gambar, Anda dapat mengatur jangkar ke tempat tersebut dengan menggunakan

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

Catatan: Jika Anda menggunakan pengubah warna 'co' dengan gambar pushpin kustom, warna yang ditentukan akan menggantikan saluran RGB piksel dalam gambar tetapi akan membuat saluran alfa (opasitas) tidak berubah. Ini biasanya hanya akan dilakukan dengan gambar kustom warna solid.

Skala, Rotasi, dan Opasitas

Anda dapat membuat pushpin dan labelnya lebih besar atau lebih kecil dengan menggunakan pengubah gaya skala 'sc'. Ini adalah nilai yang lebih besar dari nol. Nilai 1 adalah skala standar. Nilai yang lebih besar dari 1 akan membuat pin lebih besar, dan nilai yang lebih kecil dari 1 akan membuatnya lebih kecil. Misalnya, untuk menggambar pushpin 50% lebih besar dari biasanya, gunakan

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

Anda dapat memutar pushpin dan labelnya dengan menggunakan pengubah gaya rotasi 'ro'. Ini adalah sejumlah derajat rotasi searah jajaran jam. Gunakan angka negatif untuk memutar berlawanan searah jajar. Misalnya, untuk memutar pushpin 90 derajat searah jarang dan menggandakan ukurannya, gunakan

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

Anda dapat membuat pushpin dan labelnya sebagian transparan dengan menentukan pengubah gaya alfa 'al'. Ini adalah angka antara 0 dan 1 yang menunjukkan keburaman pushpin. Nol membuatnya benar-benar transparan (dan tidak terlihat) dan 1 membuatnya benar-benar buram (yang merupakan default). Misalnya, untuk membuat pushpin dan labelnya hanya 67% buram, gunakan

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

Ringkasan Pengubah Gaya

Pengubah	Deskripsi	Jenis	Rentang
al	Alfa (opasitas)	float	0 hingga 1
an	Sematkan jangkar	<int32, int32>	*
co	Sematkan warna	string	000000 ke FFFFFF
la	Jangkar label	<int32, int32>	*
Lc	Warna label	string	000000 ke FFFFFF
Is	Ukuran label	float	Lebih besar dari 0
ro	Rotasi	float	-360 hingga 360
Sc	Skala	float	Lebih besar dari 0

Koordinat X dan Y dapat berada di mana saja dalam gambar pin atau margin di sekitarnya. Ukuran margin adalah minimum lebar dan tinggi pin.

tilesetId

query

TilesetId

Gaya peta yang akan dikembalikan. Nilai yang mungkin adalah microsoft.base.road, microsoft.base.darkgrey, dan microsoft.imagery. Nilai default diatur menjadi microsoft.base.road. Untuk informasi selengkapnya, lihat Render TilesetId.

trafficLayer

query

TrafficTilesetId

Nilai Opsional, menunjukkan tidak ada arus lalu lintas yang dilapisi pada hasil gambar. Nilai yang mungkin adalah microsoft.traffic.relative.main dan none. Nilai default tidak ada, menunjukkan tidak ada arus lalu lintas yang dikembalikan. Jika tilesetId terkait lalu lintas disediakan, akan mengembalikan gambar peta dengan lapisan lalu lintas yang sesuai. Untuk informasi selengkapnya, lihat Render TilesetId.

view

query

LocalizedMapView

Parameter Tampilan (juga disebut parameter "wilayah pengguna"), memungkinkan Anda menampilkan peta yang benar untuk negara/wilayah tertentu untuk wilayah yang disengketakan secara geopolitik. Negara/wilayah yang berbeda memiliki tampilan yang berbeda dari wilayah tersebut, dan parameter Tampilan memungkinkan aplikasi Anda untuk mematuhi tampilan yang diperlukan oleh negara/wilayah yang akan dilayani aplikasi Anda. Secara default, parameter Tampilan diatur ke "Terpadu" meskipun Anda belum menentukannya dalam permintaan. Anda bertanggung jawab untuk menentukan lokasi pengguna Anda, lalu mengatur parameter Tampilan dengan benar untuk lokasi tersebut. Atau, Anda memiliki opsi untuk mengatur 'View=Auto', yang akan mengembalikan data peta berdasarkan alamat IP permintaan. Parameter Tampilan di Azure Maps harus digunakan sesuai dengan undang-undang yang berlaku, termasuk yang berkaitan dengan pemetaan, negara/wilayah tempat peta, gambar, dan data lain dan konten pihak ketiga yang diizinkan untuk Anda akses melalui Azure Maps tersedia. Contoh: view=IN.

Silakan lihat Tampilan yang Didukung untuk detailnya dan untuk melihat Tampilan yang tersedia.

width

query

integer

int32

Lebar gambar yang dihasilkan dalam piksel. Rentang dari 80 hingga 2000. Defaultnya adalah 512. Ini tidak boleh digunakan dengan bbox.

zoom

query

integer

int32

Tingkat pembesaran tampilan peta yang diinginkan. Mendukung rentang nilai zoom dari 0-20 (inklusif) untuk tilesetId menjadi microsoft.base.road atau microsoft.base.darkgrey. Mendukung rentang nilai zoom dari 0-19 (inklusif) untuk tilesetId menjadi microsoft.imagery. Nilai defaultnya adalah 12.

Untuk informasi selengkapnya, lihat Tingkat Pembesaran Tampilan dan Kisi Petak Peta.

Header Permintaan

Nama	Diperlukan	Jenis	Deskripsi
x-ms-client-id		string	Menentukan akun mana yang ditujukan untuk penggunaan bersama dengan model keamanan ID Microsoft Entra. Ini mewakili ID unik untuk akun Azure Maps dan dapat diambil dari API Akun bidang manajemen Azure Maps. Untuk menggunakan keamanan ID Microsoft Entra di Azure Maps, lihat artikel berikut ini untuk panduan.
Accept		MediaType	Bidang Terima header dapat digunakan untuk menentukan preferensi mengenai jenis media respons. Jenis media yang diizinkan termasuk gambar/jpeg dan gambar/png. Mengembalikan gambar dalam gambar/png jika header Terima tidak ditentukan.

Respons

Nama	Jenis	Deskripsi
200 OK	object	Gambar ini dikembalikan dari panggilan Get Map Static Image yang berhasil. Media Types: "image/jpeg", "image/png" Header Content-Type: string
Other Status Codes	ErrorResponse	Terjadi kesalahan tak terduga. Media Types: "image/jpeg", "image/png"

Nama

Jenis

Deskripsi

200 OK

object

Gambar ini dikembalikan dari panggilan Get Map Static Image yang berhasil.

Media Types: "image/jpeg", "image/png"

Header

Content-Type: string

Other Status Codes

ErrorResponse

Terjadi kesalahan tak terduga.

Media Types: "image/jpeg", "image/png"

Keamanan

AADToken

Ini adalah Alur Microsoft Entra OAuth 2.0 . Saat dipasangkan dengan kontrol akses berbasis peran Azure , kontrol akses tersebut dapat digunakan untuk mengontrol akses ke REST API Azure Maps. Kontrol akses berbasis peran Azure digunakan untuk menunjuk akses ke satu atau beberapa akun sumber daya atau sub-sumber daya Azure Maps. Setiap pengguna, grup, atau perwakilan layanan dapat diberikan akses melalui peran bawaan atau peran kustom yang terdiri dari satu atau beberapa izin ke REST API Azure Maps.

Untuk menerapkan skenario, sebaiknya lihat konsep autentikasi. Singkatnya, definisi keamanan ini menyediakan solusi untuk memodelkan aplikasi melalui objek yang mampu mengontrol akses pada API dan cakupan tertentu.

Catatan

Definisi keamanan ini memerlukan penggunaan x-ms-client-id header untuk menunjukkan sumber daya Azure Maps mana yang meminta akses aplikasi. Ini dapat diperoleh dari API manajemen Maps.

Authorization URL khusus untuk instans cloud publik Azure. Sovereign cloud memiliki URL Otorisasi yang unik dan konfigurasi ID Microsoft Entra. * Kontrol akses berbasis peran Azure dikonfigurasi dari bidang manajemen Azure melalui portal Microsoft Azure, PowerShell, CLI, Azure SDK, atau REST API. * Penggunaan Azure Maps Web SDK memungkinkan penyiapan aplikasi berbasis konfigurasi untuk beberapa kasus penggunaan.

Untuk informasi selengkapnya tentang platform identitas Microsoft, lihat Gambaran umum platform identitas Microsoft.

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama	Deskripsi
https://atlas.microsoft.com/.default	https://atlas.microsoft.com/.default

subscription-key

Ini adalah kunci bersama yang disediakan saat membuat sumber daya Azure Maps melalui bidang manajemen Azure melalui portal Microsoft Azure, PowerShell, CLI, Azure SDK, atau REST API.

Dengan kunci ini, aplikasi apa pun berwenang untuk mengakses semua REST API. Dengan kata lain, saat ini dapat diperlakukan sebagai kunci master ke akun tempat kunci tersebut dikeluarkan.

Untuk aplikasi yang diekspos secara publik, rekomendasi kami adalah menggunakan akses server-ke-server dari REST API Azure Maps tempat kunci ini dapat disimpan dengan aman.

Jenis: apiKey
Dalam: header

SAS Token

Ini adalah token tanda tangan akses bersama dibuat dari operasi Daftar SAS pada sumber daya Azure Maps melalui bidang manajemen Azure melalui portal Microsoft Azure, PowerShell, CLI, Azure SDK, atau REST API.

Dengan token ini, aplikasi apa pun berwenang untuk mengakses dengan kontrol akses berbasis peran Azure dan kontrol halus ke kedaluwarsa, laju, dan wilayah penggunaan untuk token tertentu. Dengan kata lain, Token SAS dapat digunakan untuk memungkinkan aplikasi mengontrol akses dengan cara yang lebih aman daripada kunci bersama.

Untuk aplikasi yang diekspos secara publik, rekomendasi kami adalah mengonfigurasi daftar asal tertentu yang diizinkan di sumber daya akun Peta untuk membatasi penyalahgunaan penyalahgunaan dan memperbarui Token SAS secara teratur.

Jenis: apiKey
Dalam: header

Contoh

Successful Static Image Request

Permintaan sampel

HTTP

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

Respon sampel

Kode status:: 200

Content-Type: image/png

"{file}"

Definisi

Nama	Deskripsi
ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
ErrorDetail	Detail kesalahan.
ErrorResponse	Respons kesalahan
LocalizedMapView	Parameter Tampilan (juga disebut parameter "wilayah pengguna"), memungkinkan Anda menampilkan peta yang benar untuk negara/wilayah tertentu untuk wilayah yang disengketakan secara geopolitik. Negara/wilayah yang berbeda memiliki tampilan yang berbeda dari wilayah tersebut, dan parameter Tampilan memungkinkan aplikasi Anda untuk mematuhi tampilan yang diperlukan oleh negara/wilayah yang akan dilayani aplikasi Anda. Secara default, parameter Tampilan diatur ke "Terpadu" meskipun Anda belum menentukannya dalam permintaan. Anda bertanggung jawab untuk menentukan lokasi pengguna Anda, lalu mengatur parameter Tampilan dengan benar untuk lokasi tersebut. Atau, Anda memiliki opsi untuk mengatur 'View=Auto', yang akan mengembalikan data peta berdasarkan alamat IP permintaan. Parameter Tampilan di Azure Maps harus digunakan sesuai dengan hukum yang berlaku, termasuk yang berkaitan dengan pemetaan, negara/wilayah tempat peta, gambar, dan data lain dan konten pihak ketiga yang berwenang untuk Anda akses melalui Azure Maps tersedia. Contoh: view=IN. Silakan lihat Tampilan yang Didukung untuk detailnya dan untuk melihat Tampilan yang tersedia.
MediaType	Bidang Terima header dapat digunakan untuk menentukan preferensi mengenai jenis media respons. Jenis media yang diizinkan termasuk gambar/jpeg dan gambar/png. Mengembalikan gambar dalam gambar/png jika header Terima tidak ditentukan.
TilesetId	Gaya peta yang akan dikembalikan. Nilai yang mungkin adalah microsoft.base.road, microsoft.base.darkgrey, dan microsoft.imagery. Nilai default diatur menjadi microsoft.base.road. Untuk informasi selengkapnya, lihat Render TilesetId.
TrafficTilesetId	Nilai Opsional, menunjukkan tidak ada arus lalu lintas yang dilapisi pada hasil gambar. Nilai yang mungkin adalah microsoft.traffic.relative.main dan none. Nilai default tidak ada, menunjukkan tidak ada arus lalu lintas yang dikembalikan. Jika tilesetId terkait lalu lintas disediakan, akan mengembalikan gambar peta dengan lapisan lalu lintas yang sesuai. Untuk informasi selengkapnya, lihat Render TilesetId.

ErrorAdditionalInfo

Info tambahan kesalahan manajemen sumber daya.

Nama	Jenis	Deskripsi
info	object	Info tambahan.
type	string	Jenis info tambahan.

ErrorDetail

Detail kesalahan.

Nama	Jenis	Deskripsi
additionalInfo	ErrorAdditionalInfo[]	Info tambahan kesalahan.
code	string	Kode kesalahan.
details	ErrorDetail[]	Detail kesalahan.
message	string	Pesan kesalahan.
target	string	Target kesalahan.

ErrorResponse

Respons kesalahan

Nama	Jenis	Deskripsi
error	ErrorDetail	Objek kesalahan.

LocalizedMapView

Parameter Tampilan (juga disebut parameter "wilayah pengguna"), memungkinkan Anda menampilkan peta yang benar untuk negara/wilayah tertentu untuk wilayah yang disengketakan secara geopolitik. Negara/wilayah yang berbeda memiliki tampilan yang berbeda dari wilayah tersebut, dan parameter Tampilan memungkinkan aplikasi Anda untuk mematuhi tampilan yang diperlukan oleh negara/wilayah yang akan dilayani aplikasi Anda. Secara default, parameter Tampilan diatur ke "Terpadu" meskipun Anda belum menentukannya dalam permintaan. Anda bertanggung jawab untuk menentukan lokasi pengguna Anda, lalu mengatur parameter Tampilan dengan benar untuk lokasi tersebut. Atau, Anda memiliki opsi untuk mengatur 'View=Auto', yang akan mengembalikan data peta berdasarkan alamat IP permintaan. Parameter Tampilan di Azure Maps harus digunakan sesuai dengan hukum yang berlaku, termasuk yang berkaitan dengan pemetaan, negara/wilayah tempat peta, gambar, dan data lain dan konten pihak ketiga yang berwenang untuk Anda akses melalui Azure Maps tersedia. Contoh: view=IN.

Silakan lihat Tampilan yang Didukung untuk detailnya dan untuk melihat Tampilan yang tersedia.

Nama	Jenis	Deskripsi
AE	string	Uni Emirat Arab (Tampilan Arab)
AR	string	Argentina (Tampilan Argentina)
Auto	string	Kembalikan data peta berdasarkan alamat IP permintaan.
BH	string	Bahrain (Tampilan Arab)
IN	string	India (Tampilan India)
IQ	string	Irak (Tampilan Arab)
JO	string	Yordania (Tampilan Arab)
KW	string	Kuwait (Tampilan Arab)
LB	string	Lebanon (Tampilan Arab)
MA	string	Maroko (Tampilan Maroko)
OM	string	Oman (Tampilan Arab)
PK	string	Pakistan (Tampilan Pakistan)
PS	string	Otoritas Palestina (Tampilan Arab)
QA	string	Qatar (Tampilan Arab)
SA	string	Arab Saudi (Tampilan Arab)
SY	string	Suriah (Tampilan Arab)
Unified	string	Tampilan Terpadu (Lainnya)
YE	string	Yaman (Tampilan Arab)

MediaType

Bidang Terima header dapat digunakan untuk menentukan preferensi mengenai jenis media respons. Jenis media yang diizinkan termasuk gambar/jpeg dan gambar/png. Mengembalikan gambar dalam gambar/png jika header Terima tidak ditentukan.

Nama	Jenis	Deskripsi
image/jpeg	string	Mengembalikan gambar dalam format jpeg.
image/png	string	Mengembalikan gambar dalam format png.

TilesetId

Nama	Jenis	Deskripsi
microsoft.base.darkgrey	string	TilesetId berisi semua lapisan dengan gaya abu-abu gelap kami.
microsoft.base.road	string	TilesetId berisi semua lapisan dengan gaya utama penyajian.
microsoft.imagery	string	TilesetId berisi kombinasi citra satelit dan udara.

TrafficTilesetId

Nama	Jenis	Deskripsi
microsoft.traffic.relative.main	string	TilesetId terkait lalu lintas yang didukung.
none	string	Nilai default, tidak ada overlay arus lalu lintas.

Bagikan melalui

Render - Get Map Static Image

Parameter URI

Pengubah Gaya

Ringkasan Pengubah Gaya

Pengubah Gaya

Label Pushpin

Pushpin Kustom

Skala, Rotasi, dan Opasitas

Ringkasan Pengubah Gaya

Header Permintaan

Respons

Keamanan

AADToken

Catatan

Cakupan

subscription-key

SAS Token

Contoh

Successful Static Image Request

Permintaan sampel

Respon sampel

Definisi

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

LocalizedMapView

MediaType

TilesetId

TrafficTilesetId

Sumber Daya Tambahan: