다음을 통해 공유


Azure Maps iOS SDK 시작(미리 보기)

Azure Maps iOS SDK는 iOS용 벡터 맵 라이브러리입니다. 이 문서에서는 Azure Maps iOS SDK를 설치하고 맵을 로드하는 프로세스를 안내합니다.

참고 항목

Azure Maps iOS SDK 사용 중지

이제 iOS용 Azure Maps 네이티브 SDK는 더 이상 사용되지 않으며 2025년 3월 31일에 사용 중지됩니다. 서비스 중단을 방지하려면 2025년 3월 31일까지 Azure Maps 웹 SDK로 마이그레이션하세요. 자세한 내용은 Azure Maps iOS SDK 마이그레이션 가이드를 참조하세요.

필수 조건

빠른 시작: iOS 앱 만들기 문서의 단계를 완료해야 합니다.

맵 지역화

Azure Maps iOS SDK는 맵의 언어 및 지역 보기를 설정하는 세 가지 방법을 제공합니다. 다음 코드에서는 언어를 프랑스어(fr-FR)로 설정하고 지역 보기Auto로 설정하는 다양한 방법을 보여 줍니다.

  1. 정적 languageview 속성을 사용하여 언어 및 지역 보기 정보를 AzureMaps 클래스에 전달하여 앱에서 기본 언어 및 지역 보기 속성을 설정합니다.

    // Alternatively use Azure Active Directory authenticate.
    AzureMaps.configure(aadClient: "<Your aad clientId>", aadAppId: "<Your aad AppId>", aadTenant: "<Your aad Tenant>")
    
    // Set your Azure Maps Key.
    // AzureMaps.configure(subscriptionKey: "<Your Azure Maps Key>")
    
    // Set the language to be used by Azure Maps.
    AzureMaps.language = "fr-FR"
    
    // Set the regional view to be used by Azure Maps.
    AzureMaps.view = "Auto"
    
  2. 언어 및 지역 보기 정보를 지도 컨트롤 init에 전달할 수도 있습니다.

    MapControl(options: [
        StyleOption.language("fr-FR"),
        StyleOption.view("Auto")
    ])
    
  3. 언어 및 지역별 보기 속성을 프로그래밍 방식으로 설정하는 마지막 방법은 지도 setStyle 메서드를 사용하는 것입니다. 지도의 언어 및 지역 보기를 변경해야 할 때마다 지도 setStyle 메서드를 사용합니다.

    mapControl.getMapAsync { map in
        map.setStyleOptions([
            StyleOption.language("fr-FR"),
            StyleOption.view("Auto")
        ])
    }
    

다음은 언어가 fr-FR로 설정되고 지역 보기가 Auto로 설정된 Azure Maps 애플리케이션의 예제입니다.

프랑스어로 레이블을 표시하는 맵 이미지.

지원되는 언어 및 지역별 보기의 전체 목록은 Azure Maps 지역화 지원을 참조하세요.

이 섹션에서는 Azure Maps 프로그램에서 탐색하는 다양한 방법을 자세히 설명합니다.

맵 확대/축소

  • 두 손가락으로 맵을 터치하고 두 손가락을 모으면 축소되고 두 손가락을 넓히면 확대됩니다.
  • 한 수준 확대하려면 맵을 두 번 탭합니다.
  • 두 손가락을 두 번 탭하여 맵을 한 단계 축소합니다.
  • 두 번 탭할 때 두 번째 탭에서 손가락을 맵에 고정한 채로 위나 아래로 끌면 확대 또는 축소됩니다.

맵 이동

  • 맵을 터치하고 원하는 방향으로 끕니다.

맵 회전

  • 두 손가락으로 맵을 터치하고 회전합니다.

맵 피치

  • 두 손가락으로 맵을 터치하고 위나 아래로 함께 끕니다.

Azure Government 클라우드 지원

Azure Maps iOS SDK는 Azure Government 클라우드 사용을 지원합니다. Azure Maps 인증 세부 정보가 지정된 위치에서 다음 코드 줄을 추가하여 Azure Maps 정부 클라우드 도메인 사용을 지정합니다.

AzureMaps.domain = "atlas.azure.us"

맵 및 서비스 인증 시 Azure Government 클라우드 플랫폼에서 Azure Maps 인증 세부 정보를 사용해야 합니다.

추가 정보

더 많은 코드 예제는 다음 문서를 참조하세요.