Richiedere una chiave di autenticazione per le mappe

  • Articolo

Avviso

I servizi mappe online potrebbero non essere disponibili nelle versioni precedenti di Windows 10. Nelle versioni seguenti MapControl potrebbe non visualizzare più mappe e API in Windows.Services.Spazio dei nomi Maps potrebbe non restituire risultati:

  • Windows 10, versione 1607 e versioni precedenti: i servizi mappa non saranno disponibili a partire da ottobre 2020
  • Windows 10, versione 1703 e versioni precedenti: i servizi mappa non sono disponibili in alcuni dispositivi venduti in Cina

L'app Universal Windows deve essere autenticata prima che possa usare MapControl e map services nello spazio dei nomi Windows.Services.Maps. Per eseguire l'autenticazione della tua app, devi specificare una chiave di autenticazione per le mappe. Questo argomento descrive come richiedere una chiave di autenticazione per le mappe al centro per sviluppatori di Bing Mappe e aggiungerla alla tua app.

Suggerimento Per saperne di più su come usare le mappe e la posizione nella tua app, scarica gli esempi seguenti dal repository Windows-universal-samples su GitHub:

Ottenere una chiave

Creare e gestire le chiavi di autenticazione mappa per le app di Universal Windows usando Centro per sviluppatori Bing Maps.

Per creare una nuova chiave

  1. Nel browser passare al Centro per sviluppatori Bing Maps (https://www.bingmapsportal.com).

  2. Se viene chiesto di accedere, immettere l'account Microsoft e fare clic su Accedi.

  3. Scegliere l'account da associare all'account Bing Maps. Se si vuole usare l'account Microsoft, fare clic su Sì. In caso contrario, fare clic su Accedi con un altro account.

  4. Se non si ha già un account di Bing Maps, creare un nuovo account Bing Maps. Inserire Nome account, Nome contatto, Nome azienda, Indirizzo E-mail e Numero di telefono. Dopo aver accettato le condizioni per l'utilizzo, fare clic su Crea.

  5. Nel menu My account fare clic su My Keys.

  6. Se in precedenza è stata creata una chiave, fare clic sul collegamento per creare una nuova chiave. In caso contrario, passare al modulo Crea chiave.

  7. Compilare il modulo Crea chiave e quindi fare clic su Crea.

    • Nome dell'applicazione: Il nome dell'applicazione.
    • URL applicazione (facoltativo): URL dell'applicazione.
    • Tipo di chiave: Selezionare Basic o Enterprise.
    • Tipo di applicazione: Selezionare Applicazione Windows da usare nell'app di Universal Windows.

    Questo è un esempio dell'aspetto del modulo.

    an example of the create key form.

  8. Dopo aver fatto clic su Crea, la nuova chiave viene visualizzata sotto il modulo Crea chiave. Copiarlo in un luogo sicuro o aggiungerlo immediatamente all'app, come descritto nel passaggio successivo.

Aggiungere la chiave all'app

La chiave di autenticazione della mappa è necessaria per usare i servizi MapControl e map (Windows.Services.Maps) nell'app Universal Windows. Aggiungerlo al controllo mappa e mappare gli oggetti del servizio, a seconda delle esigenze.

Per aggiungere la chiave a un controllo mappa

Per autenticare MapControl, impostare la proprietà MapServiceToken nel valore della chiave di autenticazione. Si può impostare questa proprietà nel codice o nel markup XAML, a seconda delle preferenze. Per altre informazioni sull'uso di MapControl, vedere Visualizzare le mappe con viste 2D, 3D e Streetside.

  • In questo esempio si imposta MapServiceToken al valore della chiave di autenticazione nel codice.

    MapControl1.MapServiceToken = "abcdef-abcdefghijklmno";

  • In questo esempio si imposta MapServiceToken al valore della chiave di autenticazione in XAML markup.

    <Maps:MapControl x:Name="MapControl1" MapServiceToken="abcdef-abcdefghijklmno"/>

Per aggiungere la chiave per mappare i servizi

Per usare i servizi nello spazio dei nomi Windows.Services.Mappe, impostare la proprietà ServiceToken sul valore della chiave di autenticazione. Per altre info sull'uso dei servizi mappa, vedere Visualizzare itinerari e indicazioni stradali ed eseguire la geocodifica e la geocodifica inversa.

  • In questo esempio si imposta ServiceToken al valore della chiave di autenticazione nel codice.

    MapService.ServiceToken = "abcdef-abcdefghijklmno";