/usr/share/qt5/doc/qtlocation/qgeocodingmanager.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 | <?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" />
<!-- qgeocodingmanager.cpp -->
<title>QGeoCodingManager 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>QGeoCodingManager</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">QGeoCodingManager Class</h1>
<!-- $$$QGeoCodingManager-brief -->
<p>The QGeoCodingManager class provides support for geocoding operations. <a href="#details">More...</a></p>
<!-- @@@QGeoCodingManager -->
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> Header:</td><td class="memItemRight bottomAlign"> </b><tt><span class="preprocessor">#include <QGeoCodingManager></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="qgeocodingmanager-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="qgeocodingmanager.html#dtor.QGeoCodingManager">~QGeoCodingManager</a></b>()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QGeoCodeReply * </td><td class="memItemRight bottomAlign"><b><a href="qgeocodingmanager.html#geocode">geocode</a></b>(const QGeoAddress &<i> address</i>, const QGeoShape &<i> bounds</i> = QGeoShape())</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QGeoCodeReply * </td><td class="memItemRight bottomAlign"><b><a href="qgeocodingmanager.html#geocode-2">geocode</a></b>(const QString &<i> address</i>, int<i> limit</i> = -1, int<i> offset</i> = 0, const QGeoShape &<i> bounds</i> = QGeoShape())</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QLocale </td><td class="memItemRight bottomAlign"><b><a href="qgeocodingmanager.html#locale">locale</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qgeocodingmanager.html#managerName">managerName</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> int </td><td class="memItemRight bottomAlign"><b><a href="qgeocodingmanager.html#managerVersion">managerVersion</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QGeoCodeReply * </td><td class="memItemRight bottomAlign"><b><a href="qgeocodingmanager.html#reverseGeocode">reverseGeocode</a></b>(const QGeoCoordinate &<i> coordinate</i>, const QGeoShape &<i> bounds</i> = QGeoShape())</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qgeocodingmanager.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="qgeocodingmanager.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="qgeocodingmanager.html#finished">finished</a></b>(QGeoCodeReply *<i> reply</i>)</td></tr>
</table>
<a name="details"></a>
<!-- $$$QGeoCodingManager-description -->
<div class="descr">
<h2>Detailed Description</h2>
<p>The QGeoCodingManager class provides support for geocoding operations.</p>
<p>The <a href="qgeocodingmanager.html#geocode">geocode</a>() and <a href="qgeocodingmanager.html#reverseGeocode">reverseGeocode</a>() functions return <a href="qgeocodereply.html">QGeoCodeReply</a> objects, which manage these operations and report on the result of the operations and any errors which may have occurred.</p>
<p>The <a href="qgeocodingmanager.html#geocode">geocode</a>() and <a href="qgeocodingmanager.html#reverseGeocode">reverseGeocode</a>() functions can be used to convert QGeoAddress instances to QGeoCoordinate instances and vice-versa.</p>
<p>The <a href="qgeocodingmanager.html#geocode">geocode</a>() function is also overloaded to allow a user to perform a free text geocoding operation, if the string provided can be interpreted as an address it can be geocoded to coordinate information.</p>
<p>Instances of QGeoCodingManager can be accessed with <a href="qgeoserviceprovider.html#geocodingManager">QGeoServiceProvider::geocodingManager</a>().</p>
</div>
<!-- @@@QGeoCodingManager -->
<div class="func">
<h2>Member Function Documentation</h2>
<!-- $$$~QGeoCodingManager[overload1]$$$~QGeoCodingManager -->
<h3 class="fn"><a name="dtor.QGeoCodingManager"></a>QGeoCodingManager::<span class="name">~QGeoCodingManager</span>()</h3>
<p>Destroys this manager.</p>
<!-- @@@~QGeoCodingManager -->
<!-- $$$error[overload1]$$$errorQGeoCodeReply*QGeoCodeReply::ErrorQString -->
<h3 class="fn"><a name="error"></a><span class="type">void</span> QGeoCodingManager::<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="qgeocodingmanager.html#finished">QGeoCodingManager::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> QGeoCodingManager::<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> * QGeoCodingManager::<span class="name">geocode</span>(const <span class="type">QGeoAddress</span> &<i> address</i>, const <span class="type">QGeoShape</span> &<i> bounds</i> = QGeoShape())</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 manager 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 is a valid QGeoShape it will be used to limit the results to those that are contained within <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="qgeocodingmanager.html#finished">QGeoCodingManager::finished</a>(), <a href="qgeocodingmanager.html#error">QGeoCodingManager::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> * QGeoCodingManager::<span class="name">geocode</span>(const <span class="type">QString</span> &<i> address</i>, <span class="type">int</span><i> limit</i> = -1, <span class="type">int</span><i> offset</i> = 0, const <span class="type">QGeoShape</span> &<i> bounds</i> = QGeoShape())</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 manager 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 within <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="qgeocodingmanager.html#finished">QGeoCodingManager::finished</a>(), <a href="qgeocodingmanager.html#error">QGeoCodingManager::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> QGeoCodingManager::<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="qgeocodingmanager.html#setLocale">setLocale</a>().</p>
<!-- @@@locale -->
<!-- $$$managerName[overload1]$$$managerName -->
<h3 class="fn"><a name="managerName"></a><span class="type">QString</span> QGeoCodingManager::<span class="name">managerName</span>() const</h3>
<p>Returns the name of the engine which implements the behaviour of this geocoding manager.</p>
<p>The combination of managerName() and <a href="qgeocodingmanager.html#managerVersion">managerVersion</a>() should be unique amongst the plugin implementations.</p>
<!-- @@@managerName -->
<!-- $$$managerVersion[overload1]$$$managerVersion -->
<h3 class="fn"><a name="managerVersion"></a><span class="type">int</span> QGeoCodingManager::<span class="name">managerVersion</span>() const</h3>
<p>Returns the version of the engine which implements the behaviour of this geocoding manager.</p>
<p>The combination of <a href="qgeocodingmanager.html#managerName">managerName</a>() and managerVersion() should be unique amongst the 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> * QGeoCodingManager::<span class="name">reverseGeocode</span>(const <span class="type">QGeoCoordinate</span> &<i> coordinate</i>, const <span class="type">QGeoShape</span> &<i> bounds</i> = QGeoShape())</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 manager 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 QGeoRectangle it will be used to limit the results to those that are contained within <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="qgeocodingmanager.html#finished">QGeoCodingManager::finished</a>(), <a href="qgeocodingmanager.html#error">QGeoCodingManager::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> QGeoCodingManager::<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="qgeocodingmanager.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>
|