Anfordern eines Kartenauthentifizierungsschlüssels

  • Artikel

Warnung

Onlinekartendienste sind in älteren Versionen von Windows 10 möglicherweise nicht verfügbar. In den folgenden Versionen zeigt MapControl möglicherweise keine Karten mehr an, und APIs im Windows.Services.Maps-Namespace geben möglicherweise keine Ergebnisse zurück:

  • Windows 10, Version 1607 und frühere Versionen: Kartendienste sind ab Oktober 2020 weltweit nicht verfügbar
  • Windows 10, Version 1703 und früheren Versionen: Kartendienste sind auf einigen in China verkauften Geräten nicht verfügbar.

Ihre universelle Windows-App muss authentifiziert werden, bevor sie mapControl und Kartendienste im Windows.Services.Maps-Namespace verwenden kann. Zum Authentifizieren Ihrer App müssen Sie einen Kartenauthentifizierungsschlüssel angeben. In diesem Thema wird beschrieben, wie Sie einen Kartenauthentifizierungsschlüssel vom Bing Maps Developer Center anfordern und Ihrer App hinzufügen.

Tipp Um mehr über das Verwenden von Karten in Ihrer App zu erfahren, laden Sie das folgende Beispiel aus den API-Beispielen für die universelle Windows-Plattform auf GitHub herunter:

Abrufen eines Schlüssels

Erstellen und verwalten Sie Kartenauthentifizierungsschlüssel für Ihre universellen Windows-Apps im Bing Maps Developer Center.

So erstellen Sie einen neuen Schlüssel

  1. Navigieren Sie in Ihrem Browser zum Bing Maps Developer Center (https://www.bingmapsportal.com).

  2. Wenn Sie zum Anmelden aufgefordert werden, geben Sie Ihre Microsoft-Kontoinformationen ein, und klicken Sie auf Anmelden.

  3. Wählen Sie das Konto, das mit Ihrem Bing Karten-Konto verknüpft werden soll. Wenn Sie Ihr Microsoft-Konto verwenden möchten, klicken Sie auf Ja. Andernfalls klicken Sie auf die Option zum Anmelden mit einem anderen Konto.

  4. Wenn Sie noch kein Bing Karten-Konto besitzen, erstellen Sie ein neues Bing Karten-Konto. Geben Sie Kontoname, Kontaktname, Firmenname, E-Mail-Adresse und Telefonnummer ein. Akzeptieren Sie die Nutzungsbedingungen, und klicken Sie auf Erstellen.

  5. Klicken Sie im Menü Mein Konto auf Meine Schlüssel.

  6. Wenn Sie zuvor einen Schlüssel erstellt haben, klicken Sie auf den Link, um einen neuen Schlüssel zu erstellen. Fahren Sie andernfalls mit dem Formular Schlüssel erstellen fort.

  7. Füllen Sie das Formular Schlüssel erstellen aus, und klicken Sie dann auf Erstellen.

    • Anwendungsname: Der Name Ihrer Anwendung.
    • Anwendungs-URL (optional): Die URL Ihrer Anwendung.
    • Schlüsseltyp: Wählen Sie Basic oder Enterprise aus.
    • Anwendungstyp: Wählen Sie Windows-Anwendung zur Verwendung in Ihrer universellen Windows-App aus.

    So sieht das Formular aus.

    Beispiel des Formulars „Schlüssel erstellen“.

  8. Nachdem Sie auf Erstellen geklickt haben, wird der neue Schlüssel unterhalb des Formulars Schlüssel erstellen angezeigt. Kopieren Sie ihn an einen sicheren Ort, oder fügen Sie ihn sofort wie im nächsten Schritt beschrieben Ihrer App hinzu.

Hinzufügen des Schlüssels zur App

Der Kartenauthentifizierungsschlüssel ist erforderlich, um die MapControl-Klasse und Kartendienste (Windows.Services.Maps) in Ihrer universellen Windows-App zu verwenden. Fügen Sie ihn ggf. dem Kartensteuerelement und Kartendienstobjekten hinzu.

So fügen Sie den Schlüssel einem Kartensteuerelement hinzu

Setzen Sie zum Authentifizieren der MapControl-Klasse die MapServiceToken-Eigenschaft auf den Wert des Authentifizierungsschlüssels. Sie können diese Eigenschaft je nach Ihren Einstellungen im Code oder im XAML-Markup festlegen. Weitere Informationen zur Verwendung der MapControl-Klasse finden Sie unter Anzeigen von Karten mit 2D-, 3D- und Streetside-Ansichten.

  • In diesem Beispiel wird die MapServiceToken-Eingeschaft auf den Wert des Authentifizierungsschlüssels im Code gesetzt.

    MapControl1.MapServiceToken = "abcdef-abcdefghijklmno";

  • In diesem Beispiel wird die MapServiceToken-Eingeschaft auf den Wert des Authentifizierungsschlüssels im XAML-Markup gesetzt.

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

So fügen Sie den Schlüssel Kartendiensten hinzu

Um Dienste im Windows.Services.Maps-Namespace zu verwenden, setzen Sie die ServiceToken-Eigenschaft auf den Wert des Authentifizierungsschlüssels. Weitere Informationen zur Verwendung von Kartendiensten finden Sie unter Anzeigen von Routen und Wegbeschreibungen auf einer Karte und Durchführen der Geocodierung und umgekehrten Geocodierung.

  • In diesem Beispiel wird die ServiceToken-Eingeschaft auf den Wert des Authentifizierungsschlüssels im Code gesetzt.

    MapService.ServiceToken = "abcdef-abcdefghijklmno";