Azure 지도 웹 SDK 마이그레이션 가이드

매핑 요구를 위해 Azure Maps 웹 SDK를 선택해 주셔서 감사합니다. 이 마이그레이션 가이드를 사용하면 v1 및 v2에서 v3으로 전환하여 최신 기능과 향상된 기능을 활용할 수 있습니다.

변경 내용 이해

마이그레이션 프로세스를 시작하기 전에 웹 SDK v3에 도입된 주요 변경 내용 및 개선 사항을 숙지해야 합니다. 릴리스 정보를 검토하여 새 기능의 범위를 파악합니다.

웹 SDK 버전 업데이트

CDN

CDN(콘텐츠 배달 네트워크)을 사용하는 경우 HTML 파일 요소에서 v3 스타일시트 및 JavaScript에 대한 참조를 head 업데이트합니다.

v1

<link rel="stylesheet" href="https://atlas.microsoft.com/sdk/css/atlas.min.css?api-version=1" type="text/css" />
<script src="https://atlas.microsoft.com/sdk/js/atlas.min.js?api-version=1"></script>

v2

<link rel="stylesheet" href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/2/atlas.min.css" type="text/css" />
<script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/2/atlas.min.js"></script>

v3

<link rel="stylesheet" href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3/atlas.min.css" type="text/css" />
<script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3/atlas.min.js"></script>

npm

npm을 사용하는 경우 다음 명령을 실행하여 최신 Azure Maps 컨트롤로 업데이트합니다.

npm install azure-maps-control@latest

인증 방법 검토(선택 사항)

보안을 강화하기 위해 v2부터 웹 SDK에 더 많은 인증 방법이 포함됩니다. 새로운 방법에는 Microsoft Entra 인증 및 공유 키 인증이 포함됩니다. Azure Maps 웹 애플리케이션 보안에 대한 자세한 내용은 Azure Maps의 인증 관리를 참조하세요.

테스팅

포괄적인 테스트는 마이그레이션 중에 반드시 필요합니다. 다양한 브라우저 및 디바이스에서 애플리케이션의 기능, 성능 및 사용자 환경을 철저히 테스트합니다.

점진적 출시

업데이트된 버전에 대한 점진적 출시 전략을 고려합니다. 전체 사용자 기반에서 사용할 수 있도록 하기 전에 마이그레이션된 버전을 더 작은 사용자 그룹 또는 제어된 환경에서 릴리스합니다.

이러한 단계를 수행하고 모범 사례를 고려하면 Azure 지도 Web SDK v1 및 v2에서 v3으로 애플리케이션을 성공적으로 마이그레이션할 수 있습니다. 사용자에게 매끄럽고 원활한 전환을 보장하면서 최신 버전이 제공하는 새로운 기능과 개선 사항을 수용합니다. 자세한 내용은 Azure Maps 웹 SDK 모범 사례를 참조하세요.

다음 단계

Azure Maps에서 맵 컨트롤 클라이언트 측 JavaScript 라이브러리를 사용하여 웹 및 모바일 애플리케이션에 맵을 추가하는 방법에 대해 알아봅니다.