|
|
              
Qt Location Nokia PluginOverviewIncluded with Qt Location is a geo services plugin which accesses the relevant Nokia services provided by Nokia. The use of these services is governed by the terms and conditions available at Qt Location Nokia Plugin - Nokia Services Terms and Conditions. Note that accepting the terms and conditions only applies those terms and conditions to the use of the Nokia geo services plugin and does not limit the use of the other geo services plugins that may be included with Qt. The Nokia geo services plugin requires an application id and token pair to authenticate the application with the Nokia services. To obtain an application id and token pair visit https://api.developer.nokia.com/ The Nokia geo services plugin can be loaded by using the plugin key "nokia". The online plugin uses the tiled map classes, which caches tile data in heap memory and texture memory. ParametersThe following table lists optional parameters that can be passed to the Nokia plugin.
Parameter Usage ExampleThe following two examples show how to create a Nokia plugin instance with a proxy server set for use with routing, and a routing token unique to the application. QML Plugin {
name: "nokia"
PluginParameter { name: "proxy"; value: "system" }
PluginParameter { name: "token"; value: "abcdefg12345" }
}
C++QMap<QString,QVariant> params; params["proxy"] = "system"; params["token"] = "abcdefg12345"; QGeoServiceProvider *gsp = new QGeoServiceProvider("nokia", params); PlacesThe Nokia provider remotely accesses places (read-only) from a REST based server. The specific capabilities and behaviours are outlined below: Capabilities
Plugin Specific Behaviors and Limitations.SearchThe following list shows what core place data is returned during a place search:
The following list shows further details that may be retrieved via QPlaceManager::getDetails()
Searching for PlacesSearch Term and CategoriesThe nokia plugin supports searching with a search term and category or categories, however both are not supported simultaneously.
This limitation applies when using the nokia plugin with PlaceSearchModel and QPlaceManager::search(). Search AreaThe nokia plugin only supports provision of a search center when searching for places via PlaceSearchModel and QPlaceManager::search(). A search center can be provided via a bounding circle, however the radius should be kept at the default value of -1. Typically a developer should not have to set the radius at all. If a developer sets a radius, it is ignored by the plugin and the boundaries are not honored. In a similar manner only the center of a bounding box is taken into consideration when searching. The boundaries of the box are not honored. A search center must be provided for all searches. Search Term suggestionsOnly a partial search term and search center is supported when retrieving suggestions. This limitation applies when using the nokia plugin with the PlaceSearchSuggestionModel and QPlaceManager::searchSuggestions(). Both search term and search center must be provided when retrieving search term suggestions. RecommendationsOnly a given place identifier is supported as a parameter for a recommendations. No other parameters such as limit, offset, and search area are supported. This limitation applies when using the nokia plugin with PlaceRecommendationModel and QPlaceManager::recommendations(). Icons themes, base urls and variantsIcons are provided in the form of "base urls" which reference valid icon images. For example, if the "wp7_dark" theme was specified, then an icon url might look something like http://<server>/01.icon.wp7_dark and this references an actual icon image. However these urls are "base urls" in the sense that they can be appended onto, to provide variants. For example, one could add ".list.png" to the above url to get the list variant of the icon, http://<server>/01.icon.wp7_dark.list.png. The following table shows the themes provided by the nokia plugin, along with any variants supported for those themes:
|
