AGMapDataStruct.hpp

/*
 * Location.hpp
 *
 *  Created on: Jan 9, 2013
 *      Author: USER
 */

#ifndef AG_MAP_DATA_STRUCT
#define AG_MAP_DATA_STRUCT

#include <QString>

enum AGTrackMeType { AGTrackMeTypeAccuracy, AGTrackMeTypeDirection, AGTrackMeTypeBoth };

enum AGSignalType
{
    AGSignalUserLocated,
    AGSignalUserLocatingFailed,
    AGSignalTrackingStarted,
    AGSignalTrackingStopped,
    AGSignalMapViewTouchedDown
};

/*
 *  CLLocationDegrees
 *
 *  Discussion:
 *    Type used to represent a latitude or longitude coordinate in degrees under the WGS 84 reference
 *    frame. The degree can be positive (North and East) or negative (South and West).
 */
typedef double AGLocationDegrees;

typedef double AGPixelCoordinate;

typedef double AGOffsetCoordinate;

/*
 *  CLLocationAccuracy
 *
 *  Discussion:
 *    Type used to represent a location accuracy level in meters. The lower the value in meters, the
 *    more physically precise the location is. A negative accuracy value indicates an invalid location.
 */
typedef double AGLocationAccuracy;

/*
 *  CLLocationSpeed
 *
 *  Discussion:
 *    Type used to represent the speed in meters per second.
 */
typedef double AGLocationSpeed;

/*
 *  CLLocationDirection
 *
 *  Discussion:
 *    Type used to represent the direction in degrees from 0 to 359.9. A negative value indicates an
 *    invalid direction.
 */
typedef double AGLocationDirection;
typedef double AGLocationDistance;

/*
 *  CLLocationCoordinate2D
 *
 *  Discussion:
 *    A structure that contains a geographical coordinate.
 *
 *  Fields:
 *    latitude:
 *      The latitude in degrees.
 *    longitude:
 *      The longitude in degrees.
 */



typedef struct {
    AGLocationDegrees latitude;
    AGLocationDegrees longitude;
} AGLocationCoordinate2D;


typedef struct {
    AGPixelCoordinate localPixelX;
    AGPixelCoordinate localPixelY;
} AGLocalPixelCoordinate2D;

struct AGOffsetInPixel {
    AGOffsetCoordinate offsetX;
    AGOffsetCoordinate offsetY;

    AGOffsetInPixel(): offsetX(0.0), offsetY(0.0) {}
};


typedef struct
{
    float x;
    float y;
    float z;
} AGVertex;

struct AGGeoInformation {
    AGLocationCoordinate2D *screenLowerLeftLatLon;
    AGLocationCoordinate2D *screenLowerRightLatLon;
    AGLocationCoordinate2D *screenUpperLeftLatLon;
    AGLocationCoordinate2D *screenUpperRightLatLon;
    AGLocationCoordinate2D *screenMiddleLatLon;
    AGLocationCoordinate2D *longPressPointLatLon;
    AGLocationCoordinate2D *currentLocation;
    int zoomLevel;
    float scaleX,scaleY;
    QString remainingTimeToUpdateTraffic;

    AGGeoInformation(AGLocationCoordinate2D* arg1, AGLocationCoordinate2D* arg2, AGLocationCoordinate2D* arg3,
            AGLocationCoordinate2D* arg4, AGLocationCoordinate2D* arg5, AGLocationCoordinate2D* arg6, AGLocationCoordinate2D* arg7,
            int arg8, float arg9, float arg10, QString arg11)
    {
        screenLowerLeftLatLon = arg1;
        screenLowerRightLatLon = arg2;
        screenUpperLeftLatLon = arg3;
        screenUpperRightLatLon = arg4;
        screenMiddleLatLon = arg5;
        longPressPointLatLon = arg6;
        currentLocation = arg7;
        zoomLevel = arg8;
        scaleX = arg9;
        scaleY = arg10;
        remainingTimeToUpdateTraffic = arg11;
    }
    ~AGGeoInformation()
    {
        if (screenLowerLeftLatLon)
        {
            delete(screenLowerLeftLatLon);
        }
        if (screenLowerRightLatLon)
        {
            delete(screenLowerRightLatLon);
        }
        if (screenUpperLeftLatLon)
        {
            delete(screenUpperLeftLatLon);
        }
        if (screenUpperRightLatLon)
        {
            delete(screenUpperRightLatLon);
        }
        if (screenMiddleLatLon)
        {
            delete(screenMiddleLatLon);
        }
        if (longPressPointLatLon)
        {
            delete(longPressPointLatLon);
        }
        if (currentLocation)
        {
            delete(currentLocation);
        }
    }
};

inline void AGLocationCoordinate2DSet(AGLocationCoordinate2D *geoLocation,AGLocationDegrees latitude,AGLocationDegrees longitude)
{
    geoLocation->latitude = latitude;
    geoLocation->longitude = longitude;
}

inline void AGLocalPixelCoordinate2DSet(AGLocalPixelCoordinate2D *pixelCoordinate, AGPixelCoordinate localPixelX, AGPixelCoordinate localPixelY)
{
    pixelCoordinate->localPixelX = localPixelX;
    pixelCoordinate->localPixelY = localPixelY;
}

inline void AGOffsetInPixelSet(AGOffsetInPixel *offset, AGOffsetCoordinate offsetX, AGOffsetCoordinate offsetY)
{
    offset->offsetX = offsetX;
    offset->offsetY = offsetY;
}

inline void AGVertexSet(AGVertex *vertex, float x, float y, float z)
{
    vertex->x = x;
    vertex->y = y;
    vertex->z = z;
}

typedef struct
{
    unsigned int location;
    unsigned int length;
} AGRange;

/*
 *  CLLocationDistance
 *
 *  Discussion:
 *    Type used to represent a distance in meters.
 */
/*
typedef double CLLocationDistance;


 *  kCLDistanceFilterNone
 *
 *  Discussion:
 *    Use as the distanceFilter property for CLLocationManager. This indicates
 *    to the location service that no minimum movement filter is desired - ie, client will be informed
 *    of any movement.

extern const CLLocationDistance kCLDistanceFilterNone;


 *  kCLLocationAccuracy<x>
 *
 *  Discussion:
 *    Used to specify the accuracy level desired. The location service will try its best to achieve
 *    your desired accuracy. However, it is not guaranteed. To optimize
 *    power performance, be sure to specify an appropriate accuracy for your usage scenario (eg,
 *    use a large accuracy value when only a coarse location is needed).

//extern const CLLocationAccuracy kCLLocationAccuracyBestForNavigation __OSX_AVAILABLE_STARTING(__MAC_10_7,__IPHONE_4_0);
extern const CLLocationAccuracy kCLLocationAccuracyBest;
extern const CLLocationAccuracy kCLLocationAccuracyNearestTenMeters;
extern const CLLocationAccuracy kCLLocationAccuracyHundredMeters;
extern const CLLocationAccuracy kCLLocationAccuracyKilometer;
extern const CLLocationAccuracy kCLLocationAccuracyThreeKilometers;


 *  kCLLocationCoordinate2DInvalid
 *
 *  Discussion:
 *    Used to specify an invalid CLLocationCoordinate2D.

extern const CLLocationCoordinate2D kCLLocationCoordinate2DInvalid __OSX_AVAILABLE_STARTING(__MAC_10_7,__IPHONE_4_0);

#ifdef __cplusplus
extern "C" {
#endif


 *  CLLocationCoordinate2DIsValid
 *
 *  Discussion:
 *    Returns YES if the specified coordinate is valid, NO otherwise.

BOOL CLLocationCoordinate2DIsValid(CLLocationCoordinate2D coord) __OSX_AVAILABLE_STARTING(__MAC_10_7,__IPHONE_4_0);


 *  CLLocationCoordinate2DMake:
 *
 *  Discussion:
 *    Returns a new CLLocationCoordinate2D at the given latitude and longitude

CLLocationCoordinate2D CLLocationCoordinate2DMake(CLLocationDegrees latitude, CLLocationDegrees longitude) __OSX_AVAILABLE_STARTING(__MAC_10_7,__IPHONE_4_0);

#ifdef __cplusplus
}
#endif


 *  CLLocation
 *
 *  Discussion:
 *    Represents a geographical coordinate along with accuracy and timestamp information.

NS_CLASS_AVAILABLE(10_6, 2_0)
@interface CLLocation : NSObject <NSCopying, NSCoding>
{
@private
    id _internal;
}


 *  initWithLatitude:longitude:
 *
 *  Discussion:
 *    Initialize with the specified latitude and longitude.

- (id)initWithLatitude:(CLLocationDegrees)latitude
    longitude:(CLLocationDegrees)longitude;


 *  initWithCoordinate:altitude:horizontalAccuracy:verticalAccuracy:timestamp:
 *
 *  Discussion:
 *    Initialize with the specified parameters.

- (id)initWithCoordinate:(CLLocationCoordinate2D)coordinate
    altitude:(CLLocationDistance)altitude
    horizontalAccuracy:(CLLocationAccuracy)hAccuracy
    verticalAccuracy:(CLLocationAccuracy)vAccuracy
    timestamp:(NSDate *)timestamp;


 *  initWithCoordinate:altitude:horizontalAccuracy:verticalAccuracy:course:speed:timestamp:
 *
 *  Discussion:
 *    Initialize with the specified parameters.

- (id)initWithCoordinate:(CLLocationCoordinate2D)coordinate
    altitude:(CLLocationDistance)altitude
    horizontalAccuracy:(CLLocationAccuracy)hAccuracy
    verticalAccuracy:(CLLocationAccuracy)vAccuracy
    course:(CLLocationDirection)course
    speed:(CLLocationSpeed)speed
    timestamp:(NSDate *)timestamp __OSX_AVAILABLE_STARTING(__MAC_10_7,__IPHONE_4_2);


 *  coordinate
 *
 *  Discussion:
 *    Returns the coordinate of the current location.

@property(readonly, nonatomic) CLLocationCoordinate2D coordinate;


 *  altitude
 *
 *  Discussion:
 *    Returns the altitude of the location. Can be positive (above sea level) or negative (below sea level).

@property(readonly, nonatomic) CLLocationDistance altitude;


 *  horizontalAccuracy
 *
 *  Discussion:
 *    Returns the horizontal accuracy of the location. Negative if the lateral location is invalid.

@property(readonly, nonatomic) CLLocationAccuracy horizontalAccuracy;


 *  verticalAccuracy
 *
 *  Discussion:
 *    Returns the vertical accuracy of the location. Negative if the altitude is invalid.

@property(readonly, nonatomic) CLLocationAccuracy verticalAccuracy;


 *  course
 *
 *  Discussion:
 *    Returns the course of the location in degrees true North. Negative if course is invalid.
 *
 *  Range:
 *    0.0 - 359.9 degrees, 0 being true North

@property(readonly, nonatomic) CLLocationDirection course __OSX_AVAILABLE_STARTING(__MAC_10_7,__IPHONE_2_2);


 *  speed
 *
 *  Discussion:
 *    Returns the speed of the location in m/s. Negative if speed is invalid.

@property(readonly, nonatomic) CLLocationSpeed speed __OSX_AVAILABLE_STARTING(__MAC_10_7,__IPHONE_2_2);


 *  timestamp
 *
 *  Discussion:
 *    Returns the timestamp when this location was determined.

@property(readonly, nonatomic) NSDate *timestamp;


 *  description
 *
 *  Discussion:
 *    Returns a string representation of the location.

- (NSString *)description;


 *  getDistanceFrom:
 *
 *  Discussion:
 *    Deprecated. Use -distanceFromLocation: instead.

- (CLLocationDistance)getDistanceFrom:(const CLLocation *)location __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_NA,__MAC_NA,__IPHONE_2_0,__IPHONE_3_2);


 *  distanceFromLocation:
 *
 *  Discussion:
 *    Returns the lateral distance between two locations.

- (CLLocationDistance)distanceFromLocation:(const CLLocation *)location __OSX_AVAILABLE_STARTING(__MAC_10_6,__IPHONE_3_2);

@end

*/

#endif /* AG_MAP_DATA_STRUCT */