Waypoint class

Represents a waypoint, used as input for route calculation.

Constructors

Waypoint(GeoCoordinates coordinates, [WaypointType type = WaypointType.stopover, int transitRadiusInMeters = 0, double? headingInDegrees = null, GeoCoordinates? sideOfStreetHint = null, GeoCoordinates? displayLocation = null, int? minCourseDistanceInMeters = null, String? nameHint = null, MatchSideOfStreet? matchSideOfStreet = null, Duration duration = const Duration(seconds: 0), SegmentReference? segmentHint = null, int? onRoadThresholdInMeters = null, ChargingStop? chargingStop = null, int? currentWeightChangeInKilograms = null])
Creates a new instance.
Waypoint.withDefaults(GeoCoordinates coordinates)
Creates a new instance.

Properties

chargingStop ↔ ChargingStop?
Specifies of a user-planned charging stop. The resulting Route may contain this waypoint as a RoutePlace with a non-null ChargingStation member when the provided specifications indicate that a stop is required to charge the EV battery. Note: If EVCarOptions.ensure_reachability is not set as true and ChargingStop.min_duration is not provided, route calculation may suggest a better charging stop instead of this stop.
getter/setter pair
coordinates ↔ GeoCoordinates
The waypoint's geographic coordinates.
getter/setter pair
currentWeightChangeInKilograms ↔ int?
Changes the value of vehicle[currentWeight] by this value. Enables the support of scenarios where the vehicle takes additional cargo or unloads its cargo along the route. Changes to the configuration of the vehicle, such as adding a trailer, aren't supported. Relative value in kilograms. Available range: from -40000 to 40000 (inclusive). Note:
getter/setter pair
displayLocation ↔ GeoCoordinates?
Optional coordinates to indicate physical location of the Points of Interest (PoI). It is different from coordinates and Waypoint.sideOfStreetHint which are generally expected to to be on the navigable road network and can be different from actual location of the PoI. display_location is used for visualization of the PoI regardless of road network.
getter/setter pair
duration ↔ Duration
The duration in seconds that should be spent at a waypoint of type WaypointType.stopover. Impacts time-aware calculations. Ignored for waypoints of type WaypointType.passThrough. The default duration is 0 seconds.
getter/setter pair
hashCode → int
The hash code for this object.
no setter
headingInDegrees ↔ double?
Optional heading angle referenced by true North, clockwise specifying the direction of travel. The heading direction may help the routing algorithm to select the best direction, for example, when multiple directions are possible at a road junction. North is 0 degrees, East is 90 degrees, South is 180 degrees, and West is 270 degrees. The value must be in the range [0, 360] when specified. By default, or when null is set, heading is ignored for route calculation.
getter/setter pair
matchSideOfStreet ↔ MatchSideOfStreet?
Specifies how the location set by Waypoint.sideOfStreetHint should be handled. Note that this setting might affect the geometry of the resulting route.
getter/setter pair
minCourseDistanceInMeters ↔ int?
Optional distance in meters during which the user wants to avoid taking actions. For example, if the origin is set by a moving vehicle, the user might not have time to react to immediate actions such as a sharp right turn.
getter/setter pair
nameHint ↔ String?
Optional name hint causes the router to look for the place with the most similar name. This can e.g. include things like: North being used to differentiate between interstates I66 North and I66 South, Downtown Avenue being used to correctly select a residential street.
getter/setter pair
onRoadThresholdInMeters ↔ int?
Optional threshold allows specifying a distance within which the waypoint could be considered as being on a highway/bridge/tunnel/sliproad. Within this threshold, the attributes of the segments do not impact the matching. Outside the threshold only segments which aren't one of highway/bridge/tunnel/sliproad can be matched.
getter/setter pair
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited
segmentHint ↔ SegmentReference?
Optional segment hint causes the router to try and match to the specified segment. Waypoint coordinates need to be on the segment, otherwise waypoint will be matched ignoring the segment hint. This parameter can be used when the waypoint is too close to more than one segment to force matching to a specific one. Only topology segment id and travel direction are used to define the segment hint
getter/setter pair
sideOfStreetHint ↔ GeoCoordinates?
Optional coordinates to indicate which side of the street should be used to reach the waypoint. For example, if the location is to the left of the street, the router will prefer using that side in case the street has dividers. Note that this option is ignored if the user sets Waypoint.transitRadiusInMeters option with a value greater than zero.
getter/setter pair
transitRadiusInMeters ↔ int
The maximum allowed distance from the waypoint that the calculated route may pass through. For example, to drive past a city without necessarily going into the city center, you can specify the coordinates of the center and a transit radius of 5000m. The default transit radius is zero. If the route should pass the waypoint as close as possible, the default value should be kept. Note that the waypoint will be map-matched to a road. Non-zero values allow a greater tolerance. Note that Waypoint.sideOfStreetHint option is ignored if the user sets this option with a value greater than zero.
getter/setter pair
type ↔ WaypointType
Defines how a waypoint should be considered for route calculation. The default waypoint type is WaypointType.stopover.
getter/setter pair

Methods

noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
toString() → String
A string representation of this object.
inherited

Operators

operator ==(Object other) → bool
The equality operator.