Bagikan melalui

RenderGetMapStaticImageQueryParamProperties interface

Paket:
@azure-rest/maps-render

Properti

bbox

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 diperlukan parameter. Mereka saling eksklusif. bbox tidak boleh digunakan dengan tinggi atau lebar.

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

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

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

Tinggi gambar yang dihasilkan dalam piksel. Berkisar antara 80 hingga 1500. 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.
path

Gaya dan lokasi jalur (dalam 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 cadangan 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 di garis lintang 45°N dan garis 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 garis bujur untuk lokasi garis dan poligon dapat berada dalam kisaran 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 (formulir tiga digit tidak didukung). Misalnya, untuk menggunakan warna merah muda dalam 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 Lingkup
Lc Warna garis string 000000 ke FFFFFFFF
Fc Warna isian string 000000 ke FFFFFFFF
La Alfa baris (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

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 dengan benar dari parameter ini karena akan berisi karakter cadangan seperti pipa dan tanda baca.)

SKU S0 akun Azure Maps hanya mendukung satu instans parameter pin dan jumlah lokasi dibatasi hingga 5 per pin. SKU lain memungkinkan hingga 25 instans parameter pin untuk menentukan beberapa gaya pin, dan jumlah lokasi dibatasi hingga 50 per pin.

Untuk merender pushpin di 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 singkatan 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 || dalam 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 mewakili 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 mengambil alih jangkar label, gunakan pengubah gaya 'la' dan berikan 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 koordinat pin. Ini biasanya tidak ideal karena mengaburkan lokasi yang coba Anda sorot. Untuk mengambil alih 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.

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 normal, 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 Lingkup
Al Alfa (opasitas) float 0 hingga 1
an Sematkan jangkar <int32, int32> *
co Sematkan warna string 000000 ke FFFFFFFF
La Jangkar label <int32, int32> *
Lc Warna label string 000000 ke FFFFFFFF
Ls Ukuran label float Lebih besar dari 0
Ro Rotasi float -360 hingga 360
Sc Sisik 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

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

Nilai Opsional, menunjukkan tidak ada arus lalu lintas yang dilapisi pada hasil gambar. Nilai yang mungkin adalah microsoft.traffic.relative.main dan tidak ada. 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

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 merujuk ke Tampilan yang Didukung untuk detailnya dan untuk melihat Tampilan yang tersedia.
width

Lebar gambar yang dihasilkan dalam piksel. Berkisar antara 80 hingga 2000. Defaultnya adalah 512. Ini tidak boleh digunakan dengan bbox.
zoom

Tingkat pembesaran 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 Zoom dan Kisi Petak peta.

Detail Properti

bbox

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 diperlukan parameter. Mereka saling eksklusif. bbox tidak boleh digunakan dengan tinggi atau lebar.

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

bbox?: number[]

Nilai Properti

number[]

center

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

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

center?: number[]

Nilai Properti

number[]

height

Tinggi gambar yang dihasilkan dalam piksel. Berkisar antara 80 hingga 1500. 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

path

Gaya dan lokasi jalur (dalam 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 cadangan 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 di garis lintang 45°N dan garis 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 garis bujur untuk lokasi garis dan poligon dapat berada dalam kisaran 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 (formulir tiga digit tidak didukung). Misalnya, untuk menggunakan warna merah muda dalam 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 Lingkup
Lc Warna garis string 000000 ke FFFFFFFF
Fc Warna isian string 000000 ke FFFFFFFF
La Alfa baris (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 
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 (dalam label ganda) dan opsional untuk setiap pin. (Pastikan untuk mengodekan nilai URL dengan benar dari parameter ini karena akan berisi karakter cadangan seperti pipa dan tanda baca.)

SKU S0 akun Azure Maps hanya mendukung satu instans parameter pin dan jumlah lokasi dibatasi hingga 5 per pin. SKU lain memungkinkan hingga 25 instans parameter pin untuk menentukan beberapa gaya pin, dan jumlah lokasi dibatasi hingga 50 per pin.

Untuk merender pushpin di 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 singkatan 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 || dalam 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 mewakili 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 mengambil alih jangkar label, gunakan pengubah gaya 'la' dan berikan 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 koordinat pin. Ini biasanya tidak ideal karena mengaburkan lokasi yang coba Anda sorot. Untuk mengambil alih 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.

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 normal, 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 Lingkup
Al Alfa (opasitas) float 0 hingga 1
an Sematkan jangkar <int32, int32> *
co Sematkan warna string 000000 ke FFFFFFFF
La Jangkar label <int32, int32> *
Lc Warna label string 000000 ke FFFFFFFF
Ls Ukuran label float Lebih besar dari 0
Ro Rotasi float -360 hingga 360
Sc Sisik 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.
pins?: string

Nilai Properti

string

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.

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"

Nilai Properti

"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"

trafficLayer

Nilai Opsional, menunjukkan tidak ada arus lalu lintas yang dilapisi pada hasil gambar. Nilai yang mungkin adalah microsoft.traffic.relative.main dan tidak ada. 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.

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

Nilai Properti

"microsoft.traffic.relative.main" | "none"

view

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 merujuk ke Tampilan yang Didukung untuk detailnya dan untuk melihat Tampilan yang tersedia.

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

Nilai Properti

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

width

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

width?: number

Nilai Properti

number

zoom

Tingkat pembesaran 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 Zoom dan Kisi Petak peta.

zoom?: number

Nilai Properti

number