QGeoRoute Class Reference
The QGeoRoute class represents a route between two points. More...
#include <QGeoRoute>
Public Functions
Detailed Description
The QGeoRoute class represents a route between two points.
A QGeoRoute object contains high level information about a route, such as the length the route, the estimated travel time for the route, and enough information to render a basic image of the route on a map.
The QGeoRoute object also contains a list of QGeoRouteSegment objecs, or objects derived from QGeoRouteSegment, which describe subsections of the route in greater detail. The subclasses of QGeoRouteSegment are used to provide specific information for the subsection of the route for particular cases, as may be needed when the segment is to be traversed via public transport or in a truck.
Routing information is normally requested using QGeoRoutingManager::calculateRoute(), which returns a QGeoRouteReply instance. If the operation is completed successfully the routing information can be accessed with QGeoRouteReply::routes()
See also QGeoRoutingManager.
Member Function Documentation
QGeoRoute::QGeoRoute ()
Constructs a route object.
QGeoRoute::QGeoRoute ( const QGeoRoute & other )
Constructs a route object from the contents of other.
QGeoRoute::~QGeoRoute ()
Destroys this route object.
Returns a bounding box which encompasses the entire route.
See also setBounds().
qreal QGeoRoute::distance () const
Returns the distance covered by this route, in metres.
See also setDistance().
QList<QGeoCoordinate> QGeoRoute::path () const
Returns the geometric shape of the route.
The coordinates should be listed in the order in which they would be traversed by someone travelling along this segment of the route.
See also setPath().
Returns the route request which describes the criteria used in the calculation of this route.
See also setRequest().
QString QGeoRoute::routeId () const
Returns the ID of this route.
Service providers which support the updating of routes commonly assign IDs to routes. If this route did not come from such a service provider the function will return an empty string.
See also setRouteId().
QList<QGeoRouteSegment> QGeoRoute::routeSegments () const
Returns the route segments.
QGeoRouteSegment contains more detailed information than QGeoRoute and can be subclasses to provide more specialized information, such as for the description of segments of the journey for those who are travelling by public transport, or by truck.
See also setRouteSegments().
void QGeoRoute::setBounds ( const QGeoBoundingBox & bounds )
Sets the bounding box which encompasses the entire route to bounds.
See also bounds().
void QGeoRoute::setDistance ( qreal distance )
Sets the distance covered by this route, in metres, to distance.
See also distance().
void QGeoRoute::setPath ( const QList<QGeoCoordinate> & path )
Sets the geometric shape of the route to path.
The coordinates in path should be listed in the order in which they would be traversed by someone travelling along this segment of the route.
See also path().
void QGeoRoute::setRequest ( const QGeoRouteRequest & request )
Sets the route request which describes the criteria used in the calculcation of this route to request.
See also request().
void QGeoRoute::setRouteId ( const QString & id )
Sets the ID of this route to id.
Service providers which support the updating of routes commonly assign IDs to routes. If this route came from such a service provider changing the ID will probably cause route updates to stop working.
See also routeId().
void QGeoRoute::setRouteSegments ( const QList<QGeoRouteSegment> & routeSegments )
Sets the list of route segements to routeSegments.
QGeoRouteSegment contains more detailed information than QGeoRoute and can be subclasses to provide more specialized information, such as for the description of segments of the journey for those who are travelling by public transport, or by truck.
See also routeSegments().
Sets the travel mode for this route.
This should be one of the travel modes returned by request().travelModes().
See also travelMode().
void QGeoRoute::setTravelTime ( int secs )
Sets the estimated amount of time it will take to traverse this route, in seconds, to secs.
See also travelTime().
Returns the travel mode for the this route.
This should be one of the travel modes returned by request().travelModes().
See also setTravelMode().
int QGeoRoute::travelTime () const
Returns the estimated amount of time it will take to traverse this route, in seconds.
See also setTravelTime().
QGeoRoute & QGeoRoute::operator= ( const QGeoRoute & other )
Assigns the contents of other to this route and returns a reference to this route.