Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Azure dan Google Maps menyediakan akses ke API spasial melalui layanan web REST. Antarmuka API dari platform ini menjalankan fungsi yang serupa. Tetapi, masing-masing menggunakan konvensi penamaan dan objek respons yang berbeda.
Tutorial ini menunjukkan cara:
- Forward (mengonversi alamat menjadi koordinat) dan reverse geocoding (mengonversi koordinat menjadi alamat)
- Mencari lokasi menarik
- Memperhitungkan rute dan petunjuk arah
- Mengambil gambar peta
- Memperhitungkan matriks jarak
- Mendapatkan detail zona waktu
Anda juga akan mempelajari:
- Layanan REST Azure Maps mana yang digunakan saat migrasi dari Layanan Web Google Maps
- Tips tentang cara mengoptimalkan layanan Azure Maps
- Wawasan tentang layanan Azure Maps terkait lainnya
Tabel ini menampilkan API layanan Azure Maps, yang memiliki fungsi serupa dengan API layanan Google Maps yang tercantum.
API layanan Google Maps | API layanan Azure Maps |
---|---|
Petunjuk | Rute |
Matriks Jarak | Matriks Rute Pos |
Geocoding | Mencari |
Places Search | Mencari |
Place Autocomplete | Mencari |
Snap to Road | Lihat bagian Memperhitungkan rute dan petunjuk arah. |
Batas Kecepatan | Lihat bagian Melakukan geocoding terbalik pada koordinat. |
Static Map | Render |
Zona Waktu | Zona waktu |
API layanan berikut saat ini tidak tersedia di Azure Maps:
- Geolokasi - Azure Maps memang memiliki layanan yang disebut Geolokasi, tetapi menyediakan Alamat IP untuk informasi lokasi, tetapi saat ini tidak mendukung menara sel atau triangulasi WiFi.
- Detail tempat dan foto - Nomor telepon dan URL situs tersedia di Azure Maps search API.
- URL Peta
- Jalan Terdekat - Dapat dicapai menggunakan Web SDK seperti yang ditunjukkan dalam sampel logika Snap to road Dasar, tetapi saat ini tidak tersedia sebagai layanan.
- Tampilan jalan statik
Prasyarat
Jika Anda tidak memiliki langganan Azure, buat akun gratis sebelum Anda memulai.
- Akun Azure Maps
- Kunci langganan
Catatan
Untuk informasi selengkapnya tentang autentikasi di Azure Maps, lihat Mengelola autentikasi di Azure Maps.
Melakukan geocoding pada alamat
Geocoding adalah proses mengubah alamat menjadi koordinat. Misalnya, "1 Microsoft way, Redmond, WA" dikonversi menjadi garis bujur: -122.1298, garis lintang: 47.64005. Lalu, Koordinat dapat digunakan untuk berbagai jenis tujuan, seperti, memosisikan penanda pusat pada peta.
Azure Maps menyediakan beberapa metode untuk melakukan geocoding pada alamat:
- Dapatkan Alamat Pencarian: Geocoding alamat bentuk bebas digunakan untuk menentukan string alamat tunggal (seperti
"1 Microsoft way, Redmond, WA"
) dan segera memproses permintaan. Layanan ini direkomendasikan jika Anda perlu geocode alamat individu dengan cepat. - Dapatkan Alamat Pencarian Terstruktur: Tentukan bagian dari satu alamat, seperti nama jalan, kota, negara/wilayah, dan kode pos dan segera memproses permintaan. API ini direkomendasikan jika Anda harus melakukan geocoding pada suatu alamat dengan cepat dan data alamat sudah diurai menjadi beberapa bagian.
- Posting Batch Alamat Pencarian: Buat permintaan yang berisi hingga 10.000 alamat dan proses selama jangka waktu tertentu. Semua alamat di-geocode secara paralel di server dan ketika selesai, tataan hasil lengkap dapat diunduh. Metode ini direkomendasikan jika Anda melakukan geocoding untuk himpunan data besar.
- Dapatkan Search Fuzzy: API pencarian fuzzy menggabungkan geocoding alamat dengan pencarian titik minat. API ini mengambil string bentuk bebas yang dapat menjadi alamat, tempat, landmark, lokasi menarik, atau kategori titik minat dan memproses permintaan dengan segera. API ini direkomendasikan untuk aplikasi di mana pengguna dapat mencari alamat atau lokasi menarik dari kotak teks yang sama.
- Post Search Fuzzy Batch: Gunakan pencarian batch fuzzy untuk membuat permintaan yang berisi hingga 10.000 alamat, tempat, landmark, atau tempat menarik dan memprosesnya selama jangka waktu tertentu. Semua data diproses secara paralel di server dan ketika selesai, kumpulan hasil lengkap dapat diunduh.
Tabel berikut memberikan referensi silang untuk parameter Google Maps API dengan parameter API yang dapat dibandingkan di Azure Maps.
Parameter Google Maps API | Parameter Azure Maps API yang dapat dibandingkan |
---|---|
address |
query |
bounds |
topLeft dan btmRight |
components |
streetNumber streetName crossStreet postalCode municipality - kotamunicipalitySubdivision – pemukiman, kota kecil/besarcountrySubdivision - negara bagian atau provinsicountrySecondarySubdivision - wilayahcountryTertiarySubdivision - distrikcountryCode - dua huruf untuk kode negara/wilayah |
key |
subscription-key – Untuk informasi selengkapnya, lihat Autentikasi dengan Azure Maps. |
language |
language – Untuk informasi selengkapnya, lihat Dukungan pelokalan di Azure Maps. |
region |
countrySet |
Untuk informasi selengkapnya tentang menggunakan layanan pencarian, lihat Mencari lokasi menggunakan azure Maps layanan Pencarian s. Pastikan Anda meninjau praktik terbaik untuk pencarian.
Tip
API melakukan geocoding alamat dengan bentuk bebas dan API pencarian fuzzy dapat digunakan dalam mode pelengkapan otomatis dengan menambahkan &typeahead=true
ke URL permintaan. Langkah ini akan memberi tahu server bahwa teks input kemungkinan parsial, dan pencarian akan masuk ke mode prediktif.
Melakukan geocoding terbalik pada koordinat
Geocoding terbalik adalah proses mengonversi koordinat geografis menjadi alamat. Koordinat dengan "garis bujur: -122.1298, garis lintang: 47.64005" dikonversi menjadi "1 Microsoft way, Redmond, WA".
Azure Maps menyediakan beberapa metode geocoding terbalik:
- Dapatkan Alamat Pencarian Terbalik: Tentukan satu koordinat geografis untuk mendapatkan perkiraan alamat yang sesuai dengan koordinat ini. Pemrosesan permintaan hampir secara real time.
- Dapatkan Search Address Reverse Cross Street: Tentukan satu koordinat geografis untuk mendapatkan informasi lintas jalan terdekat dan segera memproses permintaan. Misalnya, Anda mungkin menerima lintas jalan berikut: Ave ke-1 dan Main St.
- Pasca Batch Balik Alamat Pencarian: Buat permintaan yang berisi hingga 10.000 koordinat dan proses selama jangka waktu tertentu. Semua data diproses secara paralel di server. Setelah permintaan selesai, Anda dapat mengunduh tataan hasil yang lengkap.
Tabel berikut memberikan referensi silang untuk parameter Google Maps API dengan parameter API yang dapat dibandingkan di Azure Maps.
Parameter Google Maps API | Parameter Azure Maps API yang dapat dibandingkan |
---|---|
key |
subscription-key – Untuk informasi selengkapnya, lihat Autentikasi dengan Azure Maps. |
language |
language – Untuk informasi selengkapnya, lihat Dukungan pelokalan di Azure Maps. |
latlng |
query |
location_type |
N/A |
result_type |
entityType |
Untuk informasi selengkapnya, lihat praktik terbaik untuk pencarian.
API geocoding terbalik Azure Maps memiliki fitur tambahan, yang tidak tersedia di Google Maps. Fitur tersebut mungkin berguna untuk diintegrasikan dengan aplikasi saat Anda memigrasikan aplikasi:
- Mengambil data batas kecepatan
- Mengambil informasi penggunaan jalan: jalan lokal, arteri, akses terbatas, jalur, dan sebagainya
- Mengambil sisi jalan tempat koordinat berada
Mencari lokasi menarik
Data lokasi menarik dapat dicari di Google Maps menggunakan Places Search API. API ini menyediakan tiga cara berbeda untuk mencari lokasi menarik:
- Mencari tempat berdasarkan teks: Mencari lokasi menarik berdasarkan nama, alamat, atau nomor telepon.
- Pencarian Terdekat: Mencari lokasi menarik yang berada dalam jarak tertentu dari lokasi.
- Pencarian Teks: Mencari tempat menggunakan teks bentuk bebas, yang menyertakan informasi lokasi dan tempat menarik. Misalnya, "pizza di Bandung" atau "restoran di dekat Jalan Jakarta".
Azure Maps meneydiakan beberapa API penelusuran untuk lokasi menarik:
- Dapatkan POI Pencarian: Cari tempat menarik berdasarkan nama. Misalnya, "Starbucks".
- Dapatkan Kategori POI Pencarian: Cari tempat menarik menurut kategori. Misalnya, "restoran".
- Dapatkan Pencarian Di Sekitar: Mencari tempat menarik yang berada dalam jarak tertentu dari lokasi.
- Dapatkan Search Fuzzy: API pencarian fuzzy menggabungkan geocoding alamat dengan pencarian titik minat. API ini mengambil string bentuk bebas yang dapat menjadi alamat, tempat, landmark, lokasi menarik, atau kategori titik minat dan memproses permintaan dengan segera. API ini direkomendasikan untuk aplikasi di mana pengguna dapat mencari alamat atau lokasi menarik dari kotak teks yang sama.
- Post Search Inside Geometry: Cari tempat menarik yang berada dalam geometri tertentu. Misalnya, pencarian lokasi menarik dalam poligon.
- Posting Pencarian Sepanjang Rute: Cari tempat menarik yang berada di sepanjang jalur rute tertentu.
- Post Search Fuzzy Batch: Gunakan pencarian batch fuzzy untuk membuat permintaan yang berisi hingga 10.000 alamat, tempat, landmark, atau tempat menarik dan memprosesnya selama jangka waktu tertentu. Semua data diproses secara paralel di server dan ketika selesai, kumpulan hasil lengkap dapat diunduh.
Saat ini, Azure Maps tidak memiliki API yang sebanding dengan Text Search API di Google Maps.
Tip
API pencarian POI, API pencarian kategori POI, dan API pencarian fuzzy dapat digunakan dalam mode pelengkapan otomatis dengan menambahkan &typeahead=true
ke URL permintaan. Langkah ini akan memberi tahu server bahwa teks input kemungkinan parsial. API akan menjalankan pencarian dalam mode prediktif.
Untuk informasi selengkapnya, lihat praktik terbaik untuk pencarian.
Menemukan tempat berdasarkan teks
Gunakan AZURE Maps Get Search POI dan Get Search Fuzzy untuk mencari tempat menarik berdasarkan nama atau alamat.
Tabel memberikan referensi silang untuk parameter Google Maps API dengan parameter API Azure Maps yang dapat dibandingkan.
Parameter Google Maps API | Parameter Azure Maps API yang dapat dibandingkan |
---|---|
fields |
N/A |
input |
query |
inputtype |
N/A |
key |
subscription-key – Untuk informasi selengkapnya, lihat Autentikasi dengan Azure Maps. |
language |
language – Untuk informasi selengkapnya, lihat Dukungan pelokalan di Azure Maps. |
locationbias |
lat , lon , dan radius topLeft dan btmRight countrySet |
Pencarian di sekitar
Gunakan GET Search Nearby API untuk mengambil tempat menarik terdekat, di Azure Maps.
Tabel menampilkan parameter Google Maps API dengan parameter API Azure Maps yang dapat dibandingkan.
Parameter Google Maps API | Parameter Azure Maps API yang dapat dibandingkan |
---|---|
key |
subscription-key – Untuk informasi selengkapnya, lihat Autentikasi dengan Azure Maps. |
keyword |
categorySet dan brandSet |
language |
language – Untuk informasi selengkapnya, lihat Dukungan pelokalan di Azure Maps. |
location |
lat dan lon |
maxprice |
N/A |
minprice |
N/A |
name |
categorySet dan brandSet |
opennow |
N/A |
pagetoken |
ofs dan limit |
radius |
radius |
rankby |
N/A |
type |
categorySet – Untuk informasi selengkapnya, lihat kategori pencarian yang didukung. |
Memperhitungkan rute dan petunjuk arah
Perhitungkan rute dan petunjuk arah menggunakan Azure Maps. Azure Maps memiliki banyak fungsi yang sama dengan layanan perutean Google Maps, seperti:
- Waktu kedatangan dan keberangkatan.
- Rute lalu lintas berbasis real-time dan prediktif.
- Moda transportasi yang berbeda. Seperti mengemudi, berjalan kaki, dan bersepeda.
Catatan
Azure Maps mewajibkan semua titik arah berbentuk koordinat. Alamat harus di-geocode terlebih dahulu.
Layanan perutean Azure Maps menyediakan API berikut untuk memperhitungkan rute:
- Dapatkan Petunjuk Arah Rute: Hitung rute dan minta permintaan segera diproses. API ini mendukung
GET
permintaan danPOST
.POST
permintaan disarankan saat menentukan sejumlah besar titik arah atau saat menggunakan banyak opsi rute untuk memastikan bahwa permintaan URL tidak menjadi terlalu panjang dan menyebabkan masalah.POST
Arah Rute di Azure Maps memiliki opsi yang dapat mengambil ribuan titik pendukung dan menggunakannya untuk membuat ulang jalur rute logis di antara mereka (snap to road). - Post Route Directions Batch: Buat permintaan yang berisi hingga 1.000 permintaan rute dan proses selama jangka waktu tertentu. Semua data diproses secara paralel di server dan ketika selesai, kumpulan hasil lengkap dapat diunduh.
Tabel memberikan referensi silang untuk parameter Google Maps API dengan parameter API yang dapat dibandingkan di Azure Maps.
Parameter Google Maps API | Parameter Azure Maps API yang dapat dibandingkan |
---|---|
alternatives |
maxAlternatives |
arrival_time |
arriveAt |
avoid |
avoid |
departure_time |
departAt |
destination |
query – koordinat dalam format "lat0,lon0:lat1,lon1…." |
key |
subscription-key – Untuk informasi selengkapnya, lihat Autentikasi dengan Azure Maps. |
language |
language – Untuk informasi selengkapnya, lihat Dukungan pelokalan di Azure Maps. |
mode |
travelMode |
optimize |
computeBestOrder |
origin |
query |
region |
N/A – Fitur ini terkait dengan geocoding. Gunakan parameter countrySet saat menggunakan Azure Maps geocoding API. |
traffic_model |
N/A – Hanya dapat ditentukan jika data lalu lintas harus digunakan dengan parameter traffic. |
units |
N/A – Azure Maps hanya menggunakan sistem metrik. |
waypoints |
query |
Tip
Secara default, Azure Maps route API hanya menampilkan ringkasan. API menampilkan jarak, waktu, dan koordinat jalur rute. Gunakan parameter instructionsType
untuk mengambil petunjuk belokan demi belokan. Lalu, gunakan routeRepresentation
untuk memfilter ringkasan dan jalur rute.
API perutean Azure Maps memiliki fitur tambahan yang tidak tersedia di Google Maps. Saat memigrasikan aplikasi Anda, pertimbangkan untuk menggunakan fitur-fitur ini:
- Dukungan untuk jenis rute: terpendek, tercepat, menarik, dan paling hemat bahan bakar.
- Dukungan untuk mode perjalanan lainnya: bus, sepeda motor, taksi, truk, dan van.
- Dukungan untuk 150 titik arah.
- Menghitung beberapa waktu perjalanan dalam satu permintaan; lalu lintas historis, lalu lintas langsung, tidak ada kemacetan.
- Menghindari jenis jalan tambahan: jalur transportasi khusus, jalan yang belum diaspal, jalan yang sudah digunakan.
- Menentukan area kustom yang harus dihindari.
- Batasi elevasi yang mungkin naik rute.
- Rute berdasarkan spesifikasi mesin. Hitung rute untuk pembakaran atau kendaraan listrik berdasarkan spesifikasi mesin dan sisa bahan bakar atau pengisian daya.
- Mendukung parameter rute kendaraan komersial. Seperti dimensi kendaraan, berat, jumlah axel dan jenis kargo.
- Menentukan kecepatan maksimum kendaraan.
Selain itu, layanan rute di Azure Maps mendukung Dapatkan Rentang Rute. Penghitungan rentang yang dapat dirutekan juga dikenal sebagai isochrone. Memperhitungkan rentang ini memerlukan pembuatan poligon yang mencakup area yang dapat dilewati arah mana pun dari titik awal. Semua dalam jumlah waktu atau jumlah bahan bakar atau baterai yang ditentukan.
Untuk informasi selengkapnya, lihat praktik terbaik untuk perutean.
Mengambil gambar peta
Azure Maps menyediakan API untuk merender gambar peta statik dengan data yang dilapisi. Get Map Static Image API di Azure Maps sebanding dengan API peta statis di Google Maps.
Catatan
Azure Maps memerlukan pusat, semua penanda, dan lokasi jalur untuk dikoordinasikan dalam format "garis bujur, garis lintang". Sedangkan, Google Maps menggunakan format "garis lintang, garis bujur". Alamat harus di-geocode terlebih dahulu.
Tabel memberikan referensi silang untuk parameter Google Maps API dengan parameter API yang dapat dibandingkan di Azure Maps.
Parameter Google Maps API | Parameter Azure Maps API yang dapat dibandingkan |
---|---|
center |
center |
format |
format – ditentukan sebagai bagian dari jalur URL. Saat ini hanya PNG yang didukung. |
key |
subscription-key – Untuk informasi selengkapnya, lihat Autentikasi dengan Azure Maps. |
language |
language – Untuk informasi selengkapnya, lihat Dukungan pelokalan di Azure Maps. |
maptype |
layer dan style – Untuk informasi selengkapnya, lihat Gaya peta yang didukung. |
markers |
pins |
path |
path |
region |
N/A – Fitur terkait geocoding. Gunakan parameter countrySet saat menggunakan API geocoding Azure Maps. |
scale |
N/A |
size |
width dan height – Ukuran maksimum adalah 8192 x 8192. |
style |
N/A |
visible |
N/A |
zoom |
zoom |
Catatan
Dalam sistem petak peta Azure Maps, petak peta berukuran dua kali lebih besar dari petak peta yang digunakan di Google Maps. Dengan demikian, nilai tingkat perbesar tampilan di Azure Maps akan muncul satu tingkat pembesaran lebih dekat di Azure Maps dibandingkan dengan Google Maps. Untuk mengimbangi perbedaan ini, turunkan tingkat pembesaran tampilan dalam permintaan yang Anda migrasikan.
Untuk informasi selengkapnya, lihat Merender data kustom pada peta raster.
Selain dapat menghasilkan gambar peta statis, layanan render Azure Maps memungkinkan akses langsung petak peta dalam format raster (PNG) dan vektor:
- Dapatkan Gambar Statis Peta: Ambil petak peta raster (PNG) dan vektor untuk peta dasar (jalan, batas, latar belakang).
- Dapatkan Petak Peta: Ambil petak peta citra udara dan satelit.
Tip
Banyak aplikasi Google Maps dialihkan dari pengalaman peta interaktif ke gambar peta statis beberapa tahun yang lalu. Tindakan ini diambil demi menghemat biaya. Di Azure Maps, biasanya lebih hemat biaya untuk menggunakan kontrol peta interaktif di Web SDK. Kontrol peta interaktif menghabiskan biaya berdasarkan jumlah muatan petak peta. Petak peta di Azure Maps besar. Biasanya hanya perlu beberapa petak peta untuk membuat ulang tampilan peta yang sama dengan peta statik. Petak peta di-cache secara otomatis oleh browser. Dengan demikian, kontrol peta interaktif biasanya menghasilkan sebagian kecil dari transaksi saat membuat kembali tampilan peta statik. Penyentuhan searah dan pembesaran tampilan akan memuat lebih banyak petak peta; namun, ada opsi dalam kontrol peta untuk menonaktifkan perilaku ini. Kontrol peta interaktif juga menyediakan lebih banyak opsi visualisasi daripada layanan peta statik.
Perbandingan format parameter URL penanda
Sebelum: Google Maps
Tambahkan penanda menggunakan parameter markers
di URL. Parameter markers
mengambil gaya dan daftar lokasi yang akan dirender di peta dengan gaya seperti yang ditunjukkan di bawah ini:
&markers=markerStyles|markerLocation1|markerLocation2|...
Untuk menambahkan gaya lain, gunakan parameter markers
ke URL dengan gaya dan kumpulan lokasi yang berbeda.
Tentukan lokasi penanda dengan format "garis lintang, garis bujur".
Tambahkan gaya penanda dengan format optionName:value
, dengan beberapa gaya yang dipisahkan oleh karakter pipa (|) seperti ini "optionName1:value1|optionName2:value2". Perhatikan bahwa nama dan nilai opsi dipisahkan dengan titik dua (:). Gunakan opsi nama gaya berikut untuk menandai gaya di Google Maps:
color
– Warna ikon penanda default. Dapat berupa warna heksadesimal 24 bit (0xrrggbb
) atau salah satu nilai berikut;black
,brown
,green
,purple
,yellow
,blue
,gray
,orange
,red
,white
.label
– Satu karakter alfanumerik huruf besar untuk ditampilkan di atas ikon.size
- Ukuran penanda. Bisatiny
,mid
, atausmall
.
Gunakan nama opsi gaya berikut untuk ikon Kustom di Google Maps:
anchor
– Menentukan cara menyelaraskan gambar ikon ke koordinat. Dapat berupa nilai piksel (x,y) atau salah satu nilai berikut;top
,bottom
,left
,right
,center
,topleft
,topright
,bottomleft
, ataubottomright
.icon
– URL yang mengarah ke gambar ikon.
Misalnya, mari kita tambahkan penanda merah berukuran sedang ke peta di garis bujur: -110, garis lintang: 45:
&markers=color:red|size:mid|45,-110
Setelah: Azure Maps
Tambahkan penanda ke gambar peta statik dengan menentukan parameter pins
dalam URL. Seperti Google Maps, tentukan gaya dan daftar lokasi dalam parameter. Parameter pins
dapat ditentukan beberapa kali untuk mendukung penanda dengan gaya yang berbeda.
&pins=iconType|pinStyles||pinLocation1|pinLocation2|...
Untuk menambahkan gaya lain, tambahkan parameter pins
ekstra ke URL dengan gaya dan kumpulan lokasi yang berbeda.
Di Azure Maps, lokasi pin harus dalam format "bujur,lintang". Google Maps menggunakan format "garis lintang, garis bujur". Dalam Azure Maps, spasi, bukan koma, digunakan untuk memisahkan garis bujur dan garis lintang.
iconType
menentukan jenis pin yang akan dibuat. Parameter dapat memiliki nilai berikut:
default
– Ikon pin default.none
– Tidak ada ikon yang ditampilkan, hanya label yang dirender.custom
– Menentukan ikon kustom yang akan digunakan. URL yang mengarah ke gambar ikon dapat ditambahkan ke akhir parameterpins
setelah informasi lokasi pin.
Tambahkan gaya pin dengan format optionNameValue
. Pisahkan beberapa gaya dengan karakter pipa (|). Misalnya: iconType|optionName1Value1|optionName2Value2
. Nilai dan nama opsi tidak boleh dipisah. Gunakan nama opsi gaya berikut ini untuk penanda gaya:
al
– Menentukan tingkat keburaman (alfa) penanda. Pilih angka antara 0 dan 1.an
– Menentukan jangkar pin. Tentukan nilai piksel X dan y dalam format "x y".co
– Warna pin. Tentukan warna heksadesimal 24 bit:000000
menjadiFFFFFF
.la
– Menentukan jangkar label. Tentukan nilai piksel X dan y dalam format "x y".lc
– Warna label. Tentukan warna heksadesimal 24 bit:000000
menjadiFFFFFF
.ls
– Ukuran label dalam piksel. Pilih angka yang lebih besar dari 0.ro
– Nilai dalam derajat untuk memutar ikon. Pilih angka antara -360 dan 360.sc
– Nilai skala untuk ikon pin. Pilih angka yang lebih besar dari 0.
Tentukan nilai label untuk setiap lokasi pin. Pendekatan ini lebih efisien daripada menerapkan satu nilai label ke semua penanda dalam daftar lokasi. Nilai label dapat menjadi string dari beberapa karakter. Tutup string dengan tanda kutip tunggal untuk memastikan string tidak disangka sebagai nilai gaya atau lokasi.
Mari kita tambahkan ikon default merah (FF0000
), dengan label "Space Needle", diletakkan di bawah ini (15 50). Ikon ini berada pada garis bujur: -122.349300, garis lintang: 47.620180:
&pins=default|coFF0000|la15 50||'Space Needle' -122.349300 47.620180
Tambahkan tiga pin dengan nilai label '1', '2', dan '3':
&pins=default||'1'-122 45|'2'-119.5 43.2|'3'-121.67 47.12
Perbandingan format parameter URL penanda
Sebelum: Google Maps
Tambahkan garis dan poligon ke gambar peta statik menggunakan parameter path
di URL. Parameter path
mengambil gaya dan daftar lokasi yang akan dirender di peta:
&path=pathStyles|pathLocation1|pathLocation2|...
Gunakan gaya lain dengan menambahkan parameter path
ekstra ke URL dengan gaya dan kumpulan lokasi yang berbeda.
Lokasi jalur ditentukan dengan format latitude1,longitude1|latitude2,longitude2|…
. Jalur dapat dikodekan atau berisi alamat untuk titik.
Tambahkan gaya jalur dengan format optionName:value
, pisahkan beberapa gaya dengan karakter pipa (|). Pisahkan juga nama dan nilai opsi dengan titik dua (:). Misalnya: optionName1:value1|optionName2:value2
. Nama opsi gaya berikut dapat digunakan untuk jalur gaya di Google Maps:
color
– Warna jalur atau garis luar poligon. Dapat berupa warna heksadesimal 24 bit (0xrrggbb
), warna heksadesimal 32 bit (0xrrggbbbaa
) atau salah satu nilai berikut: hitam, cokelat, hijau, ungu, kuning, biru, abu-abu, jingga, merah, atau putih.fillColor
– Warna untuk mengisi area jalur (poligon). Dapat berupa warna heksadesimal 24 bit (0xrrggbb
), warna heksadesimal 32 bit (0xrrggbbbaa
) atau salah satu nilai berikut: hitam, cokelat, hijau, ungu, kuning, biru, abu-abu, jingga, merah, atau putih.geodesic
– Menunjukkan apakah jalan harus menjadi garis yang mengikuti kelengkungan bumi.weight
– Ketebalan garis jalur dalam piksel.
Tambahkan tingkat keburaman garis merah dan ketebalan piksel ke peta di antara koordinat, di parameter URL. Untuk contoh berikut, garis memiliki keburaman 50% dan ketebalan empat piksel. Koordinatnya adalah garis bujur: -110, garis lintang: 45 dan garis bujur: -100, garis lintang: 50.
&path=color:0xFF000088|weight:4|45,-110|50,-100
Setelah: Azure Maps
Tambahkan penanda ke gambar peta statik dengan menentukan parameter path
dalam URL. Seperti Google Maps, tentukan gaya dan daftar lokasi dalam parameter. Tentukan parameter path
beberapa kali untuk merender beberapa lingkaran, garis, dan poligon dengan gaya yang berbeda.
&path=pathStyles||pathLocation1|pathLocation2|...
Ketika datang ke lokasi jalur, Azure Maps mengharuskan koordinat berada dalam format "bujur,lintang". Google Maps menggunakan format "garis lintang, garis bujur". Dalam Azure Maps, spasi, bukan koma, digunakan untuk memisahkan garis bujur dan garis lintang. Azure Maps tidak mendukung jalur atau alamat yang dikodekan untuk titik.
Tambahkan gaya jalur dengan format optionNameValue
. Pisahkan beberapa gaya dengan karakter pipa (|), seperti ini optionName1Value1|optionName2Value2
. Nilai dan nama opsi tidak boleh dipisah. Gunakan nama opsi gaya berikut ini untuk jalur gaya di Azure Maps:
fa
- Tingkat keburaman warna isian (alfa) yang digunakan saat merender poligon. Pilih angka antara 0 dan 1.fc
- Warna isian yang digunakan untuk merender area poligon.la
– Tingkat keburaman warna garis luar (alfa) yang digunakan saat merender garis dan garis poligon. Pilih angka antara 0 dan 1.lc
– Warna garis yang digunakan untuk merender garis dan garis luar poligon.lw
– Lebar garis dalam piksel.ra
– Menentukan radius lingkaran dalam meter.
Tambahkan tingkat keburaman garis merah dan ketebalan piksel di antara koordinat, di parameter URL. Untuk contoh berikut, garis memiliki opasitas 50% dan ketebalan empat piksel. Koordinat memiliki nilai-nilai berikut: garis bujur: -110, garis lintang: 45 dan garis bujur: -100, garis lintang: 50.
&path=lcFF0000|la.5|lw4||-110 45|-100 50
Memperhitungkan matriks jarak
Azure Maps menyediakan API matriks jarak. Gunakan API ini untuk memperhitungkan waktu perjalanan dan jarak antara kumpulan lokasi, dengan matriks jarak. Penghitungan ini sebanding dengan distance matrix API di Google Maps.
- Post Route Matrix: Menghitung waktu dan jarak perjalanan secara asinkron untuk sekumpulan asal dan tujuan. Mendukung hingga 700 sel per permintaan. Itulah jumlah titik asal yang dikalikan dengan jumlah tujuan. Dengan batasan seperti itu, contoh dimensi matriks yang memungkinkan adalah: 700x1, 50x10, 10x10, 28x25, 10x70.
Catatan
Permintaan ke API matriks jarak hanya dapat dibuat menggunakan POST
permintaan dengan informasi asal dan tujuan dalam isi permintaan. Selain itu, Azure Maps mengharuskan semua titik asal dan tujuan menjadi koordinat. Alamat harus di-geocode terlebih dahulu.
Tabel ini memberikan referensi silang untuk parameter Google Maps API dengan parameter API Azure Maps yang dapat dibandingkan.
Parameter Google Maps API | Parameter Azure Maps API yang dapat dibandingkan |
---|---|
arrival_time |
arriveAt |
avoid |
avoid |
departure_time |
departAt |
destinations |
destination – tentukan dalam isi POST permintaan sebagai GeoJSON. |
key |
subscription-key – Untuk informasi selengkapnya, lihat Autentikasi dengan Azure Maps. |
language |
language – Untuk informasi selengkapnya, lihat Dukungan pelokalan di Azure Maps. |
mode |
travelMode |
origins |
origins – tentukan dalam isi POST permintaan sebagai GeoJSON. |
region |
N/A – Fitur ini terkait dengan geocoding. Gunakan parameter countrySet saat menggunakan API geocoding Azure Maps. |
traffic_model |
N/A – Hanya dapat ditentukan jika data lalu lintas harus digunakan dengan parameter traffic . |
transit_mode |
N/A - Saat ini, matriks jarak berbasis transit tidak didukung. |
transit_routing_preference |
N/A - Saat ini, matriks jarak berbasis transit tidak didukung. |
units |
N/A – Azure Maps hanya menggunakan sistem metrik. |
Tip
Semua opsi perutean tingkat lanjut yang tersedia di Azure Maps routing API didukung di Azure Maps distance matrix API. Pilihan perutean tingkat lanjut meliputi: perutean truk, spesifikasi mesin, dan sebagainya.
Untuk informasi selengkapnya, lihat praktik terbaik untuk perutean.
Mengatur zona waktu
Azure Maps menyediakan API untuk mengambil zona waktu koordinat. Azure Maps time zone API sebanding dengan time zone API di Google Maps:
- Dapatkan Zona Waktu Menurut Koordinat: Tentukan koordinat dan terima detail zona waktu koordinat.
Tabel berikut memberikan referensi silang untuk parameter Google Maps API dengan parameter API yang dapat dibandingkan di Azure Maps.
Parameter Google Maps API | Parameter Azure Maps API yang dapat dibandingkan |
---|---|
key |
subscription-key – Untuk informasi selengkapnya, lihat Autentikasi dengan Azure Maps. |
language |
language – Untuk informasi selengkapnya, lihat Dukungan pelokalan di Azure Maps. |
location |
query |
timestamp |
timeStamp |
Selain API ini, Azure Maps menyediakan sejumlah API zona waktu. API ini mengonversi waktu berdasarkan nama atau ID zona waktu:
- Dapatkan Zona Waktu Menurut ID: Mengembalikan informasi zona waktu saat ini, historis, dan yang akan datang untuk ID zona waktu IANA yang ditentukan.
- Dapatkan Timezone Enum IANA: Mengembalikan daftar lengkap ID zona waktu IANA. Pembaruan untuk layanan IANA diterapkan di sistem dalam satu hari.
- Dapatkan Timezone Enum Windows: Mengembalikan daftar lengkap ID Zona Waktu Windows.
- Dapatkan Versi IANA Zona Waktu: Mengembalikan nomor versi IANA saat ini yang digunakan oleh Azure Maps.
- Dapatkan Zona Waktu Windows Ke IANA: Mengembalikan ID IANA terkait, dengan ID Zona Waktu Windows yang valid. Beberapa ID IANA dapat ditampilkan untuk satu ID Windows.
Pustaka klien
Azure Maps menyediakan pustaka klien untuk bahasa pemrograman berikut ini:
- JavaScript, TypeScript, Node.js – Paket npm modul | layanan Azure Maps
Pustaka klien sumber terbuka ini untuk bahasa pemrograman lain:
- .NET Standard 2.0 – Proyek GitHub | Paket NuGet
Membersihkan sumber daya
Tidak ada sumber daya yang harus dibersihkan.
Langkah berikutnya
Pelajari selengkapnya tentang layanan REST Azure Maps: