/usr/share/qt5/doc/qtlocation/qgeocodingmanagerengine.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 | <?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" />
<!-- qgeocodingmanagerengine.cpp -->
<title>QGeoCodingManagerEngine Class | 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-module.html">C++ Classes</a></li>
<li>QGeoCodingManagerEngine</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="#public-functions">Public Functions</a></li>
<li class="level1"><a href="#signals">Signals</a></li>
<li class="level1"><a href="#details">Detailed Description</a></li>
</ul>
</div>
<h1 class="title">QGeoCodingManagerEngine Class</h1>
<!-- $$$QGeoCodingManagerEngine-brief -->
<p>The QGeoCodingManagerEngine class provides an interface and convenience methods to implementers of <a href="qgeoserviceprovider.html">QGeoServiceProvider</a> plugins who want to provide support for geocoding operations. <a href="#details">More...</a></p>
<!-- @@@QGeoCodingManagerEngine -->
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> Header:</td><td class="memItemRight bottomAlign"> </b><tt><span class="preprocessor">#include <QGeoCodingManagerEngine></span>
</tt></td></tr><tr><td class="memItemLeft rightAlign topAlign"> qmake:</td><td class="memItemRight bottomAlign"> <tt>QT += location</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="qgeocodingmanagerengine-members.html">List of all members, including inherited members</a></li>
</ul>
<a name="public-functions"></a>
<h2>Public Functions</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qgeocodingmanagerengine.html#QGeoCodingManagerEngine">QGeoCodingManagerEngine</a></b>(const QMap<QString, QVariant> &<i> parameters</i>, QObject *<i> parent</i> = 0)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual </td><td class="memItemRight bottomAlign"><b><a href="qgeocodingmanagerengine.html#dtor.QGeoCodingManagerEngine">~QGeoCodingManagerEngine</a></b>()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual QGeoCodeReply * </td><td class="memItemRight bottomAlign"><b><a href="qgeocodingmanagerengine.html#geocode">geocode</a></b>(const QGeoAddress &<i> address</i>, const QGeoShape &<i> bounds</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual QGeoCodeReply * </td><td class="memItemRight bottomAlign"><b><a href="qgeocodingmanagerengine.html#geocode-2">geocode</a></b>(const QString &<i> address</i>, int<i> limit</i>, int<i> offset</i>, const QGeoShape &<i> bounds</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QLocale </td><td class="memItemRight bottomAlign"><b><a href="qgeocodingmanagerengine.html#locale">locale</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qgeocodingmanagerengine.html#managerName">managerName</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> int </td><td class="memItemRight bottomAlign"><b><a href="qgeocodingmanagerengine.html#managerVersion">managerVersion</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual QGeoCodeReply * </td><td class="memItemRight bottomAlign"><b><a href="qgeocodingmanagerengine.html#reverseGeocode">reverseGeocode</a></b>(const QGeoCoordinate &<i> coordinate</i>, const QGeoShape &<i> bounds</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qgeocodingmanagerengine.html#setLocale">setLocale</a></b>(const QLocale &<i> locale</i>)</td></tr>
</table>
<a name="signals"></a>
<h2>Signals</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qgeocodingmanagerengine.html#error">error</a></b>(QGeoCodeReply *<i> reply</i>, QGeoCodeReply::Error<i> error</i>, QString<i> errorString</i> = QString())</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qgeocodingmanagerengine.html#finished">finished</a></b>(QGeoCodeReply *<i> reply</i>)</td></tr>
</table>
<a name="details"></a>
<!-- $$$QGeoCodingManagerEngine-description -->
<div class="descr">
<h2>Detailed Description</h2>
<p>The QGeoCodingManagerEngine class provides an interface and convenience methods to implementers of <a href="qgeoserviceprovider.html">QGeoServiceProvider</a> plugins who want to provide support for geocoding operations.</p>
<p>In the default implementation, supportsGeocoding() and supportsReverseGeocoding() returns false while <a href="qgeocodingmanagerengine.html#geocode">geocode</a>() and <a href="qgeocodingmanagerengine.html#reverseGeocode">reverseGeocode</a>() cause <a href="qgeocodereply.html#Error-enum">QGeoCodeReply::UnsupportedOptionError</a> to occur.</p>
<p>If the service provider supports geocoding the subclass should provide an implementation of <a href="qgeocodingmanagerengine.html#geocode">geocode</a>() and call setSupportsGeocoding(true) at some point in time before <a href="qgeocodingmanagerengine.html#geocode">geocode</a>() is called.</p>
<p>Similarly, if the service provider supports reverse geocoding the subclass should provide an implementation <a href="qgeocodingmanagerengine.html#reverseGeocode">reverseGeocode</a>() and call setSupportsReverseGeocoding(true) at some point in time before <a href="qgeocodingmanagerengine.html#reverseGeocode">reverseGeocode</a>() is called.</p>
<p>A subclass of QGeoCodingManagerEngine will often make use of a subclass fo <a href="qgeocodereply.html">QGeoCodeReply</a> internally, in order to add any engine-specific data (such as a QNetworkReply object for network-based services) to the <a href="qgeocodereply.html">QGeoCodeReply</a> instances used by the engine.</p>
</div>
<p><b>See also </b><a href="qgeocodingmanager.html">QGeoCodingManager</a>.</p>
<!-- @@@QGeoCodingManagerEngine -->
<div class="func">
<h2>Member Function Documentation</h2>
<!-- $$$QGeoCodingManagerEngine[overload1]$$$QGeoCodingManagerEngineconstQMap<QString,QVariant>&QObject* -->
<h3 class="fn"><a name="QGeoCodingManagerEngine"></a>QGeoCodingManagerEngine::<span class="name">QGeoCodingManagerEngine</span>(const <span class="type">QMap</span><<span class="type">QString</span>, <span class="type">QVariant</span>> &<i> parameters</i>, <span class="type">QObject</span> *<i> parent</i> = 0)</h3>
<p>Constructs a new engine with the specified <i>parent</i>, using <i>parameters</i> to pass any implementation specific data to the engine.</p>
<!-- @@@QGeoCodingManagerEngine -->
<!-- $$$~QGeoCodingManagerEngine[overload1]$$$~QGeoCodingManagerEngine -->
<h3 class="fn"><a name="dtor.QGeoCodingManagerEngine"></a>QGeoCodingManagerEngine::<span class="name">~QGeoCodingManagerEngine</span>()<tt> [virtual]</tt></h3>
<p>Destroys this engine.</p>
<!-- @@@~QGeoCodingManagerEngine -->
<!-- $$$error[overload1]$$$errorQGeoCodeReply*QGeoCodeReply::ErrorQString -->
<h3 class="fn"><a name="error"></a><span class="type">void</span> QGeoCodingManagerEngine::<span class="name">error</span>(<span class="type"><a href="qgeocodereply.html">QGeoCodeReply</a></span> *<i> reply</i>, <span class="type"><a href="qgeocodereply.html#Error-enum">QGeoCodeReply::Error</a></span><i> error</i>, <span class="type">QString</span><i> errorString</i> = QString())<tt> [signal]</tt></h3>
<p>This signal is emitted when an error has been detected in the processing of <i>reply</i>. The <a href="qgeocodingmanagerengine.html#finished">QGeoCodingManagerEngine::finished</a>() signal will probably follow.</p>
<p>The error will be described by the error code <i>error</i>. If <i>errorString</i> is not empty it will contain a textual description of the error.</p>
<p>This signal and <a href="qgeocodereply.html#error">QGeoCodeReply::error</a>() will be emitted at the same time.</p>
<p><b>Note: </b>Do not delete the <i>reply</i> object in the slot connected to this signal. Use deleteLater() instead.</p><!-- @@@error -->
<!-- $$$finished[overload1]$$$finishedQGeoCodeReply* -->
<h3 class="fn"><a name="finished"></a><span class="type">void</span> QGeoCodingManagerEngine::<span class="name">finished</span>(<span class="type"><a href="qgeocodereply.html">QGeoCodeReply</a></span> *<i> reply</i>)<tt> [signal]</tt></h3>
<p>This signal is emitted when <i>reply</i> has finished processing.</p>
<p>If reply::error() equals <a href="qgeocodereply.html#Error-enum">QGeoCodeReply::NoError</a> then the processing finished successfully.</p>
<p>This signal and <a href="qgeocodereply.html#finished">QGeoCodeReply::finished</a>() will be emitted at the same time.</p>
<p><b>Note: </b>Do not delete the <i>reply</i> object in the slot connected to this signal. Use deleteLater() instead.</p><!-- @@@finished -->
<!-- $$$geocode[overload1]$$$geocodeconstQGeoAddress&constQGeoShape& -->
<h3 class="fn"><a name="geocode"></a><span class="type"><a href="qgeocodereply.html">QGeoCodeReply</a></span> * QGeoCodingManagerEngine::<span class="name">geocode</span>(const <span class="type">QGeoAddress</span> &<i> address</i>, const <span class="type">QGeoShape</span> &<i> bounds</i>)<tt> [virtual]</tt></h3>
<p>Begins the geocoding of <i>address</i>. Geocoding is the process of finding a coordinate that corresponds to a given address.</p>
<p>A <a href="qgeocodereply.html">QGeoCodeReply</a> object will be returned, which can be used to manage the geocoding operation and to return the results of the operation.</p>
<p>This engine and the returned <a href="qgeocodereply.html">QGeoCodeReply</a> object will emit signals indicating if the operation completes or if errors occur.</p>
<p>If supportsGeocoding() returns false an <a href="qgeocodereply.html#Error-enum">QGeoCodeReply::UnsupportedOptionError</a> will occur.</p>
<p>Once the operation has completed, <a href="qgeocodereply.html#locations">QGeoCodeReply::locations</a>() can be used to retrieve the results, which will consist of a list of QGeoLocation objects. These objects represent a combination of coordinate and address data.</p>
<p>The address data returned in the results may be different from <i>address</i>. This will usually occur if the geocoding service backend uses a different canonical form of addresses or if <i>address</i> was only partially filled out.</p>
<p>If <i>bounds</i> is non-null and a valid QGeoShape it will be used to limit the results to those that are contained by <i>bounds</i>. This is particularly useful if <i>address</i> is only partially filled out, as the service will attempt to geocode all matches for the specified data.</p>
<p>The user is responsible for deleting the returned reply object, although this can be done in the slot connected to <a href="qgeocodingmanagerengine.html#finished">QGeoCodingManagerEngine::finished</a>(), <a href="qgeocodingmanagerengine.html#error">QGeoCodingManagerEngine::error</a>(), <a href="qgeocodereply.html#finished">QGeoCodeReply::finished</a>() or <a href="qgeocodereply.html#error">QGeoCodeReply::error</a>() with deleteLater().</p>
<!-- @@@geocode -->
<!-- $$$geocode$$$geocodeconstQString&intintconstQGeoShape& -->
<h3 class="fn"><a name="geocode-2"></a><span class="type"><a href="qgeocodereply.html">QGeoCodeReply</a></span> * QGeoCodingManagerEngine::<span class="name">geocode</span>(const <span class="type">QString</span> &<i> address</i>, <span class="type">int</span><i> limit</i>, <span class="type">int</span><i> offset</i>, const <span class="type">QGeoShape</span> &<i> bounds</i>)<tt> [virtual]</tt></h3>
<p>Begins geocoding for a location matching <i>address</i>.</p>
<p>A <a href="qgeocodereply.html">QGeoCodeReply</a> object will be returned, which can be used to manage the geocoding operation and to return the results of the operation.</p>
<p>This engine and the returned <a href="qgeocodereply.html">QGeoCodeReply</a> object will emit signals indicating if the operation completes or if errors occur.</p>
<p>Once the operation has completed, <a href="qgeocodereply.html#locations">QGeoCodeReply::locations</a>() can be used to retrieve the results, which will consist of a list of QGeoLocation objects. These objects represent a combination of coordinate and address data.</p>
<p>If <i>limit</i> is -1 the entire result set will be returned, otherwise at most <i>limit</i> results will be returned.</p>
<p>The <i>offset</i> parameter is used to ask the geocoding service to not return the first <i>offset</i> results.</p>
<p>The <i>limit</i> and <i>offset</i> results are used together to implement paging.</p>
<p>If <i>bounds</i> is non-null and a valid QGeoShape it will be used to limit the results to those that are contained by <i>bounds</i>.</p>
<p>The user is responsible for deleting the returned reply object, although this can be done in the slot connected to <a href="qgeocodingmanagerengine.html#finished">QGeoCodingManagerEngine::finished</a>(), <a href="qgeocodingmanagerengine.html#error">QGeoCodingManagerEngine::error</a>(), <a href="qgeocodereply.html#finished">QGeoCodeReply::finished</a>() or <a href="qgeocodereply.html#error">QGeoCodeReply::error</a>() with deleteLater().</p>
<!-- @@@geocode -->
<!-- $$$locale[overload1]$$$locale -->
<h3 class="fn"><a name="locale"></a><span class="type">QLocale</span> QGeoCodingManagerEngine::<span class="name">locale</span>() const</h3>
<p>Returns the locale used to hint to this geocoding manager about what language to use for the results.</p>
<p><b>See also </b><a href="qgeocodingmanagerengine.html#setLocale">setLocale</a>().</p>
<!-- @@@locale -->
<!-- $$$managerName[overload1]$$$managerName -->
<h3 class="fn"><a name="managerName"></a><span class="type">QString</span> QGeoCodingManagerEngine::<span class="name">managerName</span>() const</h3>
<p>Returns the name which this engine implementation uses to distinguish itself from the implementations provided by other plugins.</p>
<p>The combination of managerName() and <a href="qgeocodingmanagerengine.html#managerVersion">managerVersion</a>() should be unique amongst plugin implementations.</p>
<!-- @@@managerName -->
<!-- $$$managerVersion[overload1]$$$managerVersion -->
<h3 class="fn"><a name="managerVersion"></a><span class="type">int</span> QGeoCodingManagerEngine::<span class="name">managerVersion</span>() const</h3>
<p>Returns the version of this engine implementation.</p>
<p>The combination of <a href="qgeocodingmanagerengine.html#managerName">managerName</a>() and managerVersion() should be unique amongst plugin implementations.</p>
<!-- @@@managerVersion -->
<!-- $$$reverseGeocode[overload1]$$$reverseGeocodeconstQGeoCoordinate&constQGeoShape& -->
<h3 class="fn"><a name="reverseGeocode"></a><span class="type"><a href="qgeocodereply.html">QGeoCodeReply</a></span> * QGeoCodingManagerEngine::<span class="name">reverseGeocode</span>(const <span class="type">QGeoCoordinate</span> &<i> coordinate</i>, const <span class="type">QGeoShape</span> &<i> bounds</i>)<tt> [virtual]</tt></h3>
<p>Begins the reverse geocoding of <i>coordinate</i>. Reverse geocoding is the process of finding an address that corresponds to a given coordinate.</p>
<p>A <a href="qgeocodereply.html">QGeoCodeReply</a> object will be returned, which can be used to manage the reverse geocoding operation and to return the results of the operation.</p>
<p>This engine and the returned <a href="qgeocodereply.html">QGeoCodeReply</a> object will emit signals indicating if the operation completes or if errors occur.</p>
<p>If supportsReverseGeocoding() returns false an <a href="qgeocodereply.html#Error-enum">QGeoCodeReply::UnsupportedOptionError</a> will occur.</p>
<p>At that point <a href="qgeocodereply.html#locations">QGeoCodeReply::locations</a>() can be used to retrieve the results, which will consist of a list of QGeoLocation objects. These objects represent a combination of coordinate and address data.</p>
<p>The coordinate data returned in the results may be different from <i>coordinate</i>. This will usually occur if the reverse geocoding service backend shifts the coordinates to be closer to the matching addresses, or if the backend returns results at multiple levels of detail.</p>
<p>If multiple results are returned by the reverse geocoding service backend they will be provided in order of specificity. This normally occurs if the backend is configured to reverse geocode across multiple levels of detail. As an example, some services will return address and coordinate pairs for the street address, the city, the state and the country.</p>
<p>If <i>bounds</i> is non-null and a valid QGeoShape it will be used to limit the results to those that are contained by <i>bounds</i>.</p>
<p>The user is responsible for deleting the returned reply object, although this can be done in the slot connected to <a href="qgeocodingmanagerengine.html#finished">QGeoCodingManagerEngine::finished</a>(), <a href="qgeocodingmanagerengine.html#error">QGeoCodingManagerEngine::error</a>(), <a href="qgeocodereply.html#finished">QGeoCodeReply::finished</a>() or <a href="qgeocodereply.html#error">QGeoCodeReply::error</a>() with deleteLater().</p>
<!-- @@@reverseGeocode -->
<!-- $$$setLocale[overload1]$$$setLocaleconstQLocale& -->
<h3 class="fn"><a name="setLocale"></a><span class="type">void</span> QGeoCodingManagerEngine::<span class="name">setLocale</span>(const <span class="type">QLocale</span> &<i> locale</i>)</h3>
<p>Sets the locale to be used by this manager to <i>locale</i>.</p>
<p>If this geocoding manager supports returning the results in different languages, they will be returned in the language of <i>locale</i>.</p>
<p>The locale used defaults to the system locale if this is not set.</p>
<p><b>See also </b><a href="qgeocodingmanagerengine.html#locale">locale</a>().</p>
<!-- @@@setLocale -->
</div>
</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>
|