MeeGo 1.2 Harmattan Developer Documentation Develop for the Nokia N9

QGeoMappingManager Class Reference

The QGeoMappingManager class provides support for displaying and interacting with maps. More...

 #include <QGeoMappingManager>

Inherits: QObject.

This class was introduced in Qt Mobility 1.1.

Public Functions

~QGeoMappingManager ()
QGeoMapData * createMapData ()
QLocale locale () const
QString managerName () const
int managerVersion () const
qreal maximumTilt () const
qreal maximumZoomLevel () const
qreal minimumTilt () const
qreal minimumZoomLevel () const
void setLocale ( const QLocale & locale )
QList<QGraphicsGeoMap::ConnectivityMode> supportedConnectivityModes () const
QList<QGraphicsGeoMap::MapType> supportedMapTypes () const
bool supportsBearing () const
bool supportsCustomMapObjects () const
bool supportsTilting () const
  • 29 public functions inherited from QObject

Additional Inherited Members

  • 1 property inherited from QObject
  • 1 public slot inherited from QObject
  • 1 signal inherited from QObject
  • 1 public variable inherited from QObject
  • 4 static public members inherited from QObject
  • 7 protected functions inherited from QObject
  • 2 protected variables inherited from QObject

Detailed Description

The QGeoMappingManager class provides support for displaying and interacting with maps.

A QGeoMappingManager instance can create QGeoMapData instances with createMapData(). The QGeoMapData instances can be used to contain and manage information concerning what a particular QGraphicsGeoMap is viewing.

The functions in this class will typically not be used by clients of this API, as the most common uses will only need to obtain a QGeoMappingManager instance and associate it with a QGraphicsGeoMap instance:

 QGeoServiceProvider serviceProvider("nokia");
 QGeoMappingManager *manager = serviceProvider.mappingManager();
 QGraphicsGeoMap *geoMap = new QGraphicsGeoMap(manager);

This could have been simplified by having the plugin return a QGraphicsGeoMap instance instead, but this approach allows users to subclass QGraphicsGeoMap in order to override the standard event handlers and implement custom map behaviours.

Member Function Documentation

QGeoMappingManager::~QGeoMappingManager ()

Destroys this mapping manager.

QGeoMapData * QGeoMappingManager::createMapData ()

Returns a new QGeoMapData instance which will be managed by this manager.

This function was introduced in Qt Mobility 1.1.

QLocale QGeoMappingManager::locale () const

Returns the locale used to hint to this mapping manager about what language to use for map labels.

This function was introduced in Qt Mobility 1.1.

See also setLocale().

QString QGeoMappingManager::managerName () const

Returns the name of the engine which implements the behaviour of this mapping manager.

The combination of managerName() and managerVersion() should be unique amongst the plugin implementations.

This function was introduced in Qt Mobility 1.1.

int QGeoMappingManager::managerVersion () const

Returns the version of the engine which implements the behaviour of this mapping manager.

The combination of managerName() and managerVersion() should be unique amongst the plugin implementations.

This function was introduced in Qt Mobility 1.1.

qreal QGeoMappingManager::maximumTilt () const

Returns maximum tilt supported by this manager.

Value in degrees where 0 is equivalent to 90 degrees between view and earth's surface i.e. looking straight down to earth.

This function was introduced in Qt Mobility 1.2.

qreal QGeoMappingManager::maximumZoomLevel () const

Returns the maximum zoom level supported by this manager.

Larger values of the zoom level correspond to more detailed views of the map.

This function was introduced in Qt Mobility 1.1.

qreal QGeoMappingManager::minimumTilt () const

Returns minimum tilt supported by this manager.

Value in degrees where 0 is equivalent to 90 degrees between view and earth's surface i.e. looking straight down to earth.

This function was introduced in Qt Mobility 1.2.

qreal QGeoMappingManager::minimumZoomLevel () const

Returns the minimum zoom level supported by this manager.

Larger values of the zoom level correspond to more detailed views of the map.

This function was introduced in Qt Mobility 1.1.

void QGeoMappingManager::setLocale ( const QLocale & locale )

Sets the locale to be used by the this manager to locale.

If this mapping manager supports returning map labels in different languages, they will be returned in the language of locale.

The locale used defaults to the system locale if this is not set.

This function was introduced in Qt Mobility 1.1.

See also locale().

QList<QGraphicsGeoMap::ConnectivityMode> QGeoMappingManager::supportedConnectivityModes () const

Returns a list of the connectivity modes supported by this manager.

This function was introduced in Qt Mobility 1.1.

QList<QGraphicsGeoMap::MapType> QGeoMappingManager::supportedMapTypes () const

Returns a list of the map types supported by this manager.

This function was introduced in Qt Mobility 1.1.

bool QGeoMappingManager::supportsBearing () const

Return whether bearing is supported by this manager.

This function was introduced in Qt Mobility 1.2.

bool QGeoMappingManager::supportsCustomMapObjects () const

Returns whether custom map objects are supported by this engine.

Custom map objects are map objects based on QGraphicsItem instances, which are hard to support in cases where the map rendering is not being performed by the Qt Graphics View framwork.

This function was introduced in Qt Mobility 1.2.

bool QGeoMappingManager::supportsTilting () const

Return whether tilting is supported by this manager.

This function was introduced in Qt Mobility 1.2.