KNMapViewEventListener
Receives Camera gesture events (panning, Zoom, Tilt, and rotation) and screen touch events (single-tap and double-tap). Implement KNMapViewEventListener and register it with KNMapView.
@interface MyMapViewEventListener () <KNMapViewEventListener>
@end
@implementation MyMapViewEventListener
- (void)mapView:(KNMapView * _Nonnull)aMapView singleTappedWithScreenPoint:(CGPoint)aScreenPoint coordinate:(FloatPoint)aCoordinate {
...
}
@end
mapView.viewEventListener = myMapViewEventListner;Methods
mapView:singleTappedWitScreenPoint:coordinate
Called when the map is tapped once. Returns the tapped screen point and KATEC coordinates.
- (void) mapView: (KNMapView*) aMapView
singleTappedWitScreenPoint: (CGPoint) aScreenPoint
coordinate: (FloatPoint) aCoordinate;Parameters
| Name | Description |
|---|---|
aMapView | Map view where the touch event occurred |
aScreenPoint | Screen coordinates where the touch event occurred |
aCoordinate | KATEC coordinates where the touch event occurred |
mapView:doubleTappedWithScreenPoint:coordinate
Called when the map is double-tapped. Returns the last tapped screen point and KATEC coordinates.
- (void) mapView: (KNMapView*) aMapView
doubleTappedWithScreenPoint: (CGPoint) aScreenPoint
coordinate: (FloatPoint) aCoordinate;Parameters
| Name | Description |
|---|---|
aMapView | Map view where the touch event occurred |
aScreenPoint | Last Screen coordinates where the touch event occurred |
aCoordinate | Last KATEC coordinates where the touch event occurred |
mapView:longPressedWithScreenPoint:coordinate
Called when the map is long-pressed. Returns the pressed screen point and KATEC coordinates.
- (void) mapView: (KNMapView*) aMapView
longPressedWithScreenPoint: (CGPoint) aScreenPoint
coordinate: (FloatPoint) aCoordinate;Parameters
| Name | Description |
|---|---|
aMapView | Map view where the touch event occurred |
aScreenPoint | Screen coordinates where the touch event occurred |
aCoordinate | KATEC coordinates where the touch event occurred |
mapView:panningStartedWitScreenPoint:coordinate
Called when a panning gesture starts. Returns the initial screen point and KATEC coordinates.
- (void) mapView: (KNMapView*) aMapView
panningStartedWitScreenPoint: (CGPoint) aScreenPoint
coordinate: (FloatPoint) aCoordinate;Parameters
| Name | Description |
|---|---|
aMapView | Map view where the touch event occurred |
aScreenPoint | Screen coordinates where the touch event occurred |
aCoordinate | KATEC coordinates where the touch event occurred |
mapView:panningChangingWithScreenPoint:coordinate
Called while a panning gesture is in progress. Returns the changing screen point and KATEC coordinates.
- (void) mapView: (KNMapView*) aMapView
panningChangingWithScreenPoint: (CGPoint) aScreenPoint
coordinate: (FloatPoint) aCoordinate;Parameters
| Name | Description |
|---|---|
aMapView | Map view where the touch event occurred |
aScreenPoint | Screen coordinates of the changing position |
aCoordinate | KATEC coordinates of the changing position |
mapView:panningEndedWithScreenPoint:coordinate
Called when a panning gesture ends. Returns the final screen point and KATEC coordinates.
- (void) mapView: (KNMapView*) aMapView
panningEndedWithScreenPoint: (CGPoint) aScreenPoint
coordinate: (FloatPoint) aCoordinate;Parameters
| Name | Description |
|---|---|
aMapView | Map view where the touch event occurred |
aScreenPoint | Screen coordinates when the event ends |
aCoordinate | KATEC coordinates at the end of the event |
mapView:zoomingStartedWithScreenPoint:zoom
Called when a pinch Zoom gesture starts. Returns the initial screen point and Zoom level.
- (void) mapView: (KNMapView*) aMapView
zoomingStartedWithScreenPoint: (CGPoint) aScreenPoint
zoom: (float) aZoom;Parameters
| Name | Description |
|---|---|
aMapView | Map view where the touch event occurred |
aScreenPoint | Screen coordinates where the touch event occurred |
aZoom | Current zoom level of the map |
mapView:zoomingChangingWithScreenPoint:zoom
Called while a pinch Zoom gesture is in progress. Returns the changing screen point and Zoom level.
- (void) mapView: (KNMapView*) aMapView
zoomingChangingWithScreenPoint: (CGPoint) aScreenPoint
zoom: (float) aZoom;Parameters
| Name | Description |
|---|---|
aMapView | Map view where the touch event occurred |
aScreenPoint | Screen coordinates according to screen shrinkage/expansion |
aZoom | Current zoom level of the map |
mapView:zoomingEndedWithScreenPoint:zoom
Called when a pinch Zoom gesture ends. Returns the final screen point and Zoom level.
- (void) mapView: (KNMapView*) aMapView
zoomingEndedWithScreenPoint: (CGPoint) aScreenPoint
zoom: (float) aZoom;Parameters
| Name | Description |
|---|---|
aMapView | Map view where the touch event occurred |
aScreenPoint | Screen coordinates when the event ends |
aZoom | Current zoom level of the map |
mapView:bearingStartedWitScreenPoint:bearing
Called when a rotation gesture starts. Returns the initial screen point and rotation angle.
- (void) mapView: (KNMapView*) aMapView
bearingStartedWitScreenPoint: (CGPoint) aScreenPoint
bearing: (float) aBearing;Parameters
| Name | Description |
|---|---|
aMapView | Map view where the touch event occurred |
aScreenPoint | Screen coordinates where the touch event occurred |
aBearing | Current rotation angle of the map |
mapView:bearingChangingWitScreenPoint:bearing
Called while a rotation gesture is in progress. Returns the screen point and changing rotation angle.
- (void) mapView: (KNMapView*) aMapView
bearingChangingWitScreenPoint: (CGPoint) aScreenPoint
bearing: (float) aBearing;Parameters
| Name | Description |
|---|---|
aMapView | Map view where the touch event occurred |
aScreenPoint | Screen coordinates according to the rotation of the screen |
aBearing | Current rotation angle of the map |
mapView:bearingEndedWitScreenPoint:bearing
Called when a rotation gesture ends. Returns the final screen point and rotation angle.
- (void) mapView: (KNMapView*) aMapView
bearingEndedWitScreenPoint: (CGPoint) aScreenPoint
bearing: (float) aBearing;Parameters
| Name | Description |
|---|---|
aMapView | Map view where the touch event occurred |
aScreenPoint | Screen coordinates when the event ends |
aBearing | Current rotation angle of the map |
mapView:tiltingStartedWitScreenPoint:tilt
Called when a Tilt gesture starts. Returns the initial screen point and Tilt.
- (void) mapView: (KNMapView*) aMapView
tiltingStartedWitScreenPoint: (CGPoint) aScreenPoint
tilt: (float) aTilt;Parameters
| Name | Description |
|---|---|
aMapView | Map view where the touch event occurred |
aScreenPoint | Screen coordinates where the touch event occurred |
aTilt | Current tilt of the map |
mapView:tiltingChangingWitScreenPoint:tilt
Called while a Tilt gesture is in progress. Returns the screen point and changing Tilt.
- (void) mapView: (KNMapView*) aMapView
tiltingChangingWitScreenPoint: (CGPoint) aScreenPoint
tilt: (float) aTilt;Parameters
| Name | Description |
|---|---|
aMapView | Map view where the touch event occurred |
aScreenPoint | Tilt by screen coordinates |
aTilt | Current tilt of the map |
mapView:tiltingEndedWithScreenPoint:tilt
Called when a Tilt gesture ends. Returns the final screen point and Tilt.
- (void) mapView: (KNMapView*) aMapView
tiltingEndedWithScreenPoint: (CGPoint) aScreenPoint
tilt: (float) aTilt;Parameters
| Name | Description |
|---|---|
aMapView | Map view where the touch event occurred |
aScreenPoint | Screen coordinates when the event ends |
aTilt | Current tilt of the map |
mapView:cameraAnimationCanceledWithCameraUpdate
Called when a Camera animation started by moveAnimateCamera is canceled.
- (void) mapView: (KNMapView*) aMapView
cameraAnimationCanceledWithCameraUpdate: (KNMapCameraUpdate*) aCameraUpdate;Parameters
| Name | Description |
|---|---|
aMapView | Map view of the camera event |
aCameraUpdate | The camera information. |
mapView:cameraAnimationEndedWithCameraUpdate
Called when a Camera animation started by moveAnimateCamera finishes.
- (void) mapView: (KNMapView*) aMapView
cameraAnimationEndedWithCameraUpdate: (KNMapCameraUpdate*) aCameraUpdate;Parameters
| Name | Description |
|---|---|
aMapView | Map view of the camera event |
aCameraUpdate | The camera information. |
userLocationAnimationEnded: (Deprecated)
Called when the user-location animation on the map ends.
- (void) userLocationAnimationEnded: (KNMapView *_Nonnull) aMapView;Parameters
| Name | Description |
|---|---|
aMapView | Map view where the user's location is registered |
mapView:onRouteSelected:index: (Deprecated)
Called when a route displayed on the map is selected. Returns the selected route and its index.
- (void) mapView: (KNMapView *_Nonnull) aMapView
onRouteSelected: (KNRoute*_Nonnull) aRoute
index: (int) aIndex;Parameters
| Name | Description |
|---|---|
aMapView | Map view registered by KNRoute |
aRoute | selected route |
aIndex | Index of the selected route in the list of routes registered on the map |
mapView:onPOISelected:poiName:coordinate: (Deprecated)
Called when a POI displayed on the map is selected. Returns the selected POI ID, name, and location in KATEC coordinates.
- (void) mapView: (KNMapView *_Nonnull) aMapView
onPOISelected: (SInt64) aPOIId
poiName: (NSArray* _Nullable) aPOIName
coordinate: (FloatPoint) aCoordinate;Parameters
| Name | Description |
|---|---|
aMapView | Map view registered by KNRoute |
aPOIId | Selected points of interest(POI)of ID |
aPOIName | Selected points of interest(POI)Information on the name |
aCoordinate | KATEC coordinates of the selected POI |