Meminta kunci autentikasi peta
Penting
Penghentian layanan Bing Maps for Enterprise
Layanan UWP MapControl dan peta dari namespace Windows.Services.Maps mengandalkan Bing Maps. Bing Maps for Enterprise tidak digunakan lagi dan akan dihentikan, di mana MapControl dan layanan tidak akan lagi menerima data.
Untuk informasi selengkapnya, lihat dokumentasi Pusat Pengembang Bing Maps dan Bing Maps.
Peringatan
Layanan peta online mungkin tidak tersedia pada versi Windows 10 yang lebih lama. Pada versi berikut, MapControl mungkin tidak lagi menampilkan peta dan API di namespace Windows.Services.Maps mungkin tidak mengembalikan hasil:
- Windows 10, versi 1607 dan versi yang lebih lama: layanan peta tidak akan tersedia di seluruh dunia mulai Oktober 2020
- Windows 10, versi 1703 dan versi yang lebih lama: layanan peta tidak tersedia di beberapa perangkat yang dijual di Tiongkok
Aplikasi Anda harus diautentikasi sebelum dapat menggunakan layanan MapControl dan peta di namespace layanan Windows.Services.Maps. Untuk mengautentikasi aplikasi, Anda harus menentukan kunci autentikasi peta. Topik ini menjelaskan cara meminta kunci autentikasi peta dari Pusat Pengembang Bing Maps dan menambahkannya ke aplikasi Anda.
Mendapatkan kunci
Buat dan kelola kunci autentikasi peta untuk aplikasi Universal Windows Anda menggunakan Pusat Pengembang Bing Maps.
Untuk membuat kunci baru
Di browser Anda, navigasikan ke Pusat Pengembang Bing Maps (https://www.bingmapsportal.com).
Jika Anda diminta untuk masuk, masukkan akun Microsoft Anda dan klik Masuk.
Pilih akun yang akan dikaitkan dengan akun Bing Maps Anda. Jika Anda ingin menggunakan akun Microsoft Anda, klik Ya. Jika tidak, klik Masuk dengan akun lain.
Jika Anda belum memiliki akun Bing Maps, buat akun Bing Maps baru. Masukkan Nama Akun, Nama Kontak, Nama Perusahaan, Alamat Email, dan Nomor Telepon. Setelah menerima ketentuan penggunaan, klik Buat.
Di bawah menu Akun saya, klik Kunci Saya.
Jika sebelumnya Anda telah membuat kunci, klik tautan untuk membuat kunci baru. Jika tidak, lanjutkan ke formulir Buat Kunci.
Lengkapi formulir Buat Kunci lalu klik Buat.
- Nama aplikasi: Nama aplikasi Anda.
- URL Aplikasi (opsional): URL aplikasi Anda.
- Jenis kunci: Pilih Dasar atau Perusahaan.
- Jenis aplikasi: Pilih Aplikasi Windows untuk digunakan di aplikasi Universal Windows Anda.
Ini adalah contoh seperti apa bentuknya.
Setelah Anda mengklik Buat, kunci baru muncul di bawah formulir Buat Kunci . Salin ke tempat yang aman atau segera tambahkan ke aplikasi Anda, seperti yang dijelaskan di langkah berikutnya.
Menambahkan kunci ke aplikasi Anda
Kunci autentikasi peta diperlukan untuk menggunakan layanan MapControl dan peta (Windows.Services.Maps) di aplikasi Universal Windows Anda. Tambahkan ke kontrol peta dan objek layanan peta, sebagaimana berlaku.
Untuk menambahkan kunci ke kontrol peta
Untuk mengautentikasi MapControl, atur properti MapServiceToken ke nilai kunci autentikasi. Anda dapat mengatur properti ini dalam kode atau di markup XAML, tergantung pada preferensi Anda. Untuk informasi selengkapnya tentang menggunakan MapControl, lihat Menampilkan peta dengan tampilan 2D, 3D, dan Streetside.
Contoh ini mengatur MapServiceToken ke nilai kunci autentikasi dalam kode.
MapControl1.MapServiceToken = "abcdef-abcdefghijklmno";Contoh ini mengatur MapServiceToken ke nilai kunci autentikasi dalam markup XAML.
<Maps:MapControl x:Name="MapControl1" MapServiceToken="abcdef-abcdefghijklmno"/>
Untuk menambahkan kunci ke layanan peta
Untuk menggunakan layanan di namespace layanan Windows.Services.Maps , atur properti ServiceToken ke nilai kunci autentikasi. Untuk informasi selengkapnya tentang menggunakan layanan peta, lihat Menampilkan rute dan petunjuk arah dan Melakukan geocoding dan geocoding terbalik.
Contoh ini mengatur ServiceToken ke nilai kunci autentikasi dalam kode.
MapService.ServiceToken = "abcdef-abcdefghijklmno";