<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.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" />
<!-- qgeoroutingmanager.cpp -->
<title>Qt Mobility 1.2: QGeoRoutingManager Class Reference</title>
<link rel="stylesheet" type="text/css" href="style/offline.css" />
</head>
<body>
<div class="header" id="qtdocheader">
<div class="content">
<a href="index.html" class="qtref"><span>QtMobility Reference Documentation</span></a>
</div>
<div class="breadcrumb toolblock">
<ul>
<li class="first"><a href="index.html">Home</a></li>
<!-- Breadcrumbs go here -->
<li><a href="modules.html">Modules</a></li>
<li><a href="qtlocation.html">QtLocation</a></li>
<li>QGeoRoutingManager</li>
</ul>
</div>
</div>
<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">QGeoRoutingManager Class Reference</h1>
<!-- $$$QGeoRoutingManager-brief -->
<p>The QGeoRoutingManager class provides support for geographic routing operations. <a href="#details">More...</a></p>
<!-- @@@QGeoRoutingManager -->
<pre class="cpp"> <span class="preprocessor">#include <QGeoRoutingManager></span></pre><p><b>Inherits: </b><a href="http://qt.nokia.com/doc/4.7/qobject.html">QObject</a>.</p>
<p>This class was introduced in Qt Mobility 1.1.</p>
<ul>
<li><a href="qgeoroutingmanager-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="qgeoroutingmanager.html#dtor.QGeoRoutingManager">~QGeoRoutingManager</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QGeoRouteReply * </td><td class="memItemRight bottomAlign"><b><a href="qgeoroutingmanager.html#calculateRoute">calculateRoute</a></b> ( const QGeoRouteRequest & <i>request</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QLocale </td><td class="memItemRight bottomAlign"><b><a href="qgeoroutingmanager.html#locale">locale</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qgeoroutingmanager.html#managerName">managerName</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> int </td><td class="memItemRight bottomAlign"><b><a href="qgeoroutingmanager.html#managerVersion">managerVersion</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qgeoroutingmanager.html#setLocale">setLocale</a></b> ( const QLocale & <i>locale</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QGeoRouteRequest::FeatureTypes </td><td class="memItemRight bottomAlign"><b><a href="qgeoroutingmanager.html#supportedFeatureTypes">supportedFeatureTypes</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QGeoRouteRequest::FeatureWeights </td><td class="memItemRight bottomAlign"><b><a href="qgeoroutingmanager.html#supportedFeatureWeights">supportedFeatureWeights</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QGeoRouteRequest::ManeuverDetails </td><td class="memItemRight bottomAlign"><b><a href="qgeoroutingmanager.html#supportedManeuverDetails">supportedManeuverDetails</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QGeoRouteRequest::RouteOptimizations </td><td class="memItemRight bottomAlign"><b><a href="qgeoroutingmanager.html#supportedRouteOptimizations">supportedRouteOptimizations</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QGeoRouteRequest::SegmentDetails </td><td class="memItemRight bottomAlign"><b><a href="qgeoroutingmanager.html#supportedSegmentDetails">supportedSegmentDetails</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QGeoRouteRequest::TravelModes </td><td class="memItemRight bottomAlign"><b><a href="qgeoroutingmanager.html#supportedTravelModes">supportedTravelModes</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qgeoroutingmanager.html#supportsAlternativeRoutes">supportsAlternativeRoutes</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qgeoroutingmanager.html#supportsExcludeAreas">supportsExcludeAreas</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qgeoroutingmanager.html#supportsRouteUpdates">supportsRouteUpdates</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QGeoRouteReply * </td><td class="memItemRight bottomAlign"><b><a href="qgeoroutingmanager.html#updateRoute">updateRoute</a></b> ( const QGeoRoute & <i>route</i>, const QGeoCoordinate & <i>position</i> )</td></tr>
</table>
<ul>
<li class="fn">29 public functions inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#public-functions">QObject</a></li>
</ul>
<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="qgeoroutingmanager.html#error">error</a></b> ( QGeoRouteReply * <i>reply</i>, QGeoRouteReply::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="qgeoroutingmanager.html#finished">finished</a></b> ( QGeoRouteReply * <i>reply</i> )</td></tr>
</table>
<ul>
<li class="fn">1 signal inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#signals">QObject</a></li>
</ul>
<h3>Additional Inherited Members</h3>
<ul>
<li class="fn">1 property inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#properties">QObject</a></li>
<li class="fn">1 public slot inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#public-slots">QObject</a></li>
<li class="fn">1 public variable inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#public-variables">QObject</a></li>
<li class="fn">4 static public members inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#static-public-members">QObject</a></li>
<li class="fn">7 protected functions inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#protected-functions">QObject</a></li>
<li class="fn">2 protected variables inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#protected-variables">QObject</a></li>
</ul>
<a name="details"></a>
<!-- $$$QGeoRoutingManager-description -->
<div class="descr">
<h2>Detailed Description</h2>
<p>The QGeoRoutingManager class provides support for geographic routing operations.</p>
<p>The <a href="qgeoroutingmanager.html#calculateRoute">calculateRoute</a>() and <a href="qgeoroutingmanager.html#updateRoute">updateRoute</a>() methods function <a href="qgeoroutereply.html">QGeoRouteReply</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="qgeoroutingmanager.html#calculateRoute">calculateRoute</a>() function is used to find a route (or routes) that follows a set of waypoints and matches various other criteria. The <a href="qgeorouterequest.html">QGeoRouteRequest</a> class is used to specify this information.</p>
<p>If <a href="qgeoroutingmanager.html#supportsRouteUpdates">supportsRouteUpdates</a>() returns true then the QGeoRoutingManager supports updating route information based on position updates. This will cause the travel time and distance estimates to be updated, and any QGeoRouteSegments already traversed to be removed from the route.</p>
<p>The updates can be triggered with the <a href="qgeoroutingmanager.html#updateRoute">updateRoute</a>() function, which makes use of the <a href="qgeopositioninfo.html">QGeoPositionInfo</a> instances emitted as position updates by <a href="qgeopositioninfosource.html">QGeoPositionInfoSource</a>.</p>
<p>Instances of QGeoRoutingManager can be accessed with <a href="qgeoserviceprovider.html#routingManager">QGeoServiceProvider::routingManager</a>().</p>
<p>A small example of the usage of QGeoRoutingManager and QGeoRouteRequests follows:</p>
<pre class="cpp"> <span class="keyword">class</span> MyRouteHandler : <span class="keyword">public</span> <span class="type"><a href="http://qt.nokia.com/doc/4.7/qobject.html">QObject</a></span>
{
Q_OBJECT
<span class="keyword">public</span>:
MyRouteHandler(<span class="type">QGeoRoutingManager</span> <span class="operator">*</span>routingManager<span class="operator">,</span>
<span class="keyword">const</span> <span class="type"><a href="qgeocoordinate.html">QGeoCoordinate</a></span> <span class="operator">&</span>origin<span class="operator">,</span>
<span class="keyword">const</span> <span class="type"><a href="qgeocoordinate.html">QGeoCoordinate</a></span> <span class="operator">&</span>destination) {
<span class="type"><a href="qgeorouterequest.html">QGeoRouteRequest</a></span> request(origin<span class="operator">,</span> destination);
<span class="comment">// The request defaults to the fastest route by car, which is</span>
<span class="comment">// equivalent to:</span>
<span class="comment">// request.setTravelMode(QGeoRouteRequest::CarTravel);</span>
<span class="comment">// request.setRouteOptimization(QGeoRouteRequest::FastestRoute);</span>
request<span class="operator">.</span>setAvoidFeatureTypes(<span class="type"><a href="qgeorouterequest.html">QGeoRouteRequest</a></span><span class="operator">::</span>AvoidTolls);
request<span class="operator">.</span>setAvoidFeatureTypes(<span class="type"><a href="qgeorouterequest.html">QGeoRouteRequest</a></span><span class="operator">::</span>AvoidMotorPoolLanes);
<span class="type"><a href="qgeorouterequest.html">QGeoRouteRequest</a></span><span class="operator">::</span>AvoidFeaturesTypes avoidableFeatures <span class="operator">=</span> routingManager<span class="operator">-</span><span class="operator">></span>supportedAvoidFeatureTypes();
<span class="keyword">if</span> (<span class="operator">!</span>(avoidableFeatures <span class="operator">&</span> request<span class="operator">.</span>avoidFeatureTypes())) {
<span class="comment">// ... inform the user that the routing manager does not</span>
<span class="comment">// provide support for avoiding tolls and/or motor pool lanes ...</span>
<span class="keyword">return</span>;
}
<span class="type"><a href="qgeoroutereply.html">QGeoRouteReply</a></span> <span class="operator">*</span>reply <span class="operator">=</span> routingManager<span class="operator">-</span><span class="operator">></span>calculateRoute(request);
<span class="keyword">if</span> (reply<span class="operator">-</span><span class="operator">></span>isFinished()) {
<span class="keyword">if</span> (reply<span class="operator">-</span><span class="operator">></span>error() <span class="operator">=</span><span class="operator">=</span> <span class="type"><a href="qgeoroutereply.html">QGeoRouteReply</a></span><span class="operator">::</span>NoError) {
routeCalculated(reply);
} <span class="keyword">else</span> {
routeError(reply<span class="operator">,</span> reply<span class="operator">-</span><span class="operator">></span>error()<span class="operator">,</span> reply<span class="operator">-</span><span class="operator">></span>errorString());
}
<span class="keyword">return</span>;
}
connect(routingManager<span class="operator">,</span>
SIGNAL(finished(<span class="type"><a href="qgeoroutereply.html">QGeoRouteReply</a></span><span class="operator">*</span>))<span class="operator">,</span>
<span class="keyword">this</span><span class="operator">,</span>
SLOT(routeCalculated(<span class="type"><a href="qgeoroutereply.html">QGeoRouteReply</a></span><span class="operator">*</span>)));
connect(routingManager<span class="operator">,</span>
SIGNAL(error(<span class="type"><a href="qgeoroutereply.html">QGeoRouteReply</a></span><span class="operator">*</span><span class="operator">,</span><span class="type"><a href="qgeoroutereply.html">QGeoRouteReply</a></span><span class="operator">::</span>Error<span class="operator">,</span><span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span>))<span class="operator">,</span>
<span class="keyword">this</span><span class="operator">,</span>
SLOT(routeError(<span class="type"><a href="qgeoroutereply.html">QGeoRouteReply</a></span><span class="operator">*</span><span class="operator">,</span><span class="type"><a href="qgeoroutereply.html">QGeoRouteReply</a></span><span class="operator">::</span>Error<span class="operator">,</span><span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span>)));
}
<span class="keyword">private</span> <span class="keyword">slots</span>:
<span class="type">void</span> routeCalculated(<span class="type"><a href="qgeoroutereply.html">QGeoRouteReply</a></span> <span class="operator">*</span>reply)
{
<span class="comment">// A route request can ask for several alternative routes ...</span>
<span class="keyword">if</span> (reply<span class="operator">-</span><span class="operator">></span>routes()<span class="operator">.</span>size() <span class="operator">!</span><span class="operator">=</span> <span class="number">0</span>) {
<span class="comment">// ... but by default it will only get a single route</span>
<span class="type"><a href="qgeoroute.html">QGeoRoute</a></span> route <span class="operator">=</span> reply<span class="operator">-</span><span class="operator">></span>routes()<span class="operator">.</span>at(<span class="number">0</span>);
<span class="comment">//... now we have to make use of the route ...</span>
}
reply<span class="operator">-</span><span class="operator">></span>deleteLater();
}
<span class="type">void</span> routeError(<span class="type"><a href="qgeoroutereply.html">QGeoRouteReply</a></span> <span class="operator">*</span>reply<span class="operator">,</span> <span class="type"><a href="qgeoroutereply.html">QGeoRouteReply</a></span>:Error error<span class="operator">,</span> <span class="keyword">const</span> <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> <span class="operator">&</span>errorString)
{
<span class="comment">// ... inform the user that an error has occurred ...</span>
reply<span class="operator">-</span><span class="operator">></span>deleteLater();
}
};</pre>
</div>
<!-- @@@QGeoRoutingManager -->
<div class="func">
<h2>Member Function Documentation</h2>
<!-- $$$~QGeoRoutingManager[overload1]$$$~QGeoRoutingManager -->
<h3 class="fn"><a name="dtor.QGeoRoutingManager"></a>QGeoRoutingManager::<span class="name">~QGeoRoutingManager</span> ()</h3>
<p>Destroys this manager.</p>
<!-- @@@~QGeoRoutingManager -->
<!-- $$$calculateRoute[overload1]$$$calculateRouteconstQGeoRouteRequest& -->
<h3 class="fn"><a name="calculateRoute"></a><span class="type"><a href="qgeoroutereply.html">QGeoRouteReply</a></span> * QGeoRoutingManager::<span class="name">calculateRoute</span> ( const <span class="type"><a href="qgeorouterequest.html">QGeoRouteRequest</a></span> & <i>request</i> )</h3>
<p>Begins the calculation of the route specified by <i>request</i>.</p>
<p>A <a href="qgeoroutereply.html">QGeoRouteReply</a> object will be returned, which can be used to manage the routing operation and to return the results of the operation.</p>
<p>This manager and the returned <a href="qgeoroutereply.html">QGeoRouteReply</a> object will emit signals indicating if the operation completes or if errors occur.</p>
<p>Once the operation has completed, QGeoRouteReply::routes can be used to retrieve the calculated route or routes.</p>
<p>If <i>request</i> includes features which are not supported by this manager, as reported by the methods in this manager, then a <a href="qgeoroutereply.html#Error-enum">QGeoRouteReply::UnsupportedOptionError</a> will occur.</p>
<p>The user is responsible for deleting the returned reply object, although this can be done in the slot connected to <a href="qgeoroutingmanager.html#finished">QGeoRoutingManager::finished</a>(), <a href="qgeoroutingmanager.html#error">QGeoRoutingManager::error</a>(), <a href="qgeoroutereply.html#finished">QGeoRouteReply::finished</a>() or <a href="qgeoroutereply.html#error">QGeoRouteReply::error</a>() with <a href="http://qt.nokia.com/doc/4.7/qobject.html#deleteLater">deleteLater</a>().</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@calculateRoute -->
<!-- $$$error[overload1]$$$errorQGeoRouteReply*QGeoRouteReply::ErrorQString -->
<h3 class="fn"><a name="error"></a><span class="type">void</span> QGeoRoutingManager::<span class="name">error</span> ( <span class="type"><a href="qgeoroutereply.html">QGeoRouteReply</a></span> * <i>reply</i>, <span class="type"><a href="qgeoroutereply.html#Error-enum">QGeoRouteReply::Error</a></span> <i>error</i>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></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="qgeoroutingmanager.html#finished">QGeoRoutingManager::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="qgeoroutereply.html#error">QGeoRouteReply::error</a>() will be emitted at the same time.</p>
<p><b>Note:</b> Do no delete the <i>reply</i> object in the slot connected to this signal. Use <a href="http://qt.nokia.com/doc/4.7/qobject.html#deleteLater">deleteLater</a>() instead.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@error -->
<!-- $$$finished[overload1]$$$finishedQGeoRouteReply* -->
<h3 class="fn"><a name="finished"></a><span class="type">void</span> QGeoRoutingManager::<span class="name">finished</span> ( <span class="type"><a href="qgeoroutereply.html">QGeoRouteReply</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="qgeoroutereply.html#Error-enum">QGeoRouteReply::NoError</a> then the processing finished successfully.</p>
<p>This signal and <a href="qgeoroutereply.html#finished">QGeoRouteReply::finished</a>() will be emitted at the same time.</p>
<p><b>Note:</b> Do no delete the <i>reply</i> object in the slot connected to this signal. Use <a href="http://qt.nokia.com/doc/4.7/qobject.html#deleteLater">deleteLater</a>() instead.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@finished -->
<!-- $$$locale[overload1]$$$locale -->
<h3 class="fn"><a name="locale"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qlocale.html">QLocale</a></span> QGeoRoutingManager::<span class="name">locale</span> () const</h3>
<p>Returns the locale used to hint to this routing manager about what language to use for addresses and instructions.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<p><b>See also </b><a href="qgeoroutingmanager.html#setLocale">setLocale</a>().</p>
<!-- @@@locale -->
<!-- $$$managerName[overload1]$$$managerName -->
<h3 class="fn"><a name="managerName"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> QGeoRoutingManager::<span class="name">managerName</span> () const</h3>
<p>Returns the name of the engine which implements the behaviour of this routing manager.</p>
<p>The combination of managerName() and <a href="qgeoroutingmanager.html#managerVersion">managerVersion</a>() should be unique amongst the plugin implementations.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@managerName -->
<!-- $$$managerVersion[overload1]$$$managerVersion -->
<h3 class="fn"><a name="managerVersion"></a><span class="type">int</span> QGeoRoutingManager::<span class="name">managerVersion</span> () const</h3>
<p>Returns the version of the engine which implements the behaviour of this routin manager.</p>
<p>The combination of <a href="qgeoroutingmanager.html#managerName">managerName</a>() and managerVersion() should be unique amongst the plugin implementations.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@managerVersion -->
<!-- $$$setLocale[overload1]$$$setLocaleconstQLocale& -->
<h3 class="fn"><a name="setLocale"></a><span class="type">void</span> QGeoRoutingManager::<span class="name">setLocale</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlocale.html">QLocale</a></span> & <i>locale</i> )</h3>
<p>Sets the locale to be used by the this manager to <i>locale</i>.</p>
<p>If this routing manager supports returning addresses and instructions 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>This function was introduced in Qt Mobility 1.1.</p>
<p><b>See also </b><a href="qgeoroutingmanager.html#locale">locale</a>().</p>
<!-- @@@setLocale -->
<!-- $$$supportedFeatureTypes[overload1]$$$supportedFeatureTypes -->
<h3 class="fn"><a name="supportedFeatureTypes"></a><span class="type"><a href="qgeorouterequest.html#FeatureType-enum">QGeoRouteRequest::FeatureTypes</a></span> QGeoRoutingManager::<span class="name">supportedFeatureTypes</span> () const</h3>
<p>Returns the types of features that this manager can take into account during route planning.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@supportedFeatureTypes -->
<!-- $$$supportedFeatureWeights[overload1]$$$supportedFeatureWeights -->
<h3 class="fn"><a name="supportedFeatureWeights"></a><span class="type"><a href="qgeorouterequest.html#FeatureWeight-enum">QGeoRouteRequest::FeatureWeights</a></span> QGeoRoutingManager::<span class="name">supportedFeatureWeights</span> () const</h3>
<p>Returns the weightings which this manager can apply to different features during route planning.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@supportedFeatureWeights -->
<!-- $$$supportedManeuverDetails[overload1]$$$supportedManeuverDetails -->
<h3 class="fn"><a name="supportedManeuverDetails"></a><span class="type"><a href="qgeorouterequest.html#ManeuverDetail-enum">QGeoRouteRequest::ManeuverDetails</a></span> QGeoRoutingManager::<span class="name">supportedManeuverDetails</span> () const</h3>
<p>Returns the levels of detail for navigation maneuvers which can be requested by this manager.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@supportedManeuverDetails -->
<!-- $$$supportedRouteOptimizations[overload1]$$$supportedRouteOptimizations -->
<h3 class="fn"><a name="supportedRouteOptimizations"></a><span class="type"><a href="qgeorouterequest.html#RouteOptimization-enum">QGeoRouteRequest::RouteOptimizations</a></span> QGeoRoutingManager::<span class="name">supportedRouteOptimizations</span> () const</h3>
<p>Returns the route optimizations supported by this manager.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@supportedRouteOptimizations -->
<!-- $$$supportedSegmentDetails[overload1]$$$supportedSegmentDetails -->
<h3 class="fn"><a name="supportedSegmentDetails"></a><span class="type"><a href="qgeorouterequest.html#SegmentDetail-enum">QGeoRouteRequest::SegmentDetails</a></span> QGeoRoutingManager::<span class="name">supportedSegmentDetails</span> () const</h3>
<p>Returns the levels of detail for routing segments which can be requested with this manager.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@supportedSegmentDetails -->
<!-- $$$supportedTravelModes[overload1]$$$supportedTravelModes -->
<h3 class="fn"><a name="supportedTravelModes"></a><span class="type"><a href="qgeorouterequest.html#TravelMode-enum">QGeoRouteRequest::TravelModes</a></span> QGeoRoutingManager::<span class="name">supportedTravelModes</span> () const</h3>
<p>Returns the travel modes supported by this manager.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@supportedTravelModes -->
<!-- $$$supportsAlternativeRoutes[overload1]$$$supportsAlternativeRoutes -->
<h3 class="fn"><a name="supportsAlternativeRoutes"></a><span class="type">bool</span> QGeoRoutingManager::<span class="name">supportsAlternativeRoutes</span> () const</h3>
<p>Returns whether this manager supports request for alternative routes.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@supportsAlternativeRoutes -->
<!-- $$$supportsExcludeAreas[overload1]$$$supportsExcludeAreas -->
<h3 class="fn"><a name="supportsExcludeAreas"></a><span class="type">bool</span> QGeoRoutingManager::<span class="name">supportsExcludeAreas</span> () const</h3>
<p>Returns whether this engine supports the exclusion of areas from routes.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@supportsExcludeAreas -->
<!-- $$$supportsRouteUpdates[overload1]$$$supportsRouteUpdates -->
<h3 class="fn"><a name="supportsRouteUpdates"></a><span class="type">bool</span> QGeoRoutingManager::<span class="name">supportsRouteUpdates</span> () const</h3>
<p>Returns whether this manager supports updating routes.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@supportsRouteUpdates -->
<!-- $$$updateRoute[overload1]$$$updateRouteconstQGeoRoute&constQGeoCoordinate& -->
<h3 class="fn"><a name="updateRoute"></a><span class="type"><a href="qgeoroutereply.html">QGeoRouteReply</a></span> * QGeoRoutingManager::<span class="name">updateRoute</span> ( const <span class="type"><a href="qgeoroute.html">QGeoRoute</a></span> & <i>route</i>, const <span class="type"><a href="qgeocoordinate.html">QGeoCoordinate</a></span> & <i>position</i> )</h3>
<p>Begins the process of updating <i>route</i> based on the current position <i>position</i>.</p>
<p>A <a href="qgeoroutereply.html">QGeoRouteReply</a> object will be returned, which can be used to manage the routing operation and to return the results of the operation.</p>
<p>This manager and the returned <a href="qgeoroutereply.html">QGeoRouteReply</a> object will emit signals indicating if the operation completes or if errors occur.</p>
<p>If <a href="qgeoroutingmanager.html#supportsRouteUpdates">supportsRouteUpdates</a>() returns false an <a href="qgeoroutereply.html#Error-enum">QGeoRouteReply::UnsupportedOptionError</a> will occur.</p>
<p>Once the operation has completed, QGeoRouteReply::routes can be used to retrieve the updated route.</p>
<p>The returned route could be entirely different to the original route, especially if <i>position</i> is far away from the initial route. Otherwise the route will be similar, although the remaining time and distance will be updated and any segments of the original route which have been traversed will be removed.</p>
<p>The user is responsible for deleting the returned reply object, although this can be done in the slot connected to <a href="qgeoroutingmanager.html#finished">QGeoRoutingManager::finished</a>(), <a href="qgeoroutingmanager.html#error">QGeoRoutingManager::error</a>(), <a href="qgeoroutereply.html#finished">QGeoRouteReply::finished</a>() or <a href="qgeoroutereply.html#error">QGeoRouteReply::error</a>() with <a href="http://qt.nokia.com/doc/4.7/qobject.html#deleteLater">deleteLater</a>().</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@updateRoute -->
</div>
<div class="ft">
<span></span>
</div>
</div>
<div class="footer">
<p>
<acronym title="Copyright">©</acronym> 2008-2011 Nokia Corporation and/or its
subsidiaries. Nokia, Qt and their respective logos are trademarks of Nokia Corporation
in Finland and/or other countries worldwide.</p>
<p>
All other trademarks are property of their respective owners. <a title="Privacy Policy"
href="http://qt.nokia.com/about/privacy-policy">Privacy Policy</a></p>
<br />
<p>
Licensees holding valid Qt Commercial licenses may use this document in accordance with the Qt Commercial License Agreement provided with the Software or, alternatively, in accordance with the terms contained in a written agreement between you and Nokia.</p>
<p>
Alternatively, this document may be used 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.</p>
</div>
</body>
</html>
distrib
>
Mageia
>
5
>
i586
>
media
>
core-release
>
by-pkgid
>
50facae208d4a6f280e44a513b104320
>
files
>
916
