Merender data kustom pada peta raster
Artikel ini menjelaskan cara menggunakan perintah Dapatkan Gambar Statis Peta dengan fungsionalitas komposisi gambar. Fungsionalitas komposisi gambar mendukung pengambilan petak peta raster statis yang berisi data kustom dan gaya yang berbeda.
Berikut ini adalah contoh data kustom:
- Pushpin kustom
- Label
- Overlay geometri
Tip
Untuk menampilkan peta sederhana di halaman web, sering kali lebih hemat biaya untuk menggunakan Azure Maps Web SDK, daripada menggunakan layanan gambar statis. SDK web menggunakan petak peta; dan kecuali pengguna menggeser dan memperbesar peta, mereka akan sering menghasilkan hanya sebagian kecil dari transaksi per beban peta menggunakan penembolokan browser. Azure Maps Web SDK memiliki opsi untuk menonaktifkan panning dan zoom. Selain itu, Azure Maps Web SDK menyediakan serangkaian opsi visualisasi data yang lebih kaya daripada layanan web peta statis.
Prasyarat
Penting
Dalam contoh URL, ganti {Your-Azure-Maps-Subscription-key}
dengan kunci langganan Azure Maps Anda.
Artikel ini menggunakan aplikasi Bruno , tetapi Anda dapat menggunakan lingkungan pengembangan API yang berbeda.
Catatan
Contoh dalam artikel ini memerlukan akun Azure Maps di tingkat harga Gen2.
Penghentian tingkat harga Azure Maps Gen1
Tingkat harga Gen1 sekarang tidak digunakan lagi dan akan dihentikan pada 15/9/26. Tingkat harga Gen2 menggantikan tingkat harga Gen1 (baik S0 maupun S1). Jika akun Azure Maps Anda memiliki tingkat harga Gen1 yang dipilih, Anda dapat beralih ke harga Gen2 sebelum dihentikan, jika tidak, akun tersebut akan diperbarui secara otomatis. Untuk informasi selengkapnya, lihat Mengelola tingkat harga akun Azure Maps Anda.
Mendapatkan gambar statik dengan pin dan label kustom
Untuk mendapatkan gambar statik dengan pin dan label kustom:
Di aplikasi Bruno, pilih Permintaan Baru.
Atur jenis ke HTTP.
Masukkan Nama untuk permintaan, seperti Dapatkan Gambar Statis Peta.
Pilih metode URL HTTP GET .
Masukkan URL berikut:
https://atlas.microsoft.com/map/static?subscription-key={Your-Azure-Maps-Subscription-key}&zoom=13&tilesetId=microsoft.base.road&api-version=2024-04-01&language=en-us¢er=-73.964085, 40.78477&path=lcFF0000|lw2|la0.60|ra700||-122.13230609893799 47.64599069048016&pins=custom%7Cla15+50%7Cls12%7Clc003b61%7C%7C%27Central Park%27-73.9657974+40.781971%7C%7Chttps%3A%2F%2Fsamples.azuremaps.com%2Fimages%2Ficons%2Fylw-pushpin.png
Pilih Buat.
Pilih panah Kirim Permintaan yang muncul di sebelah kanan URL permintaan.
Gambar berikut dikembalikan:
Merender poligon dengan warna dan tingkat keburaman
Anda dapat memodifikasi tampilan poligon dengan menggunakan pengubah gaya dengan parameter jalur.
Untuk merender poligon dengan warna dan tingkat keburaman:
Di aplikasi Bruno, pilih Permintaan Baru.
Atur jenis ke HTTP.
Masukkan Nama untuk permintaan tersebut, seperti GET Polygon.
Pilih metode URL HTTP GET .
Masukkan URL berikut ke layanan Render :
https://atlas.microsoft.com/map/static?subscription-key={Your-Azure-Maps-Subscription-key}&zoom=15&tilesetId=microsoft.base.road&api-version=2024-04-01&language=en-us&path=lc0000FF|fc0000FF|lw3|la0.80|fa0.50||-74.03995513916016 40.70090237454063|-74.04082417488098 40.70028420372218|-74.04113531112671 40.70049568385827|-74.04298067092896 40.69899904076542|-74.04271245002747 40.69879568992435|-74.04367804527283 40.6980961582905|-74.04364585876465 40.698055487620714|-74.04368877410889 40.698022951066996|-74.04168248176573 40.696444909137|-74.03901100158691 40.69837271818651|-74.03824925422668 40.69837271818651|-74.03809905052185 40.69903971085914|-74.03771281242369 40.699340668780984|-74.03940796852112 40.70058515602143|-74.03948307037354 40.70052821920425|-74.03995513916016 40.70090237454063&pins=custom%7Cla15+50%7Cls12%7Clc003b61%7C%7C%27Central Park%27-73.9657974+40.781971%7C%7Chttps%3A%2F%2Fsamples.azuremaps.com%2Fimages%2Ficons%2Fylw-pushpin.png¢er=-74.040701, 40.698666&height=500&Width=500
Gambar berikut dikembalikan:
Merender lingkaran dan pin tekan dengan label kustom
Anda dapat memodifikasi tampilan pin dengan menambahkan pengubah gaya. Misalnya, untuk membuat pin tekan dan labelnya lebih besar atau lebih kecil, sc
gunakan pengubah "gaya skala". Pengubah ini mengambil nilai yang lebih besar dari nol. Nilai 1 adalah skala standar. Nilai yang lebih besar dari 1 membuat pin lebih besar, dan nilai yang lebih kecil dari 1 membuatnya lebih kecil. Untuk informasi selengkapnya tentang pengubah gaya, lihat parameter Jalur perintah Dapatkan Gambar Statis Peta.
Untuk merender lingkaran dan pushpin dengan label kustom:
Di aplikasi Bruno, pilih Permintaan Baru.
Atur jenis ke HTTP.
Masukkan Nama untuk permintaan tersebut, seperti GET Polygon.
Pilih metode URL HTTP GET .
Masukkan URL berikut ke layanan Render :
https://atlas.microsoft.com/map/static?subscription-key={Your-Azure-Maps-Subscription-key}&zoom=14&tilesetId=microsoft.base.road&api-version=2024-04-01&language=en-us¢er=-122.13230609893799,47.64599069048016&path=lcFF0000|lw2|la0.60|ra1000||-122.13230609893799 47.64599069048016&pins=default|la15+50|sc1|al0.66|lc003C62|co002D62||'Microsoft Corporate Headquarters'-122.14131832122801 47.64690503939462|'Microsoft Visitor Center'-122.136828 47.642224|'Microsoft Conference Center'-122.12552547454833 47.642940335653996|'Microsoft The Commons'-122.13687658309935 47.64452336193245&height=700&Width=700
Pilih Buat.
Pilih panah Kirim Permintaan yang muncul di sebelah kanan URL permintaan.
Gambar berikut dikembalikan:
Selanjutnya, ubah warna pushpin dengan memodifikasi
co
pengubah gaya. Jika Anda melihat nilaipins
parameter (pins=default|la15+50|al0.66|lc003C62|co002D62|
), perhatikan bahwa warna saat ini adalah#002D62
. Untuk mengubah warna menjadi#41d42a
, ganti#002D62
dengan#41d42a
. Sekarang parameterpins
adalahpins=default|la15+50|al0.66|lc003C62|co41D42A|
. Permintaan terlihat seperti URL berikut:https://atlas.microsoft.com/map/static?subscription-key={Your-Azure-Maps-Subscription-key}&zoom=14&tilesetId=microsoft.base.road&api-version=2024-04-01&language=en-us¢er=-122.13230609893799,47.64599069048016&path=lcFF0000|lw2|la0.60|ra1000||-122.13230609893799 47.64599069048016&pins=default|la15+50|al0.66|lc003C62|co41D42A||'Microsoft Corporate Headquarters'-122.14131832122801 47.64690503939462|'Microsoft Visitor Center'-122.136828 47.642224|'Microsoft Conference Center'-122.12552547454833 47.642940335653996|'Microsoft The Commons'-122.13687658309935 47.64452336193245&height=700&Width=700
Pilih Buat.
Pilih panah Kirim Permintaan yang muncul di sebelah kanan URL permintaan.
Gambar berikut dikembalikan:
Demikian pula, Anda dapat mengubah, menambahkan, dan menghapus pengubah gaya lainnya.
Menambahkan lapisan lalu lintas
Untuk mendapatkan gambar statis dengan lapisan lalu lintas yang dirender pada peta dasar jalan, gunakan trafficLayer
parameter . Contoh berikut menunjukkan peta dengan lapisan lalu lintas dan pin dengan label:
Di aplikasi Bruno, pilih Permintaan Baru.
Atur jenis ke HTTP.
Masukkan Nama untuk permintaan, seperti Dapatkan Gambar Statis Peta - lapisan lalu lintas.
Pilih metode URL HTTP GET .
Masukkan URL berikut:
https://atlas.microsoft.com/map/static?subscription-key={Your-Azure-Maps-Subscription-key}&zoom=14&tilesetId=microsoft.base.road&api-version=2024-04-01&language=en-us¢er= -0.122427, 51.500867&pins=custom%7Cla15+50%7Cls12%7Clc003b61%7C%7C%27Westminster Bridge%27-0.122427+51.500867%7C%7Chttps%3A%2F%2Fsamples.azuremaps.com%2Fimages%2Ficons%2Fylw-pushpin.png&height=700&Width=700&trafficLayer=microsoft.traffic.relative.main
Pilih Buat.
Pilih panah Kirim Permintaan yang muncul di sebelah kanan URL permintaan.
Gambar berikut dikembalikan:
Membuat peta menggunakan gaya abu-abu gelap
Untuk mendapatkan gambar statis dengan gaya abu-abu gelap yang diterapkan, atur parameter ke TilesetId
microsoft.base.darkgrey
:
Di aplikasi Bruno, pilih Permintaan Baru.
Atur jenis ke HTTP.
Masukkan Nama untuk permintaan, seperti Dapatkan Gambar Statis Peta - gaya abu-abu gelap.
Pilih metode URL HTTP GET .
Masukkan URL berikut:
https://atlas.microsoft.com/map/static?subscription-key={Your-Azure-Maps-Subscription-key}&zoom=16&tilesetId=microsoft.base.darkgrey&api-version=2024-04-01&language=en-us¢er=-95.360200,29.753452&pins=custom%7Cla15+50%7Cls12%7Clc003b61%7C%7C%27Westminster Bridge%27-0.122427+51.500867%7C%7Chttps%3A%2F%2Fsamples.azuremaps.com%2Fimages%2Ficons%2Fylw-pushpin.png&height=700&Width=700
Pilih Buat.
Pilih panah Kirim Permintaan yang muncul di sebelah kanan URL permintaan.
Gambar berikut dikembalikan:
Untuk informasi selengkapnya tentang berbagai gaya yang tersedia menggunakan parameter TilesetId, lihat TilesetId di dokumentasi REnder - Get Map Tileset REST API.
Membuat peta menggunakan gaya citra
Untuk mendapatkan gambar statis dengan gaya citra yang diterapkan, atur parameter ke TilesetId
microsoft.imagery
:
Di aplikasi Bruno, pilih Permintaan Baru.
Atur jenis ke HTTP.
Masukkan Nama untuk permintaan, seperti Dapatkan Gambar Statis Peta - gaya citra.
Pilih metode URL HTTP GET .
Masukkan URL berikut:
https://atlas.microsoft.com/map/static?subscription-key={Your-Azure-Maps-Subscription-key}&zoom=16&tilesetId=microsoft.imagery&api-version=2024-04-01&language=en-us¢er=-43.176141,-22.965458&height=700&Width=700
Pilih Buat.
Pilih panah Kirim Permintaan yang muncul di sebelah kanan URL permintaan.
Gambar berikut dikembalikan:
Untuk informasi selengkapnya tentang berbagai gaya yang tersedia menggunakan parameter TilesetId, lihat TilesetId di dokumentasi REnder - Get Map Tileset REST API.