diff options
author | Paolo Angelelli <paolo.angelelli@theqtcompany.com> | 2016-07-26 16:45:37 +0200 |
---|---|---|
committer | Paolo Angelelli <paolo.angelelli@theqtcompany.com> | 2016-07-29 14:13:39 +0000 |
commit | e7099f14c8faea4fb7c89877973b7cec75044cb3 (patch) | |
tree | 773b6ef8f73359c256c4cb442ae4391a4a3d02e8 /src/location/doc/src/plugins/osm.qdoc | |
parent | 75dd424e11964d8755abdb1b12b27a8479353b37 (diff) | |
download | qtlocation-e7099f14c8faea4fb7c89877973b7cec75044cb3.tar.gz |
Enable dynamic addition/removal of map types by the mapping manager
Map types are currently fixed in the constructor, regardless of whether
they were available, or, now, whether they are enabled or not.
This patch makes the geomappingmanager notify (e.g., emit a signal)
when the available map types change at runtime. This is used in the
OSM mappingmanagerengine, which can now disable map types if provider
records turn out to be invalid or disabled after they have been
fetched.
Change-Id: I8e0e75504c882609f91c6d1ceb88424eee656f26
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
Reviewed-by: Alex Blasche <alexander.blasche@qt.io>
Diffstat (limited to 'src/location/doc/src/plugins/osm.qdoc')
-rw-r--r-- | src/location/doc/src/plugins/osm.qdoc | 9 |
1 files changed, 7 insertions, 2 deletions
diff --git a/src/location/doc/src/plugins/osm.qdoc b/src/location/doc/src/plugins/osm.qdoc index 2fd9e7c4..75ac104d 100644 --- a/src/location/doc/src/plugins/osm.qdoc +++ b/src/location/doc/src/plugins/osm.qdoc @@ -37,12 +37,17 @@ This geo services plugin allows applications to access \l {http://openstreetmap.org}{Open Street Map} location based services using the Qt Location API. -Data, imagery and map information provided by \l {http://www.mapquest.com}{MapQuest}, +Data, imagery and map information provided by \l {http://korona.geog.uni-heidelberg.de/}{OpenMapSurfer}, \l {http://www.thunderforest.com/}{ThunderForest}, OpenStreetMap and contributors. The data is available under the \l {http://www.opendatacommons.org/licenses/odbl}{Open Database License}. The Open Street Map geo services plugin can be loaded by using the plugin key "osm". +\note Since Qt 5.6.2, the available map types offered by this plugin may change without notice depending on the +actual availability of each provider. To prevent these changes, either a different geo service plugin should be used, or the plugin +parameter \e osm.mapping.providersrepository.address should be set to a user-specified repository, in order to take full control over +(and accept \b responsibility for) selecting the provider that is used for each map type. + \section1 Parameters \section2 Optional parameters @@ -78,7 +83,7 @@ a prefix. \li The OpenStreetMap plugin retrieves the provider's information from a remote repository. This is done to prevent using hardcoded servers by default, which may become unavailable. By default this information is fetched from \l {http://maps-redirect.qt.io} {maps-redirect.qt.io}. Setting this parameter changes the provider repository address to a user-specified one, which must contain the files - \tt{street}, \tt{satellite}, \tt{cycle}, \tt{transit}, \tt{night-transit}, \tt{terrain} and \tt{hiking}. + \tt{street}, \tt{satellite}, \tt{cycle}, \tt{transit}, \tt{night-transit}, \tt{terrain} and \tt{hiking}, each of which must contain valid provider information. \row \li osm.mapping.providersrepository.disabled \li By default, the OpenStreetMap plugin retrieves the provider's information from a remote repository to avoid a loss of service due to unavailability of hardcoded services. |