/usr/share/qt5/doc/qtlocation/qml-qtlocation-plugin.html is in qtlocation5-doc-html 5.2.1-1ubuntu2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 | <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en_US" lang="en_US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- qdeclarativegeoserviceprovider.cpp -->
<title>Plugin | QtLocation 5.2</title>
<link rel="stylesheet" type="text/css" href="style/offline.css" />
</head>
<body>
<div class="header" id="qtdocheader">
<div class="main">
<div class="main-rounded">
<div class="navigationbar">
<ul>
<li>Qt 5.2</li>
<li><a href="qtlocation-index.html">Qt Location</a></li>
<li><a href="qtlocation-qmlmodule.html">QML Types</a></li>
<li>Plugin</li>
<li id="buildversion">
Qt 5.2.1 Reference Documentation</li>
</ul>
</div>
</div>
<div class="content">
<div class="line">
<div class="content mainContent">
<div class="toc">
<h3><a name="toc">Contents</a></h3>
<ul>
<li class="level1"><a href="#properties">Properties</a></li>
<li class="level1"><a href="#methods">Methods</a></li>
<li class="level1"><a href="#details">Detailed Description</a></li>
<li class="level2"><a href="#example-usage">Example Usage</a></li>
</ul>
</div>
<h1 class="title">Plugin</h1>
<span class="subtitle"></span>
<!-- $$$Plugin-brief -->
<p>The Plugin type describes a Location based services plugin. <a href="#details">More...</a></p>
<!-- @@@Plugin -->
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> Import Statement:</td><td class="memItemRight bottomAlign"> </b><tt>import QtLocation 5.0</tt></td></tr><tr><td class="memItemLeft rightAlign topAlign"> Since:</td><td class="memItemRight bottomAlign"> Qt Location 5.0</td></tr></table><ul>
<li><a href="qml-qtlocation-plugin-members.html">List of all members, including inherited members</a></li>
</ul>
<a name="properties"></a>
<h2>Properties</h2>
<ul>
<li class="fn"><b><b><a href="qml-qtlocation-plugin.html#allowExperimental-prop">allowExperimental</a></b></b> : bool</li>
<li class="fn"><b><b><a href="qml-qtlocation-plugin.html#availableServiceProviders-prop">availableServiceProviders</a></b></b> : stringlist</li>
<li class="fn"><b><b><a href="qml-qtlocation-plugin.html#isAttached-prop">isAttached</a></b></b> : bool</li>
<li class="fn"><b><b><a href="qml-qtlocation-plugin.html#locales-prop">locales</a></b></b> : stringlist</li>
<li class="fn"><b><b><a href="qml-qtlocation-plugin.html#name-prop">name</a></b></b> : string</li>
<li class="fn"><b><b><a href="qml-qtlocation-plugin.html#parameters-prop">parameters</a></b></b> : list<PluginParameter></li>
<li class="fn"><b><b><a href="qml-qtlocation-plugin.html#preferred-prop">preferred</a></b></b> : stringlist</li>
<li class="fn"><b><b><a href="qml-qtlocation-plugin.html#required-prop">required</a></b></b> : enumeration</li>
</ul>
<a name="methods"></a>
<h2>Methods</h2>
<ul>
<li class="fn">bool <b><b><a href="qml-qtlocation-plugin.html#supportsGeocoding-method">supportsGeocoding</a></b></b>(GeocodingFeatures <i>features</i>)</li>
<li class="fn">bool <b><b><a href="qml-qtlocation-plugin.html#supportsMapping-method">supportsMapping</a></b></b>(MappingFeatures <i>features</i>)</li>
<li class="fn">bool <b><b><a href="qml-qtlocation-plugin.html#supportsPlaces-method">supportsPlaces</a></b></b>(PlacesFeatures <i>features</i>)</li>
<li class="fn">bool <b><b><a href="qml-qtlocation-plugin.html#supportsRouting-method">supportsRouting</a></b></b>(RoutingFeatures <i>features</i>)</li>
</ul>
<!-- $$$Plugin-description -->
<a name="details"></a>
<h2>Detailed Description</h2>
<p>The Plugin type is used to declaratively specify which available GeoServices plugin should be used for various tasks in the Location API. Plugins are used by <a href="qml-qtlocation-map.html">Map</a>, <a href="qml-qtlocation-routemodel.html">RouteModel</a>, and <a href="qml-qtlocation-geocodemodel.html">GeocodeModel</a> types, as well as a variety of others.</p>
<p>Plugins recognized by the system have a <a href="qml-qtlocation-plugin.html#name-prop">name</a> property, a simple string normally indicating the name of the service that the Plugin retrieves data from. They also have a variety of features, which can be test for using the <a href="qml-qtlocation-plugin.html#supportsRouting-method">supportsRouting()</a>, <a href="qml-qtlocation-plugin.html#supportsGeocoding-method">supportsGeocoding()</a>, <a href="qml-qtlocation-plugin.html#supportsMapping-method">supportsMapping()</a> and <a href="qml-qtlocation-plugin.html#supportsPlaces-method">supportsPlaces()</a> methods.</p>
<p>When a Plugin object is created, it is "detached" and not associated with any actual service plugin. Once it has received information via setting its <a href="qml-qtlocation-plugin.html#name-prop">name</a>, <a href="qml-qtlocation-plugin.html#preferred-prop">preferred</a>, or <a href="qml-qtlocation-plugin.html#required-prop">required</a> properties, it will choose an appropriate service plugin to attach to. Plugin objects can only be attached once; to use multiple plugins, create multiple Plugin objects.</p>
<a name="example-usage"></a>
<h3>Example Usage</h3>
<p>The following snippet shows a Plugin object being created with the <a href="qml-qtlocation-plugin.html#required-prop">required</a> and <a href="qml-qtlocation-plugin.html#preferred-prop">preferred</a> properties set. This Plugin will attach to the first plugin found plugin that supports both mapping and geocoding, and will prefer plugins named "nokia" or "foo" to any others.</p>
<pre class="cpp">Plugin {
id: plugin
preferred: <span class="operator">[</span><span class="string">"nokia"</span><span class="operator">,</span> <span class="string">"foo"</span><span class="operator">]</span>
required: Plugin<span class="operator">.</span>AnyMappingFeatures <span class="operator">|</span> Plugin<span class="operator">.</span>AnyGeocodingFeatures
}</pre>
<!-- @@@Plugin -->
<h2>Property Documentation</h2>
<!-- $$$allowExperimental -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlPropNode"><p><a name="allowExperimental-prop"></a><span class="name">allowExperimental</span> : <span class="type">bool</span></p></td></tr></table></div><div class="qmldoc"><p>This property indicates if experimental plugins can be used.</p>
</div></div><!-- @@@allowExperimental -->
<br/>
<!-- $$$availableServiceProviders -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlPropNode"><p><a name="availableServiceProviders-prop"></a><span class="name">availableServiceProviders</span> : <span class="type">stringlist</span></p></td></tr></table></div><div class="qmldoc"><p>This property holds a list of all available service plugins' names. This can be used to manually enumerate the available plugins if the control provided by <a href="qml-qtlocation-plugin.html#name-prop">name</a> and <a href="qml-qtlocation-plugin.html#required-prop">required</a> is not sufficient for your needs.</p>
</div></div><!-- @@@availableServiceProviders -->
<br/>
<!-- $$$isAttached -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlPropNode"><p><a name="isAttached-prop"></a><span class="name">isAttached</span> : <span class="type">bool</span></p></td></tr></table></div><div class="qmldoc"><p>This property indicates if the Plugin is attached to another Plugin.</p>
</div></div><!-- @@@isAttached -->
<br/>
<!-- $$$locales -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlPropNode"><p><a name="locales-prop"></a><span class="name">locales</span> : <span class="type">stringlist</span></p></td></tr></table></div><div class="qmldoc"><p>This property contains an ordered list of preferred plugin locales. If the first locale cannot be accommodated, then the backend falls back to using the second, and so on. By default the locales property contains the system locale.</p>
<p>The locales are specified as strings which have the format "language[_script][_country]" or "C", where:</p>
<ul>
<li>language is a lowercase, two-letter, ISO 639 language code,</li>
<li>script is a titlecase, four-letter, ISO 15924 script code,</li>
<li>country is an uppercase, two- or three-letter, ISO 3166 country code (also "419" as defined by United Nations),</li>
<li>the "C" locale is identical in behavior to English/UnitedStates as per QLocale</li>
</ul>
<p>If the first specified locale cannot be accommodated, the <a href="qml-qtlocation-plugin.html">Plugin</a> falls back to the next and so forth. Some <a href="qml-qtlocation-plugin.html">Plugin</a> backends may not support a set of locales which are rigidly defined. An arbitrary example is that some <a href="qml-qtlocation-place.html">Place</a>'s in France could have French and English localizations, while certain areas in America may only have the English localization available. In the above scenario, the set of supported locales is context dependent on the search location.</p>
<p>If the <a href="qml-qtlocation-plugin.html">Plugin</a> cannot accommodate any of the preferred locales, the manager falls back to using a supported language that is backend specific.</p>
<p>For <a href="qml-qtlocation-plugin.html">Plugin</a>'s that do not support locales, the locales list is always empty.</p>
<p>The following code demonstrates how to set a single and multiple locales:</p>
<pre class="qml"><span class="comment">//single locale</span>
<span class="type"><a href="qml-qtlocation-plugin.html">Plugin</a></span> {
<span class="name">locales</span>: <span class="string">"en_US"</span>
}
<span class="comment">//multiple locales</span>
<span class="type"><a href="qml-qtlocation-plugin.html">Plugin</a></span> {
<span class="name">locales</span>: [<span class="string">"fr_FR"</span>,<span class="string">"en_US"</span>]
}</pre>
</div></div><!-- @@@locales -->
<br/>
<!-- $$$name -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlPropNode"><p><a name="name-prop"></a><span class="name">name</span> : <span class="type">string</span></p></td></tr></table></div><div class="qmldoc"><p>This property holds the name of the plugin. Setting this property will cause the Plugin to only attach to a plugin with exactly this name. The value of <a href="qml-qtlocation-plugin.html#required-prop">required</a> will be ignored.</p>
</div></div><!-- @@@name -->
<br/>
<!-- $$$parameters -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlPropNode"><p><a name="parameters-prop"></a><span class="qmldefault">default</span><span class="name">parameters</span> : <span class="type">list</span><<span class="type"><a href="qml-qtlocation-pluginparameter.html">PluginParameter</a></span>></p></td></tr></table></div><div class="qmldoc"><p>This property holds the list of plugin parameters.</p>
</div></div><!-- @@@parameters -->
<br/>
<!-- $$$preferred -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlPropNode"><p><a name="preferred-prop"></a><span class="name">preferred</span> : <span class="type">stringlist</span></p></td></tr></table></div><div class="qmldoc"><p>This property contains an ordered list of preferred plugin names, which will be checked for the required features set in <a href="qml-qtlocation-plugin.html#required-prop">required</a> before any other available plugins are checked.</p>
</div></div><!-- @@@preferred -->
<br/>
<!-- $$$required -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlPropNode"><p><a name="required-prop"></a><span class="name">required</span> : <span class="type">enumeration</span></p></td></tr></table></div><div class="qmldoc"><p>This property contains the set of features that will be required by the Plugin object when choosing which service plugin to attach to. If the <a href="qml-qtlocation-plugin.html#name-prop">name</a> property is set, this has no effect.</p>
<p>Any of the following values or a bitwise combination of multiple values may be set:</p>
<ul>
<li>Plugin.NoFeatures</li>
<li>Plugin.GeocodingFeature</li>
<li>Plugin.ReverseGeocodingFeature</li>
<li>Plugin.RoutingFeature</li>
<li>Plugin.MappingFeature</li>
<li>Plugin.AnyPlacesFeature</li>
</ul>
</div></div><!-- @@@required -->
<br/>
<h2>Method Documentation</h2>
<!-- $$$supportsGeocoding -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlFuncNode"><p><a name="supportsGeocoding-method"></a><span class="type">bool</span> <span class="name">supportsGeocoding</span>(<span class="type">GeocodingFeatures</span><i> features</i>)</p></td></tr></table></div><div class="qmldoc"><p>This method returns a boolean indicating whether the specified set of <i>features</i> are supported by the geo service provider plugin. True is returned if all specified <i>features</i> are supported; otherwise false is returned.</p>
<p>The <i>features</i> parameter can be any flag combination of:</p>
<table class="generic">
<thead><tr class="qt-style"><th >Feature</th><th >Description</th></tr></thead>
<tr valign="top" class="odd"><td >Plugin.NoGeocodingFeatures</td><td >No geocoding features are supported.</td></tr>
<tr valign="top" class="even"><td >Plugin.OnlineGeocodingFeature</td><td >Online geocoding is supported.</td></tr>
<tr valign="top" class="odd"><td >Plugin.OfflineGeocodingFeature</td><td >Offline geocoding is supported.</td></tr>
<tr valign="top" class="even"><td >Plugin.ReverseGeocodingFeature</td><td >Reverse geocoding is supported.</td></tr>
<tr valign="top" class="odd"><td >Plugin.LocalizedGeocodingFeature</td><td >Supports returning geocoding results with localized addresses.</td></tr>
<tr valign="top" class="even"><td >Plugin.AnyGeocodingFeatures</td><td >Matches a geo service provider that provides any geocoding features.</td></tr>
</table>
</div></div><!-- @@@supportsGeocoding -->
<br/>
<!-- $$$supportsMapping -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlFuncNode"><p><a name="supportsMapping-method"></a><span class="type">bool</span> <span class="name">supportsMapping</span>(<span class="type">MappingFeatures</span><i> features</i>)</p></td></tr></table></div><div class="qmldoc"><p>This method returns a boolean indicating whether the specified set of <i>features</i> are supported by the geo service provider plugin. True is returned if all specified <i>features</i> are supported; otherwise false is returned.</p>
<p>The <i>features</i> parameter can be any flag combination of:</p>
<table class="generic">
<thead><tr class="qt-style"><th >Feature</th><th >Description</th></tr></thead>
<tr valign="top" class="odd"><td >Plugin.NoMappingFeatures</td><td >No mapping features are supported.</td></tr>
<tr valign="top" class="even"><td >Plugin.OnlineMappingFeature</td><td >Online mapping is supported.</td></tr>
<tr valign="top" class="odd"><td >Plugin.OfflineMappingFeature</td><td >Offline mapping is supported.</td></tr>
<tr valign="top" class="even"><td >Plugin.LocalizedMappingFeature</td><td >Supports returning localized map data.</td></tr>
<tr valign="top" class="odd"><td >Plugin.AnyMappingFeatures</td><td >Matches a geo service provider that provides any mapping features.</td></tr>
</table>
</div></div><!-- @@@supportsMapping -->
<br/>
<!-- $$$supportsPlaces -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlFuncNode"><p><a name="supportsPlaces-method"></a><span class="type">bool</span> <span class="name">supportsPlaces</span>(<span class="type">PlacesFeatures</span><i> features</i>)</p></td></tr></table></div><div class="qmldoc"><p>This method returns a boolean indicating whether the specified set of <i>features</i> are supported by the geo service provider plugin. True is returned if all specified <i>features</i> are supported; otherwise false is returned.</p>
<p>The <i>features</i> parameter can be any flag combination of:</p>
<table class="generic">
<thead><tr class="qt-style"><th >Feature</th><th >Description</th></tr></thead>
<tr valign="top" class="odd"><td >Plugin.NoPlacesFeatures</td><td >No places features are supported.</td></tr>
<tr valign="top" class="even"><td >Plugin.OnlinePlacesFeature</td><td >Online places is supported.</td></tr>
<tr valign="top" class="odd"><td >Plugin.OfflinePlacesFeature</td><td >Offline places is supported.</td></tr>
<tr valign="top" class="even"><td >Plugin.SavePlaceFeature</td><td >Saving categories is supported.</td></tr>
<tr valign="top" class="odd"><td >Plugin.RemovePlaceFeature</td><td >Removing or deleting places is supported.</td></tr>
<tr valign="top" class="even"><td >Plugin.PlaceRecommendationsFeature</td><td >Searching for recommended places similar to another place is supported.</td></tr>
<tr valign="top" class="odd"><td >Plugin.SearchSuggestionsFeature</td><td >Search suggestions is supported.</td></tr>
<tr valign="top" class="even"><td >Plugin.LocalizedPlacesFeature</td><td >Supports returning localized place data.</td></tr>
<tr valign="top" class="odd"><td >Plugin.NotificationsFeature</td><td >Notifications of place and category changes is supported.</td></tr>
<tr valign="top" class="even"><td >Plugin.PlaceMatchingFeature</td><td >Supports matching places from two different geo service providers.</td></tr>
<tr valign="top" class="odd"><td >Plugin.AnyPlacesFeatures</td><td >Matches a geo service provider that provides any places features.</td></tr>
</table>
</div></div><!-- @@@supportsPlaces -->
<br/>
<!-- $$$supportsRouting -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlFuncNode"><p><a name="supportsRouting-method"></a><span class="type">bool</span> <span class="name">supportsRouting</span>(<span class="type">RoutingFeatures</span><i> features</i>)</p></td></tr></table></div><div class="qmldoc"><p>This method returns a boolean indicating whether the specified set of <i>features</i> are supported by the geo service provider plugin. True is returned if all specified <i>features</i> are supported; otherwise false is returned.</p>
<p>The <i>features</i> parameter can be any flag combination of:</p>
<table class="generic">
<thead><tr class="qt-style"><th >Feature</th><th >Description</th></tr></thead>
<tr valign="top" class="odd"><td >Plugin.NoRoutingFeatures</td><td >No routing features are supported.</td></tr>
<tr valign="top" class="even"><td >Plugin.OnlineRoutingFeature</td><td >Online routing is supported.</td></tr>
<tr valign="top" class="odd"><td >Plugin.OfflineRoutingFeature</td><td >Offline routing is supported.</td></tr>
<tr valign="top" class="even"><td >Plugin.LocalizedRoutingFeature</td><td >Supports returning routes with localized addresses and instructions.</td></tr>
<tr valign="top" class="odd"><td >Plugin.RouteUpdatesFeature</td><td >Updating an existing route based on the current position is supported.</td></tr>
<tr valign="top" class="even"><td >Plugin.AlternativeRoutesFeature</td><td >Supports returning alternative routes.</td></tr>
<tr valign="top" class="odd"><td >Plugin.ExcludeAreasRoutingFeature</td><td >Supports specifying a areas which the returned route must not cross.</td></tr>
<tr valign="top" class="even"><td >Plugin.AnyRoutingFeatures</td><td >Matches a geo service provider that provides any routing features.</td></tr>
</table>
</div></div><!-- @@@supportsRouting -->
<br/>
</div>
</div>
</div>
</div>
</div>
<div class="footer">
<p>
<acronym title="Copyright">©</acronym> 2013 Digia Plc and/or its
subsidiaries. Documentation contributions included herein are the copyrights of
their respective owners.<br> The documentation provided herein is licensed under the terms of the <a href="http://www.gnu.org/licenses/fdl.html">GNU Free Documentation License version 1.3</a> as published by the Free Software Foundation.<br> Digia, Qt and their respective logos are trademarks of Digia Plc in Finland and/or other countries worldwide. All other trademarks are property
of their respective owners. </p>
</div>
</body>
</html>
|