Bagikan melalui


Tutorial: Memigrasikan layanan web dari Google Maps

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.

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 - kota
municipalitySubdivision – pemukiman, kota kecil/besar
countrySubdivision - negara bagian atau provinsi
countrySecondarySubdivision - wilayah
countryTertiarySubdivision - distrik
countryCode - 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

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 dan POST . 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. Bisa tiny, mid, atau small.

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, atau bottomright.
  • 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

Penanda Google Maps

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 parameter pins 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 menjadi FFFFFF.
  • la – Menentukan jangkar label. Tentukan nilai piksel X dan y dalam format "x y".
  • lc – Warna label. Tentukan warna heksadesimal 24 bit: 000000 menjadi FFFFFF.
  • 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

Penanda Azure Maps

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

Beberapa penanda Azure Maps

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

Polyline Google Maps

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

Poligaris Azure Maps

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:

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:

Pustaka klien

Azure Maps menyediakan pustaka klien untuk bahasa pemrograman berikut ini:

Pustaka klien sumber terbuka ini untuk bahasa pemrograman lain:

Membersihkan sumber daya

Tidak ada sumber daya yang harus dibersihkan.

Langkah berikutnya

Pelajari selengkapnya tentang layanan REST Azure Maps: