Skip to content

OptimizeWaypointsRequest

Source code in docs_src/capo_geo_routes/types/optimize_waypoints_request.py
class OptimizeWaypointsRequest(TypedDict, closed=True):
    avoid: NotRequired[
        "capo_geo_routes.types.waypoint_optimization_avoidance_options.WaypointOptimizationAvoidanceOptions"
    ]
    """<p>Features that are avoided. Avoidance is on a best-case basis. If an avoidance can't be satisfied for a particular case, this setting is ignored.</p>"""
    clustering: NotRequired[
        "capo_geo_routes.types.waypoint_optimization_clustering_options.WaypointOptimizationClusteringOptions"
    ]
    """<p>Clustering allows you to specify how nearby waypoints can be clustered to improve the optimized sequence.</p>"""
    departure_time: NotRequired[
        "capo_geo_routes.types.timestamp_with_timezone_offset.TimestampWithTimezoneOffset"
    ]
    """<p>Departure time from the waypoint.</p> <p>Time format:<code>YYYY-MM-DDThh:mm:ss.sssZ | YYYY-MM-DDThh:mm:ss.sss+hh:mm</code> </p> <p>Examples:</p> <p> <code>2020-04-22T17:57:24Z</code> </p> <p> <code>2020-04-22T17:57:24+02:00</code> </p>"""
    destination: NotRequired["capo_geo_routes.types.position.Position"]
    """<p>The final position for the route in the World Geodetic System (WGS 84) format: <code>[longitude, latitude]</code>.</p>"""
    destination_options: NotRequired[
        "capo_geo_routes.types.waypoint_optimization_destination_options.WaypointOptimizationDestinationOptions"
    ]
    """<p>Destination related options.</p>"""
    driver: NotRequired[
        "capo_geo_routes.types.waypoint_optimization_driver_options.WaypointOptimizationDriverOptions"
    ]
    """<p>Driver related options.</p>"""
    exclude: NotRequired[
        "capo_geo_routes.types.waypoint_optimization_exclusion_options.WaypointOptimizationExclusionOptions"
    ]
    """<p>Features to be strictly excluded while calculating the route.</p>"""
    key: NotRequired["capo_geo_routes.types.api_key.ApiKey"]
    """<p>Optional: The API key to be used for authorization. Either an API key or valid SigV4 signature must be provided when making a request. </p>"""
    optimize_sequencing_for: NotRequired[
        "capo_geo_routes.types.waypoint_optimization_sequencing_objective.WaypointOptimizationSequencingObjective"
    ]
    """<p>Specifies the optimization criteria for the calculated sequence.</p> <p>Default value: <code>FastestRoute</code>.</p>"""
    origin: "capo_geo_routes.types.position.Position"
    """<p>The start position for the route in World Geodetic System (WGS 84) format: [longitude, latitude].</p>"""
    origin_options: NotRequired[
        "capo_geo_routes.types.waypoint_optimization_origin_options.WaypointOptimizationOriginOptions"
    ]
    """<p>Origin related options.</p>"""
    traffic: NotRequired[
        "capo_geo_routes.types.waypoint_optimization_traffic_options.WaypointOptimizationTrafficOptions"
    ]
    """<p>Traffic-related options.</p>"""
    travel_mode: NotRequired[
        "capo_geo_routes.types.waypoint_optimization_travel_mode.WaypointOptimizationTravelMode"
    ]
    """<p>Specifies the mode of transport when calculating a route. Used in estimating the speed of travel and road compatibility.</p> <p>Default value: <code>Car</code> </p>"""
    travel_mode_options: NotRequired[
        "capo_geo_routes.types.waypoint_optimization_travel_mode_options.WaypointOptimizationTravelModeOptions"
    ]
    """<p>Travel mode related options for the provided travel mode.</p>"""
    waypoints: NotRequired[
        "capo_geo_routes.types.waypoint_optimization_waypoint_list.WaypointOptimizationWaypointList"
    ]
    """<p>List of waypoints between the <code>Origin</code> and <code>Destination</code>, in World Geodetic System (WGS 84) format: [longitude, latitude].</p> <p>The maximum number of waypoints allowed per request:</p> <ul> <li> <p>Maximum 50 waypoints per request</p> </li> <li> <p>Maximum 20 waypoints when using constraints (<code>AccessHours</code>, <code>AppointmentTime</code>, <code>ServiceDuration</code>, <code>Heading</code>, <code>SideOfStreet</code>, <code>Before</code>)</p> </li> </ul>"""

avoid instance-attribute

Features that are avoided. Avoidance is on a best-case basis. If an avoidance can't be satisfied for a particular case, this setting is ignored.

clustering instance-attribute

clustering: NotRequired[WaypointOptimizationClusteringOptions]

Clustering allows you to specify how nearby waypoints can be clustered to improve the optimized sequence.

departure_time instance-attribute

departure_time: NotRequired[TimestampWithTimezoneOffset]

Departure time from the waypoint.

Time format:YYYY-MM-DDThh:mm:ss.sssZ | YYYY-MM-DDThh:mm:ss.sss+hh:mm

Examples:

2020-04-22T17:57:24Z

2020-04-22T17:57:24+02:00

destination instance-attribute

destination: NotRequired[Position]

The final position for the route in the World Geodetic System (WGS 84) format: [longitude, latitude].

destination_options instance-attribute

destination_options: NotRequired[WaypointOptimizationDestinationOptions]

Destination related options.

driver instance-attribute

driver: NotRequired[WaypointOptimizationDriverOptions]

Driver related options.

exclude instance-attribute

Features to be strictly excluded while calculating the route.

key instance-attribute

key: NotRequired[ApiKey]

Optional: The API key to be used for authorization. Either an API key or valid SigV4 signature must be provided when making a request.

optimize_sequencing_for instance-attribute

optimize_sequencing_for: NotRequired[WaypointOptimizationSequencingObjective]

Specifies the optimization criteria for the calculated sequence.

Default value: FastestRoute.

origin instance-attribute

origin: Position

The start position for the route in World Geodetic System (WGS 84) format: [longitude, latitude].

origin_options instance-attribute

origin_options: NotRequired[WaypointOptimizationOriginOptions]

Origin related options.

traffic instance-attribute

traffic: NotRequired[WaypointOptimizationTrafficOptions]

Traffic-related options.

travel_mode instance-attribute

travel_mode: NotRequired[WaypointOptimizationTravelMode]

Specifies the mode of transport when calculating a route. Used in estimating the speed of travel and road compatibility.

Default value: Car

travel_mode_options instance-attribute

travel_mode_options: NotRequired[WaypointOptimizationTravelModeOptions]

Travel mode related options for the provided travel mode.

waypoints instance-attribute

waypoints: NotRequired[WaypointOptimizationWaypointList]

List of waypoints between the Origin and Destination, in World Geodetic System (WGS 84) format: [longitude, latitude].

The maximum number of waypoints allowed per request:

  • Maximum 50 waypoints per request

  • Maximum 20 waypoints when using constraints (AccessHours, AppointmentTime, ServiceDuration, Heading, SideOfStreet, Before)