Запрос ключа проверки подлинности картRequest a maps authentication key

Предупреждение

Службы онлайн Maps могут быть недоступны в более старых версиях Windows 10.Online maps services may not be available on older versions of Windows 10. В следующих версиях MapControl может больше не отображать карты и интерфейсы API в пространстве имен Windows. Services. Maps может не возвращать результаты:On the following versions, MapControl may no longer display maps and APIs in the Windows.Services.Maps namespace may not return results:

  • Windows 10, версия 1607 и более ранние версии: службы карт будут недоступны по всему миру начиная с 2020 октябряWindows 10, version 1607 and earlier versions: map services will be unavailable worldwide starting in October 2020
  • Windows 10, версия 1703 и более ранние версии: службы Map недоступны на некоторых устройствах, продаваемых в КитаеWindows 10, version 1703 and earlier versions: map services are unavailable on some devices sold in China

Ваше приложение Universal Windows должно пройти проверку подлинности, прежде чем оно сможет использовать MapControl и службы карт в пространстве имен Windows.Services.Maps.Your Universal Windows app must be authenticated before it can use the MapControl and map services in the Windows.Services.Maps namespace. Для проверки подлинности приложения необходимо указать ключ проверки подлинности карт.To authenticate your app, you must specify a maps authentication key. В этом разделе описано, как запросить ключ проверки подлинности карт из центра разработки Карт Bing и добавить его в приложение.This topic describes how to request a maps authentication key from the Bing Maps Developer Center and add it to your app.

Подсказка. Чтобы получить дополнительные сведения об использовании карт в приложении, скачайте следующий пример из репозитория Windows-universal-samples на веб-сайте GitHub:Tip To learn more about using maps in your app, download the following sample from the Windows-universal-samples repo on GitHub:

Получение ключаGet a key

Создавайте ключи проверки подлинности карт для своих универсальных приложений для Windows и управляйте ими с помощью центра разработки Карт Bing.Create and manage map authentication keys for your Universal Windows apps using the Bing Maps Developer Center.

Вот как создать новый ключTo create a new key

  1. В браузере перейдите в центр разработчиков карт Bing ( https://www.bingmapsportal.com ).In your browser, navigate to the Bing Maps Developer Center (https://www.bingmapsportal.com).

  2. Если появится запрос на вход, введите свою учетную запись Майкрософт и щелкните Войти.If you are asked to sign in, enter your Microsoft account and click Sign in.

  3. Выберите учетную запись, которую нужно связать с учетной записью Карт Bing.Choose the account to associate with your Bing Maps account. Если вы хотите использовать учетную запись Майкрософт, щелкните Да.If you want to use your Microsoft account, click Yes. В противном случае выберите Войти под другой учетной записью.Otherwise, click Sign in with another account.

  4. Если у вас еще нет учетной записи Карт Bing, создайте новую учетную запись.If you don't already have a Bing Maps account, create a new Bing Maps account. Введите Имя учетной записи, Имя контакта, Название организации, Адрес электронной почты и Номер телефона.Enter the Account Name, Contact Name, Company Name, Email Address, and Phone Number. Приняв условия использования, щелкните Создать.After accepting the terms of use, click Create.

  5. В меню Моя учетная запись щелкните Мои ключи.Under the My account menu, click My Keys.

  6. Если у вас есть ранее созданный ключ, щелкните ссылку, чтобы создать новый ключ.If you have previously created a key, click on the link to create a new key. В противном случае перейдите к форме "Создание ключа".Otherwise proceed to the Create Key form.

  7. Заполните форму Создание ключа, а затем щелкните Создать.Complete the Create Key form and then click Create.

    • Имя приложения: имя вашего приложения.Application name: The name of your application.
    • URL-адрес приложения (необязательно): URL-адрес вашего приложения.Application URL (optional): The URL of your application.
    • Тип ключа: выберите Базовый или Корпоративный.Key type: Select Basic or Enterprise.
    • Тип приложения: Выберите приложение Windows для использования в универсальном приложении Windows.Application type: Select Windows Application for use in your Universal Windows app.

    Ниже приведен пример формы.This is an example of what the form looks like.

    пример формы создания ключей.

  8. После нажатия кнопки Создать под формой Создание ключа появится новый ключ.After you click Create, the new key appears below the Create Key form. Скопируйте его в безопасное место или сразу добавьте в свое приложение, как описано в следующем шаге.Copy it to a safe place or immediately add it to your app, as described in the next step.

Добавление ключа в приложениеAdd the key to your app

Ключ проверки подлинности карт требуется для использования MapControl и служб карт (Windows.Services.Maps) в универсальном приложении для Windows.The map authentication key is required to use the MapControl and map services (Windows.Services.Maps) in your Universal Windows app. Добавляйте его в объекты элемента управления картой и служб карт по обстоятельствам.Add it to the map control and map service objects, as applicable.

Вот как добавить ключ в элемент управления картойTo add the key to a map control

Для проверки подлинности MapControl установите свойство MapServiceToken для значения ключа проверки подлинности.To authenticate the MapControl, set the MapServiceToken property to the authentication key value. Это свойство можно задать в коде или в разметке XAML, в зависимости от ваших предпочтений.You can set this property in code or in XAML markup, depending on your preferences. Дополнительные сведения об использовании MapControl см. в статье Отображение карт с помощью двумерных и трехмерных представлений, а также с помощью представлений Streetside.For more info about using the MapControl, see Display maps with 2D, 3D, and Streetside views.

  • В этом примере для MapServiceToken устанавливается значение ключа проверки подлинности в коде.This example sets the MapServiceToken to the value of the authentication key in code.

    MapControl1.MapServiceToken = "abcdef-abcdefghijklmno";
    
  • В этом примере для MapServiceToken устанавливается значение ключа проверки подлинности в разметке XAML.This example sets the MapServiceToken to the value of the authentication key in XAML markup.

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

Вот как добавить ключ в службы картTo add the key to map services

Для использования служб в пространстве имен Windows.Services.Maps установите для свойства ServiceToken значение ключа проверки подлинности.To use services in the Windows.Services.Maps namespace, set the ServiceToken property to the authentication key value. Дополнительные сведения об использовании служб карт см.: в разделах Отображение дорог и направлений и Выполнение геокодирования и обратного геокодирования.For more info about using map services, see Display routes and directions and Perform geocoding and reverse geocoding.

  • В этом примере для ServiceToken устанавливается значение ключа проверки подлинности в коде.This example sets the ServiceToken to the value of the authentication key in code.

    MapService.ServiceToken = "abcdef-abcdefghijklmno";