Overlay
-
지도에 오버레이되는 요소를 나타내는 최상위 클래스. 대부분의 오버레이는
See moremapView
를 사용해 동적으로 지도에 추가하거나 지도로부터 제거할 수 있습니다.Declaration
Objective-C
@interface NMFOverlay : NSObject <NMFPickable>
Swift
class NMFOverlay : NSObject, NMFPickable
-
오버레이에서 사용하는 비트맵 이미지를 나타내는 불변 클래스. 팩토리 메서드를 이용해 asset,
See moreUIImage
,NSBundle
등으로부터 인스턴스를 생성할 수 있습니다.Declaration
Objective-C
@interface NMFOverlayImage : NSObject
Swift
class NMFOverlayImage : NSObject
-
지도에서 사용할 수 있는 이미지 리소스를 만들기 위한
See moreUIView
를 반환할 수 있는 프로토콜. 이 프로토콜을 구현할 경우, 오버레이의 상태에 따라서UIView
를 반환하게 하여 그 스냅숏을NMFOverlay
클래스에서 이미지 형태로 사용할 수 있습니다.Declaration
Objective-C
@protocol NMFOverlayImageDataSource <NSObject>
Swift
protocol NMFOverlayImageDataSource : NSObjectProtocol
-
오버레이 터치에 대한 이벤트 핸들러 블록 타입 선언.
Declaration
Objective-C
typedef BOOL (^NMFOverlayTouchHandler)(NMFOverlay *__weak _Nonnull)
Swift
typealias NMFOverlayTouchHandler = (NMFOverlay) -> Bool
Return Value
YES
일 경우 이벤트를 소비합니다. 그렇지 않을 경우NMFMapView
까지 이벤트가 전달되어NMFMapViewTouchDelegate
의mapView:didTapMap:point:
가 호출됩니다. -
사용자의 현재 위치를 나타내는 오버레이. 이 오버레이는 지도에 단 하나만 존재하며, 인스턴스를 직접 생성할 수 없고
NMFMapView.locationOverlay
를 이용해서 가져올 수 있습니다. 위치 오버레이는 주 아이콘과 보조 아이콘, 원으로 구성됩니다.- 주 아이콘: 반드시 필요합니다. 이벤트를 받을 수 있습니다.
- 보조 아이콘: 생략할 수 있습니다. 주 아이콘보다 약간 아래에 그려집니다. 이벤트를 받을 수 없습니다.
- 원: 생략할 수 있습니다. 강조 효과를 위해 사용되며, 보조 아이콘 아래에 그려집니다. 이벤트를 받을 수 없습니다.
Declaration
Objective-C
@interface NMFLocationOverlay : NMFOverlay
Swift
class NMFLocationOverlay : NMFOverlay
-
아이콘과 캡션을 이용해 지도 위의 한 지점을 표시하는 오버레이.
See more -
지도의 특정 지점 또는 마커 위에 열 수 있는 정보 창. 정보 창은 이미지로 특정 지점을 표시한다는 점에서 마커와 유사하나, 다음과 같은 차이가 있습니다.
- 마커처럼 특정 좌표에 열 수 있을 뿐만 아니라 다른 마커 위에도 열 수 있습니다.
- 고정된 이미지를 지정하는 마커와 달리 이미지를 반환하는 어댑터를 지정할 수 있으므로, 객체/상황별로 다른 이미지를 노출할 수 있습니다.
Declaration
Objective-C
@interface NMFInfoWindow : NMFOverlay
Swift
class NMFInfoWindow : NMFOverlay
-
Declaration
Objective-C
enum NMFAlign : NSInteger {}
Swift
enum NMFAlign : Int, @unchecked Sendable
-
오버레이를 어느 방향으로 정렬할지 나타내는 객체. 속성 객체로만 사용해야 합니다.
See moreDeclaration
Objective-C
@interface NMFAlignType : NSObject <NSSecureCoding, NSCopying>
Swift
class NMFAlignType : NSObject, NSSecureCoding, NSCopying
-
지도에서 특정 영역을 나타내는 오버레이. 지도에 추가하기 전에 반드시
See morebounds
및overlayImage
를 지정해야 합니다.Declaration
Objective-C
@interface NMFGroundOverlay : NMFOverlay
Swift
class NMFGroundOverlay : NMFOverlay
-
지도에 원을 나타내는 오버레이.
See moreDeclaration
Objective-C
@interface NMFCircleOverlay : NMFOverlay
Swift
class NMFCircleOverlay : NMFOverlay
-
지도에 경로선을 나타내는 오버레이. 하나의 선을 나타낸다는 측면에서는
NMFPolylineOverlay
와 유사하나, 다음과 같이 경로선에 특화된 특징이 있습니다.- 테두리와 패턴 이미지를 적용할 수 있습니다.
- 지도를 기울이더라도 두께가 일정하게 유지됩니다.
- 자기교차(self-intersection)가 일어나더라도 테두리, 패턴 이미지가 자연스럽게 나타납니다.
- 진척률을 지정할 수 있으며, 지나온/지나갈 경로에 각각 다른 색상과 테두리를을 지정할 수 있습니다.
- 점선 패턴, 끝 지점/연결점의 모양은 지정할 수 없습니다.
-
NMFPath, NMFMultipartPath의 색상을 지정하는 클래스.
See moreDeclaration
Objective-C
@interface NMFPathColor : NSObject
Swift
class NMFPathColor : NSObject
-
경로선을 여러 파트로 나누어 각각 다른 색상을 부여할 수 있는 특수한
See moreNMFPath
. 다양한 색상으로 구성된 경로선을 나타내려면 여러 개의NMFPath
를 사용하는 것보다 이 클래스를 사용하는 것이 효율적입니다.MultipartPathOverlay
는 좌표열 파트의 목록와 색상 파트의 목록으로 구성되며,0
번째 좌표열 파트에0
번째 색상 파트의 색상이 적용됩니다. 따라서 좌표열 파트와 색상 파트의 크기가 동일해야 합니다.Declaration
Objective-C
@interface NMFMultipartPath : NMFOverlay
Swift
class NMFMultipartPath : NMFOverlay
-
지도에 도형을 나타내는 오버레이.
See moreDeclaration
Objective-C
@interface NMFPolygonOverlay : NMFOverlay
Swift
class NMFPolygonOverlay : NMFOverlay
-
지도에 선을 나타내는 오버레이.
See moreDeclaration
Objective-C
@interface NMFPolylineOverlay : NMFOverlay
Swift
class NMFPolylineOverlay : NMFOverlay
-
화살표 형태로 방향 또는 회전 지점을 나타내는 오버레이. 경로선 오버레이와 마찬가지로 좌표열을 나타내지만 진척률을 지정할 수 없고, 끝 지점에 삼각형 모양의 머리가 추가됩니다.
See moreDeclaration
Objective-C
@interface NMFArrowheadPath : NMFOverlay
Swift
class NMFArrowheadPath : NMFOverlay
-
피킹이 가능한 지도 요소를 정의한 프로토콜.
Declaration
Objective-C
@protocol NMFPickable <NSObject>
Swift
protocol NMFPickable : NSObjectProtocol
-
끝 지점의 모양
See moreDeclaration
Objective-C
enum NMFOverlayLineCap : NSUInteger {}
Swift
enum NMFOverlayLineCap : UInt, @unchecked Sendable
-
연결점의 모양.
See moreDeclaration
Objective-C
enum NMFOverlayLineJoin : NSUInteger {}
Swift
enum NMFOverlayLineJoin : UInt, @unchecked Sendable