Share via

RenderGetMapImageOptionalParams interface

  • Referensi
Paket:
azure-maps-rest

Parameter opsional.

Extends

RequestOptionsBase

Properti

bbox

Kotak pembatas. Proyeksi yang digunakan - EPSG:3857. Format : 'minLon, minLat, maxLon, maxLat'. Catatan: Baik bbox atau tengah adalah parameter yang diperlukan. Mereka saling eksklusif. Ini tidak boleh digunakan dengan tinggi atau lebar.

Rentang maksimum yang diizinkan untuk Lat dan Lon ditentukan untuk setiap tingkat zoom dalam tabel di bagian atas halaman ini.
center

Koordinat titik tengah. Format: 'lon,lat'. Proyeksi yang digunakan

  • EPSG:3857. Rentang garis bujur: -180 hingga 180. Rentang garis lintang: -85 hingga 85. Catatan: Baik tengah atau bbox adalah parameter yang diperlukan. Mereka saling eksklusif.
height

Tinggi gambar yang dihasilkan dalam piksel. Rentangnya adalah 1 hingga 8192. Defaultnya adalah 512. Ini tidak boleh digunakan dengan bbox.
language

Bahasa tempat 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.
layer

Lapisan peta diminta. Jika lapisan diatur ke label atau hibrid, formatnya harus png. Nilai yang mungkin termasuk: 'basic', 'hybrid', 'labels'
path

Gaya dan lokasi jalur. 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 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

Untuk merender poligon, lokasi terakhir harus sama dengan lokasi mulai. Misalnya, gunakan

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

Nilai garis bujur dan garis lintang untuk lokasi garis dan poligon dapat berkisar dari -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 bersama-sama 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

Mendapatkan lokasi Jalur dari Azure Maps Data Storage

Untuk semua SKU akun Azure Maps selain S0, informasi lokasi jalur dapat diperoleh dari Azure Maps Data Storage. Setelah mengunggah dokumen GeoJSON yang berisi lokasi jalur, layanan Penyimpanan Data mengembalikan ID Data Unik (UDID) yang dapat Anda gunakan untuk mereferensikan data di parameter jalur.

Untuk menggunakan geometri titik dari dokumen GeoJSON yang diunggah sebagai lokasi jalur, tentukan UDID di bagian lokasi parameter jalur. Misalnya,

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

Perhatikan bahwa tidak diizinkan untuk mencampur lokasi jalur dari Penyimpanan Data dengan lokasi yang ditentukan dalam parameter jalur.

Ringkasan Pengubah Gaya

Pengubah Deskripsi Rentang
Lc Warna garis 000000 ke FFFFFF
Fc Warna isian 000000 ke FFFFFF
la Alfa garis (opasitas) 0 hingga 1
fa Isi alfa (opasitas) 0 hingga 1
Lw Lebar garis Lebih besar dari 0
Ra Radius lingkaran (meter) Lebih besar dari 0
pins

Gaya dan instans pushpin. Gunakan parameter ini untuk menambahkan pushpin secara opsional ke gambar. Gaya pushpin menjelaskan tampilan pushpin, dan instans menentukan koordinat pushpin dan label opsional untuk setiap pin. (Pastikan untuk mengodekan nilai url parameter ini dengan benar karena akan berisi karakter khusus seperti pipa dan tanda baca.) Akun Azure Maps S0 SKU 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 Azure Maps S0 hanya memungkinkan 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. 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. 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 berpusat 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 (oacity) tidak berubah. Ini biasanya hanya akan dilakukan dengan gambar kustom warna solid.

Mendapatkan Pushpin dari Azure Maps Data Storage

Untuk semua SKU akun Azure Maps selain S0, gambar pushpin dan informasi lokasi dapat diperoleh dari Azure Maps Data Storage. Setelah mengunggah gambar pushpin atau dokumen GeoJSON yang berisi lokasi pin, layanan Penyimpanan Data mengembalikan ID Data Unik (UDID) yang dapat Anda gunakan untuk mereferensikan data dalam parameter pin.

Untuk menggunakan gambar pushpin kustom dari Azure Maps Data Storage, tentukan UDID yang diawali dengan 'udid-' sebagai nama gaya pushpin. Misalnya,

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

Untuk menggunakan geometri titik dari dokumen GeoJSON yang diunggah sebagai lokasi pin, tentukan UDID di bagian lokasi parameter pin. Misalnya,

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

Perhatikan bahwa hanya geometri titik dan multipoint, titik, dan multipoint dari koleksi geometri, dan geometri titik dari fitur yang akan digunakan. Geometri linestring dan poligon akan diabaikan. Jika titik berasal dari fitur dan fitur memiliki properti string yang disebut "label", nilai properti tersebut akan digunakan sebagai label untuk pin.

Anda dapat mencampur lokasi pin dari Penyimpanan Data dan lokasi pin yang ditentukan dalam parameter pin. Salah satu lokasi pin yang dibatasi pipa dapat berupa bujur dan lintang atau UDID. Misalnya,

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

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 jajar. Gunakan angka negatif untuk memutar berlawanan 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 tingkat 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 Rentang
al Alfa (opasitas) 0 hingga 1
an Sematkan jangkar *
co Sematkan warna 000000 ke FFFFFF
la Jangkar label *
Lc Warna label 000000 ke FFFFFF
Is Ukuran label Lebih besar dari 0
ro Rotasi -360 hingga 360
Sc Skala 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.
style

Gaya peta yang akan dikembalikan. Saat ini, hanya gaya yang tersedia yang utama. Nilai yang mungkin termasuk: 'main'
view

Parameter Tampilan menentukan kumpulan konten yang disengketakan secara geopolitik mana yang dikembalikan melalui layanan Azure Maps, termasuk batas dan label yang ditampilkan di peta. Parameter Tampilan (juga disebut sebagai "parameter wilayah pengguna") akan menampilkan peta yang benar untuk negara/wilayah tersebut. 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 dalam Azure Maps harus digunakan sesuai dengan hukum yang berlaku, termasuk yang berkaitan dengan pemetaan, negara tempat peta, gambar, dan data lain dan konten pihak ketiga yang anda berwenang untuk mengakses melalui Azure Maps tersedia. Contoh: view=IN. Silakan lihat Tampilan yang Didukung untuk detailnya dan untuk melihat Tampilan yang tersedia.
width

Lebar gambar yang dihasilkan dalam piksel. Rentangnya adalah 1 hingga 8192. Defaultnya adalah 512. Ini tidak boleh digunakan dengan bbox.
zoom

Tingkat zoom peta yang diinginkan. Nilai zoom harus dalam rentang: 0-20 (inklusif). Nilai defaultnya adalah 12.

Silakan lihat Tingkat Pembesaran Tampilan dan Kisi Petak untuk detailnya.

Properti yang Diwariskan

abortSignal

Sinyal yang dapat digunakan untuk membatalkan permintaan.
customHeaders

{object} [CustomHeaders] Header permintaan kustom yang ditentukan pengguna yang akan diterapkan sebelum permintaan dikirim.
onDownloadProgress

Panggilan balik yang diaktifkan setelah kemajuan pengunduhan.
onUploadProgress

Panggilan balik yang diaktifkan setelah kemajuan pengunggahan.
timeout

Jumlah milidetik yang dapat diambil permintaan sebelum dihentikan secara otomatis.

Detail Properti

bbox

Kotak pembatas. Proyeksi yang digunakan - EPSG:3857. Format : 'minLon, minLat, maxLon, maxLat'. Catatan: Baik bbox atau tengah adalah parameter yang diperlukan. Mereka saling eksklusif. Ini tidak boleh digunakan dengan tinggi atau lebar.

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

bbox?: string

Nilai Properti

string

center

Koordinat titik tengah. Format: 'lon,lat'. Proyeksi yang digunakan

  • EPSG:3857. Rentang garis bujur: -180 hingga 180. Rentang garis lintang: -85 hingga 85. Catatan: Baik tengah atau bbox adalah parameter yang diperlukan. Mereka saling eksklusif.
center?: string

Nilai Properti

string

height

Tinggi gambar yang dihasilkan dalam piksel. Rentangnya adalah 1 hingga 8192. Defaultnya adalah 512. Ini tidak boleh digunakan dengan bbox.

height?: number

Nilai Properti

number

language

Bahasa tempat 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.

language?: string

Nilai Properti

string

layer

Lapisan peta diminta. Jika lapisan diatur ke label atau hibrid, formatnya harus png. Nilai yang mungkin termasuk: 'basic', 'hybrid', 'labels'

layer?: StaticMapLayer

Nilai Properti

StaticMapLayer

path

Gaya dan lokasi jalur. 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 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

Untuk merender poligon, lokasi terakhir harus sama dengan lokasi mulai. Misalnya, gunakan

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

Nilai garis bujur dan garis lintang untuk lokasi garis dan poligon dapat berkisar dari -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 bersama-sama 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

Mendapatkan lokasi Jalur dari Azure Maps Data Storage

Untuk semua SKU akun Azure Maps selain S0, informasi lokasi jalur dapat diperoleh dari Azure Maps Data Storage. Setelah mengunggah dokumen GeoJSON yang berisi lokasi jalur, layanan Penyimpanan Data mengembalikan ID Data Unik (UDID) yang dapat Anda gunakan untuk mereferensikan data di parameter jalur.

Untuk menggunakan geometri titik dari dokumen GeoJSON yang diunggah sebagai lokasi jalur, tentukan UDID di bagian lokasi parameter jalur. Misalnya,

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

Perhatikan bahwa tidak diizinkan untuk mencampur lokasi jalur dari Penyimpanan Data dengan lokasi yang ditentukan dalam parameter jalur.

Ringkasan Pengubah Gaya

Pengubah Deskripsi Rentang
Lc Warna garis 000000 ke FFFFFF
Fc Warna isian 000000 ke FFFFFF
la Alfa garis (opasitas) 0 hingga 1
fa Isi alfa (opasitas) 0 hingga 1
Lw Lebar garis Lebih besar dari 0
Ra Radius lingkaran (meter) Lebih besar dari 0 
path?: string[]

Nilai Properti

string[]

pins

Gaya dan instans pushpin. Gunakan parameter ini untuk menambahkan pushpin secara opsional ke gambar. Gaya pushpin menjelaskan tampilan pushpin, dan instans menentukan koordinat pushpin dan label opsional untuk setiap pin. (Pastikan untuk mengodekan nilai url parameter ini dengan benar karena akan berisi karakter khusus seperti pipa dan tanda baca.) Akun Azure Maps S0 SKU 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 Azure Maps S0 hanya memungkinkan 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. 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. 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 berpusat 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 (oacity) tidak berubah. Ini biasanya hanya akan dilakukan dengan gambar kustom warna solid.

Mendapatkan Pushpin dari Azure Maps Data Storage

Untuk semua SKU akun Azure Maps selain S0, gambar pushpin dan informasi lokasi dapat diperoleh dari Azure Maps Data Storage. Setelah mengunggah gambar pushpin atau dokumen GeoJSON yang berisi lokasi pin, layanan Penyimpanan Data mengembalikan ID Data Unik (UDID) yang dapat Anda gunakan untuk mereferensikan data dalam parameter pin.

Untuk menggunakan gambar pushpin kustom dari Azure Maps Data Storage, tentukan UDID yang diawali dengan 'udid-' sebagai nama gaya pushpin. Misalnya,

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

Untuk menggunakan geometri titik dari dokumen GeoJSON yang diunggah sebagai lokasi pin, tentukan UDID di bagian lokasi parameter pin. Misalnya,

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

Perhatikan bahwa hanya geometri titik dan multipoint, titik, dan multipoint dari koleksi geometri, dan geometri titik dari fitur yang akan digunakan. Geometri linestring dan poligon akan diabaikan. Jika titik berasal dari fitur dan fitur memiliki properti string yang disebut "label", nilai properti tersebut akan digunakan sebagai label untuk pin.

Anda dapat mencampur lokasi pin dari Penyimpanan Data dan lokasi pin yang ditentukan dalam parameter pin. Salah satu lokasi pin yang dibatasi pipa dapat berupa bujur dan lintang atau UDID. Misalnya,

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

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 jajar. Gunakan angka negatif untuk memutar berlawanan 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 tingkat 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 Rentang
al Alfa (opasitas) 0 hingga 1
an Sematkan jangkar *
co Sematkan warna 000000 ke FFFFFF
la Jangkar label *
Lc Warna label 000000 ke FFFFFF
Is Ukuran label Lebih besar dari 0
ro Rotasi -360 hingga 360
Sc Skala 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.
pins?: string[]

Nilai Properti

string[]

style

Gaya peta yang akan dikembalikan. Saat ini, hanya gaya yang tersedia yang utama. Nilai yang mungkin termasuk: 'main'

style?: Style

Nilai Properti

Style

view

Parameter Tampilan menentukan kumpulan konten yang disengketakan secara geopolitik mana yang dikembalikan melalui layanan Azure Maps, termasuk batas dan label yang ditampilkan di peta. Parameter Tampilan (juga disebut sebagai "parameter wilayah pengguna") akan menampilkan peta yang benar untuk negara/wilayah tersebut. 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 dalam Azure Maps harus digunakan sesuai dengan hukum yang berlaku, termasuk yang berkaitan dengan pemetaan, negara tempat peta, gambar, dan data lain dan konten pihak ketiga yang anda berwenang untuk mengakses melalui Azure Maps tersedia. Contoh: view=IN. Silakan lihat Tampilan yang Didukung untuk detailnya dan untuk melihat Tampilan yang tersedia.

view?: string

Nilai Properti

string

width

Lebar gambar yang dihasilkan dalam piksel. Rentangnya adalah 1 hingga 8192. Defaultnya adalah 512. Ini tidak boleh digunakan dengan bbox.

width?: number

Nilai Properti

number

zoom

Tingkat zoom peta yang diinginkan. Nilai zoom harus dalam rentang: 0-20 (inklusif). Nilai defaultnya adalah 12.

Silakan lihat Tingkat Pembesaran Tampilan dan Kisi Petak untuk detailnya.

zoom?: number

Nilai Properti

number

Detail Properti yang Diwariskan

abortSignal

Sinyal yang dapat digunakan untuk membatalkan permintaan.

abortSignal?: AbortSignalLike

Nilai Properti

AbortSignalLike

Diwarisi Dari RequestOptionsBase.abortSignal

customHeaders

{object} [CustomHeaders] Header permintaan kustom yang ditentukan pengguna yang akan diterapkan sebelum permintaan dikirim.

customHeaders?: [key: string]: string

Nilai Properti

[key: string]: string

Diwarisi Dari RequestOptionsBase.customHeaders

onDownloadProgress

Panggilan balik yang diaktifkan setelah kemajuan pengunduhan.

onDownloadProgress?: (progress: TransferProgressEvent) => void

Nilai Properti

(progress: TransferProgressEvent) => void

Diwarisi Dari RequestOptionsBase.onDownloadProgress

onUploadProgress

Panggilan balik yang diaktifkan setelah kemajuan pengunggahan.

onUploadProgress?: (progress: TransferProgressEvent) => void

Nilai Properti

(progress: TransferProgressEvent) => void

Diwarisi Dari RequestOptionsBase.onUploadProgress

timeout

Jumlah milidetik yang dapat diambil permintaan sebelum dihentikan secara otomatis.

timeout?: number

Nilai Properti

number

Diwarisi Dari RequestOptionsBase.timeout