지도 인증 키 요청

  • 아티클

Warning

온라인 맵 서비스는 이전 버전의 Windows 10에서 사용하지 못할 수 있습니다. 다음 버전에서 MapControl은 더 이상 맵을 표시하지 않을 수 있으며 Windows.Services.Maps 네임스페이스의 API는 결과를 반환하지 않을 수 있습니다.

  • Windows 10, 버전 1607 및 이전 버전: 맵 서비스는 2020년 10월부터 전 세계적으로 사용할 수 없습니다.
  • Windows 10, 버전 1703 및 이전 버전: 중국에서 판매되는 일부 디바이스에서는 맵 서비스를 사용할 수 없습니다.

Windows.Services.Maps 네임스페이스에서 MapControl 및 지도 서비스를 사용하려면 먼저 유니버설 Windows 앱을 인증해야 합니다. 앱을 인증하려면 지도 인증 키를 지정해야 합니다. 이 토픽에서는 Bing 지도 개발자 센터에 지도 인증 키를 요청하고 이 키를 앱에 추가하는 방법을 설명합니다.

Tip 앱으로 지도를 사용하는 방법에 대해 자세히 알아보려면 GitHub의 Windows-universal-samples 리포지토리에서 다음 샘플을 다운로드하세요.

키 확보하기

Bing 지도 개발자 센터를 사용하여 유니버설 Windows 앱의 지도 인증 키를 생성하고 관리하세요.

새 키를 생성하려면

  1. 브라우저에서 Bing 지도 개발자 센터(https://www.bingmapsportal.com)로 이동합니다.

  2. 로그인하라는 메시지가 나타나면 Microsoft 계정을 입력하고 로그인을 클릭하세요.

  3. Bing 지도 계정에 연결할 계정을 선택하세요. Microsoft 계정을 사용하려면 예를 클릭하세요. 아니면 다른 계정으로 로그인을 클릭하세요.

  4. Bing 지도 계정이 아직 없다면 새 Bing 지도 계정을 만드세요. 계정 이름, 연락처 이름, 회사 이름, 이메일 주소 및 전화번호를 입력하세요. 사용 약관에 동의한 후 생성을 클릭하세요.

  5. 내 계정 메뉴 아래에서 내 키를 클릭합니다.

  6. 키를 이미 만든 경우 새로운 키를 만들려면 링크를 클릭합니다. 그렇지 않으면 키 만들기 양식으로 이동합니다.

  7. 키 생성 양식을 작성한 다음 생성을 클릭하세요.

    • 애플리케이션 이름: 애플리케이션의 이름입니다.
    • 애플리케이션 URL(선택 사항): 애플리케이션의 URL입니다.
    • 키 유형:기본 또는 엔터프라이즈를 선택하세요.
    • 애플리케이션 유형: 유니버설 Windows 앱에서 사용할 Windows 애플리케이션을 선택합니다.

    다음은 이 양식이 표시되는 형태의 예입니다.

    an example of the create key form.

  8. 생성을 클릭하고 나면 새 키가 키 생성 양식 아래에 표시됩니다. 다음 단계에서 설명하는 대로 해당 키를 안전한 장소로 복사하거나 즉시 앱에 추가하세요.

앱에 키 추가하기

유니버설 Windows 앱에서 MapControl 및 지도 서비스(Windows.Services.Maps)를 사용하려면 지도 인증 키가 있어야 합니다. 해당되는 경우, 이 키를 지도 컨트롤 개체 및 지도 서비스 개체에 추가하세요.

지도 컨트롤에 키를 추가하려면

MapControl을 인증하려면 MapServiceToken 속성을 인증 키 값으로 설정하세요. 이 속성은 기본 설정에 따라 코드 또는 XAML 태그에서 설정할 수 있습니다. MapControl 사용에 대한 자세한 내용은 2D 뷰, 3D 뷰 및 Streetside 뷰로 지도 보기를 참조하세요.

  • 이 예제에서는 MapServiceToken을 코드의 인증 키 값으로 설정합니다.

    MapControl1.MapServiceToken = "abcdef-abcdefghijklmno";

  • 이 예제에서는 MapServiceToken을 XAML 태그의 인증 키 값으로 설정합니다.

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

서비스 매핑을 위해 키를 추가하려면

Windows.Services.Maps 네임스페이스에서 서비스를 사용하려면 ServiceToken 속성을 인증 키 값으로 설정하세요. 지도 서비스 사용에 대한 자세한 내용은 경로 및 방향 보기 및 지오코딩 및 역방향 지오코딩 실행을 참조하세요.

  • 이 예제에서는 ServiceToken을 코드의 인증 키 값으로 설정합니다.

    MapService.ServiceToken = "abcdef-abcdefghijklmno";