InaviMapView


@interface InaviMapView : UIView

아이나비 지도를 정의하는 뷰 클래스.
해당 클래스를 서브 뷰로 추가하여 지도를 표출할 수 있습니다.

Creating Instances

  • 지정된 프레임 크기로 지도 뷰의 인스턴스를 생성합니다.

    Declaration

    Objective-C

    - (nonnull instancetype)initWithFrame:(CGRect)frame;

    Swift

    init(frame: CGRect)

    Parameters

    frame

    사용자 지정 프레임 크기.

    Return Value

    InaviMapView 인스턴스.

  • 지정된 프레임 크기와 지도의 기본 옵션을 지정하여 지도 뷰의 인스턴스를 생성합니다.

    Declaration

    Objective-C

    - (nonnull instancetype)initWithFrame:(CGRect)frame
                              options:(nonnull INVMapOptions *)options;

    Swift

    init(frame: CGRect, options: INVMapOptions)

    Parameters

    frame

    사용자 지정 프레임 크기.
    options

    지도의 기본 옵션.

    Return Value

    InaviMapView 인스턴스.

Accessing the Delegate

  • InaviMapView의 Delegate.

    지도 뷰의 Delegate를 이용해 지도의 표출이나, 화면 갱신 여부 등의 메시지를 전달합니다.

    Declaration

    Objective-C

    @property (readwrite, nonatomic, nullable) id<INVMapViewDelegate> delegate;

Configuring the Map’s Appearance

  • 지도의 최소 줌 레벨.

    기본값은 1입니다.

    Declaration

    Objective-C

    @property (assign, readwrite, nonatomic) double minimumZoomLevel;

    Swift

    var minimumZoomLevel: Double { get set }

  • 지도의 최대 줌 레벨.

    기본값은 20입니다.

    Declaration

    Objective-C

    @property (assign, readwrite, nonatomic) double maximumZoomLevel;

    Swift

    var maximumZoomLevel: Double { get set }

  • 지도 이동을 제한하는 INVLatLngBounds 영역.

    nil 설정 시 제한이 해제됩니다.

    Declaration

    Objective-C

    @property (assign, readwrite, nonatomic, nullable)
    INVLatLngBounds *constraintBounds;

    Swift

    var constraintBounds: INVLatLngBounds? { get set }

  • 지도 영역 중심에 대한 카메라 위치.

    Declaration

    Objective-C

    @property (assign, readwrite, nonatomic)
    INVCameraPosition *_Nonnull cameraPosition;

    Swift

    var cameraPosition: INVCameraPosition { get set }

  • 이 지도에 대한 INVProjection 객체.

    Declaration

    Objective-C

    @property (readonly, nonatomic) INVProjection *_Nonnull projection;

    Swift

    var projection: INVProjection { get }

  • 지도의 패딩. 패딩에 해당하는 부분은 지도의 콘텐츠 영역에서 제외됩니다.

    Declaration

    Objective-C

    @property (assign, readwrite, nonatomic) UIEdgeInsets contentInset;

    Swift

    var contentInset: UIEdgeInsets { get set }

  • 지도 영역에 대한 INVLatLngBounds.

    Declaration

    Objective-C

    @property (readonly, copy, nonatomic) INVLatLngBounds *_Nonnull contentBounds;

    Swift

    @NSCopying var contentBounds: INVLatLngBounds { get }

  • 축척 바 표출 여부.

    기본값은 YES입니다.

    Declaration

    Objective-C

    @property (assign, readwrite, nonatomic) BOOL showScaleBar;

    Swift

    var showScaleBar: Bool { get set }

  • 나침반 표출 여부.

    기본값은 YES입니다.

    Declaration

    Objective-C

    @property (assign, readwrite, nonatomic) BOOL showCompass;

    Swift

    var showCompass: Bool { get set }

  • 줌 컨트롤 표출 여부.

    기본값은 NO입니다.

    Declaration

    Objective-C

    @property (assign, readwrite, nonatomic) BOOL showZoomControl;

    Swift

    var showZoomControl: Bool { get set }

  • 현위치 버튼 표출 여부.

    기본값은 NO입니다.

    Declaration

    Objective-C

    @property (assign, readwrite, nonatomic) BOOL showLocationButton;

    Swift

    var showLocationButton: Bool { get set }

Displaying the User’s Location

Configuring How the User Interacts with the Map

  • 지도 줌 제스처 사용 여부를 나타내는 속성.

    기본값은 YES입니다.

    Declaration

    Objective-C

    @property (getter=isZoomGesturesEnabled, assign, readwrite, nonatomic)
    BOOL zoomGesturesEnabled;

    Swift

    var isZoomGesturesEnabled: Bool { get set }

  • 지도 스크롤 제스처 사용 여부를 나타내는 속성.

    기본값은 YES입니다.

    Declaration

    Objective-C

    @property (getter=isScrollGesturesEnabled, assign, readwrite, nonatomic)
    BOOL scrollGesturesEnabled;

    Swift

    var isScrollGesturesEnabled: Bool { get set }

  • 지도 회전 제스처 사용 여부를 나타내는 속성.

    기본값은 YES입니다.

    Declaration

    Objective-C

    @property (getter=isRotateGesturesEnabled, assign, readwrite, nonatomic)
    BOOL rotateGesturesEnabled;

    Swift

    var isRotateGesturesEnabled: Bool { get set }

  • 지도 기울기 제스처 사용 여부를 나타내는 속성.

    기본값은 YES입니다.

    Declaration

    Objective-C

    @property (getter=isTiltGesturesEnabled, assign, readwrite, nonatomic)
    BOOL tiltGesturesEnabled;

    Swift

    var isTiltGesturesEnabled: Bool { get set }

  • 로고 클릭 시 SDK 정보 팝업 표출 여부를 나타내는 속성.

    비활성화 시 별도의 페이지에 아이나비 지도 SDK의 오픈 소스 라이선스와 법적 공지를 제공해야 합니다.
    기본값은 YES입니다.

    See

    +[INVMapSdk presentLicenseViewController]
    +[INVMapSdk presentLegalNoticeViewController]

    Declaration

    Objective-C

    @property (getter=isLogoClickEnabled, assign, readwrite, nonatomic)
    BOOL logoClickEnabled;

    Swift

    var isLogoClickEnabled: Bool { get set }

  • 지도 애니메이션 마찰 계수 입니다. 값의 범위는 0~1이며, 계수가 클수록 마찰이 강해집니다.

    기본값은 UIScrollViewDecelerationRate의 UIScrollViewDecelerationRateNormal입니다.

    Declaration

    Objective-C

    @property (assign, readwrite, nonatomic) CGFloat decelerationRate;

    Swift

    var decelerationRate: CGFloat { get set }

Manipulating the Viewpoint

  • 카메라를 이동합니다.

    Declaration

    Objective-C

    - (void)moveCamera:(nonnull INVCameraUpdate *)cameraUpdate;

    Swift

    func moveCamera(_ cameraUpdate: INVCameraUpdate)

    Parameters

    cameraUpdate

    INVCameraUpdate 객체.

  • 카메라를 이동합니다. 카메라 이동이 완료되거나 취소되었을 경우 completion 블록이 호출됩니다.

    Declaration

    Objective-C

    - (void)moveCamera:(nonnull INVCameraUpdate *)cameraUpdate
        completion:(nullable void (^)(BOOL))completion;

    Swift

    func moveCamera(_ cameraUpdate: INVCameraUpdate, completion: ((Bool) -> Void)? = nil)

    Parameters

    cameraUpdate

    INVCameraUpdate 객체.
    completion

    카메라 이동이 완료되었을 때 호출되는 콜백 블록. (완료 전에 다른 지도 조작으로 취소 여부를 isCancelled로 전달합니다.)

  • 현재 진행 중인 지도 이동 애니메이션을 취소합니다.

    Declaration

    Objective-C

    - (void)cancelTransitions;

    Swift

    func cancelTransitions()