2.x → 3.x 마이그레이션 가이드

이 문서는 네이버 지도 iOS SDK 버전 2.x를 버전 3.x로 마이그레이션하는 방법을 설명합니다.

더 이상 제공되지 않는 기능

다음 기능은 3.x SDK에 포함되어 제공되지 않으므로 별도로 제공되는 대체 수단을 사용해 앱에서 구현해야 합니다.

좌표-주소 변환 기능

3.x SDK는 2.x SDK에서 NMapReverseGeocoder.findPlacemarkAtLocation:을 호출해 사용할 수 있었던 좌표-주소 변환(Reverse geocoding) 기능을 제공하지 않습니다. 대신 NAVER CLOUD PLATFORM에서 제공하는 Reverse Geocoding API를 사용할 수 있습니다. 자세한 내용은 Reverse Geocoding을 참고하세요.

"네이버 지도앱 실행" 버튼

3.x SDK는 2.x SDK에서 NMapView.setBuiltInAppControl:를 호출해 활성화할 수 있었던 "네이버 지도앱 실행" 버튼을 제공하지 않습니다. 대신 앱에서 직접 버튼을 배치하고 NAVER CLOUD PLATFORM에서 제공하는 지도앱 연동 URL Scheme 기능을 사용할 수 있습니다. 자세한 내용은 지도앱 연동 URL Scheme을 참고하세요.

마커 드래그

3.x SDK는 2.x SDK에서 NMapPOIitem.setPOIflagMode:를 호출해 사용할 수 있었던 마커 드래그 기능을 제공하지 않습니다. 마커를 드래그하는 대신 화면의 중심에 마커 역할을 하는 뷰를 고정하고 지도를 움직여 위치를 지정하는 것을 권장합니다. 자세한 내용은 데모 앱의 CameraEventViewController 예제를 참고하세요.

환경 설정

의존성 추가

3.x SDK의 라이브러리는 cocoapods를 통해 배포됩니다. 기존 2.x SDK NMapViewerSDK.framework와 ApiGatewayMac.framework를 프로젝트에서 삭제한 후 Podfile을 작성하고 pod install을 실행하여 framework를 추가합니다. 아래는 Podfile의 예제입니다.

platform :ios, '9.0'
use_frameworks!

target 'MyApp' do
  pod 'NMapsMap'
end

자세한 내용은 시작하기 문서의 의존성 추가 절을 참고하세요.

클라이언트 ID 지정

3.x SDK는 NMapView.setClientId:를 호출하는 대신 info.plist에 NMFClientId를 키값으로 지정하거나 NMFAuthManager.clientId 속성에 클라이언트 ID를 지정합니다.

다음은 클라이언트 ID를 지정하는 예제입니다.

2.x 3.x 
- (void)viewDidLoad {
    [super viewDidLoad];
    [self.mapView setClientId:@"YOUR_CLIENT_ID_HERE"];
}

2.x

- (void)viewDidLoad {
    [super viewDidLoad];
    [self.mapView setClientId:@"YOUR_CLIENT_ID_HERE"];
}

3.x

- (void)viewDidLoad {
    [super viewDidLoad];
    [NMFAuthManager shared].clientId = @"YOUR_CLIENT_ID_HERE";
}

자세한 내용은 시작하기 문서의 클라이언트 ID 지정 절을 참고하세요.

지도 객체

지도 표시

3.x SDK는 NMFNaverMapView 또는 NMFMapView가 NMapView를 대신해 지도에 대한 뷰 역할을 합니다.

다음은 지도를 서브뷰로 추가하여 화면에 나타내는 예제입니다.

2.x 3.x 
NMapView *mapView = [[NMapView alloc] initWithFrame:self.view.frame];
[mapView setReverseGeocoderDelegate:self];
[mapView setDelegate:self];
[self.view addSubview:mapView];

2.x

NMapView *mapView = [[NMapView alloc] initWithFrame:self.view.frame];
[mapView setReverseGeocoderDelegate:self];
[mapView setDelegate:self];
[self.view addSubview:mapView];

3.x

NMFMapView *mapView = [[NMFMapView alloc] initWithFrame:self.view.frame];
mapView.delegate = self;
[self.view addSubView:mapView];

자세한 내용은 지도 객체 문서를 참고하세요.

좌표

3.x SDK는 NMGLatLng가 NGeoPoint를 대신해 좌표를 나타냅니다. NMGLatLng와 NGeoPoint는 생성자 파라미터의 경위도 순서가 반대이므로 주의해야 합니다.

다음은 좌표 객체를 생성하고 콘솔에 위도와 경도를 출력하는 예제입니다.

2.x 3.x 
NGeoPoint coord = NGeoPointMake(126.9783740, 37.5670135); // 경도, 위도순

NSLog(@"위도: %f, 경도: %f", coord.latitude ,coord.longitude);

2.x

NGeoPoint coord = NGeoPointMake(126.9783740, 37.5670135); // 경도, 위도순

NSLog(@"위도: %f, 경도: %f", coord.latitude ,coord.longitude);

3.x

NMGLatLng *coord = NMGLatLngMake(37.5670135, 126.9783740); // 위도, 경도순

NSLog(@"위도: %f, 경도: %f", coord.lat ,coord.lng);

자세한 내용은 좌표 객체 문서의 LatLng 절을 참고하세요.

지도 유형 지정

지도의 유형을 지정하려면 NMapController.setMapViewMode: 대신 NMFMapView.mapType 속성을 지정합니다.

다음은 지도의 유형을 하이브리드로 지정하는 예제입니다.

2.x 3.x 
[self.mapView setMapViewMode:NMapViewModeHybrid];

2.x

[self.mapView setMapViewMode:NMapViewModeHybrid];

3.x

self.mapView.mapType = NMFMapTypeHybrid;

자세한 내용은 지도 옵션 문서의 지도 유형 절을 참고하세요.

레이어 그룹 지정

특정 레이어 그룹을 활성화하려면 NMapController.setMapViewTrafficMode:, NMapController.setMapViewBicycleMode:와 같은 개별 메서드 대신 NMFMapView.setLayerGroup:isEnabled:를 호출합니다.

다음은 실시간 교통정보, 자전거 레이어 그룹을 활성화하는 예제입니다.

2.x 3.x 
[self.mapView setMapViewTrafficMode:YES];
[self.mapView setMapViewBicycleMode:YES];

2.x

[self.mapView setMapViewTrafficMode:YES];
[self.mapView setMapViewBicycleMode:YES];

3.x

[self.mapView setLayerGroup:NMF_LAYER_GROUP_TRAFFIC isEnabled:YES];
[self.mapView setLayerGroup:NMF_LAYER_GROUP_BICYCLE isEnabled:YES];

자세한 내용은 지도 옵션 문서의 레이어 그룹 절을 참고하세요.

카메라와 투영

카메라의 위치

3.x SDK는 2.x SDK와 다른 줌 레벨 체계를 사용합니다. 동일한 축척일 때 3.x SDK의 줌 레벨이 2.x SDK보다 4 정도 큽니다. 또한 줌 레벨의 타입이 int에서 double로 변경되었습니다.

3.x SDK는 좌표, 줌 레벨 등 카메라와 관련된 값을 낱개로 사용하는 2.x SDK와 달리 이러한 값을 묶은 NMFCameraPosition 클래스를 사용합니다.

자세한 내용은 카메라와 투영 문서의 카메라의 위치 절을 참고하세요.

카메라의 현재 위치

카메라의 현재 위치를 얻어오려면 NMapController.mapCenter 및 NMapController.zoomLevel 속성 대신 NMFMapView.cameraPosition을 호출합니다.

다음은 카메라의 현재 위치를 얻고 콘솔에 각 속성을 출력하는 예제입니다.

2.x 3.x 
NGeoPoint center = self.mapView.mapCenter;
int zoom = self.mapView.zoomLevel;

NSLog(@"중심 위도: %f, 중심 경도: %f, 줌 레벨: %d", center.latitude, center.longitude, zoom);

2.x

NGeoPoint center = self.mapView.mapCenter;
int zoom = self.mapView.zoomLevel;

NSLog(@"중심 위도: %f, 중심 경도: %f, 줌 레벨: %d", center.latitude, center.longitude, zoom);

3.x

NMFCameraPosition *cameraPosition = self.mapView.cameraPosition;

NSLog(@"대상 지점 위도: %f, 대상 지점 경도: %f, 줌 레벨: %f, 기울임 각도: %f, 헤딩 각도: %f",
        cameraPosition.target.lat, cameraPosition.target.lng,
        cameraPosition.zoom, cameraPosition.tilt, cameraPosition.heading);

자세한 내용은 카메라와 투영 문서의 카메라의 현재 위치 절을 참고하세요.

카메라 이동

카메라를 이동하려면 NMapController.setMapCenter:를 호출하는 대신 NMFCameraUpdate 객체를 생성해 NMFMapView.moveCamera:를 호출합니다.

다음은 카메라의 대상 좌표를 (37.5666102, 126.9783881) 지점으로, 줌 레벨을 15(2.x SDK 기준 11)로 변경하는 예제입니다.

2.x 3.x 
[self.mapView setMapCenter:NGeoPointMake(126.9783881, 37.5666102) atLevel: 11];

2.x

[self.mapView setMapCenter:NGeoPointMake(126.9783881, 37.5666102) atLevel: 11];

3.x

NMFCameraUpdate *cameraUpdate = [NMFCameraUpdate cameraUpdateWithScrollTo:
                                                    NMGLatLngMake((37.5666102, 126.9783881)
                                                 zoomTo:15];
[self.mapView moveCamera:cameraUpdate];

자세한 내용은 카메라 이동 문서의 API 호출로 카메라 이동하기 절을 참고하세요.

카메라 변경 이벤트

카메라 변경 이벤트를 받으려면 NMapView.delegate 속성과 동일하게 NMFMapView.delegate 속성을 지정하고 해당 콜백 메서드를 구현합니다.

다음은 카메라 변경 이벤트를 받아 변경된 위치를 로깅하는 예제입니다.

2.x 3.x 
- (void)viewDidLoad {
    [super viewDidLoad];

    self.mapView.delegate = self; // 현재 뷰 컨트롤러가 콜백 이벤트를 받도록 지정
}

- (void) onMapView:(NMapView *)mapView didChangeMapLevel:(int)level {
    NSLog(@"줌 레벨 변경: %d", level);
}

- (void) onMapView:(NMapView *)mapView didChangeMapCenter:(NGeoPoint)location {
    NSLog(@"중심 변경 - 위도: %f, 경도: %f", location.longitude, location.latitude);
}

2.x

- (void)viewDidLoad {
    [super viewDidLoad];

    self.mapView.delegate = self; // 현재 뷰 컨트롤러가 콜백 이벤트를 받도록 지정
}

- (void) onMapView:(NMapView *)mapView didChangeMapLevel:(int)level {
    NSLog(@"줌 레벨 변경: %d", level);
}

- (void) onMapView:(NMapView *)mapView didChangeMapCenter:(NGeoPoint)location {
    NSLog(@"중심 변경 - 위도: %f, 경도: %f", location.longitude, location.latitude);
}

3.x

- (void)viewDidLoad {
    [super viewDidLoad];

    self.mapView.delegate = self; // 현재 뷰 컨트롤러가 콜백 이벤트를 받도록 지정
}

- (void)mapView:(nonnull NMFMapView *)mapView regionDidChangeAnimated:(BOOL)animated byReason:(NSInteger)reason {
    NMFCameraPosition *cameraPosition = mapView.cameraPosition;

    NSLog(@"카메라 변경 - 대상 지점 위도: %f, 대상 지점 경도: %f, 줌 레벨: %f, 기울임 각도: %f, 헤딩 각도: %f",
            cameraPosition.target.lat, cameraPosition.target.lng,
            cameraPosition.zoom, cameraPosition.tilt, cameraPosition.heading);
}

자세한 내용은 카메라 이동 문서의 카메라 변경 이벤트 절을 참고하세요.

투영

화면 좌표와 지도 좌표를 상호 변환하려면 NMapProjection 대신 NMFProjection 클래스를 사용합니다. NMFMapView.projection 속성으로 받아올 수 있습니다.

화면 좌표를 지도 좌표로 변환하려면 NMapProjection.fromPoint: 대신 NMFProjection.latlngFromPoint:를, 지도 좌표를 화면 좌표로 변환하려면 NMapProjection.toPointFromLocation: 대신 NMFProjection.pointFromLatLng:를 호출합니다.

다음은 화면의 (100, 100) 지점을 지도 좌표로 변환하는 예제입니다.

2.x 3.x 
NGeoPoint coord = [self.mapView fromPoint:CGPointMake(100, 100)];

2.x

NGeoPoint coord = [self.mapView fromPoint:CGPointMake(100, 100)];

3.x

NMGLatLng *coord = [self.mapView.projection latlngFromPoint:CGPointMake(100, 100)];

다음은 지도의 (37.5666102, 126.9783881) 지점을 화면 좌표로 변환하는 예제입니다.

2.x 3.x 
CGPoint point = [self.mapView toPointFromLocation:NGeoPointMake(126.9783881, 37.5666102)];

2.x

CGPoint point = [self.mapView toPointFromLocation:NGeoPointMake(126.9783881, 37.5666102)];

3.x

CGPoint point = [self.mapView.projection pointFromLatLng:NMGLatLngMake(37.5666102, 126.9783881)];

자세한 내용은 카메라와 투영 문서의 화면 좌표와 지도 좌표 간 변환 절을 참고하세요.

상호작용

컨트롤

3.x SDK에는 줌 컨트롤을 비롯한 여러 가지 컨트롤이 내장되어 있습니다. 줌 컨트롤은 기본적으로 활성화되며, 비활성화하려면 NMFNaverMapView.showZoomControls를 호출합니다.

2.x 3.x 
// 지원하지 않음

2.x

// 지원하지 않음

3.x

self.naverMapView.showZoomControls = YES;

자세한 내용은 사용자 인터페이스 문서의 컨트롤 절을 참고하세요.

UI 이벤트

지도의 탭 이벤트를 받으려면 -onMapView:handleSingleTapGesture: 대신 -mapView:didTapMap:point 메서드를 이용해 콜백 이벤트를 받습니다.

다음은 지도의 탭 이벤트를 받아 탭된 좌표를 출력하는 예제입니다.

2.x 3.x 
- (void) onMapView:(NMapView *)mapView handleSingleTapGesture:(UIGestureRecognizer*)recogniser {
    NGeoPoint coord = [mapView fromPoint:[recogniser locationInView:mapView]];
    NSLog(@"탭 : %f, %f", coord.latitude, coord.longitude);
}

2.x

- (void) onMapView:(NMapView *)mapView handleSingleTapGesture:(UIGestureRecognizer*)recogniser {
    NGeoPoint coord = [mapView fromPoint:[recogniser locationInView:mapView]];
    NSLog(@"탭 : %f, %f", coord.latitude, coord.longitude);
}

3.x

- (void)mapView:(NMFMapView *)mapView didTapMap:(NMGLatLng *)latlng point:(CGPoint)point {
    NSLog(@"탭 : %f, %f", latlng.lat, latlng.lng);
}

자세한 내용은 사용자 인터페이스 문서의 UI 이벤트 절을 참고하세요.

위치

2.x SDK는 위치 추적 기능을 사용하려면 NMapLocationManager, NMapMyLocationOverlay를 생성하고 기능을 활성화하는 메서드를 각각 호출해야 했습니다.

3.x SDK에는 위치 추적 기능이 내장되어 있으므로 NMFNaverMapView.positionMode 속성을 변경하면 위치 추적 기능이 활성화됩니다.

다음은 위치 추적 기능을 활성화하는 예제입니다.

2.x 3.x 
- (void)findMyLocation {
    NMapLocationManager *lm = [NMapLocationManager getSharedInstance];

    [lm setDelegate:self];    
    [self.mapView setAutoRotateEnabled:YES];
    [lm startUpdatingHeading];
    [lm startContinuousLocationInfo];
}

- (void)locationManager:(NMapLocationManager *)locationManager didUpdateToLocation:(CLLocation *)location {

    CLLocationCoordinate2D coordinate = [location coordinate];

    NGeoPoint myLocation;
    myLocation.longitude = coordinate.longitude;
    myLocation.latitude = coordinate.latitude;
    float locationAccuracy = [location horizontalAccuracy];

    [[self.mapView mapOverlayManager] setMyLocation:myLocation locationAccuracy:locationAccuracy];

    [self.mapView setMapCenter:myLocation];
}

- (void)locationManager:(NMapLocationManager *)locationManager didUpdateHeading:(CLHeading *)heading {
    double headingValue = [heading trueHeading] < 0.0 ? [heading magneticHeading] : [heading trueHeading];
    [self.mapView setRotateAngle:(CGFloat)headingValue];    
}

2.x

- (void)findMyLocation {
    NMapLocationManager *lm = [NMapLocationManager getSharedInstance];

    [lm setDelegate:self];    
    [self.mapView setAutoRotateEnabled:YES];
    [lm startUpdatingHeading];
    [lm startContinuousLocationInfo];
}

- (void)locationManager:(NMapLocationManager *)locationManager didUpdateToLocation:(CLLocation *)location {

    CLLocationCoordinate2D coordinate = [location coordinate];

    NGeoPoint myLocation;
    myLocation.longitude = coordinate.longitude;
    myLocation.latitude = coordinate.latitude;
    float locationAccuracy = [location horizontalAccuracy];

    [[self.mapView mapOverlayManager] setMyLocation:myLocation locationAccuracy:locationAccuracy];

    [self.mapView setMapCenter:myLocation];
}

- (void)locationManager:(NMapLocationManager *)locationManager didUpdateHeading:(CLHeading *)heading {
    double headingValue = [heading trueHeading] < 0.0 ? [heading magneticHeading] : [heading trueHeading];
    [self.mapView setRotateAngle:(CGFloat)headingValue];    
}

3.x

self.naverMapView.positionMode = NMFMyPositionCompass;

자세한 내용은 위치 문서를 참고하세요.

오버레이

사용 준비

2.x SDK에서 오버레이 기능을 사용하려면 먼저 NMapPOIdataOverlayDelegate 관련 메서드를 구현하고, 각 오버레이에 NMapXXXdata를 생성한 후 NMapOverlayManager.newXXXOverlay: 메서드를 호출해야 했습니다.

3.x SDK에서는 오버레이 객체 각각이 기능을 독립적으로 완결성 있게 수행하므로 이러한 준비 과정이 필요하지 않습니다. 필요한 오버레이 객체를 생성하고 속성을 객체에 직접 지정한 후 mapView 속성에 표시할 지도를 지정하면 오버레이가 나타납니다.

다음은 오버레이 기능을 사용하기 위해 관련 객체를 준비하는 예제입니다.

2.x 3.x 
NMapOverlayManager *mapOverlayManager = [self.mapView mapOverlayManager];

2.x

NMapOverlayManager *mapOverlayManager = [self.mapView mapOverlayManager];

3.x

// 준비 과정 불필요

탭 이벤트

2.x SDK에서는 오버레이의 탭 이벤트를 받으려면 NMapPOIdataOverlayDelegate에서 정의된 메서드를 구현하고, -onMapOverlay:didChangeSelectedPOIitemAtIndex:withObject: 등의 메서드에서 이벤트를 구현해야 했습니다.

3.x SDK에서는 NMFOverlay.touchHandler 속성에 블록 메서드로 NMFOverlayTouchHandler를 지정합니다.

2.x 3.x 
NMapPOIdataOverlay overlay = ...

- (BOOL) onMapOverlay:(NMapPOIdataOverlay *)poiDataOverlay didChangeSelectedPOIitemAtIndex:(int)index withObject:(id)object {
    NSLog(@"오버레이 탭: %d", index);

    return YES;
}

- (BOOL) onMapOverlay:(NMapPOIdataOverlay *)poiDataOverlay didSelectCalloutOfPOIitemAtIndex:(int)index withObject:(id)object {
    NSLog(@"정보 창 탭: %d", index);

    return YES;
}

2.x

NMapPOIdataOverlay overlay = ...

- (BOOL) onMapOverlay:(NMapPOIdataOverlay *)poiDataOverlay didChangeSelectedPOIitemAtIndex:(int)index withObject:(id)object {
    NSLog(@"오버레이 탭: %d", index);

    return YES;
}

- (BOOL) onMapOverlay:(NMapPOIdataOverlay *)poiDataOverlay didSelectCalloutOfPOIitemAtIndex:(int)index withObject:(id)object {
    NSLog(@"정보 창 탭: %d", index);

    return YES;
}

3.x

NMFOverlay *overlay = ...
overlay.touchHandler = ^BOOL(NMFOverlay *overlay) {
    NSLog(@"오버레이 탭");
    return YES;
};

자세한 내용은 오버레이 공통 문서의 이벤트 절을 참고하세요.

마커

2.x SDK에서는 마커를 지도에 추가하려면 NMapPOIdata를 생성하고 NMapOverlayManager.newPOIdataOverlay를 호출해야 했습니다.

3.x SDK에서는 NMFMarker 객체를 생성하고 필요한 속성을 객체에 직접 지정한 후 mapView 속성에 표시할 지도를 지정합니다.

마커 드래그 기능은 더 이상 제공되지 않습니다.

다음은 마커를 지도에 추가하는 예제입니다.

2.x 3.x 
NMapOverlayManager *mapOverlayManager = [_mapView mapOverlayManager];
NMapPOIdataOverlay *poiDataOverlay = [mapOverlayManager newPOIdataOverlay];
[poiDataOverlay initPOIdata:1];
[poiDataOverlay addPOIitemAtLocation:NGeoPointMake(126.9783740, 37.5670135) title:nil type:NMapPOIflagTypePin iconIndex:0 withObject:nil];
[poiDataOverlay endPOIdata];
[poiDataOverlay showAllPOIdata];

2.x

NMapOverlayManager *mapOverlayManager = [_mapView mapOverlayManager];
NMapPOIdataOverlay *poiDataOverlay = [mapOverlayManager newPOIdataOverlay];
[poiDataOverlay initPOIdata:1];
[poiDataOverlay addPOIitemAtLocation:NGeoPointMake(126.9783740, 37.5670135) title:nil type:NMapPOIflagTypePin iconIndex:0 withObject:nil];
[poiDataOverlay endPOIdata];
[poiDataOverlay showAllPOIdata];

3.x

NMFMarker *marker = [NMFMarker markerWithPosition:NMGLatLngMake(37.5670135, 126.9783740)];
marker.mapView = self.mapView;

자세한 내용은 마커 문서를 참고하세요.

정보 창

2.x SDK에서는 마커의 제목을 지정한 경우 마커를 탭하면 자동으로 마커의 위에 정보 창이 나타났습니다. 정보 창을 별도로 생성하거나 동시에 한 개 이상 노출할 수 없었습니다.

3.x SDK에서는 정보 창도 마커처럼 독립적인 객체이므로 자유롭게 생성하고 추가할 수 있습니다. 정보 창을 지도에 추가하려면 NMFInfoWindow 객체를 생성하고 필요한 속성을 객체에 직접 지정한 후 -openWithMapView:를 호출합니다.

다음은 마커를 탭하면 정보 창을 지도에 추가하는 예제입니다.

2.x 3.x 
NMapOverlayManager *mapOverlayManager = [self.mapView mapOverlayManager];
NMapPOIdataOverlay *poiDataOverlay = [mapOverlayManager newPOIdataOverlay];
[poiDataOverlay initPOIdata:1];
[poiDataOverlay addPOIitemAtLocation:NGeoPointMake(126.9783740, 37.5670135) title:@"정보 창 내용" type:NMapPOIflagTypePin iconIndex:0 withObject:nil];
[poiDataOverlay endPOIdata];
[poiDataOverlay showAllPOIdata];

- (UIView*) onMapOverlay:(NMapPOIdataOverlay *)poiDataOverlay viewForCalloutOverlayItem:(NMapPOIitem *)poiItem calloutPosition:(CGPoint *)calloutPosition {
    self.callOutLabel.text = poiItem.title;
    return self.callOutView;
}

- (BOOL) onMapOverlay:(NMapPOIdataOverlay *)poiDataOverlay didSelectCalloutOfPOIitemAtIndex:(int)index withObject:(id)object {
    NSLog(@"정보 창 탭: %d", index);
    return YES;
}

2.x

NMapOverlayManager *mapOverlayManager = [self.mapView mapOverlayManager];
NMapPOIdataOverlay *poiDataOverlay = [mapOverlayManager newPOIdataOverlay];
[poiDataOverlay initPOIdata:1];
[poiDataOverlay addPOIitemAtLocation:NGeoPointMake(126.9783740, 37.5670135) title:@"정보 창 내용" type:NMapPOIflagTypePin iconIndex:0 withObject:nil];
[poiDataOverlay endPOIdata];
[poiDataOverlay showAllPOIdata];

- (UIView*) onMapOverlay:(NMapPOIdataOverlay *)poiDataOverlay viewForCalloutOverlayItem:(NMapPOIitem *)poiItem calloutPosition:(CGPoint *)calloutPosition {
    self.callOutLabel.text = poiItem.title;
    return self.callOutView;
}

- (BOOL) onMapOverlay:(NMapPOIdataOverlay *)poiDataOverlay didSelectCalloutOfPOIitemAtIndex:(int)index withObject:(id)object {
    NSLog(@"정보 창 탭: %d", index);
    return YES;
}

3.x

NMFInfoWindow *infoWindow = [NMFInfoWindow infoWindow];
infoWindow.dataSource = [NaverDefaultInfoWindowImage defaultInfoWindowImage];
infoWindow.touchHandler = ^BOOL(NMFOverlay *overlay) {
    NSLog(@"정보 창 탭");
    return YES;
};

NMFMarker *marker = [NMFMarker markerWithPosition:NMGLatLngMake(37.5670135, 126.9783740)];
marker.userInfo = @{INFOWINDOW_TITLE_KEY:@"정보 창 내용"};
marker.touchHandler = ^BOOL(NMFOverlay *overlay) {
    [infoWindow openWithMarker:(NMFMarker *)overlay];
    return YES;
};
marker.mapView = self.mapView;

자세한 내용은 정보 창 문서를 참고하세요.

셰이프

2.x SDK에서는 셰이프를 지도에 추가하려면 NMapPathData에 셰이프의 좌표를, NMapPathLineStyle 또는 NMapCircleStyle 객체를 이용해 셰이프의 스타일을 지정하고 NMapOverlayManager.newPathDataOverlay:를 호출해야 했습니다.

3.x SDK에서는 NMFPolylineOverlay, NMFPolygonOverlay, NMFCircleOverlay 등 유형별 셰이프 객체를 생성하고 필요한 속성을 객체에 직접 지정한 후 mapView 속성에 표시할 지도를 지정합니다.

다음은 폴리라인을 지도에 추가하는 예제입니다.

2.x 3.x 
NMapPathData *pathData = [[NMapPathData alloc] initWithCapacity:4];
[pathData initPathData];
[pathData addPathPointLongitude:126.97714 latitude:37.57152 lineType:NMapPathLineTypeSolid];
[pathData addPathPointLongitude:126.98268 latitude:37.56607 lineType:0];
[pathData addPathPointLongitude:126.97707 latitude:37.56445 lineType:0];
[pathData addPathPointLongitude:126.97822 latitude:37.55855 lineType:0];
[pathData endPathData];

NMapPathLineStyle *style = [[NMapPathLineStyle alloc] init];
[style setPathDataType:NMapPathDataTypePolyline];
[style setLineColor:[UIColor greenColor]];
[pathData setPathLineStyle:style];

NMapPathDataOverlay *pathDataOverlay = [mapOverlayManager newPathDataOverlay:pathData];
[pathDataOverlay showAllPathData];

2.x

NMapPathData *pathData = [[NMapPathData alloc] initWithCapacity:4];
[pathData initPathData];
[pathData addPathPointLongitude:126.97714 latitude:37.57152 lineType:NMapPathLineTypeSolid];
[pathData addPathPointLongitude:126.98268 latitude:37.56607 lineType:0];
[pathData addPathPointLongitude:126.97707 latitude:37.56445 lineType:0];
[pathData addPathPointLongitude:126.97822 latitude:37.55855 lineType:0];
[pathData endPathData];

NMapPathLineStyle *style = [[NMapPathLineStyle alloc] init];
[style setPathDataType:NMapPathDataTypePolyline];
[style setLineColor:[UIColor greenColor]];
[pathData setPathLineStyle:style];

NMapPathDataOverlay *pathDataOverlay = [mapOverlayManager newPathDataOverlay:pathData];
[pathDataOverlay showAllPathData];

3.x

NMFPolylineOverlay *polyline = [NMFPolylineOverlay polylineOverlayWithPoints:
                                @[
                                    NMGLatLngMake(37.57152, 126.97714),
                                    NMGLatLngMake(37.56607, 126.98268),
                                    NMGLatLngMake(37.56445, 126.97707),
                                    NMGLatLngMake(37.55855, 126.97822)
                                ]];
polyline.color = UIColor.greenColor;
polyline.mapView = self.mapView;

다음은 폴리곤을 지도에 추가하는 예제입니다.

2.x 3.x 
NMapOverlayManager *mapOverlayManager = [self.mapView mapOverlayManager];
NMapPathData *pathData = [[NMapPathData alloc] initWithCapacity:5];
[pathData initPathData];
[pathData addPathPointLongitude:126.9712268 latitude:37.5640984 lineType:NMapPathLineTypeSolid];
[pathData addPathPointLongitude:126.9767904 latitude:37.5651279 lineType:0];
[pathData addPathPointLongitude:126.9832241 latitude:37.5625365 lineType:0];
[pathData addPathPointLongitude:126.9809297 latitude:37.5585305 lineType:0];
[pathData addPathPointLongitude:126.974617 latitude:37.5590777 lineType:0];
[pathData endPathData];

NMapPathLineStyle *style = [[NMapPathLineStyle alloc] init];
[style setPathDataType:NMapPathDataTypePolygon];
[style setLineColor:[UIColor greenColor]];
[style setFillColor:[UIColor whiteColor]];
[pathData setPathLineStyle:style];

NMapPathDataOverlay *pathDataOverlay = [mapOverlayManager newPathDataOverlay:pathData];
[pathDataOverlay showAllPathData];

2.x

NMapOverlayManager *mapOverlayManager = [self.mapView mapOverlayManager];
NMapPathData *pathData = [[NMapPathData alloc] initWithCapacity:5];
[pathData initPathData];
[pathData addPathPointLongitude:126.9712268 latitude:37.5640984 lineType:NMapPathLineTypeSolid];
[pathData addPathPointLongitude:126.9767904 latitude:37.5651279 lineType:0];
[pathData addPathPointLongitude:126.9832241 latitude:37.5625365 lineType:0];
[pathData addPathPointLongitude:126.9809297 latitude:37.5585305 lineType:0];
[pathData addPathPointLongitude:126.974617 latitude:37.5590777 lineType:0];
[pathData endPathData];

NMapPathLineStyle *style = [[NMapPathLineStyle alloc] init];
[style setPathDataType:NMapPathDataTypePolygon];
[style setLineColor:[UIColor greenColor]];
[style setFillColor:[UIColor whiteColor]];
[pathData setPathLineStyle:style];

NMapPathDataOverlay *pathDataOverlay = [mapOverlayManager newPathDataOverlay:pathData];
[pathDataOverlay showAllPathData];

3.x

NMGPolygon *polygon = [NMGPolygon polygonWithRing:
                        [NMGLineString lineStringWithPoints:@[
                            NMGLatLngMake(37.5640984, 126.9712268),
                            NMGLatLngMake(37.5651279, 126.9767904),
                            NMGLatLngMake(37.5625365, 126.9832241),
                            NMGLatLngMake(37.5585305, 126.9809297),
                            NMGLatLngMake(37.5590777, 126.974617)
                        ]]];
NMFPolygonOverlay *polygonOverlay = [NMFPolygonOverlay polygonOverlay:polygon];
polygonOverlay.fillColor = UIColor.whiteColor;
polygonOverlay.outlineColor = UIColor.greenColor;
polygonOverlay.mapView = self.mapView;

다음은 서클을 지도에 추가하는 예제입니다.

2.x 3.x 
NMapOverlayManager *mapOverlayManager = [self.mapView mapOverlayManager];
NMapPathDataOverlay *pathDataOverlay = [mapOverlayManager newPathDataOverlay:[[NMapPathData alloc] init]];

NMapCircleData *circleData = [[NMapCircleData alloc] initWithCapacity:1];
[circleData initCircleData];
[circleData addCirclePointLongitude:126.9783881 latitude:37.5666102 radius:50.0F];

NMapCircleStyle *circleStyle = [[NMapCircleStyle alloc] init];
[circleStyle setFillColor:[UIColor whiteColor]];
[circleStyle setStrokeColor:[UIColor greenColor]];

[circleData setCircleStyle:circleStyle];
[circleData endCircleData];

[pathDataOverlay addCircleData:circleData];
[pathDataOverlay showAllPathData];

2.x

NMapOverlayManager *mapOverlayManager = [self.mapView mapOverlayManager];
NMapPathDataOverlay *pathDataOverlay = [mapOverlayManager newPathDataOverlay:[[NMapPathData alloc] init]];

NMapCircleData *circleData = [[NMapCircleData alloc] initWithCapacity:1];
[circleData initCircleData];
[circleData addCirclePointLongitude:126.9783881 latitude:37.5666102 radius:50.0F];

NMapCircleStyle *circleStyle = [[NMapCircleStyle alloc] init];
[circleStyle setFillColor:[UIColor whiteColor]];
[circleStyle setStrokeColor:[UIColor greenColor]];

[circleData setCircleStyle:circleStyle];
[circleData endCircleData];

[pathDataOverlay addCircleData:circleData];
[pathDataOverlay showAllPathData];

3.x

NMFCircleOverlay* circleOverlay = [NMFCircleOverlay circleOverlay:NMGLatLngMake(37.5666102, 126.9783881) radius:50];
circleOverlay.fillColor = UIColor.whiteColor;
circleOverlay.outlineColor = UIColor.greenColor;
circleOverlay.mapView = self.mapView;

자세한 내용은 셰이프 문서를 참고하세요.

위치 오버레이

2.x SDK는 위치 오버레이가 분리되지 않아 NMapOverlayManager를 통해서만 위치 오버레이에 접근할 수 있었습니다.

3.x SDK는 위치 오버레이가 독립적으로 동작하므로 NMFMapView.locationOverlay 속성을 호출해 인스턴스에 접근한 후 필요한 속성을 직접 지정할 수 있습니다.

2.x 3.x 
[[self.mapView mapOverlayManager] setMyLocation:myLocation locationAccuracy:locationAccuracy];

2.x

[[self.mapView mapOverlayManager] setMyLocation:myLocation locationAccuracy:locationAccuracy];

3.x

NMFLocationOverlay *locationOverlay = self.mapView.locationOverlay;
locationOverlay.hidden = NO;

자세한 내용은 위치 오버레이 문서를 참고하세요.

results matching ""

    No results matching ""