Richiedere una chiave di autenticazione per le mappeRequest a maps authentication key

Avviso

I servizi online Maps potrebbero non essere disponibili nelle versioni precedenti di Windows 10.Online maps services may not be available on older versions of Windows 10. Nelle versioni seguenti, MapControl potrebbe non visualizzare più le mappe e le API nello spazio dei nomi Windows. Services. Maps non può restituire risultati:On the following versions, MapControl may no longer display maps and APIs in the Windows.Services.Maps namespace may not return results:

  • Windows 10, versione 1607 e versioni precedenti: i servizi di mapping non saranno disponibili in tutto il mondo a partire dal 2020 ottobreWindows 10, version 1607 and earlier versions: map services will be unavailable worldwide starting in October 2020
  • Windows 10, versione 1703 e versioni precedenti: i servizi di mapping non sono disponibili in alcuni dispositivi venduti in CinaWindows 10, version 1703 and earlier versions: map services are unavailable on some devices sold in China

Per poter usare i servizi MapControl e Map nello spazio dei nomi Windows. Services. Maps , è necessario autenticare l' app di Windows universale .Your Universal Windows app must be authenticated before it can use the MapControl and map services in the Windows.Services.Maps namespace. Per eseguire l'autenticazione della tua app, devi specificare una chiave di autenticazione per le mappe.To authenticate your app, you must specify a maps authentication key. Questo argomento spiega come richiedere una chiave di autenticazione per le mappe dal centro per sviluppatori di Bing Mappe e aggiungerla alla tua app.This topic describes how to request a maps authentication key from the Bing Maps Developer Center and add it to your app.

Suggerimento Per altre informazioni su come usare le mappe nella tua app, scarica l'esempio seguente dal repository di esempi universali di Windows su GitHub:Tip To learn more about using maps in your app, download the following sample from the Windows-universal-samples repo on GitHub:

Ottenere una chiaveGet a key

Crea e gestisci le chiavi di autenticazione per le mappe per le tue app di Windows universali usando il centro per sviluppatori di Bing Mappe.Create and manage map authentication keys for your Universal Windows apps using the Bing Maps Developer Center.

Per creare una nuova chiaveTo create a new key

  1. Nel browser passare al centro per sviluppatori di Bing Maps ( https://www.bingmapsportal.com ).In your browser, navigate to the Bing Maps Developer Center (https://www.bingmapsportal.com).

  2. Se viene richiesto di accedere, immetti il tuo account Microsoft e fai clic su Sign in.If you are asked to sign in, enter your Microsoft account and click Sign in.

  3. Scegli l'account da associare al tuo account di Bing Mappe.Choose the account to associate with your Bing Maps account. Se vuoi usare il tuo account Microsoft, fai clic su Yes.If you want to use your Microsoft account, click Yes. In caso contrario, fai clic su Sign in with another account.Otherwise, click Sign in with another account.

  4. Se non hai già un account di Bing Mappe, creane uno nuovo.If you don't already have a Bing Maps account, create a new Bing Maps account. Immetti le informazioni in Account Name, Contact Name, Company Name, Email Address e Phone Number.Enter the Account Name, Contact Name, Company Name, Email Address, and Phone Number. Dopo aver accettato le condizioni per l'utilizzo fai clic su Create.After accepting the terms of use, click Create.

  5. Nel menu account personale fare clic su chiavi personali.Under the My account menu, click My Keys.

  6. Se in precedenza è stata creata una chiave, fare clic sul collegamento per creare una nuova chiave.If you have previously created a key, click on the link to create a new key. In caso contrario, passare al modulo Crea chiave.Otherwise proceed to the Create Key form.

  7. Compila il modulo Create Key e quindi fai clic su Create.Complete the Create Key form and then click Create.

    • Application name: il nome della tua applicazione.Application name: The name of your application.
    • Application URL (optional): URL della tua applicazione.Application URL (optional): The URL of your application.
    • Key type: seleziona Basic o Enterprise.Key type: Select Basic or Enterprise.
    • Tipo di applicazione: Selezionare applicazione Windows da usare nell'app di Windows universale.Application type: Select Windows Application for use in your Universal Windows app.

    Il tuo modulo sarà simile al seguente.This is an example of what the form looks like.

    Esempio di modulo per la creazione della chiave.

  8. Dopo aver fatto clic su Create, la nuova chiave verrà visualizzata sotto il modulo Create Key.After you click Create, the new key appears below the Create Key form. Copiala in una posizione sicura o aggiungila immediatamente alla tua app, come descritto nel passaggio successivo.Copy it to a safe place or immediately add it to your app, as described in the next step.

Aggiungere la chiave all'appAdd the key to your app

La chiave di autenticazione per le mappe è necessaria per usare il MapControl e i servizi per le mappe (Windows.Services.Maps) nella tua app di Windows universale.The map authentication key is required to use the MapControl and map services (Windows.Services.Maps) in your Universal Windows app. Aggiungila al controllo mappa e agli oggetti del servizio per le mappe, come applicabile.Add it to the map control and map service objects, as applicable.

Per aggiungere la chiave a un controllo mappaTo add the key to a map control

Per autenticare il MapControl, impostare la proprietà MapServiceToken sul valore della chiave di autenticazione.To authenticate the MapControl, set the MapServiceToken property to the authentication key value. Puoi impostare questa proprietà nel codice o nel markup XAML, a seconda delle tue preferenze.You can set this property in code or in XAML markup, depending on your preferences. Per altre informazioni sull'uso di MapControl, vedi Mostrare mappe con visualizzazioni 2D, 3D e Streetside.For more info about using the MapControl, see Display maps with 2D, 3D, and Streetside views.

  • Questo esempio imposta MapServiceToken sul valore della chiave di autenticazione nel codice.This example sets the MapServiceToken to the value of the authentication key in code.

    MapControl1.MapServiceToken = "abcdef-abcdefghijklmno";
    
  • Questo esempio imposta MapServiceToken sul valore della chiave di autenticazione nel markup XAML.This example sets the MapServiceToken to the value of the authentication key in XAML markup.

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

Per aggiungere la chiave ai servizi per le mappeTo add the key to map services

Per usare i servizi nello spazio dei nomi Windows.Services.Maps, imposta la proprietà ServiceToken sul valore della chiave di autenticazione.To use services in the Windows.Services.Maps namespace, set the ServiceToken property to the authentication key value. Per altre informazioni sui servizi per le mappe, vedi Visualizzare itinerari e indicazioni stradali e Eseguire la geocodifica e la geocodifica inversa.For more info about using map services, see Display routes and directions and Perform geocoding and reverse geocoding.

  • Questo esempio imposta ServiceToken sul valore della chiave di autenticazione nel codice.This example sets the ServiceToken to the value of the authentication key in code.

    MapService.ServiceToken = "abcdef-abcdefghijklmno";