Qt Mobility Reference Documentation

QML Map Element

The Map element displays a map. More...

Properties

Methods

Detailed Description

The Map element can be used be used to display a map of the world. The bulk of the functionality is provided by a mapping plugin described by the Plugin element associated with the Map.

Various map objects can be added to the map. These map objects are specified in terms of coordinates and metres.

The Map element is part of the QtMobility.location 1.1 module.


Property Documentation

center : Coordinate

This property holds the coordinate which occupies the center of the mapping viewport.

The default value is an arbitrary valid coordinate.


connectivityMode : enumeration

This property holds the connectivity mode used to fetch the map data.

The mode can be one of:

  • Map.OfflineMode
  • Map.OnlineMode
  • Map.HybridMode

The default value is determined by the plugin.


mapType : enumeration

This property holds the type of map to display.

The type can be one of:

  • Map.StreetMap
  • Map.SatelliteMapDay
  • Map.SatelliteMapNight
  • Map.TerrainMap

The default value is determined by the plugin.


maximumZoomLevel : qreal

This property holds the maximum valid zoom level for the map.


minimumZoomLevel : qreal

This property holds the minimum valid zoom level for the map.


defaultobjects : list<QGeoMapObject>

This property holds the list of objects associated with this map.

The various objects that can be added include:


plugin : Plugin

This property holds the plugin which provides the mapping functionality.

This is write-once property. Once the map has a plugin associated with it any attempted modifications of the plugin will be ignored.


size : QSizeF

This property holds the size of the map viewport.


zoomLevel : qreal

This property holds the zoom level for the map.

Larger values for the zoom level provide more detail.

The default value is 8.0.


Method Documentation

Map::toCoordinate ( QPointF screenPosition )

Returns the coordinate which corresponds to the screen position screenPosition.

Returns an invalid coordinate if screenPosition is not within the current viewport.


Map::toScreenPosition ( Coordinate coordinate )

Returns the screen position which corresponds to the coordinate coordinate.

Returns an invalid QPointF if coordinate is not within the current viewport.


X

Thank you for giving your feedback.

Make sure it is related to this specific page. For more general bugs and requests, please use the Qt Bug Tracker.