포털 바로가기 네이버 클라우드 플랫폼 설명서

2018년 11월 13일 Mobile Dynamic Map 3.0 버전이 출시됨에 따라, 기존의 2.0 버전의 서비스는 2019년 12월 31일까지만 제공될 예정입니다. 2020년 1월 이후에는 Mobile Dynamic Map 2.0 버전 사용 시 지도 초기 화면에서 오류메세지가 노출되며 기능을 사용할 수 없습니다.

이와 같이 2019년 12월 31일까지는 Mobile Dynamic Map 2.0 버전과 3.0 버전을 함께 이용할 수 있으나, 2020년 1월 1일부터는 2.0 버전은 종료되며, 새로운 3.0 버전만 이용할 수 있으니 2.0 버전 종료 이전에 전환을 요청드립니다.

Mobile Dynamic Map 2.0 버전에서 3.0 버전으로 이전하기 위한 상세한 가이드는 아래 링크를 참고하시길 바랍니다. ​

※ 서비스 종료 일정

• Mobile Dynamic Map SDK 2.0 버전 신규 다운로드 종료 : 2019년 8월 1일
• Mobile Dynamic Map 2.0 버전 서비스 종료 : 2020년 1월 1일

​ ※ 서비스 이전(마이그레이션) 가이드

• Android 마이그레이션 설명서
• iOS 마이그레이션 설명서

iOS용 라이브러리

iOS용 Maps 라이브러리에서 제공하는 클래스에 대한 정보를 제공합니다. 라이브러리에서는 지도를 화면에 표시하기 위한 지도 메인 클래스와 지도 위에 오버레이 데이터를 표시하기 위한 오버레이 클래스, 그리고 데이터 클래스를 제공합니다.

SDK 및 샘플코드 >

API 호출 예제

iOS Maps API 개발을 위한 준비사항은 다음과 같습니다.

• XCode에서 프로젝트 생성: 이때 입력하는 ‘Bundle Identifier’는 애플리케이션 등록설정의 iOS Bundle ID와 반드시 일치하도록 주의 합니다.
• https://github.com/navermaps/maps.ios에서 SDK를 다운로드합니다.

• SDK의 NMapViewerSDK 프레임웍과 ApiGatewayMac 프레임웍을 프로젝트에 추가합니다. NMapViewerSDK는 Linked Frameworks로 ApiGatewayMac은 Embedded Binaries로 등록해야 합니다. Embedded Binaries로 등록하면 자동으로 Linked Frameworks 에도 등록됩니다. 프레임웍은 SDK의 Frameworks 폴더에 있습니다.

• 프로젝트 Build 설정에 아래 설정을 추가합니다.

• Linking > Other Linker Flags에 -ObjC -lxml2 플래그를 추가합니다.

• Search Paths > Framework Search Paths에 NMapViewerSDK, ApiGatewayMac 프레임웍이 있는 폴더가 추가되어 있는지 확인합니다.

• 프로젝트 타겟의 Build Phases에 아래 설정을 추가합니다.

• New Run Script Phases에 strip-frameworks.sh 스크립트를 추가합니다.

• 스크립트의 위치에 따라 경로명을 조정해야 합니다.

• Info.plist에 아래 설정을 추가합니다.

<key>NSAppTransportSecurity</key>
<dict>
    <key>NSAllowsArbitraryLoads</key>
    <true/>
</dict>

<key>LSApplicationCategoryType</key>
<string>NSLocationWhenInUseUsageDescription</string>

• Swift를 이용하는 경우, 아래 작업이 추가로 필요합니다.

• Objective-C Bridging Header를 아래 내용으로 생성합니다.

#ifndef your_project_Bridging_Header_h
#define your_project_Bridging_Header_h

#import <NMapViewerSDK/NMapView.h>
#import <NMapViewerSDK/NMapLocationManager.h>

#endif

• 프로젝트 Build 설정에 아래 설정을 추가합니다.
  • Swift Compiler - General > Objective-C Bridging Header에 위에서 생성한 헤더파일을 추가합니다.

// 네이버 지도만 화면으로 띄우는 간단한 예제입니다.(파일명: MapViewController.m)
#import "MapViewController.h"
#import <NMapViewerSDK/NMapView.h>
#define kClientID @" YOUR_CLIENT_ID" //get your clientID

@interface ViewController () <NMapViewDelegate, NMapPOIdataOverlayDelegate>
@property (nonatomic, strong) NMapView *mapView;
@end

@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];
    // create map view
    self.mapView = [[NMapView alloc] initWithFrame:self.view.bounds];
    // set delegate for map view
    [self.mapView setDelegate:self];
    // set Client ID for Open MapViewer Library
    [self.mapView setClientId:kClientID];
    [self.view addSubview:self.mapView];
}

- (void)didReceiveMemoryWarning {
    [super didReceiveMemoryWarning];
}

#pragma mark NMapViewDelegate Method

- (void) onMapView:(NMapView *)mapView initHandler:(NMapError *)error {

    if (error == nil) { // success
        // set map center and level
        [self.mapView setMapCenter:NGeoPointMake(126.978371, 37.5666091) atLevel:11];
        [self.mapView setMapEnlarged:YES mapHD:YES];
    } else { // fail
        NSLog(@"onMapView:initHandler: %@", [error description]);
    }
}

#pragma mark NMapPOIdataOverlayDelegate

- (UIImage *) onMapOverlay:(NMapPOIdataOverlay *)poiDataOverlay imageForOverlayItem:(NMapPOIitem *)poiItem selected:(BOOL)selected {
    return nil;
}

- (CGPoint) onMapOverlay:(NMapPOIdataOverlay *)poiDataOverlay anchorPointWithType:(NMapPOIflagType)poiFlagType {
    return CGPointZero;
}

- (UIImage*) onMapOverlay:(NMapPOIdataOverlay *)poiDataOverlay imageForCalloutOverlayItem:(NMapPOIitem *)poiItem
           constraintSize:(CGSize)constraintSize selected:(BOOL)selected
imageForCalloutRightAccessory:(UIImage *)imageForCalloutRightAccessory
          calloutPosition:(CGPoint *)calloutPosition calloutHitRect:(CGRect *)calloutHitRect {
    return nil;
}

- (UIImage*) onMapOverlay:(NMapPOIdataOverlay *)poiDataOverlay imageForCalloutOverlayItem:(NMapPOIitem *)poiItem
            constraintSize:(CGSize)constraintSize selected:(BOOL)selected
imageForCalloutRightAccessory:(UIImage *)imageForCalloutRightAccessory
            calloutPosition:(CGPoint *)calloutPosition calloutHitRect:(CGRect*)calloutHitRect {
    return nil;
}

- (CGPoint) onMapOverlay:(NMapPOIdataOverlay *)poiDataOverlay calloutOffsetWithType:(NMapPOIflagType)poiFlagType {
    return CGPointZero;
}

@end

Data 클래스

NGeoPoint

• Description
  지도 상의 경위도 좌표를 나타내는 클래스입니다.

• Constructor

• Fields

NMapError

• Initializer
  에러 코드와 에러 메시지를 나타내는 클래스입니다.

• Constructor

• Properties

NMapPlacemark

• Description
  경위도 좌표를 주소로 변환하는 메서드의 콜백 인터페이스로 전달되는 클래스입니다. 주소는 번지를 포함하지 않습니다.

• Initializer

• Properties

NMapPlacemark

• Description
  경위도 좌표를 주소로 변환하는 메서드의 콜백 인터페이스로 전달되는 클래스입니다. 주소는 번지를 포함하지 않습니다.

• Initializer

• Properties

• Methods

NMapLocationManager

• Description
  단말기의 현재 위치 탐색과 나침반 기능을 사용하기 위한 클래스입니다. 내부적으로 시스템에서 제공하는 CLLocationManager 클래스를 사용합니다. 나침반 기능은 현재 위치 탐색 상태에서만 사용 가능합니다.

• Constants
  현재 위치 탐색 및 나침반 모니터링 실패에 대한 에러 종류는 아래와 같습니다.

• Properties

• Methods

• Protocol – NMapLocationManagerDelegate
  단말기의 현재 위치 또는 나침반 상태 변경 시 호출되는 프로토콜 정의합니다.

Map Main 클래스

NMapView

• Description
  지도 데이터를 화면에 표시하는 뷰 클래스이며 UIView 클래스를 상속받습니다. 본 클래스에서 관리하는 지도 데이터는 지도 이미지 이외에도 지도 위에 표시되는 오버레이 객체를 포함합니다.

• Initializer

• Constants
  지도 상태에 대한 상수 값은 아래와 같습니다.

지도 모드에 대한 상수 값은 아래와 같습니다.

• Properties

• Methods

• Protocol – NMapViewDelegate
  지도 상태 변경 및 터치 이벤트 발생 시 호출되는 콜백 프로토콜을 정의합니다.

NMapController

• Description
  NMapView 클래스의 카테고리 클래스이며 지도 뷰어를 컨트롤하는 역할을 수행합니다. 지도 중심 위치 및 지도 레벨 지정, 확대, 축소, 패닝 기능 등 다양한 기능을 수행합니다.

• Properties

• Methods

NMapProjection

• Description NMapView 클래스의 카테고리 클래스이며 화면 좌표를 지도 좌표로 변환하는 기능을 수행합니다. 오버레이 레이어를 직접 구현할 경우에 사용해야 합니다.

• Methods
  

NMapViewRotation

• Description
  NMapView 클래스의 카테고리 클래스이며 지도 회전 기능을 수행합니다.

• Properties

NMapReverseGeocoder

• Description
  NMapView 클래스의 카테고리 클래스이며 좌표를 주소로 변환하는 메서드를 수행합니다.

• Methods

• Protocol – NMapReverseGeocoderDelegate
  좌표를 주소를 변환하는 API에 대한 응답 프로토콜을 정의합니다.

Overlay 클래스

NMapOverlay

• Description
  지도 위에 오버레이 객체를 표시하기 위한 기반 클래스입니다. 이 클래스를 상속받은 클래스에서는 아래의 메서드를 직접 구현해야 합니다.

• Properties

• Methods

NMapPOIitem

• Description
  지도 위에 표시되는 오버레이 아이템 클래스이며 NMapPOIdataOverlay 클래스에서 표시하는 기본 객체로 사용됩니다. 지도에 표시되는 마커 이미지는 NMapPOIdataOverlayDelegate 프로토콜을 통해서 전달합니다.

• Initializer
  NMapPOIdataOverlay 클래스의 메서드를 사용하여 아이템 추가 시 내부적으로 생성됩니다.

• Constants
  현재 위치 오버레이 객체를 표시하기 위하여 미리 정의된 마커의 종류는 아래와 같습니다. 지도 라이브러리에서 현재 위치 표시 기능을 사용하는 경우에는 애플리케이션에서 해당 마커의 이미지를 제공해야 합니다.

오버레이 아이템의 속성은 아래와 같습니다.

• Properties

• Methods

NMapPOIdataOverlay

• Description
  여러 개의 오버레이 아이템을 포함할 수 있는 오버레이 클래스이며 NMapOverlay 클래스를 상속합니다. 그룹 오버레이 아이템을 효과적으로 처리할 수 있는 기능을 제공합니다.

• Initializer
  NMapOverlayManager 클래스의 createPOIdataOverlay 메서드 호출 시 내부적으로 생성됩니다.

• Properties

• Methods

• Protocol – NMapPOIdataOverlayDelegate
  오버레이 아이템 처리 시 호출되는 콜백 프로토콜을 정의합니다.

NMapPathData

• Description
  지도 위에 표시되는 경로 선을 관리하는 클래스입니다.

• Constants
  경로 선 스타일에 대한 상수 필드의 설명은 아래와 같습니다.

• Initializer

• Methods

NMapPathDataOverlay

• Description
  경로 데이터를 표시하기 위한 오버레이 클래스이며 NMapOverlay 클래스를 상속합니다. 단순한 경로 데이터 이외에도 폴리곤 및 원 데이터를 표시할 수 있습니다.

• Initializer
  NMapOverlayManager 클래스의 createPathDataOverlay 메서드 호출 시 내부적으로 생성됩니다.

• Methods

NMapOverlayManager

• Description
  지도 위에 표시되는 모든 오버레이 객체들을 관리합니다.

• Initializer
  NMapView 클래스에서 내부적으로 생성됩니다.

• Properties

• Methods