motion-yandexmapkit 0.0.1

data/YandexMapKit/Headers/YMKDraggablePinAnnotationViewDelegate+Protocol.h

@@ -0,0 +1,41 @@
+/*
+ * YMKDraggablePinAnnotationViewDelegate+Protocol.h
+ *
+ * This file is a part of the Yandex Map Kit.
+ *
+ * Version for iOS © 2011 YANDEX
+ * 
+ * You may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at http://legal.yandex.ru/mapkit/
+ */
+
+#import <Foundation/Foundation.h>
+
+@class YMKDraggablePinAnnotationView;
+
+/**
+ Provides information about draggable pin annotations to a map view.
+ */
+@protocol YMKDraggablePinAnnotationViewDelegate <NSObject>
+
+@optional
+
+/**
+ Called when user did start interation with the pin annotation view
+ @param pin annotation view is being interacted
+ */
+- (void)draggablePinAnnotationViewDidStartInteraction:(YMKDraggablePinAnnotationView *)view;
+
+/**
+ Called when user did start moving the pin annotation view
+ @param pin annotation view is being moved
+ */
+- (void)draggablePinAnnotationViewDidStartMoving:(YMKDraggablePinAnnotationView *)view;
+
+/**
+ Called when user did end moving the pin annotation view
+ @param pin annotation view is being moved
+ */
+- (void)draggablePinAnnotationViewDidEndMoving:(YMKDraggablePinAnnotationView *)view;
+
+@end

data/YandexMapKit/Headers/YMKGeoObject.h

@@ -0,0 +1,26 @@
+/*
+ * YMKGeoObject.h
+ *
+ * This file is a part of the Yandex Map Kit.
+ *
+ * Version for iOS © 2011 YANDEX
+ * 
+ * You may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at http://legal.yandex.ru/mapkit/
+ */
+
+#import <CoreLocation/CoreLocation.h>
+#import <Foundation/Foundation.h>
+
+/**
+ Defines generic geographical object
+ */
+@protocol YMKGeoObject <NSObject>
+@required
+
+/**
+ The map coordinates of the center point of an object.
+ */
+@property (nonatomic, readonly) CLLocationCoordinate2D coordinate;
+
+@end

data/YandexMapKit/Headers/YMKHostsConfiguration.h

@@ -0,0 +1,30 @@
+/*
+ * YMKHostsConfiguration.h
+ *
+ * This file is a part of the Yandex Map Kit.
+ *
+ * Version for iOS © 2011 YANDEX
+ * 
+ * You may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at http://legal.yandex.ru/mapkit/
+ */
+
+#import <Foundation/Foundation.h>
+
+@interface YMKHostsConfiguration : NSObject {
+@private
+    NSString * startupURLString_;
+    NSString * tileRequestURLString_;
+    NSString * jamsRequestURLString_;
+    NSString * jamStylesURLString_;
+    NSString * routeBuilderURLString_;
+    NSString * ymapsmlStylesURLString_;
+}
+@property (nonatomic, readonly, copy) NSString * startupURLString;
+@property (nonatomic, readonly, copy) NSString * tileRequestURLString;
+@property (nonatomic, readonly, copy) NSString * jamsRequestURLString;
+@property (nonatomic, readonly, copy) NSString * jamStylesURLString;
+@property (nonatomic, readonly, copy) NSString * routeBuilderURLString;
+@property (nonatomic, readonly, copy) NSString * ymapsmlStylesURLString;
+
+@end

data/YandexMapKit/Headers/YMKMapLayerInfo.h

@@ -0,0 +1,57 @@
+/*
+ * YMKMapLayerInfo.h
+ *
+ * This file is a part of the Yandex Map Kit.
+ *
+ * Version for iOS © 2011 YANDEX
+ * 
+ * You may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at http://legal.yandex.ru/mapkit/
+ */
+
+#import <Foundation/Foundation.h>
+#include <stdint.h>
+
+/**
+ An instance of YMKMapLayerInfo stores information about map layer supported
+ by map view.
+ */
+@interface YMKMapLayerInfo : NSObject {
+@private
+    uint16_t _identifier;
+    NSString * _requestString;
+    NSString * _localizedName;
+    BOOL _hasVersion;
+    uint16_t _currentVersion;
+    BOOL _auxiliary;
+    uint16_t _sizeInPixels;
+    BOOL _allowsNightMode;
+}
+
+/**
+ Layer identifier
+ */
+@property (nonatomic, assign) uint16_t identifier;
+
+/**
+ Localized name of a layer. You can use it in layer switching UI
+ */
+@property (nonatomic, copy) NSString * localizedName;
+
+/**
+ Boolean flag indicating service map layer with various meta information.
+ */
+@property (nonatomic, assign) BOOL auxiliary; 
+
+/**
+ Size of a map layer tile in pixels.
+ */
+@property (nonatomic, assign) uint16_t sizeInPixels;
+
+/**
+ Boolean flag indicating whether map layer supports night mode. For example, 
+ satellite layer doesn't support nigt mode.
+ */
+@property (nonatomic, assign) BOOL allowsNightMode;
+
+@end

data/YandexMapKit/Headers/YMKMapLayersConfiguration.h

@@ -0,0 +1,50 @@
+/*
+ * YMKMapLayersConfig.h
+ *
+ * This file is a part of the Yandex Map Kit.
+ *
+ * Version for iOS © 2011 YANDEX
+ * 
+ * You may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at http://legal.yandex.ru/mapkit/
+ */
+
+#import <Foundation/Foundation.h>
+#import "YMKMapLayerInfo.h"
+
+/**
+ Provides information about map layers supported by map view
+ */
+@interface YMKMapLayersConfiguration : NSObject {
+@private
+    NSArray * _infos;
+    BOOL _hasServiceLayer;
+    YMKMapLayerInfo * _serviceLayerInfo;
+}
+
+/**
+ Contains instances of YMKMapLayerInfo supported by map view. You should query
+ this array manually.
+ @see infoForLayerWithIdentifier:
+ */
+@property (nonatomic, readonly) NSArray * infos;
+
+/**
+ Indicates whether current configuration contains auxillary map layer
+ */
+@property (nonatomic, readonly) BOOL hasServiceLayer;
+
+/**
+ If hasServiceLayer property is set to YES then serviceLayerInfo
+ points to auxillary map layer info
+ */
+@property (nonatomic, readonly) YMKMapLayerInfo * serviceLayerInfo;
+
+/**
+ Returns instance of YMKMapLayerInfo whose identifier is equal to parameter passed
+ @param identifier identifier of a requested map layer info
+ @return instance of YMKMapLayerInfo or nil
+ */
+- (YMKMapLayerInfo *)infoForLayerWithIdentifier:(uint16_t)identifier;
+
+@end

data/YandexMapKit/Headers/YMKMapStructs.h

@@ -0,0 +1,507 @@
+/*
+ * YMKMapStructs.h
+ *
+ * This file is a part of the Yandex Map Kit.
+ *
+ * Version for iOS © 2011 YANDEX
+ * 
+ * You may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at http://legal.yandex.ru/mapkit/
+ */
+
+
+#import <Foundation/Foundation.h>
+#import <CoreLocation/CoreLocation.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+typedef CLLocationCoordinate2D YMKMapCoordinate;
+typedef CLLocationDegrees YMKMapDegrees;
+
+extern const YMKMapDegrees kYMKMapStructsComparisonAccuracy;
+extern const YMKMapDegrees kYMKMapStructsCoordinateLatitudeMinValue;
+extern const YMKMapDegrees kYMKMapStructsCoordinateLatitudeMaxValue;
+extern const YMKMapDegrees kYMKMapStructsCoordinateLongitudeMinValue;
+extern const YMKMapDegrees kYMKMapStructsCoordinateLongitudeMaxValue;
+extern const YMKMapDegrees kYMKMapRegionSizeDeltaLatitudeMinValue;
+extern const YMKMapDegrees kYMKMapRegionSizeDeltaLatitudeMaxValue;
+extern const YMKMapDegrees kYMKMapRegionSizeDeltaLongitudeMinValue;
+extern const YMKMapDegrees kYMKMapRegionSizeDeltaLongitudeMaxValue;
+
+typedef enum {
+	YMKMapTypeInvalid = 0,
+	YMKMapTypeMap = 1,
+	YMKMapTypeSattelite = 2,
+	YMKMapTypeWiki = 3,
+	YMKMapTypeHybrid = 4
+} YMKMapType DEPRECATED_ATTRIBUTE;
+
+#pragma mark -
+#pragma mark Structs and Constants
+
+#pragma mark YMKMapCoordinate
+
+/**
+ Creates a point on the map with coordinate (0.0; 0.0).
+ */
+#define YMKMapCoordinateZero ((YMKMapCoordinate){0.0f, 0.0f})
+    
+/**
+ Returns a point on the map with invalid coordinate
+ */
+#define YMKMapCoordinateInvalid ((YMKMapCoordinate){kYMKMapStructsCoordinateLatitudeMaxValue + kYMKMapStructsComparisonAccuracy * 10.f, kYMKMapStructsCoordinateLongitudeMaxValue + kYMKMapStructsComparisonAccuracy * 10.f})
+
+#pragma mark YMKMapCoordinateComponents
+
+/**
+ Represents a geographical coordinate (latitude or longitude) in the degrees-minutes-seconds (DMS) format.
+ */
+typedef struct {
+	short degrees;
+	unsigned short minutes;
+	float seconds;
+} YMKCoordinateComponents;
+
+#pragma mark YMKMapRegionSize
+
+/**
+ Defines the size of YMKMapRegion instance
+ */
+typedef struct {
+	YMKMapDegrees latitudeDelta;    /**< the vertical distance of the region */
+	YMKMapDegrees longitudeDelta;   /**< the horizontal distance of the region */
+} YMKMapRegionSize;
+
+/**
+ Returns the map region which has a zero size.
+ */
+#define YMKMapRegionSizeZero ((YMKMapRegionSize){0.0f, 0.0f})
+
+/**
+ Returns region size with invalid parameters
+ */
+#define YMKMapRegionSizeInvalid ((YMKMapRegionSize){kYMKMapRegionSizeDeltaLatitudeMaxValue + kYMKMapStructsComparisonAccuracy * 10.f, kYMKMapRegionSizeDeltaLongitudeMaxValue + kYMKMapStructsComparisonAccuracy * 10.f})
+    
+/**
+ Returns map region size containing the entire Earth.
+ */
+#define YMKMapRegionSizeEarth ((YMKMapRegionSize){kYMKMapRegionSizeDeltaLatitudeMaxValue, kYMKMapRegionSizeDeltaLongitudeMaxValue})
+
+#pragma mark YMKMapRegion
+
+/**
+ Defines a map region.
+ */
+typedef struct {
+	YMKMapCoordinate center;    /**< the coordinate of the region center */
+	YMKMapRegionSize span;      /**< the region size */
+} YMKMapRegion;
+
+/**
+ Returns the zero-sized region.
+ */
+#define YMKMapRegionZero ((YMKMapRegion){YMKMapCoordinateZero, YMKMapRegionSizeZero})
+    
+/**
+ Returns invalid map region.
+ */
+#define YMKMapRegionInvalid ((YMKMapRegion){YMKMapCoordinateInvalid, YMKMapRegionSizeInvalid})
+
+/**
+ Returns map region containing the entire Earth.
+ */
+#define YMKMapRegionEarth ((YMKMapRegion){YMKMapCoordinateZero, YMKMapRegionSizeEarth})
+
+#pragma mark YMKMapRect
+
+/**
+ Defines a rectangular area on the map.
+ */
+typedef struct {
+	YMKMapCoordinate topLeft;       /**< the coordinate of the top left corner of the rectangle  */
+	YMKMapCoordinate bottomRight;   /**< the coordinate of the bottom right corner of the rectangle */
+} YMKMapRect;
+    
+/**
+ Return the zero-sized rectangular area.
+ */
+#define YMKMapRectZero ((YMKMapRect){YMKMapCoordinateZero, YMKMapCoordinateZero})
+    
+/**
+ Returns rectangular area with invalid parameters
+ */
+#define YMKMapRectInvalid ((YMKMapRect){YMKMapCoordinateInvalid, YMKMapCoordinateInvalid})
+
+
+#pragma mark YMKMapViewPort
+
+/**
+ Defines map view port
+ */
+typedef struct {
+    YMKMapRect mapRect;     /**< current map rectangular area covered by view port */
+    NSUInteger zoomLevel;   /**< current map zoom level */        
+} YMKMapViewPort;
+    
+/**
+ Returns zero-sized viewport
+ */
+#define YMKMapViewPortZero ((YMKMapViewPort){YMKMapRectZero, 0})
+
+/**
+ Defines a point on the map.
+ */
+typedef struct {
+	long long int x;
+	long long int y;
+} YMKMapPoint;
+
+#pragma mark -
+#pragma mark Utility Functions
+
+#pragma mark YMKMapDegrees
+
+/**
+ Converts degrees to the string representation.
+ @param degrees the coordinate in degrees
+ @return the string representation of the coordinate in degrees
+ */
+NSString * NSStringFromMapDegrees(YMKMapDegrees degrees);
+
+#pragma mark YMKMapCoordinate
+
+/**
+ Creates a geographical point with specified coordinates.
+ @param latitude the latitude of the point
+ @param longitude the longitude of the point
+ @return the geographical point with the specified coordinates
+ */
+extern YMKMapCoordinate YMKMapCoordinateMake(YMKMapDegrees latitude, YMKMapDegrees longitude);
+
+/**
+ Compares two geographical coordinates for equality.
+ @param ll1 the first coordinate
+ @param ll2 the second coordinate
+ @return YES if coordinates are equal, NO - otherwise
+ */
+extern BOOL YMKMapCoordinateEqualToMapCoordinate(YMKMapCoordinate ll1, YMKMapCoordinate ll2);
+
+/**
+ Checks if the specified map coordinate is a zero coordinate (YMKMapCoordinateZero).
+ @param ll a map coordinate
+ @return YES if the map coordinate is a zero coordinate, NO - otherwise
+ @include
+ */
+extern BOOL YMKMapCoordinateIsZero(YMKMapCoordinate ll);
+
+/**
+ Checks if the specified map coordinate is invalid (YMKMapCoordinateInvalid).
+ @param ll a map coordinate 
+ @return YES if the map coordinate is invalid, NO - otherwise
+ */
+extern BOOL YMKMapCoordinateIsValid(YMKMapCoordinate ll);
+
+/**
+ Creates a map coordinate from the dictionary.
+ The dictionary should contain two keys: latitude and longitude which values should be of type double.
+ @param dict the dictionary
+ @return the created coordinate
+ */
+extern YMKMapCoordinate YMKMapCoordinateFromDictionary(NSDictionary * dict);
+
+/**
+ Converts a map coordinate to the dictionary.
+ @param ll a map coordinate
+ @return the dictionary
+ */
+extern NSDictionary * NSDictionaryFromMapCoordinate(YMKMapCoordinate ll);
+
+/**
+ Returns the string representation of a map coordinate.
+ @param ll a map coordinate
+ @param pretty YES - to use pretty formatting (degrees/minutes/seconds), NO - not
+ @return the string representation of the specified coordinate
+ */
+extern NSString * NSStringFromMapCoordinate(YMKMapCoordinate ll, BOOL pretty);
+
+#pragma mark YMKMapCoordinateComponents
+
+/**
+ Splits a geographical coordinate into components (degrees, minutes and seconds).
+ @param degrees a geographical coordinate
+ @return components of the specified geograhical coordinate (degrees, minutes and seconds)
+ */
+extern YMKCoordinateComponents YMKCoordinateComponentsFromMapDegrees(YMKMapDegrees degrees);
+
+/**
+ Returns the string representation of coordinate componets (degrees, minutes and seconds).
+ @param components coordinate components (degrees, minutes and seconds)
+ @return the string representation of the specified coordinate componets
+ */
+extern NSString * NSStringFromCoordinateComponents(YMKCoordinateComponents components);
+
+#pragma mark YMKMapRegionSize
+
+/**
+ Creates a region of the specified size.
+ @param latitudeDelta the difference between latitudes of the most northern and and the most southern points of the region, in degrees. 
+ @param longitudeDelta the difference between longitudes of the most western and and the most eastern points of the region, in degrees.
+ @return the region of the specified size
+ */
+extern YMKMapRegionSize YMKMapRegionSizeMake(YMKMapDegrees latitudeDelta, YMKMapDegrees longitudeDelta);
+
+/**
+ Checks if two regions have equal size. 
+ @param s1 the size of the first region
+ @param s2 the size of the second region
+ @return YES - regions have equal size, NO - not
+ */
+extern BOOL YMKMapRegionSizeEqualToMapRegionSize(YMKMapRegionSize s1, YMKMapRegionSize s2); 
+
+/**
+ Checks if a map region has a zero size.
+ @param size the region size
+ @return YES - the map region has a zero size, NO - not
+ */
+extern BOOL YMKMapRegionSizeIsZero(YMKMapRegionSize size);
+
+/**
+ Checks if a map region size is valid.
+ @param size the region size
+ @return YES - the region size is valid, NO - not
+ */
+extern BOOL YMKMapRegionSizeIsValid(YMKMapRegionSize size);
+
+/**
+ Retrieves the region size from the dictionary.
+ The dictionary should contain two keys: latitudeDelta and longitudeDelta which values should be of type double.
+ @param dict the dictionary
+ @return the region size from the dictionary
+ */
+extern YMKMapRegionSize YMKMapRegionSizeFromDictionary(NSDictionary * dict);
+
+/**
+ Converts the map region size to the dictionary.
+ @param size the map region size
+ @return the dictionary
+ */
+extern NSDictionary * NSDictionaryFromMapRegionSize(YMKMapRegionSize size);
+
+#pragma mark YMKMapRegion
+
+/**
+ Creates a map region with the specified center and the span measured from its center by latitude and longitude. 
+ @param center map coordinates of the region center
+ @param span the span measured from the region center by latitude and longitude
+ @return the specified region
+ */
+extern YMKMapRegion YMKMapRegionMake(YMKMapCoordinate center, YMKMapRegionSize span);
+
+/**
+ Checks if two regions are equal.
+ @param r1 the first region
+ @param r2 the second region
+ @returns YES - regions are equal, NO - not
+ */
+extern BOOL YMKMapRegionEqualToMapRegion(YMKMapRegion r1, YMKMapRegion r2); 
+
+/**
+ Checks if the specified region is zero-sized.
+ @param region the map region
+ @return YES - the specified region is zero-sized, NO - not
+ */
+extern BOOL YMKMapRegionIsZero(YMKMapRegion region);
+
+/**
+ Checks if the specified region is valid.
+ @param region the region
+ @returns YES - the specified region is valid, NO - not
+ */
+extern BOOL YMKMapRegionIsValid(YMKMapRegion region);
+
+/**
+ Checks if the map region contains the specified geographical coordinate. 
+ @param region the map region
+ @param ll the geographical coordinate
+ @return YES - the region contains the coordinate, NO - not
+ */
+extern BOOL YMKMapRegionContainsMapCoordinate(YMKMapRegion region, YMKMapCoordinate ll);
+
+/**
+ Checks if the first map region contains the second map region.
+ @param r1 the first map region
+ @param r2 the second map region
+ @return YES - the first region contains the second region, NO - not
+ */
+extern BOOL YMKMapRegionContainsMapRegion(YMKMapRegion r1, YMKMapRegion r2);
+
+/**
+ Returns the map coordinate of the top left corner of the specified region.
+ @param region the region
+ @return the map coordinate of the top left corner of the specified region
+ */
+extern YMKMapCoordinate YMKMapRegionGetTopLeftCoordinate(YMKMapRegion region);
+
+/**
+ Returns the map coordinate of the bottom right corner of the specified region.
+ @param region specifies the region
+ @return the map coordinate of the bottom right corner of the specified region
+ */
+extern YMKMapCoordinate YMKMapRegionGetBottomRightCoordinate(YMKMapRegion region);
+
+/**
+ Retrieves the map region from the dictionary.
+ @param dict the dictionary
+ @return the map region from the dictionary
+ */
+extern YMKMapRegion YMKMapRegionFromDictionary(NSDictionary * dict);
+
+/**
+ Converts the map region to the dictionary.
+ @param region the map region
+ @return the dictionary 
+ */
+extern NSDictionary * NSDictionaryFromMapRegion(YMKMapRegion region);
+
+/**
+ Returns a rectangular area which fits the specified region.
+ @param region specifies the region
+ @return a rectangular area which fits the specified region
+ */
+extern YMKMapRect YMKMapRectFromMapRegion(YMKMapRegion region);
+
+#pragma mark YMKMapRect
+
+/**
+ Creates a rectangular area from the top left point and the bottom right point.
+ @param topLeft the top left point
+ @param bottomRight the bottom right point
+ @return the created rectangular area
+ */
+extern YMKMapRect YMKMapRectMake(YMKMapCoordinate topLeft, YMKMapCoordinate bottomRight);
+
+/**
+ Checks if two rectangular areas are equal.
+ @param r1 the first rectangular area
+ @param r2 the second rectangular area
+ @return YES - the rectangular areas are equal, NO - not
+ */
+extern BOOL YMKMapRectEqualToMapRect(YMKMapRect r1, YMKMapRect r2);
+
+/**
+ Checks if the specified rectangular area has zero size.
+ @param rect the rectangular area
+ @return YES - the specified rectangular area has zero size, NO - not 
+ */
+extern BOOL YMKMapRectIsZero(YMKMapRect rect);
+
+/**
+ Checks if the specified rectangular area is valid.
+ @param rect the rectangular area
+ @return YES - the specified rectangular area is valid, NO - not
+ */
+extern BOOL YMKMapRectIsValid(YMKMapRect rect);
+
+/**
+ Checks if the rectangular area contains the specified map coordinate.
+ @param rect the rectangular area
+ @param ll the geographical coordinate
+ @return YES - the rectangular area contains the specified coordinate, NO - not
+ */
+extern BOOL YMKMapRectContainsMapCoordinate(YMKMapRect rect, YMKMapCoordinate ll);
+
+/**
+ Checks if the first rectangular area contains the second rectangular area.
+ @param r1 the first rectangular area
+ @param r2 the second rectangular area
+ @return YES - the the first rectangular area contains the second rectangular area, NO - not
+ */
+extern BOOL YMKMapRectContainsMapRect(YMKMapRect r1, YMKMapRect r2);
+
+/**
+ Checks if the first rectangular area intersects the second rectangular area.
+ @param r1 the first rectangular area
+ @param r2 the second rectangular area
+ @return YES - the the first rectangular area intersects the second rectangular area, NO - not
+ */
+extern BOOL YMKMapRectIntersectsMapRect(YMKMapRect r1, YMKMapRect r2);
+
+/**
+ Retrieves the specified rectangular area from the dictionary.
+ @param dict the dictionary
+ @return the rectangular area from the dictionary
+ */
+extern YMKMapRect YMKMapRectFromDictionary(NSDictionary * dict);
+
+/**
+ Converts the specified rectangular area to the dictionary
+ @param rect the rectangular area
+ @return the dictionary
+ */
+extern NSDictionary * NSDictionaryFromMapRect(YMKMapRect rect);
+
+/**
+ Returns the string representation of the rectangular area.
+ @param rect the rectangular area
+ @return the string representation of the rectangular area
+ */
+extern NSString * NSStringFromMapRect(YMKMapRect rect);
+
+/**
+ Creates a map region from the specified rectangular area.
+ @param rect the rectangular area
+ @return the map region created from the specified rectangular area
+ */
+extern YMKMapRegion YMKMapRegionFromMapRect(YMKMapRect rect);
+
+/**
+ Creates a rectangular area with the specified center and the specified vertical and horizontal span measured from its center.
+ @param center the center of the rectangular area
+ @param meters the vertical and horizontal span measured from the center (in meters)
+ @return the rectangular area
+ */
+extern YMKMapRect YMKMapRectMakeWithCenterAndMeters(CLLocationCoordinate2D center, long long int meters);
+extern YMKMapCoordinate YMKMapRectGetCenterCoordinate(YMKMapRect rect);
+    
+extern YMKMapRect YMKMapRectNormalize(const YMKMapRect rect);
+
+#pragma mark YMKMapViewPort
+
+/**
+ Creates view port with given rect and zoom level
+ @param rect the rectangular area
+ @param zoomLevel map zoom level
+ @return map view port
+ */
+extern YMKMapViewPort YMKMapViewPortMake(YMKMapRect rect, NSUInteger zoomLevel);
+
+/**
+ Checks if the first map view port contains the second view port.
+ @param viewPort the first map view port
+ @param subViewPort the second map view port
+ @return YES - the the first view port contains the second view port, NO - not
+ */
+extern BOOL YMKMapViewPortContainsViewPort(YMKMapViewPort viewPort, YMKMapViewPort subViewPort); 
+extern BOOL YMKMapViewPortEqualToViewPort(YMKMapViewPort a, YMKMapViewPort b);
+extern BOOL YMKMapViewPortIsZero(YMKMapViewPort rect);
+extern NSString * NSStringFromMapViewPort(YMKMapViewPort viewPort);
+    
+/**
+ Retrieves the specified view port from the dictionary.
+ @param dict the dictionary
+ @return the view port from the dictionary
+ */
+extern YMKMapViewPort YMKMapViewPortFromDictionary(NSDictionary * dict);
+
+/**
+ Converts the specified view port to the dictionary
+ @param viewPort the view port
+ @return the dictionary
+ */
+extern NSDictionary * NSDictionaryFromMapViewPort(YMKMapViewPort viewPort);    
+    
+#ifdef __cplusplus
+}
+#endif