Meminta kunci autentikasi peta

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 Windows. Layanan. Peta namespace 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 Universal Windows Anda harus diautentikasi sebelum dapat menggunakan layanan MapControl dan peta di Windows. Layanan. Peta namespace. Untuk mengautentikasi aplikasi, Anda harus menentukan kunci autentikasi peta. Topik ini menjelaskan cara meminta kunci autentikasi peta dari Bing Maps Developer Center dan menambahkannya ke aplikasi Anda.

Tips Untuk mempelajari selengkapnya tentang menggunakan peta di aplikasi Anda, unduh sampel berikut dari repositori Windows-universal-samples di GitHub:

Mendapatkan kunci

Buat dan kelola kunci autentikasi peta untuk aplikasi Universal Windows Anda menggunakan Pusat Pengembang Bing Maps.

Untuk membuat kunci baru

  1. Di browser Anda, navigasikan ke Pusat Pengembang Bing Maps (https://www.bingmapsportal.com).

  2. Jika Anda diminta untuk masuk, masukkan akun Microsoft Anda dan klik Masuk.

  3. 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.

  4. 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.

  5. Di bawah menu Akun saya , klik Kunci Saya.

  6. Jika sebelumnya Anda telah membuat kunci, klik tautan untuk membuat kunci baru. Jika tidak, lanjutkan ke formulir Buat Kunci.

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

    an example of the create key form.

  8. 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. Layanan. Peta) 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 Windows. Layanan. Peta namespace layanan, 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";