Viadeo Twitter Google Bookmarks ! Facebook Digg del.icio.us MySpace Yahoo MyWeb Blinklist Netvouz Reddit Simpy StumbleUpon Bookmarks Windows Live Favorites 
Logo Documentation Qt ·  Page d'accueil  ·  Toutes les classes  ·  Classes principales  ·  Annotées  ·  Classes groupées  ·  Modules  ·  Fonctions  · 

QGeoRoutingManager Class

The QGeoRoutingManager class provides support for geographic routing operations. More...

 #include <QGeoRoutingManager>

Inherits: QObject.

This class was introduced in Qt Location 5.0.

Public Functions

~QGeoRoutingManager()
QGeoRouteReply * calculateRoute(const QGeoRouteRequest & request)
QLocale locale() const
QString managerName() const
int managerVersion() const
void setLocale(const QLocale & locale)
QGeoRouteRequest::FeatureTypes supportedFeatureTypes() const
QGeoRouteRequest::FeatureWeights supportedFeatureWeights() const
QGeoRouteRequest::ManeuverDetails supportedManeuverDetails() const
QGeoRouteRequest::RouteOptimizations supportedRouteOptimizations() const
QGeoRouteRequest::SegmentDetails supportedSegmentDetails() const
QGeoRouteRequest::TravelModes supportedTravelModes() const
QGeoRouteReply * updateRoute(const QGeoRoute & route, const QGeoCoordinate & position)
  • 31 public functions inherited from QObject

Signals

void error(QGeoRouteReply * reply, QGeoRouteReply::Error error, QString errorString = QString())
void finished(QGeoRouteReply * reply)

Additional Inherited Members

  • 1 property inherited from QObject
  • 1 public slot inherited from QObject
  • 11 static public members inherited from QObject
  • 9 protected functions inherited from QObject

Detailed Description

The QGeoRoutingManager class provides support for geographic routing operations.

The calculateRoute() and updateRoute() methods function QGeoRouteReply objects, which manage these operations and report on the result of the operations and any errors which may have occurred.

The calculateRoute() function is used to find a route (or routes) that follows a set of waypoints and matches various other criteria. The QGeoRouteRequest class is used to specify this information.

If supportsRouteUpdates() 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.

The updates can be triggered with the updateRoute() function, which makes use of the QGeoPositionInfo instances emitted as position updates by QGeoPositionInfoSource.

Instances of QGeoRoutingManager can be accessed with QGeoServiceProvider::routingManager().

A small example of the usage of QGeoRoutingManager and QGeoRouteRequests follows:

 class MyRouteHandler : public QObject
 {
     Q_OBJECT
 public:
     MyRouteHandler(QGeoRoutingManager *routingManager,
                    const QGeoCoordinate &origin,
                    const QGeoCoordinate &destination) {

         QGeoRouteRequest request(origin, destination);

         // The request defaults to the fastest route by car, which is
         // equivalent to:
         // request.setTravelMode(QGeoRouteRequest::CarTravel);
         // request.setRouteOptimization(QGeoRouteRequest::FastestRoute);

         request.setAvoidFeatureTypes(QGeoRouteRequest::AvoidTolls);
         request.setAvoidFeatureTypes(QGeoRouteRequest::AvoidMotorPoolLanes);

         QGeoRouteRequest::AvoidFeaturesTypes avoidableFeatures = routingManager->supportedAvoidFeatureTypes();

         if (!(avoidableFeatures & request.avoidFeatureTypes())) {
             // ... inform the user that the routing manager does not
             // provide support for avoiding tolls and/or motor pool lanes ...
             return;
         }

         QGeoRouteReply *reply = routingManager->calculateRoute(request);

         if (reply->isFinished()) {
             if (reply->error() == QGeoRouteReply::NoError) {
                 routeCalculated(reply);
             } else {
                 routeError(reply, reply->error(), reply->errorString());
             }
             return;
         }

         connect(routingManager,
                 SIGNAL(finished(QGeoRouteReply*)),
                 this,
                 SLOT(routeCalculated(QGeoRouteReply*)));

         connect(routingManager,
                 SIGNAL(error(QGeoRouteReply*,QGeoRouteReply::Error,QString)),
                 this,
                 SLOT(routeError(QGeoRouteReply*,QGeoRouteReply::Error,QString)));
     }

 private slots:
     void routeCalculated(QGeoRouteReply *reply)
     {
         // A route request can ask for several alternative routes ...
         if (reply->routes().size() != 0) {

             // ... but by default it will only get a single route
             QGeoRoute route = reply->routes().at(0);

             //... now we have to make use of the route ...
         }

         reply->deleteLater();
     }

     void routeError(QGeoRouteReply *reply, QGeoRouteReply:Error error, const QString &errorString)
     {
         // ... inform the user that an error has occurred ...
         reply->deleteLater();
     }
 };

Member Function Documentation

QGeoRoutingManager::~QGeoRoutingManager()

Destroys this manager.

QGeoRouteReply * QGeoRoutingManager::calculateRoute(const QGeoRouteRequest & request)

Begins the calculation of the route specified by request.

A QGeoRouteReply object will be returned, which can be used to manage the routing operation and to return the results of the operation.

This manager and the returned QGeoRouteReply object will emit signals indicating if the operation completes or if errors occur.

Once the operation has completed, QGeoRouteReply::routes can be used to retrieve the calculated route or routes.

If request includes features which are not supported by this manager, as reported by the methods in this manager, then a QGeoRouteReply::UnsupportedOptionError will occur.

The user is responsible for deleting the returned reply object, although this can be done in the slot connected to QGeoRoutingManager::finished(), QGeoRoutingManager::error(), QGeoRouteReply::finished() or QGeoRouteReply::error() with deleteLater().

void QGeoRoutingManager::error(QGeoRouteReply * reply, QGeoRouteReply::Error error, QString errorString = QString()) [signal]

This signal is emitted when an error has been detected in the processing of reply. The QGeoRoutingManager::finished() signal will probably follow.

The error will be described by the error code error. If errorString is not empty it will contain a textual description of the error.

This signal and QGeoRouteReply::error() will be emitted at the same time.

Note: Do not delete the reply object in the slot connected to this signal. Use deleteLater() instead.

void QGeoRoutingManager::finished(QGeoRouteReply * reply) [signal]

This signal is emitted when reply has finished processing.

If reply::error() equals QGeoRouteReply::NoError then the processing finished successfully.

This signal and QGeoRouteReply::finished() will be emitted at the same time.

Note: Do not delete the reply object in the slot connected to this signal. Use deleteLater() instead.

QLocale QGeoRoutingManager::locale() const

Returns the locale used to hint to this routing manager about what language to use for addresses and instructions.

See also setLocale().

QString QGeoRoutingManager::managerName() const

Returns the name of the engine which implements the behaviour of this routing manager.

The combination of managerName() and managerVersion() should be unique amongst the plugin implementations.

int QGeoRoutingManager::managerVersion() const

Returns the version of the engine which implements the behaviour of this routin manager.

The combination of managerName() and managerVersion() should be unique amongst the plugin implementations.

void QGeoRoutingManager::setLocale(const QLocale & locale)

Sets the locale to be used by this manager to locale.

If this routing manager supports returning addresses and instructions in different languages, they will be returned in the language of locale.

The locale used defaults to the system locale if this is not set.

See also locale().

QGeoRouteRequest::FeatureTypes QGeoRoutingManager::supportedFeatureTypes() const

Returns the types of features that this manager can take into account during route planning.

QGeoRouteRequest::FeatureWeights QGeoRoutingManager::supportedFeatureWeights() const

Returns the weightings which this manager can apply to different features during route planning.

QGeoRouteRequest::ManeuverDetails QGeoRoutingManager::supportedManeuverDetails() const

Returns the levels of detail for navigation maneuvers which can be requested by this manager.

QGeoRouteRequest::RouteOptimizations QGeoRoutingManager::supportedRouteOptimizations() const

Returns the route optimizations supported by this manager.

QGeoRouteRequest::SegmentDetails QGeoRoutingManager::supportedSegmentDetails() const

Returns the levels of detail for routing segments which can be requested with this manager.

QGeoRouteRequest::TravelModes QGeoRoutingManager::supportedTravelModes() const

Returns the travel modes supported by this manager.

QGeoRouteReply * QGeoRoutingManager::updateRoute(const QGeoRoute & route, const QGeoCoordinate & position)

Begins the process of updating route based on the current position position.

A QGeoRouteReply object will be returned, which can be used to manage the routing operation and to return the results of the operation.

This manager and the returned QGeoRouteReply object will emit signals indicating if the operation completes or if errors occur.

If supportsRouteUpdates() returns false an QGeoRouteReply::UnsupportedOptionError will occur.

Once the operation has completed, QGeoRouteReply::routes can be used to retrieve the updated route.

The returned route could be entirely different to the original route, especially if position 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.

The user is responsible for deleting the returned reply object, although this can be done in the slot connected to QGeoRoutingManager::finished(), QGeoRoutingManager::error(), QGeoRouteReply::finished() or QGeoRouteReply::error() with deleteLater().

Cette page est une traduction d'une page de la documentation de Qt, écrite par Nokia Corporation and/or its subsidiary(-ies). Les éventuels problèmes résultant d'une mauvaise traduction ne sont pas imputables à Nokia. Qt 5.0-snapshot
Copyright © 2012 Developpez LLC. Tous droits réservés Developpez LLC. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon, vous encourez selon la loi jusqu'à 3 ans de prison et jusqu'à 300 000 E de dommages et intérêts. Cette page est déposée à la SACD.
Vous avez déniché une erreur ? Un bug ? Une redirection cassée ? Ou tout autre problème, quel qu'il soit ? Ou bien vous désirez participer à ce projet de traduction ? N'hésitez pas à nous contacter ou par MP !
 
 
 
 
Partenaires

Hébergement Web