The RouteQuery type is used to provide query parameters to a RouteModel . 更多...
import 语句: | import QtLocation 5.3 |
Since: | Qt Location 5.5 |
A RouteQuery contains all the parameters necessary to make a request to a routing service, which can then populate the contents of a RouteModel .
These parameters describe key details of the route, such as waypoints to pass through, excludedAreas to avoid, the travelModes in use, as well as detailed preferences on how to optimize the route and what features to prefer or avoid along the path (such as toll roads, highways, etc).
RouteQuery objects are used exclusively to fill out the value of a RouteModel 's query property, which can then begin the retrieval process to populate the model.
The following snipped shows an incomplete example of creating a RouteQuery object and setting it as the value of a RouteModel 's query 特性。
RouteQuery {
id: aQuery
}
RouteModel {
query: aQuery
autoUpdate: false
}
For a more complete example, see the documentation for the RouteModel type, and the Mapviewer example.
另请参阅 RouteModel .
excludedAreas : list < georectangle > |
Areas that the route must not cross.
Excluded areas can be set as part of the RouteQuery type declaration or dynamically with the functions provided.
另请参阅 addExcludedArea , removeExcludedArea ,和 clearExcludedAreas .
List of features that will be considered when planning the route. Features with a weight of NeutralFeatureWeight will not be returned.
另请参阅 setFeatureWeight and featureWeight .
The level of detail which will be used in the representation of routing maneuvers.
默认值为 RouteQuery .BasicManeuvers
The number of alternative routes requested when requesting routes. The default value is 0.
The route optimizations which should be considered during the planning of the route. Values can be combined with OR ('|') -operator.
默认值为 RouteQuery .FastestRoute
The level of detail which will be used in the representation of routing segments.
默认值为 RouteQuery .BasicSegmentData
The travel modes which should be considered during the planning of the route. Values can be combined with OR ('|') -operator.
默认值为 RouteQuery .CarTravel
waypoints : list < coordinate > |
The waypoint coordinates of the desired route. The waypoints should be given in order from origin to destination. Two or more coordinates are needed.
Waypoints can be set as part of the RouteQuery type declaration or dynamically with the functions provided.
另请参阅 addWaypoint , removeWaypoint ,和 clearWaypoints .
Adds the given area to excluded areas (areas that the route must not cross). Same area can only be added once.
另请参阅 removeExcludedArea and clearExcludedAreas .
Appends a coordinate to the list of waypoints. Same coordinate can be set multiple times.
另请参阅 removeWaypoint and clearWaypoints .
Clears all excluded areas (areas that the route must not cross).
另请参阅 addExcludedArea and removeExcludedArea .
Clears all waypoints.
另请参阅 removeWaypoint and addWaypoint .
Gets the weight for the featureType .
另请参阅 featureTypes , setFeatureWeight ,和 resetFeatureWeights .
Removes the given area to excluded areas (areas that the route must not cross).
另请参阅 addExcludedArea and clearExcludedAreas .
Removes the given from the list of waypoints. In case same coordinate appears multiple times, the most recently added coordinate instance is removed.
另请参阅 addWaypoint and clearWaypoints .
Resets all feature weights to their default state (NeutralFeatureWeight).
另请参阅 featureTypes , setFeatureWeight ,和 featureWeight .
Defines the weight to associate with a feature during the planning of a route.
Following lists the possible feature weights:
另请参阅 featureTypes , resetFeatureWeights ,和 featureWeight .