The QGeoRouteRequest class represents the parameters and restrictions which define a request for routing information. More...
#include <QGeoRouteRequest>
enum | AvoidFeatureType { AvoidNothing, AvoidTolls, AvoidHighways, AvoidPublicTransit, ..., AvoidMotorPoolLanes } |
flags | AvoidFeatureTypes |
enum | InstructionDetail { NoInstructions, BasicInstructions } |
flags | InstructionDetails |
enum | RouteOptimization { ShortestRoute, FastestRoute, MostEconomicRoute, MostScenicRoute } |
flags | RouteOptimizations |
enum | SegmentDetail { NoSegmentData, BasicSegmentData } |
flags | SegmentDetails |
enum | TravelMode { CarTravel, PedestrianTravel, BicycleTravel, PublicTransitTravel, TruckTravel } |
flags | TravelModes |
QGeoRouteRequest ( const QList<QGeoCoordinate> & waypoints = QList<QGeoCoordinate> () ) | |
QGeoRouteRequest ( const QGeoCoordinate & origin, const QGeoCoordinate & destination ) | |
QGeoRouteRequest ( const QGeoRouteRequest & other ) | |
~QGeoRouteRequest () | |
AvoidFeatureTypes | avoidFeatureTypes () const |
QList<QGeoBoundingBox> | excludeAreas () const |
InstructionDetail | instructionDetail () const |
int | numberAlternativeRoutes () const |
RouteOptimizations | routeOptimization () const |
SegmentDetail | segmentDetail () const |
void | setAvoidFeatureTypes ( AvoidFeatureTypes avoidFeatureTypes ) |
void | setExcludeAreas ( const QList<QGeoBoundingBox> & areas ) |
void | setInstructionDetail ( InstructionDetail instructionDetail ) |
void | setNumberAlternativeRoutes ( int alternatives ) |
void | setRouteOptimization ( RouteOptimizations optimization ) |
void | setSegmentDetail ( SegmentDetail segmentDetail ) |
void | setTravelModes ( TravelModes travelModes ) |
void | setWaypoints ( const QList<QGeoCoordinate> & waypoints ) |
TravelModes | travelModes () const |
QList<QGeoCoordinate> | waypoints () const |
bool | operator!= ( const QGeoRouteRequest & other ) const |
QGeoRouteRequest & | operator= ( const QGeoRouteRequest & other ) |
bool | operator== ( const QGeoRouteRequest & other ) const |
The QGeoRouteRequest class represents the parameters and restrictions which define a request for routing information.
The default state of a QGeoRouteRequest instance will result in a request for basic route segment and navigation instructions describing the fastest route by car which covers the given waypoints.
There may be signifcant variation in the features supported by different providers of routing information, or even in the features supported by the same provider if different levels of authorization are used.
There are several functions in QGeoRoutingManager which can be used to check which features are supported with the current provider and authorization level.
See also QGeoRoutingManager.
Defines features to be avoided while planning a route.
Constant | Value | Description |
---|---|---|
QGeoRouteRequest::AvoidNothing | 0x00000000 | The route can be planned without considering features to be avoided. |
QGeoRouteRequest::AvoidTolls | 0x00000001 | Avoid routes that require the use of tollways. |
QGeoRouteRequest::AvoidHighways | 0x00000002 | Avoid routes that require the use of highways. |
QGeoRouteRequest::AvoidPublicTransit | 0x00000004 | Avoid routes that require the use of public transit. |
QGeoRouteRequest::AvoidFerries | 0x00000008 | Avoid routes that require the use of ferries. |
QGeoRouteRequest::AvoidTunnels | 0x00000010 | Avoid routes that require the use of tunnels. |
QGeoRouteRequest::AvoidDirtRoads | 0x00000020 | Avoid routes that require the use of dirt roads. |
QGeoRouteRequest::AvoidPark | 0x00000040 | Avoid routes that require the travel through parks. |
QGeoRouteRequest::AvoidMotorPoolLanes | 0x00000080 | Avoid routes that require the use of motor pool lanes. |
The AvoidFeatureTypes type is a typedef for QFlags<AvoidFeatureType>. It stores an OR combination of AvoidFeatureType values.
Defines the amount of instruction information that should be included with the route.
Constant | Value | Description |
---|---|---|
QGeoRouteRequest::NoInstructions | 0x0000 | No instructions should be included with the route. |
QGeoRouteRequest::BasicInstructions | 0x0001 | Basic instructions will be included with the route. This will include QGeoInstruction::instructionText(). |
The InstructionDetails type is a typedef for QFlags<InstructionDetail>. It stores an OR combination of InstructionDetail values.
Defines the type of optimization which is applied to the planning of the route.
Constant | Value | Description |
---|---|---|
QGeoRouteRequest::ShortestRoute | 0x0001 | Minimize the length of the journey. |
QGeoRouteRequest::FastestRoute | 0x0002 | Minimize the travelling time for the journey. |
QGeoRouteRequest::MostEconomicRoute | 0x0004 | Minimize the cost of the journey. |
QGeoRouteRequest::MostScenicRoute | 0x0008 | Maximize the scenic potential of the journey. |
The RouteOptimizations type is a typedef for QFlags<RouteOptimization>. It stores an OR combination of RouteOptimization values.
Defines the amount of route segment information that shoudl be included with the route.
Constant | Value | Description |
---|---|---|
QGeoRouteRequest::NoSegmentData | 0x0000 | No segment data should be included with the route. A route requested with this level of segment detail will initialise QGeoRouteSegment::path() as a straight line between the positions of the previous and next QGeoInstruction instances. |
QGeoRouteRequest::BasicSegmentData | 0x0001 | Basic segment data will be included with the route. This will include QGeoRouteSegment::path(). |
The SegmentDetails type is a typedef for QFlags<SegmentDetail>. It stores an OR combination of SegmentDetail values.
Defines modes of travel to be used for a route.
Constant | Value | Description |
---|---|---|
QGeoRouteRequest::CarTravel | 0x0001 | The route will be optimized for someone who is driving a car. |
QGeoRouteRequest::PedestrianTravel | 0x0002 | The route will be optimized for someone who is walking. |
QGeoRouteRequest::BicycleTravel | 0x0004 | The route will be optimized for someone who is riding a bicycle. |
QGeoRouteRequest::PublicTransitTravel | 0x0008 | The route will be optimized for someone who is making use of public transit. |
QGeoRouteRequest::TruckTravel | 0x0010 | The route will be optimized for someone who is driving a truck. |
The TravelModes type is a typedef for QFlags<TravelMode>. It stores an OR combination of TravelMode values.
Constructs a request to calculate a route through the coordinates waypoints.
The route will traverse the elements of waypoints in order.
Constructs a request to calculate a route between origin and destination.
Constructs a route request object from the contents of other.
Destroys the request.
Returns the features which this request specifies should be avoided during the planning of the route.
See also setAvoidFeatureTypes().
Returns areas the route must not cross.
See also setExcludeAreas().
Returns the level of detail which will be used in the representation of routing instructions.
See also setInstructionDetail().
Returns the number of alternative routes which will be requested.
See also setNumberAlternativeRoutes().
Returns the optimization criteria which this request specifies should be used while planning the route.
See also setRouteOptimization().
Returns the level of detail which will be used in the representation of routing segments.
See also setSegmentDetail().
Sets the features to be avoided during the planning of the route to avoidFeatureTypes.
The default value is QGeoRouteRequest::AvoidNothing.
See also avoidFeatureTypes().
Sets areas as excluded areas that the route must not cross.
See also excludeAreas().
Sets the level of detail to use when representing routing instructions to instructionDetail.
The default value is QGeoRouteRequest::BasicInstructions.
See also instructionDetail().
Sets the number of alternative routes to request to alternatives.
The default value is 0.
See also numberAlternativeRoutes().
Sets the optimization criteria to use while planning the route to optimization.
The default value is QGeoRouteRequest::FastestRoute.
See also routeOptimization().
Sets the level of detail to use when representing routing segments to segmentDetail.
See also segmentDetail().
Sets the travel modes which should be considered during the planning of the route to travelModes.
The default value is QGeoRouteRequest::CarTravel.
See also travelModes().
Sets waypoints as the waypoints that the route should pass through.
The waypoints should be given in order from origin to destination.
This request will be invalid until the waypoints have been set to a list containing two or more coordinates.
See also waypoints().
Returns the travel modes which this request specifies should be considered during the planning of the route.
See also setTravelModes().
Returns the waypoints that the route will pass through.
See also setWaypoints().
Returns whether this route request and other are equal.
Assigns other to this route request object and then returns a reference to this route request object.
Returns whether this route request and other are equal.