Begära en autentiseringsnyckel för kartor

Viktigt!

UWP MapControl - och Windows Maps-plattforms-API:er (Windows.Services.Maps.*) är inaktuella och är kanske inte tillgängliga i framtida versioner av Windows. Mer information finns i Resurser för inaktuella funktioner.

Viktigt!

Avveckling av tjänst för Bing Maps for Enterprise

UWP MapControl och karttjänster från namnrymderna Windows.Services.Maps förlitar sig på Bing Maps. Bing Maps for Enterprise är inaktuell och kommer att dras tillbaka, då MapControl och tjänsterna inte längre tar emot data.

Mer information finns i dokumentationen Bing Maps Developer Center och Bing Maps.

Varning

Onlinekarttjänster kanske inte är tillgängliga i äldre versioner av Windows 10. I de följande versionerna kan MapControl inte längre visa kartor och API:er i namnområdet Windows.Services.Maps kanske inte returnerar resultat.

  • Windows 10 version 1607 och tidigare versioner: karttjänster är inte tillgängliga över hela världen från och med oktober 2020
  • Windows 10 version 1703 och tidigare versioner: karttjänster är inte tillgängliga på vissa enheter som säljs i Kina

Appen måste autentiseras innan den kan använda MapControl- och mappa tjänster i Windows.Services.Maps namnområde. Om du vill autentisera din app måste du ange en mappningsautentiseringsnyckel. Det här avsnittet beskriver hur du begär en mappningsautentiseringsnyckel från Bing Maps Developer Center och lägger till den i din app.

Hämta en nyckel

Skapa och hantera kartautentiseringsnycklar för dina universella Windows-appar genom Bing Maps Developer Center.

Skapa en ny nyckel

  1. I webbläsaren navigerar du till Bing Maps Developer Center (https://www.bingmapsportal.com).

  2. Om du uppmanas att logga in anger du ditt Microsoft-konto och klickar på Logga in.

  3. Välj det konto som ska associeras med ditt Bing Maps-konto. Om du vill använda ditt Microsoft-konto klickar du på Ja. Annars klickar du på Logga in med ett annat konto.

  4. Om du inte redan har ett Bing Maps-konto skapar du ett nytt Bing Maps-konto. Ange kontonamn, kontaktnamn, företagsnamn, e-postadressoch telefonnummer. När du har accepterat användningsvillkoren klickar du på Skapa.

  5. Under menyn Mitt konto klickar du på Mina nycklar.

  6. Om du tidigare har skapat en nyckel klickar du på länken för att skapa en ny nyckel. Annars fortsätter du till formuläret Skapa nyckel.

  7. Fyll i formuläret Skapa nyckel och klicka sedan på Skapa.

    • Programnamn: Namnet på ditt program.
    • Ansöknings-URL (valfritt): applikationens URL.
    • Nyckeltyp: Välj Basic eller Enterprise.
    • Programtyp: Välj Windows-program som ska användas i din Universella Windows-app.

    Det här är ett exempel på hur formuläret ser ut.

    ett exempel på formuläret skapa nyckel.

  8. När du har klickat på Skapavisas den nya nyckeln under formuläret Skapa nyckel. Kopiera den till en säker plats eller lägg omedelbart till den i din app, enligt beskrivningen i nästa steg.

Lägg till nyckeln i din app

Kartautentiseringsnyckeln krävs för att använda MapControl-- och karttjänster (Windows.Services.Maps) i din Universella Windows-app. Lägg till den i kartkontrollen och mappa tjänstobjekt, efter behov.

Så här lägger du till nyckeln i en kartkontroll

Om du vill autentisera MapControl-anger du egenskapen MapServiceToken till värdet för autentiseringsnyckeln. Du kan ange den här egenskapen i kod eller I XAML-markering, beroende på dina inställningar. För mer information om att använda MapControl, se Visa kartor med 2D-, 3D- och Streetside-vyer.

  • I det här exemplet anges MapServiceToken värdet för autentiseringsnyckeln i koden.

    MapControl1.MapServiceToken = "abcdef-abcdefghijklmno";
    
  • Det här exemplet anger MapServiceToken värdet för autentiseringsnyckeln i XAML-markering.

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

Lägga till nyckeln till karttjänster

Om du vill använda tjänster i Windows.Services.Maps namnområde anger du egenskapen ServiceToken värdet för autentiseringsnyckeln. Mer information om hur du använder karttjänster finns i Visa vägar och vägbeskrivningar och Utföra geokodning och omvänd geokodning.

  • Det här exemplet anger ServiceToken värdet för autentiseringsnyckeln i koden.

    MapService.ServiceToken = "abcdef-abcdefghijklmno";