지도 인증 키 요청Request a maps authentication key

경고

온라인 maps 서비스는 이전 버전의 Windows 10에서 사용 하지 못할 수 있습니다.Online maps services may not be available on older versions of Windows 10. 다음 버전에서는 없습니다가 더 이상 지도를 표시 하지 않을 수 있으며, Windows. Maps 네임 스페이스의 Api는 결과를 반환 하지 않을 수 있습니다.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 및 이전 버전: map services는 전 세계 2020 년 10 월부터 사용할 수 없습니다.Windows 10, version 1607 and earlier versions: map services will be unavailable worldwide starting in October 2020
  • Windows 10, 버전 1703 및 이전 버전: 중국에서 판매 되는 일부 장치 에서 지도 서비스를 사용할 수 없음Windows 10, version 1703 and earlier versions: map services are unavailable on some devices sold in China

유니버설 windows 앱없습니다 네임 스페이스 에서 서비스를 사용 하 고 매핑하기 전에 인증 되어야 합니다.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 Maps 개발자 센터 에서 지도 인증 키를 요청 하 고 앱에 추가 하는 방법에 대해 설명 합니다.This topic describes how to request a maps authentication key from the Bing Maps Developer Center and add it to your app.

앱에서 지도를 사용 하는 방법에 대 한 자세한 내용은 GitHub의 Windows 유니버설 샘플 리포지토리 에서 다음 샘플을 다운로드 하세요.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

Bing Maps 개발자 센터를 사용 하 여 유니버설 Windows 앱에 대 한 맵 인증 키를 만들고 관리 합니다.Create and manage map authentication keys for your Universal Windows apps using the Bing Maps Developer Center.

새 키를 만들려면To create a new key

  1. 브라우저에서 Bing Maps 개발자 센터 ()로 이동 https://www.bingmapsportal.com 합니다.In your browser, navigate to the Bing Maps Developer Center (https://www.bingmapsportal.com).

  2. 로그인 하 라는 메시지가 표시 되 면 Microsoft 계정 입력 하 고 로그인을 클릭 합니다.If you are asked to sign in, enter your Microsoft account and click Sign in.

  3. Bing Maps 계정에 연결할 계정을 선택 합니다.Choose the account to associate with your Bing Maps account. Microsoft 계정를 사용 하려면 를 클릭 합니다.If you want to use your Microsoft account, click Yes. 그러지 않은 경우 다른 계정으로 로그인을 클릭합니다.Otherwise, click Sign in with another account.

  4. Bing Maps 계정이 아직 없는 경우 새 Bing Maps 계정을 만듭니다.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. 그렇지 않으면 Create 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.

    create key 폼의 예입니다.

  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

유니버설 Windows 앱의 없습니다 및 map services ( MapControl )를 사용 하려면 맵 인증 키가 필요합니다.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

없습니다을 인증 하려면 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. 없습니다사용에 대 한 자세한 내용은 2d, 3d 및 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

ServiceToken 네임 스페이스에서 서비스를 사용 하려면 인증 키 값으로 ServiceToken 속성을 설정 합니다.To use services in the Windows.Services.Maps namespace, set the ServiceToken property to the authentication key value. Map services를 사용 하는 방법에 대 한 자세한 내용은 경로 및 방향 표시지 오 코딩 및 역방향 지 오 코딩 수행을 참조 하세요.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";