feat: minor fields and documentation update (#7669)

feat: A new message `RouteModifiers` is added feat: A new field `route_modifiers` is added to message `.google.maps.routeoptimization.v1.Vehicle` feat: A new field `cost_per_kilometer_below_soft_max` is added to message `.google.maps.routeoptimization.v1.DistanceLimit` docs: A comment for method `BatchOptimizeTours` in service `RouteOptimization` is changed docs: A comment for enum value `DEFAULT_SOLVE` in enum `SolvingMode` is changed docs: A comment for field `validation_errors` in message `.google.maps.routeoptimization.v1.OptimizeToursResponse` is changed docs: A comment for message `TimeWindow` is changed docs: A comment for enum value `CODE_UNSPECIFIED` in enum `Code` is changed docs: A comment for field `reasons` in message `.google.maps.routeoptimization.v1.SkippedShipment` is changed docs: A comment for enum value `RELAX_VISIT_TIMES_AND_SEQUENCE_AFTER_THRESHOLD` in enum `Level` is changed docs: A comment for message `OptimizeToursValidationError` is changed docs: A comment for field `code` in message `.google.maps.routeoptimization.v1.OptimizeToursValidationError` is changed PiperOrigin-RevId: 674021227 Source-Link: googleapis/googleapis@a834320 Source-Link: googleapis/googleapis-gen@13dfeeb Copy-Tag: eyJwIjoiTWFwc1JvdXRlT3B0aW1pemF0aW9uLy5Pd2xCb3QueWFtbCIsImgiOiIxM2RmZWViMjFkN2RkMTZjNmY4MGY3MTk2ZTA3YTJhMmFjZTM1ZWI0In0=
googleapis · Sep 13, 2024 · d08872a · d08872a
1 parent 2bd2f09
commit d08872a
Show file tree

Hide file tree

Showing 13 changed files with 430 additions and 23 deletions.
diff --git a/MapsRouteOptimization/metadata/V1/RouteOptimizationService.php b/MapsRouteOptimization/metadata/V1/RouteOptimizationService.php
diff --git a/MapsRouteOptimization/samples/V1/RouteOptimizationClient/batch_optimize_tours.php b/MapsRouteOptimization/samples/V1/RouteOptimizationClient/batch_optimize_tours.php
@@ -46,6 +46,18 @@
  * containing `ShipmentRoute`s, which are a set of routes to be performed by
  * vehicles minimizing the overall cost.
  *
+ * The user can poll `operations.get` to check the status of the LRO:
+ *
+ * If the LRO's `done` field is false, then at least one request is still
+ * being processed. Other requests may have completed successfully and their
+ * results are available in GCS.
+ *
+ * If the LRO's `done` field is true, then all requests have been processed.
+ * Any successfully processed requests will have their results available in
+ * GCS. Any requests that failed will not have their results available in
+ * GCS. If the LRO's `error` field is set, then it contains the error from
+ * one of the failed requests.
+ *
  * @param string $parent                             Target project and location to make a call.
  *
  *                                                   Format:

diff --git a/MapsRouteOptimization/src/V1/Client/RouteOptimizationClient.php b/MapsRouteOptimization/src/V1/Client/RouteOptimizationClient.php
@@ -247,6 +247,18 @@ public function __call($method, $args)
      * containing `ShipmentRoute`s, which are a set of routes to be performed by
      * vehicles minimizing the overall cost.
      *
+     * The user can poll `operations.get` to check the status of the LRO:
+     *
+     * If the LRO's `done` field is false, then at least one request is still
+     * being processed. Other requests may have completed successfully and their
+     * results are available in GCS.
+     *
+     * If the LRO's `done` field is true, then all requests have been processed.
+     * Any successfully processed requests will have their results available in
+     * GCS. Any requests that failed will not have their results available in
+     * GCS. If the LRO's `error` field is set, then it contains the error from
+     * one of the failed requests.
+     *
      * The async variant is {@see RouteOptimizationClient::batchOptimizeToursAsync()} .
      *
      * @example samples/V1/RouteOptimizationClient/batch_optimize_tours.php

diff --git a/MapsRouteOptimization/src/V1/DistanceLimit.php b/MapsRouteOptimization/src/V1/DistanceLimit.php
diff --git a/...eOptimization/src/V1/InjectedSolutionConstraint/ConstraintRelaxation/Relaxation/Level.php b/...eOptimization/src/V1/InjectedSolutionConstraint/ConstraintRelaxation/Relaxation/Level.php
diff --git a/MapsRouteOptimization/src/V1/OptimizeToursRequest/SolvingMode.php b/MapsRouteOptimization/src/V1/OptimizeToursRequest/SolvingMode.php
diff --git a/MapsRouteOptimization/src/V1/OptimizeToursResponse.php b/MapsRouteOptimization/src/V1/OptimizeToursResponse.php
diff --git a/MapsRouteOptimization/src/V1/OptimizeToursValidationError.php b/MapsRouteOptimization/src/V1/OptimizeToursValidationError.php