feat: Add support for generating route tokens (#7694)

feat: A new field `route_token` is added to message `.google.maps.routeoptimization.v1.ShipmentRoute.Transition`
docs: A comment for method `BatchOptimizeTours` in service `RouteOptimization` is changed
docs: A comment for field `populate_transition_polylines` in message `.google.maps.routeoptimization.v1.OptimizeToursRequest` is changed
docs: A comment for field `code` in message `.google.maps.routeoptimization.v1.OptimizeToursValidationError` is changed
PiperOrigin-RevId: 677952232
Source-Link: googleapis/googleapis@534e49c
Source-Link: googleapis/googleapis-gen@da6e35d
Copy-Tag: eyJwIjoiTWFwc1JvdXRlT3B0aW1pemF0aW9uLy5Pd2xCb3QueWFtbCIsImgiOiJkYTZlMzVkMzFiMGRlOWRkYmFhOTdiZDk2NDg5OWZiYjliMWMwMDBjIn0=

MapsRouteOptimization/samples/V1/RouteOptimizationClient/batch_optimize_tours.php

@@ -40,23 +40,23 @@
  *
  * This method is a Long Running Operation (LRO). The inputs for optimization
  * (`OptimizeToursRequest` messages) and outputs (`OptimizeToursResponse`
- * messages) are read/written from/to Cloud Storage in user-specified
+ * messages) are read from and written to Cloud Storage in user-specified
  * format. Like the `OptimizeTours` method, each `OptimizeToursRequest`
  * contains a `ShipmentModel` and returns an `OptimizeToursResponse`
- * containing `ShipmentRoute`s, which are a set of routes to be performed by
- * vehicles minimizing the overall cost.
+ * containing `ShipmentRoute` fields, 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
+ * If the LRO `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.
+ * results are available in Cloud Storage.
  *
  * 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.
+ * Cloud Storage. Any requests that failed will not have their results
+ * available in Cloud Storage. 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.
  *

MapsRouteOptimization/src/V1/Client/RouteOptimizationClient.php

@@ -241,23 +241,23 @@ public function __call($method, $args)
      *
      * This method is a Long Running Operation (LRO). The inputs for optimization
      * (`OptimizeToursRequest` messages) and outputs (`OptimizeToursResponse`
-     * messages) are read/written from/to Cloud Storage in user-specified
+     * messages) are read from and written to Cloud Storage in user-specified
      * format. Like the `OptimizeTours` method, each `OptimizeToursRequest`
      * contains a `ShipmentModel` and returns an `OptimizeToursResponse`
-     * containing `ShipmentRoute`s, which are a set of routes to be performed by
-     * vehicles minimizing the overall cost.
+     * containing `ShipmentRoute` fields, 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
+     * If the LRO `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.
+     * results are available in Cloud Storage.
      *
      * 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.
+     * Cloud Storage. Any requests that failed will not have their results
+     * available in Cloud Storage. 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()} .
      *