Meluncurkan aplikasi Peta Windows

Artikel
07/13/2023

Pelajari cara meluncurkan aplikasi Peta Windows dari aplikasi Anda. Topik ini menjelaskan bingmaps:, ms-drive-to:, ms-walk-to:, dan ms-settings: Skema Uniform Resource Identifier (URI). Gunakan skema URI ini untuk meluncurkan aplikasi Peta Windows ke peta, petunjuk arah, dan hasil pencarian tertentu atau untuk mengunduh peta offline Peta Windows dari aplikasi Pengaturan.

Tips Untuk mempelajari selengkapnya tentang meluncurkan aplikasi Peta Windows dari aplikasi Anda, unduh sampel peta Platform Windows Universal (UWP) dari repo Windows-universal-samples di GitHub.

Memperkenalkan URI

Skema URI memungkinkan Anda membuka aplikasi dengan mengklik hyperlink (atau secara terprogram, di aplikasi Anda). Sama seperti Anda dapat memulai email baru menggunakan mailto: atau membuka browser web menggunakan http:, Anda dapat membuka aplikasi peta Windows menggunakan bingmaps:, ms-drive-to:, dan ms-walk-to:.

Peta bing: URI menyediakan peta untuk lokasi, hasil pencarian, petunjuk arah, dan lalu lintas.
Ms-drive-to: URI menyediakan petunjuk arah mengemudi belokan demi belokan dari lokasi Anda saat ini.
Ms-walk-to: URI menyediakan petunjuk jalan kaki belokan demi belokan dari lokasi Anda saat ini.

Misalnya, URI berikut membuka aplikasi Peta Windows dan menampilkan peta yang berpusat di atas New York City.

<bingmaps:?cp=40.726966~-74.006076>

sebuah peta yang berpusat di kota New York.

Berikut adalah deskripsi skema URI:

bingmaps:?query

Dalam skema URI ini, kueri adalah serangkaian pasangan nama/nilai parameter:

¶m1=value1¶m2=value2 ...

Untuk daftar lengkap parameter yang tersedia, lihat referensi parameter bingmaps:, ms-drive-to:, dan ms-walk-to: . Ada juga contoh nanti dalam topik ini.

Meluncurkan URI dari aplikasi Anda

Untuk meluncurkan aplikasi Peta Windows dari aplikasi Anda, panggil metode LaunchUriAsync dengan bingmaps:, ms-drive-to:, atau ms-walk-to: URI. Contoh berikut meluncurkan URI yang sama dari contoh sebelumnya. Untuk informasi selengkapnya tentang meluncurkan aplikasi melalui URI, lihat Meluncurkan aplikasi default untuk URI.

// Center on New York City
var uriNewYork = new Uri(@"bingmaps:?cp=40.726966~-74.006076");

// Launch the Windows Maps app
var launcherOptions = new Windows.System.LauncherOptions();
launcherOptions.TargetApplicationPackageFamilyName = "Microsoft.WindowsMaps_8wekyb3d8bbwe";
var success = await Windows.System.Launcher.LaunchUriAsync(uriNewYork, launcherOptions);

Dalam contoh ini, kelas LauncherOptions digunakan untuk membantu memastikan aplikasi Peta Windows diluncurkan.

Tampilkan lokasi yang diketahui

Ada banyak opsi untuk mengontrol bagian mana dari peta yang akan ditampilkan. Anda dapat menggunakan parameter cp (titik tengah) dengan parameter rad (radius) atau lvl (tingkat zoom) untuk menampilkan lokasi dan memilih seberapa dekat untuk memperbesar tampilannya. Saat Anda menggunakan parameter cp , Anda juga dapat menentukan hdg (judul) dan pit (pitch) untuk mengontrol arah tampilan. Metode lain adalah menggunakan parameter bb (kotak pembatas) untuk menyediakan koordinat selatan, timur, utara, dan barat maksimum dari area yang ingin Anda tampilkan.

Untuk mengontrol jenis tampilan, gunakan parameter sty (style) dan ss (Streetside). Parameter sty memungkinkan Anda beralih antara tampilan jalan dan udara. Parameter ss menempatkan peta ke dalam tampilan Streetside. Untuk informasi selengkapnya tentang parameter ini dan lainnya, lihat bingmaps: referensi parameter.

Contoh URI	Hasil
bingmaps:?	Membuka aplikasi Maps.
bingmaps:?cp=40.726966~-74.006076	Menampilkan peta yang berpusat di atas New York City.
bingmaps:?cp=40.726966~-74.006076&lvl=10	Menampilkan peta yang berpusat di atas New York City dengan tingkat perbesar tampilan 10.
bingmaps:?bb=39.719_-74.52~41.71_-73.5	Menampilkan peta Kota New York, yang merupakan area yang ditentukan dalam argumen bb .
bingmaps:?bb=39.719_-74.52~41.71_-73.5&cp=47~-122	Menampilkan peta Kota New York, yang merupakan area yang ditentukan dalam argumen kotak pembatas. Titik tengah untuk Seattle yang ditentukan dalam argumen cp diabaikan karena bb ditentukan.
bingmaps:?collection=point.36.116584_-115.176753_Caesars%20Palace&lvl=16	Menampilkan peta dengan titik bernama Caesars Palace (di Las Vegas) dan mengatur tingkat perbesar tampilan menjadi 16.
bingmaps:?collection=point.40.726966_-74.006076_Some%255FBusiness	Menampilkan peta dengan titik bernama Some_Business (di Las Vegas).
bingmaps:?cp=40.726966~-74.006076&trfc=1&sty=a	Menampilkan peta Kota New York dengan lalu lintas dan gaya peta udara.
bingmaps:?cp=47.6204~-122.3491&sty=3d	Menampilkan tampilan 3D dari Space Needle.
bingmaps:?cp=47.6204~-122.3491&sty=3d&rad=200&pit=75&hdg=165	Menampilkan tampilan 3D Space Needle dengan radius 200m, nada 75 derajat, dan judul 165 derajat.
bingmaps:?cp=47.6204~-122.3491&ss=1	Menampilkan tampilan Streetside dari Space Needle.

Menampilkan hasil pencarian

Saat mencari tempat menggunakan parameter q , sebaiknya buat istilah sespesifikasi mungkin dan menggunakan parameter cp, bb, atau where untuk menentukan lokasi pencarian. Jika Anda tidak menentukan lokasi pencarian dan lokasi pengguna saat ini tidak tersedia, pencarian mungkin tidak mengembalikan hasil yang bermakna. Hasil pencarian ditampilkan dalam tampilan peta yang paling sesuai. Untuk informasi selengkapnya tentang parameter ini dan lainnya, lihat bingmaps: referensi parameter.

Contoh URI	Hasil
bingmaps:?q=1600%20Pennsylvania%20Ave,%20Washington,%20DC	Menampilkan peta dan mencari alamat Gedung Putih di Washington, DC.
bingmaps:?q=coffee&where=Seattle	Mencari kopi di Seattle.
bingmaps:?cp=40.726966~-74.006076&where=New%20York	Mencari New York di dekat titik pusat yang ditentukan.
bingmaps:?bb=39.719_-74.52~41.71_-73.5&q=pizza	Mencari pizza dalam kotak pembatas yang ditentukan (yaitu, di New York City).

Menampilkan beberapa titik

Gunakan parameter koleksi untuk menampilkan sekumpulan titik kustom di peta. Jika ada lebih dari satu poin, daftar titik ditampilkan. Mungkin ada hingga 25 poin dalam koleksi dan tercantum dalam urutan yang disediakan. Koleksi lebih diutamakan daripada permintaan pencarian dan petunjuk arah. Untuk informasi selengkapnya tentang parameter ini dan lainnya, lihat bingmaps: referensi parameter.

Contoh URI	Hasil
bingmaps:?collection=point.36.116584_-115.176753_Caesars%20Palace	Mencari Caesar's Palace di Las Vegas dan menampilkan hasilnya di peta dalam tampilan peta terbaik.
bingmaps:?collection=point.36.116584_-115.176753_Caesars%20Palace&lvl=16	Menampilkan pushpin bernama Caesars Palace di Las Vegas dan memperbesar ke level 16.
bingmaps:?collection=point.36.116584_-115.176753_Caesars%20Palace~point.36.113126_-115.175188_The%20Bellagio&lvl=16&cp=36.114902~-115.176669	Menampilkan pushpin bernama Caesars Palace dan pushpin bernama The Bellagio di Las Vegas dan zoom ke level 16.
bingmaps:?collection=point.40.726966_-74.006076_Fake%255FBusiness%255Fwith%255FUnderscore	Menampilkan New York dengan pushpin bernama Fake_Business_with_Underscore.
bingmaps:?collection=name. Hotel%20List~point.36.116584_-115.176753_Caesars%20Palace~point.36.113126_-115.175188_The%20Bellagio&lvl=16&cp=36.114902~-115.176669	Menampilkan daftar bernama Hotel List dan dua pushpin untuk Caesars Palace dan The Bellagio di Las Vegas dan zoom ke tingkat 16.

Menampilkan arah dan lalu lintas

Anda dapat menampilkan arah antara dua titik menggunakan parameter rtp ; titik tersebut dapat berupa alamat atau koordinat garis lintang dan bujur. Gunakan parameter trfc untuk menampilkan informasi lalu lintas. Untuk menentukan jenis petunjuk arah: mengemudi, berjalan, atau transit, gunakan parameter mode . Jika mode tidak ditentukan, petunjuk arah akan disediakan menggunakan moda transportasi pilihan pengguna. Untuk informasi selengkapnya tentang parameter ini dan lainnya, lihat bingmaps: referensi parameter.

contoh petunjuk arah

Contoh URI	Hasil
bingmaps:?rtp=pos.44.9160_-110.4158~pos.45.0475_-109.4187	Menampilkan peta dengan arah titik-ke-titik. Karena mode tidak ditentukan, petunjuk arah akan disediakan menggunakan moda preferensi transportasi pengguna.
bingmaps:?cp=43.0332~-87.9167&trfc=1	Menampilkan peta yang berpusat di milwaukee, WI dengan lalu lintas.
bingmaps:?rtp=adr. One Microsoft Way, Redmond, WA 98052~pos.39.0731_-108.7238	Menampilkan peta dengan petunjuk arah dari alamat yang ditentukan ke lokasi yang ditentukan.
bingmaps:?rtp=adr.1%20Microsoft%20Way,%20Redmond,%20WA,%2098052~pos.36.1223_-111.9495_Grand%20Canyon%20northern%20rim	Menampilkan petunjuk arah dari 1 Microsoft Way, Redmond, WA, 98052 ke pelek utara Grand Canyon.
bingmaps:?rtp=adr. Davenport, CA~adr. Desa Yosemite	Menampilkan peta dengan petunjuk arah mengemudi dari lokasi yang ditentukan ke landmark yang ditentukan.
bingmaps:?rtp=adr. Mountain%20View,%20CA~adr. San%20Francisco%20International%20Airport,%20CA&mode=d	Menampilkan petunjuk arah mengemudi dari Mountain View, CA ke Bandara Internasional San Francisco, CA.
bingmaps:?rtp=adr. Mountain%20View,%20CA~adr. San%20Francisco%20International%20Airport,%20CA&mode=w	Menampilkan arah berjalan kaki dari Mountain View, CA ke Bandara Internasional San Francisco, CA.
bingmaps:?rtp=adr. Mountain%20View,%20CA~adr. San%20Francisco%20International%20Airport,%20CA&mode=t	Menampilkan arah transit dari Mountain View, CA ke Bandara Internasional San Francisco, CA.

Menampilkan arah belokan demi belokan

Skema ms-drive-to: dan ms-walk-to: URI memungkinkan Anda meluncurkan langsung ke tampilan belokan demi belokan rute. Skema URI ini hanya dapat memberikan petunjuk arah dari lokasi pengguna saat ini. Jika Anda harus memberikan petunjuk arah antara titik yang tidak menyertakan lokasi pengguna saat ini, gunakan bingmaps: skema URI seperti yang dijelaskan di bagian sebelumnya. Untuk informasi selengkapnya tentang skema URI ini, lihat referensi parameter ms-drive-to: dan ms-walk-to: .

Penting Ketika skema ms-drive-to: atau ms-walk-to: URI diluncurkan, aplikasi Maps akan memeriksa apakah perangkat pernah memiliki perbaikan lokasi GPS. Jika sudah, aplikasi Maps akan melanjutkan ke arah belokan demi belokan. Jika belum, aplikasi akan menampilkan gambaran umum rute, seperti yang dijelaskan dalam Petunjuk tampilan dan lalu lintas.

contoh arah belokan demi belokan

Contoh URI	Hasil
ms-drive-to:?destination.latitude=47.680504&destination.longitude=-122.328262&destination.name=Green Lake	Menampilkan peta dengan arah mengemudi belokan demi belokan ke Green Lake dari lokasi Anda saat ini.
ms-walk-to:?destination.latitude=47.680504&destination.longitude=-122.328262&destination.name=Green Lake	Menampilkan peta dengan arah berjalan belokan demi belokan ke Green Lake dari lokasi Anda saat ini.

Mengunduh peta offline

Pengaturan ms: Skema URI memungkinkan Anda meluncurkan langsung ke halaman tertentu di aplikasi Pengaturan. Meskipun pengaturan ms: Skema URI tidak diluncurkan ke aplikasi Maps, itu memungkinkan Anda untuk meluncurkan langsung ke halaman Peta Offline di aplikasi Pengaturan dan menampilkan dialog konfirmasi untuk mengunduh peta offline yang digunakan oleh aplikasi Maps. Skema URI menerima titik yang ditentukan oleh garis lintang dan bujur dan secara otomatis menentukan apakah ada peta offline yang tersedia untuk wilayah yang berisi titik tersebut. Jika garis lintang dan garis bujur diteruskan terjadi dalam beberapa wilayah unduhan, dialog konfirmasi akan memungkinkan pengguna memilih wilayah mana yang akan diunduh. Jika peta offline tidak tersedia untuk wilayah yang berisi titik tersebut, halaman Peta offline di aplikasi Pengaturan ditampilkan dengan dialog kesalahan.

Contoh URI	Hasil
ms-settings:maps-downloadmaps?latlong=47.6,-122.3	Membuka aplikasi Pengaturan ke halaman Peta Offline dengan dialog konfirmasi yang ditampilkan untuk mengunduh peta untuk wilayah yang berisi titik bujur lintang yang ditentukan.

bingmaps: referensi parameter

Sintaks untuk setiap parameter dalam tabel ini diperlihatkan dengan menggunakan Formulir Augmented Backus–Naur (ABNF).

Parameter	Definisi	Definisi dan Contoh ABNF	Detail
Cp	Titik tengah	cp = cp=" cpval cpval = degreeslat "~" degreeslon degreeslat = ["-"] 13DIGIT ["." 17DIGIT] degreeslon = ["-"] 12DIGIT ["." 17DIGIT] Contoh: cp=40.726966~-74.006076	Kedua nilai harus dinyatakan dalam derajat desimal dan dipisahkan oleh tilde(~). Nilai bujur yang valid antara -180 dan +180 inklusif. Nilai garis lintang yang valid antara -90 dan +90 inklusif.
Bb	Kotak pembatas	bb = "bb=" southlatitude "_" westlongitude "~" northlatitude "_" eastlongitude southlatitude = degreeslat northlatitude = degreeslat westlongitude = degreeslon eastlongitude = derajatslon degreeslat = ["-"] 13DIGIT ["." 17DIGIT] degreeslon = ["-"] 12DIGIT ["." 17DIGIT] Contoh: bb=39.719_-74.52~41.71_-73.5	Area persegi panjang yang menentukan kotak pembatas yang dinyatakan dalam derajat desimal, menggunakan tilde (~) untuk memisahkan sudut kiri bawah dari sudut kanan atas. Garis lintang dan bujur untuk masing-masing dipisahkan dengan garis bawah (_). Nilai bujur yang valid antara -180 dan +180 inklusif. Nilai garis lintang yang valid antara -90 dan +90 inklusif. Parameter cp dan lvl diabaikan saat kotak pembatas disediakan.
di mana	Lokasi	where = "where=" whereval whereval = 1( ALPHA / DIGIT / "-" / "." / "_" / pct-encoded / "!" / "$" / "'" / "(" / ")" / "" / "+" / "," / ";" / ":" / "@" / "/" / "?") Contoh: where=1600%20Pennsylvania%20Ave,%20Washington,%20DC	Istilah pencarian untuk lokasi, tengara, atau tempat tertentu.
q	Istilah Kueri	q = "q=" whereval Contoh: q=mexican%20restaurants	Istilah pencarian untuk bisnis lokal atau kategori bisnis.
lvl	Tingkat Zoom	lvl = "lvl=" 12DIGIT ["." 12DIGIT] Contoh: lvl=10.50	Menentukan tingkat pembesaran tampilan peta. Nilai yang valid adalah 1-20 di mana 1 diperbesar semua jalan keluar.
Sty	Gaya	sty = "sty=" ("a" / "r"/"3d") Contoh: sty=a	Menentukan gaya peta. Nilai yang valid untuk parameter ini meliputi: a: Menampilkan tampilan udara peta. r: Menampilkan tampilan jalan peta. 3d: Menampilkan tampilan peta 3D. Gunakan bersama dengan parameter cp dan secara opsional dengan parameter rad . Di Windows 10, tampilan udara dan gaya tampilan 3D sama. Catatan Menghilangkan parameter sty menghasilkan hasil yang sama dengan sty=r.
rad	Radius	rad = "rad=" 1*8DIGIT Contoh: rad=1000	Area melingkar yang menentukan tampilan peta yang diinginkan. Nilai radius diukur dalam meter.
lubang	Kemiringan	pit = pitch "pit=" Contoh: pit=60	Menunjukkan sudut yang dilihat peta, di mana 90 melihat ke cakrawala (maksimum) dan 0 melihat lurus ke bawah (minimum). Nilai pitch yang valid adalah antara 0 dan 90 inklusif.
hdg	Heading	hdg = judul "hdg=" Contoh: hdg=180	Menunjukkan arah peta menuju derajat, di mana 0 atau 360 = Utara, 90 = Timur, 180 = Selatan, dan 270 = Barat.
Ss	Pinggir jalan	ss = "ss=" BIT Contoh: ss=1	Menunjukkan bahwa citra tingkat jalan ditampilkan saat `ss=1`. Menghilangkan parameter ss menghasilkan hasil yang sama dengan `ss=0`. Gunakan bersama dengan parameter cp untuk menentukan lokasi tampilan tingkat jalan. Catatan Citra tingkat jalan tidak tersedia di semua wilayah.
trfc	Lalu lintas	trfc = "trfc=" BIT Contoh: trfc=1	Menentukan apakah informasi lalu lintas disertakan di peta. Menghilangkan parameter trfc menghasilkan hasil yang sama dengan `trfc=0`. Catatan Data lalu lintas tidak tersedia di semua wilayah.
rtp	Rute	rtp = "rtp=" (waypoint "~" [waypoint]) / ("~" waypoint) waypoint = ("pos." point ) / ("adr." whereval) titik = "titik." pointval ["_" title] pointval = degreeslat "" degreeslon degreeslat = ["-"] 13DIGIT ["." 17DIGIT] degreeslon = ["-"] 12DIGIT ["." 17DIGIT] title = whereval whereval = 1( ALPHA / DIGIT / "-" / "." / "_" / pct-encoded / "!" / "$" / "'" / "(" / ")" / "" / "+" / "," / ";" / ":" / "@" / "/" / "?") Contoh: rtp=adr. Mountain%20View,%20CA~adr. SFO rtp=adr. Satu%20Microsoft%20Way,%20Redmond,%20WA~pos.45.23423_-122.1232_My%20Picnic%20Spot	Menentukan awal dan akhir rute untuk menggambar di peta, dipisahkan oleh tilde (~). Setiap titik arah didefinisikan oleh posisi menggunakan ltitude, bujur, dan judul opsional atau pengidentifikasi alamat. Rute lengkap berisi tepat dua titik arah. Misalnya, rute dengan dua titik arah didefinisikan oleh `rtp="A"~"B"`. Juga dapat diterima untuk menentukan rute yang tidak lengkap. Misalnya, Anda hanya dapat menentukan awal rute dengan `rtp="A"~`. Dalam hal ini, input petunjuk arah ditampilkan dengan titik arah yang disediakan di bidang Dari dan bidang Kepada memiliki fokus. Jika hanya akhir rute yang ditentukan, seperti halnya `rtp=~"B"`, panel petunjuk arah ditampilkan dengan titik arah yang disediakan di bidang Kepada . Jika lokasi saat ini yang akurat tersedia, lokasi saat ini telah diisi sebelumnya di bidang Dari dengan fokus. Tidak ada garis rute yang digambar ketika rute yang tidak lengkap diberikan. Gunakan bersama dengan parameter mode untuk menentukan moda transportasi (mengemudi, transit, atau berjalan). Jika mode tidak ditentukan, petunjuk arah akan disediakan menggunakan moda preferensi transportasi pengguna. Catatan Judul dapat digunakan untuk lokasi jika lokasi ditentukan oleh nilai parameter pos . Daripada menampilkan garis lintang dan bujur, judul akan ditampilkan.
mode	Moda transportasi	mode = "mode=" ("d" / "t" / "w") Contoh: mode=d	Mendefinisikan moda transportasi. Nilai yang valid untuk parameter ini meliputi: d: Menampilkan gambaran umum rute untuk petunjuk arah mengemudi t: Menampilkan gambaran umum rute untuk arah transit w: Menampilkan gambaran umum rute untuk petunjuk arah berjalan Gunakan bersama dengan parameter rtp untuk arah transportasi. Jika mode tidak ditentukan, petunjuk arah akan disediakan menggunakan moda preferensi transportasi pengguna. Mode dapat disediakan tanpa parameter rute untuk memasukkan input petunjuk arah untuk mode tersebut dari lokasi saat ini.
collection	Koleksi	collection = "collection="(name"~"/)point["~"point] name = "name." whereval whereval = 1( ALPHA / DIGIT / "-" / "." / "_" / pct-encoded / "!" / "$" / "'" / "(" / ")" / "" / "+" / "," / ";" / ":" / "@" / "/" / "?") titik = "titik." pointval ["_" title] pointval = degreeslat "" degreeslon degreeslat = ["-"] 13DIGIT ["." 17DIGIT] degreeslon = ["-"] 12DIGIT ["." 17DIGIT] title = whereval Contoh: collection=name. My%20Trip%20Stops~point.36.116584_-115.176753_Las%20Vegas~point.37.8268_-122.4798_Golden%20Gate%20Bridge	Kumpulan poin yang akan ditambahkan ke peta dan daftar. Kumpulan titik dapat diberi nama menggunakan parameter nama. Titik ditentukan menggunakan garis lintang, bujur, dan judul opsional. Pisahkan nama dan beberapa titik dengan tilde (~). Jika item yang Anda tentukan berisi tilde, pastikan tilde dikodekan sebagai `%7E`. Jika tidak disertai dengan parameter Titik tengah dan Tingkat Zoom, koleksi akan memberikan tampilan peta terbaik. Penting Jika item yang Anda tentukan berisi garis bawah, pastikan garis bawah dikodekan ganda sebagai %255F.

ms-drive-to: referensi parameter

URI untuk meluncurkan permintaan arah mengemudi belokan demi belokan tidak perlu dikodekan dan memiliki format berikut.

Catatan Anda tidak menentukan titik awal dalam skema URI ini. Titik awal selalu diasumsikan sebagai lokasi saat ini. Jika Anda perlu menentukan titik awal selain lokasi saat ini, lihat Menampilkan petunjuk arah dan lalu lintas.

Parameter	Definisi	Contoh	Detail
destination.latitude	Garis lintang tujuan	Contoh: destination.latitude=47.6451413797194	Garis lintang tujuan. Nilai garis lintang yang valid antara -90 dan +90 inklusif.
destination.longitude	Garis bujur tujuan	Contoh: destination.longitude=-122.141964733601	Garis bujur tujuan. Nilai bujur yang valid antara -180 dan +180 inklusif.
destination.name	Nama tujuan	Contoh: destination.name=Redmond, WA	Nama tujuan. Anda tidak perlu mengodekan nilai destination.name .

ms-walk-to: referensi parameter

URI untuk meluncurkan permintaan untuk arah berjalan belokan demi belokan tidak perlu dikodekan dan memiliki format berikut.