AfrigisMapSDK.hpp

/*
 * Copyright (c) 2011, 2012 Research In Motion Limited.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

#ifndef AFRIGISMAPSDK_HPP
#define AFRIGISMAPSDK_HPP

#include <QtCore/QObject>
#include <bb/system/SystemUiResult>
#include "AGMapDataStruct.hpp"

namespace bb
{
    namespace cascades
    {
        class Page;
        class AbsoluteLayoutProperties;
        class ForeignWindowControl;
        class Container;
    }
}

class ViewManager;
class MapServerRequest;
class AnnotationView;
class Item;
class PolylineItem;
class CircleItem;
class ImageItem;
class AGMapViewDelegate;

class AfrigisMapSDK : public QObject
{
    Q_OBJECT
    Q_ENUMS(ViewType)
//    Q_ENUMS(TrackMeType)
public:
    enum ViewType { SatelliteView, MapView };
//    enum TrackMeType { Accuracy, Direction };

public:

    AfrigisMapSDK(bb::cascades::Page *mapPage,double lat,double lon,int zoom, QString serviceName, QString serviceKey,
            AGMapViewDelegate* mapViewDelegate, ViewType viewType, int x, int y, int width, int height);

    AfrigisMapSDK(bb::cascades::Container *mapContainer, double lat, double lon, int zoom, QString serviceName,
            QString serviceKey, AGMapViewDelegate* mapViewDelegate, ViewType viewType, int x, int y, int width,
            int height, double scaleX = 1.0, double scaleY = 1.0);

    ~AfrigisMapSDK();

//    static void init(QString serviceName, QString serviceKey);

    void setViewType(ViewType viewType);

    AGLocalPixelCoordinate2D* getLocalPixelFromLatLon(AGLocationCoordinate2D *geoCoordinate);

    AGLocationCoordinate2D* getLatLonFromLocalPixel(AGLocalPixelCoordinate2D *pixelCoordinate);

    AGGeoInformation* getCurrentBoundingBox();
   /* void addPinView();
    void removePinView();*/

public slots:

    void clearMap();

//  void locateMe();

    void removeLocateMe();

    void trackMe(AGTrackMeType type);

    void enableLocatingUserInCenter(bool enable);

    void stopTracking();

    void stopAndRemoveTracking();

    void addTrafficLayer();

    void removeTrafficLayer();

    QObject* addRouteView(QList<QPair<float,float> > *routeGeoLocationCoordinates, bool startMarkerOn, bool endMarkerOn);

    void removeRouteView(QObject *routeView);

    void zoomToExtend(QList<AGLocationCoordinate2D> *listOfPoints);

    void addPinView(AGGeoInformation *geoInfo,QByteArray *imageData,bool callOutBubbleEnabled, bool contextMenuEnabled);

    void removePinView();

    AnnotationView* addAnnotationView(QList<Item*> *itemList = NULL);

    void removeAnnotationView(AnnotationView* annotationView);

    PolylineItem* createPolylineItem(QList<AGLocationCoordinate2D> *geoLocationCoordinates, bool enableZoomToExtend, AGOffsetInPixel offset = AGOffsetInPixel());

    CircleItem* createCircleItem(QList<AGLocationCoordinate2D> *circleCenter, float circleRadius, QColor *circleColor, AGOffsetInPixel offset = AGOffsetInPixel());

    ImageItem* createImageItem(QList<AGLocationCoordinate2D> *imageCenter, QByteArray *image, int imageWidth, int imageHeight, AGOffsetInPixel offset = AGOffsetInPixel());

    void updateLocation(AGLocationCoordinate2D *updatedLocationCoordinate = NULL, int zoomLevel = 0);

    void pauseRender();

    void resumeRender();

    void enableZoomInOutButton(bool zoomInOutButtonEnabled);

    bool isBubbleTouched(double localX, double localY);

    void setBubbleEnabled(bool bubbleStatus);

    bool isBubbleEnabled();

private slots:

    void onTrackingStarted(AGSignalType , QList<QVariant>);

    void onTrackingStopped(AGSignalType , QList<QVariant>);

    void onUserLocated(AGSignalType , QList<QVariant>);

    void onUserLocatingFailed(AGSignalType , QList<QVariant>);

    void onMapViewTouchedDown(AGSignalType, AGGeoInformation*);

private:

    void connectSignals();

    void emitSignal(AGSignalType signalType, QList<QVariant> params);

private:

    static const int trafficLayerTimeout = 500;     //ms

    QString serviceName;

    QString serviceKey;

    ViewManager *viewManager;

    static MapServerRequest *serverRequest;

    AGMapViewDelegate *mapViewDelegate;

    bb::cascades::AbsoluteLayoutProperties *layoutProperties ;

    bb::cascades::ForeignWindowControl *foreignWindow;

    bb::cascades::Container* container;

    ViewType viewType;

signals:

    void signalTrackingStarted();

    void signalTrackingStopped();

    void signalUserLocatedWithAccuracy(int);

    void signalUserLocatingFailed();

    void signalMapViewTouchedDown(AGGeoInformation*);
};

#endif // ifndef AFRIGISMAPSDK_HPP