@googlemaps/routing 0.5.1 → 1.0.0

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## [1.0.0](https://github.com/googleapis/google-cloud-node/compare/routing-v0.6.0...routing-v1.0.0) (2023-08-06)
+
+
+### ⚠ BREAKING CHANGES
+
+* migrate to Node 14 ([#4443](https://github.com/googleapis/google-cloud-node/issues/4443))
+
+### Bug Fixes
+
+* [Many APIs] fix typings for IAM methods ([#4466](https://github.com/googleapis/google-cloud-node/issues/4466)) ([fa1520c](https://github.com/googleapis/google-cloud-node/commit/fa1520c3eb526efd3523d9cea349ed31683d5889))
+
+
+### Miscellaneous Chores
+
+* Migrate to Node 14 ([#4443](https://github.com/googleapis/google-cloud-node/issues/4443)) ([2260f12](https://github.com/googleapis/google-cloud-node/commit/2260f12543d171bda95345e53475f5f0fdc45770))
+
+## [0.6.0](https://github.com/googleapis/google-cloud-node/compare/routing-v0.5.1...routing-v0.6.0) (2023-07-04)
+
+
+### Features
+
+* [routing] Add HTML Navigation Instructions feature to ComputeRoutes ([#4381](https://github.com/googleapis/google-cloud-node/issues/4381)) ([8414c84](https://github.com/googleapis/google-cloud-node/commit/8414c8458133ecc654d25eeb8b0b90c4dac9ff04))
+
 ## [0.5.1](https://github.com/googleapis/google-cloud-node/compare/routing-v0.5.0...routing-v0.5.1) (2023-04-13)
 
 

package/README.md

@@ -2,7 +2,7 @@
 [//]: # "To regenerate it, use `python -m synthtool`."
 <img src="https://avatars2.githubusercontent.com/u/2810941?v=3&s=96" alt="Google Cloud Platform logo" title="Google Cloud Platform" align="right" height="96" width="96"/>
 
-# [Google Maps Routing: Node.js Client](https://github.com/googleapis/google-cloud-node)
+# [Google Maps Routing: Node.js Client](https://github.com/googleapis/google-cloud-node/tree/main/packages/google-maps-routing)
 
 [![release level](https://img.shields.io/badge/release%20level-preview-yellow.svg?style=flat)](https://cloud.google.com/terms/launch-stages)
 [![npm version](https://img.shields.io/npm/v/@googlemaps/routing.svg)](https://www.npmjs.org/package/@googlemaps/routing)
@@ -158,14 +158,13 @@ callComputeRoutes();
 
 ## Samples
 
-Samples are in the [`samples/`](https://github.com/googleapis/google-cloud-node/tree/main/samples) directory. Each sample's `README.md` has instructions for running its sample.
+Samples are in the [`samples/`](https://github.com/googleapis/google-cloud-node/tree/main/packages/google-maps-routing/samples) directory. Each sample's `README.md` has instructions for running its sample.
 
 | Sample                      | Source Code                       | Try it |
 | --------------------------- | --------------------------------- | ------ |
-| Routes.compute_route_matrix | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-routing/samples/generated/v2/routes.compute_route_matrix.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-maps-routing/samples/generated/v2/routes.compute_route_matrix.js,samples/README.md) |
-| Routes.compute_routes | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-routing/samples/generated/v2/routes.compute_routes.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-maps-routing/samples/generated/v2/routes.compute_routes.js,samples/README.md) |
-| Quickstart | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-routing/samples/quickstart.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-maps-routing/samples/quickstart.js,samples/README.md) |
-| Quickstart | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-routing/samples/test/quickstart.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-maps-routing/samples/test/quickstart.js,samples/README.md) |
+| Routes.compute_route_matrix | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-routing/samples/generated/v2/routes.compute_route_matrix.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-maps-routing/samples/generated/v2/routes.compute_route_matrix.js,packages/google-maps-routing/samples/README.md) |
+| Routes.compute_routes | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-routing/samples/generated/v2/routes.compute_routes.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-maps-routing/samples/generated/v2/routes.compute_routes.js,packages/google-maps-routing/samples/README.md) |
+| Quickstart | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-routing/samples/quickstart.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-maps-routing/samples/quickstart.js,packages/google-maps-routing/samples/README.md) |
 
 
 

package/build/protos/google/maps/routing/v2/localized_time.proto

@@ -0,0 +1,40 @@
+// Copyright 2023 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.maps.routing.v2;
+
+import "google/type/localized_text.proto";
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Maps.Routing.V2";
+option go_package = "cloud.google.com/go/maps/routing/apiv2/routingpb;routingpb";
+option java_multiple_files = true;
+option java_outer_classname = "LocalizedTimeProto";
+option java_package = "com.google.maps.routing.v2";
+option objc_class_prefix = "GMRV2";
+option php_namespace = "Google\\Maps\\Routing\\V2";
+option ruby_package = "Google::Maps::Routing::V2";
+
+// Localized description of time.
+message LocalizedTime {
+  // The time specified as a string in a given time zone.
+  google.type.LocalizedText time = 1;
+
+  // Contains the time zone. The value is the name of the time zone as defined
+  // in the [IANA Time Zone Database](http://www.iana.org/time-zones), e.g.
+  // "America/New_York".
+  string time_zone = 2;
+}

package/build/protos/google/maps/routing/v2/location.proto

@@ -35,10 +35,10 @@ message Location {
   google.type.LatLng lat_lng = 1;
 
   // The compass heading associated with the direction of the flow of traffic.
-  // This value is used to specify the side of the road to use for pickup and
-  // drop-off. Heading values can be from 0 to 360, where 0 specifies a heading
-  // of due North, 90 specifies a heading of due East, etc. You can use this
-  // field only for `DRIVE` and `TWO_WHEELER`
+  // This value specifies the side of the road for pickup and drop-off. Heading
+  // values can be from 0 to 360, where 0 specifies a heading of due North, 90
+  // specifies a heading of due East, and so on. You can use this field only for
+  // `DRIVE` and `TWO_WHEELER`
   // [RouteTravelMode][google.maps.routing.v2.RouteTravelMode].
   google.protobuf.Int32Value heading = 2;
 }

package/build/protos/google/maps/routing/v2/maneuver.proto

@@ -85,4 +85,10 @@ enum Maneuver {
 
   // Turn right at the roundabout.
   ROUNDABOUT_RIGHT = 18;
+
+  // Initial maneuver.
+  DEPART = 19;
+
+  // Used to indicate a street name change.
+  NAME_CHANGE = 20;
 }

package/build/protos/google/maps/routing/v2/route.proto

@@ -17,13 +17,19 @@ syntax = "proto3";
 package google.maps.routing.v2;
 
 import "google/geo/type/viewport.proto";
+import "google/maps/routing/v2/localized_time.proto";
 import "google/maps/routing/v2/location.proto";
 import "google/maps/routing/v2/navigation_instruction.proto";
 import "google/maps/routing/v2/polyline.proto";
 import "google/maps/routing/v2/route_label.proto";
+import "google/maps/routing/v2/route_travel_mode.proto";
 import "google/maps/routing/v2/speed_reading_interval.proto";
 import "google/maps/routing/v2/toll_info.proto";
+import "google/maps/routing/v2/transit.proto";
 import "google/protobuf/duration.proto";
+import "google/protobuf/timestamp.proto";
+import "google/type/localized_text.proto";
+import "google/type/money.proto";
 
 option cc_enable_arenas = true;
 option csharp_namespace = "Google.Maps.Routing.V2";
@@ -35,20 +41,38 @@ option objc_class_prefix = "GMRV2";
 option php_namespace = "Google\\Maps\\Routing\\V2";
 option ruby_package = "Google::Maps::Routing::V2";
 
-// Encapsulates a route, which consists of a series of connected road segments
+// Contains a route, which consists of a series of connected road segments
 // that join beginning, ending, and intermediate waypoints.
 message Route {
+  // Text representations of certain properties.
+  message RouteLocalizedValues {
+    // Travel distance represented in text form.
+    google.type.LocalizedText distance = 1;
+
+    // Duration taking traffic conditions into consideration, represented in
+    // text form. Note: If you did not request traffic information, this value
+    // will be the same value as static_duration.
+    google.type.LocalizedText duration = 2;
+
+    // Duration without taking traffic conditions into
+    // consideration, represented in text form.
+    google.type.LocalizedText static_duration = 3;
+
+    // Transit fare represented in text form.
+    google.type.LocalizedText transit_fare = 4;
+  }
+
   // Labels for the `Route` that are useful to identify specific properties
   // of the route to compare against others.
   repeated RouteLabel route_labels = 13;
 
-  // A collection of legs (path segments between waypoints) that make-up the
+  // A collection of legs (path segments between waypoints) that make up the
   // route. Each leg corresponds to the trip between two non-`via`
   // [Waypoints][google.maps.routing.v2.Waypoint]. For example, a route with no
   // intermediate waypoints has only one leg. A route that includes one
   // non-`via` intermediate waypoint has two legs. A route that includes one
   // `via` intermediate waypoint has one leg. The order of the legs matches the
-  // order of Waypoints from `origin` to `intermediates` to `destination`.
+  // order of waypoints from `origin` to `intermediates` to `destination`.
   repeated RouteLeg legs = 1;
 
   // The travel distance of the route, in meters.
@@ -61,11 +85,11 @@ message Route {
   // taking traffic conditions into account.
   google.protobuf.Duration duration = 3;
 
-  // The duration of traveling through the route without taking traffic
+  // The duration of travel through the route without taking traffic
   // conditions into consideration.
   google.protobuf.Duration static_duration = 4;
 
-  // The overall route polyline. This polyline will be the combined polyline of
+  // The overall route polyline. This polyline is the combined polyline of
   // all `legs`.
   Polyline polyline = 5;
 
@@ -81,26 +105,40 @@ message Route {
   // Additional information about the route.
   RouteTravelAdvisory travel_advisory = 9;
 
-  // Web-safe base64 encoded route token that can be passed to NavigationSDK,
-  // which allows the Navigation SDK to reconstruct the route during navigation,
-  // and in the event of rerouting honor the original intention when Routes
-  // ComputeRoutes is called. Customers should treat this token as an
-  // opaque blob.
+  // If you set
+  // [optimize_waypoint_order][google.maps.routing.v2.ComputeRoutesRequest.optimize_waypoint_order]
+  // to true, this field contains the optimized ordering of intermediate
+  // waypoints. Otherwise, this field is empty.
+  // For example, if you give an input of Origin: LA; Intermediate waypoints:
+  // Dallas, Bangor, Phoenix; Destination: New York; and the optimized
+  // intermediate waypoint order is Phoenix, Dallas, Bangor, then this field
+  // contains the values [2, 0, 1]. The index starts with 0 for the first
+  // intermediate waypoint provided in the input.
+  repeated int32 optimized_intermediate_waypoint_index = 10;
+
+  // Text representations of properties of the `Route`.
+  RouteLocalizedValues localized_values = 11;
+
+  // A web-safe, base64-encoded route token that can be passed to the Navigation
+  // SDK, that allows the Navigation SDK to reconstruct the route during
+  // navigation, and, in the event of rerouting, honor the original intention
+  // when you created the route by calling ComputeRoutes. Customers should treat
+  // this token as an opaque blob. It is not meant for reading or mutating.
   // NOTE: `Route.route_token` is only available for requests that have set
   // `ComputeRoutesRequest.routing_preference` to `TRAFFIC_AWARE` or
-  // `TRAFFIC_AWARE_OPTIMAL`. `Route.route_token` is also not supported for
-  // requests that have Via waypoints.
+  // `TRAFFIC_AWARE_OPTIMAL`. `Route.route_token` is not supported for requests
+  // that have Via waypoints.
   string route_token = 12;
 }
 
-// Encapsulates the additional information that the user should be informed
-// about, such as possible traffic zone restriction etc.
+// Contains the additional information that the user should be informed
+// about, such as possible traffic zone restrictions.
 message RouteTravelAdvisory {
-  // Encapsulates information about tolls on the Route.
-  // This field is only populated if we expect there are tolls on the Route.
-  // If this field is set but the estimated_price subfield is not populated,
-  // we expect that road contains tolls but we do not know an estimated price.
-  // If this field is not set, then we expect there is no toll on the Route.
+  // Contains information about tolls on the route. This field is only populated
+  // if tolls are expected on the route. If this field is set, but the
+  // estimatedPrice subfield is not populated, then the route contains tolls,
+  // but the estimated price is unknown. If this field is not set, then there
+  // are no tolls expected on the route.
   TollInfo toll_info = 2;
 
   // Speed reading intervals detailing traffic density. Applicable in case of
@@ -115,23 +153,33 @@ message RouteTravelAdvisory {
   //     speed_reading_intervals: [A,C), [C,D), [D,G).
   repeated SpeedReadingInterval speed_reading_intervals = 3;
 
-  // The fuel consumption prediction in microliters.
+  // The predicted fuel consumption in microliters.
   int64 fuel_consumption_microliters = 5;
+
+  // Returned route may have restrictions that are not suitable for requested
+  // travel mode or route modifiers.
+  bool route_restrictions_partially_ignored = 6;
+
+  // If present, contains the total fare or ticket costs on this route
+  // This property is only returned for `TRANSIT` requests and only
+  // for routes where fare information is available for all transit steps.
+  google.type.Money transit_fare = 7;
 }
 
-// Encapsulates the additional information that the user should be informed
-// about, such as possible traffic zone restriction etc. on a route leg.
+// Contains the additional information that the user should be informed
+// about on a leg step, such as possible traffic zone restrictions.
 message RouteLegTravelAdvisory {
-  // Encapsulates information about tolls on the specific RouteLeg.
-  // This field is only populated if we expect there are tolls on the RouteLeg.
-  // If this field is set but the estimated_price subfield is not populated,
-  // we expect that road contains tolls but we do not know an estimated price.
-  // If this field does not exist, then there is no toll on the RouteLeg.
+  // Contains information about tolls on the specific `RouteLeg`.
+  // This field is only populated if we expect there are tolls on the
+  // `RouteLeg`. If this field is set but the estimated_price subfield is not
+  // populated, we expect that road contains tolls but we do not know an
+  // estimated price. If this field does not exist, then there is no toll on the
+  // `RouteLeg`.
   TollInfo toll_info = 1;
 
   // Speed reading intervals detailing traffic density. Applicable in case of
   // `TRAFFIC_AWARE` and `TRAFFIC_AWARE_OPTIMAL` routing preferences.
-  // The intervals cover the entire polyline of the RouteLg without overlap.
+  // The intervals cover the entire polyline of the `RouteLeg` without overlap.
   // The start point of a specified interval is the same as the end point of the
   // preceding interval.
   //
@@ -142,15 +190,59 @@ message RouteLegTravelAdvisory {
   repeated SpeedReadingInterval speed_reading_intervals = 2;
 }
 
-// Encapsulates the additional information that the user should be informed
-// about, such as possible traffic zone restriction on a leg step.
+// Contains the additional information that the user should be informed
+// about, such as possible traffic zone restrictions on a leg step.
 message RouteLegStepTravelAdvisory {
   // NOTE: This field is not currently populated.
   repeated SpeedReadingInterval speed_reading_intervals = 1;
 }
 
-// Encapsulates a segment between non-`via` waypoints.
+// Contains a segment between non-`via` waypoints.
 message RouteLeg {
+  // Text representations of certain properties.
+  message RouteLegLocalizedValues {
+    // Travel distance represented in text form.
+    google.type.LocalizedText distance = 1;
+
+    // Duration taking traffic conditions into consideration represented in text
+    // form. Note: If you did not request traffic information, this value will
+    // be the same value as static_duration.
+    google.type.LocalizedText duration = 2;
+
+    // Duration without taking traffic conditions into
+    // consideration, represented in text form.
+    google.type.LocalizedText static_duration = 3;
+  }
+
+  // Provides overview information about a list of `RouteLegStep`s.
+  message StepsOverview {
+    // Provides summarized information about different multi-modal segments of
+    // the `RouteLeg.steps`. A multi-modal segment is defined as one or more
+    // contiguous `RouteLegStep` that have the same `RouteTravelMode`.
+    // This field is not populated if the `RouteLeg` does not contain any
+    // multi-modal segments in the steps.
+    message MultiModalSegment {
+      // The corresponding `RouteLegStep` index that is the start of a
+      // multi-modal segment.
+      optional int32 step_start_index = 1;
+
+      // The corresponding `RouteLegStep` index that is the end of a
+      // multi-modal segment.
+      optional int32 step_end_index = 2;
+
+      // NavigationInstruction for the multi-modal segment.
+      NavigationInstruction navigation_instruction = 3;
+
+      // The travel mode of the multi-modal segment.
+      RouteTravelMode travel_mode = 4;
+    }
+
+    // Summarized information about different multi-modal segments of
+    // the `RouteLeg.steps`. This field is not populated if the `RouteLeg` does
+    // not contain any multi-modal segments in the steps.
+    repeated MultiModalSegment multi_modal_segments = 1;
+  }
+
   // The travel distance of the route leg, in meters.
   int32 distance_meters = 1;
 
@@ -161,37 +253,54 @@ message RouteLeg {
   // conditions into account.
   google.protobuf.Duration duration = 2;
 
-  // The duration of traveling through the leg, calculated without taking
+  // The duration of travel through the leg, calculated without taking
   // traffic conditions into consideration.
   google.protobuf.Duration static_duration = 3;
 
-  // The overall polyline for this leg. This includes that each `step`'s
+  // The overall polyline for this leg that includes each `step`'s
   // polyline.
   Polyline polyline = 4;
 
-  // The start location of this leg. This might be different from the provided
-  // `origin`. For example, when the provided `origin` is not near a road, this
-  // is a point on the road.
+  // The start location of this leg. This location might be different from the
+  // provided `origin`. For example, when the provided `origin` is not near a
+  // road, this is a point on the road.
   Location start_location = 5;
 
-  // The end location of this leg. This might be different from the provided
-  // `destination`. For example, when the provided `destination` is not near a
-  // road, this is a point on the road.
+  // The end location of this leg. This location might be different from the
+  // provided `destination`. For example, when the provided `destination` is not
+  // near a road, this is a point on the road.
   Location end_location = 6;
 
   // An array of steps denoting segments within this leg. Each step represents
   // one navigation instruction.
   repeated RouteLegStep steps = 7;
 
-  // Encapsulates the additional information that the user should be informed
-  // about, such as possible traffic zone restriction etc. on a route leg.
+  // Contains the additional information that the user should be informed
+  // about, such as possible traffic zone restrictions, on a route leg.
   RouteLegTravelAdvisory travel_advisory = 8;
+
+  // Text representations of properties of the `RouteLeg`.
+  RouteLegLocalizedValues localized_values = 9;
+
+  // Overview information about the steps in this `RouteLeg`. This field is only
+  // populated for TRANSIT routes.
+  StepsOverview steps_overview = 10;
 }
 
-// Encapsulates a segment of a [RouteLeg][google.maps.routing.v2.RouteLeg]. A
+// Contains a segment of a [RouteLeg][google.maps.routing.v2.RouteLeg]. A
 // step corresponds to a single navigation instruction. Route legs are made up
 // of steps.
 message RouteLegStep {
+  // Text representations of certain properties.
+  message RouteLegStepLocalizedValues {
+    // Travel distance represented in text form.
+    google.type.LocalizedText distance = 1;
+
+    // Duration without taking traffic conditions into
+    // consideration, represented in text form.
+    google.type.LocalizedText static_duration = 3;
+  }
+
   // The travel distance of this step, in meters. In some circumstances, this
   // field might not have a value.
   int32 distance_meters = 1;
@@ -213,7 +322,74 @@ message RouteLegStep {
   // Navigation instructions.
   NavigationInstruction navigation_instruction = 6;
 
-  // Encapsulates the additional information that the user should be informed
-  // about, such as possible traffic zone restriction on a leg step.
+  // Contains the additional information that the user should be informed
+  // about, such as possible traffic zone restrictions, on a leg step.
   RouteLegStepTravelAdvisory travel_advisory = 7;
+
+  // Text representations of properties of the `RouteLegStep`.
+  RouteLegStepLocalizedValues localized_values = 8;
+
+  // Details pertaining to this step if the travel mode is `TRANSIT`.
+  RouteLegStepTransitDetails transit_details = 9;
+
+  // The travel mode used for this step.
+  RouteTravelMode travel_mode = 10;
+}
+
+// Additional information for the `RouteLegStep` related to `TRANSIT` routes.
+message RouteLegStepTransitDetails {
+  // Details about the transit stops for the `RouteLegStep`
+  message TransitStopDetails {
+    // Information about the arrival stop for the step.
+    TransitStop arrival_stop = 1;
+
+    // The estimated time of arrival for the step.
+    google.protobuf.Timestamp arrival_time = 2;
+
+    // Information about the departure stop for the step.
+    TransitStop departure_stop = 3;
+
+    // The estimated time of departure for the step.
+    google.protobuf.Timestamp departure_time = 4;
+  }
+
+  // Localized descriptions of values for RouteTransitDetails.
+  message TransitDetailsLocalizedValues {
+    // Time in its formatted text representation with a corresponding time zone.
+    LocalizedTime arrival_time = 1;
+
+    // Time in its formatted text representation with a corresponding time zone.
+    LocalizedTime departure_time = 2;
+  }
+
+  // Information about the arrival and departure stops for the step.
+  TransitStopDetails stop_details = 1;
+
+  // Text representations of properties of the `RouteLegStepTransitDetails`.
+  TransitDetailsLocalizedValues localized_values = 2;
+
+  // Specifies the direction in which to travel on this line as marked on
+  // the vehicle or at the departure stop. The direction is often the terminus
+  // station.
+  string headsign = 3;
+
+  // Specifies the expected time as a duration between departures from the same
+  // stop at this time. For example, with a headway seconds value of 600, you
+  // would expect a ten minute wait if you should miss your bus.
+  google.protobuf.Duration headway = 4;
+
+  // Information about the transit line used in this step.
+  TransitLine transit_line = 5;
+
+  // The number of stops from the departure to the arrival stop. This count
+  // includes the arrival stop, but excludes the departure stop. For example, if
+  // your route leaves from Stop A, passes through stops B and C, and arrives at
+  // stop D, stop_count will return 3.
+  int32 stop_count = 6;
+
+  // The text that appears in schedules and sign boards to identify a transit
+  // trip to passengers. The text should uniquely identify a trip within a
+  // service day. For example, "538" is the `trip_short_text` of the Amtrak
+  // train that leaves San Jose, CA at 15:10 on weekdays to Sacramento, CA.
+  string trip_short_text = 7;
 }

package/build/protos/google/maps/routing/v2/route_modifiers.proto

@@ -32,26 +32,24 @@ option ruby_package = "Google::Maps::Routing::V2";
 // Encapsulates a set of optional conditions to satisfy when calculating the
 // routes.
 message RouteModifiers {
-  // Specifies whether to avoid toll roads where reasonable. Preference will be
-  // given to routes not containing toll roads. Applies only to the `DRIVE` and
+  // When set to true, avoids toll roads where reasonable, giving preference to
+  // routes not containing toll roads. Applies only to the `DRIVE` and
   // `TWO_WHEELER` [RouteTravelMode][google.maps.routing.v2.RouteTravelMode].
   bool avoid_tolls = 1;
 
-  // Specifies whether to avoid highways where reasonable. Preference will be
-  // given to routes not containing highways. Applies only to the `DRIVE` and
+  // When set to true, avoids highways where reasonable, giving preference to
+  // routes not containing highways. Applies only to the `DRIVE` and
   // `TWO_WHEELER` [RouteTravelMode][google.maps.routing.v2.RouteTravelMode].
   bool avoid_highways = 2;
 
-  // Specifies whether to avoid ferries where reasonable. Preference will be
-  // given to routes not containing travel by ferries.
-  // Applies only to the `DRIVE` and`TWO_WHEELER`
+  // When set to true, avoids ferries where reasonable, giving preference to
+  // routes not containing ferries. Applies only to the `DRIVE` and`TWO_WHEELER`
   // [RouteTravelMode][google.maps.routing.v2.RouteTravelMode].
   bool avoid_ferries = 3;
 
-  // Specifies whether to avoid navigating indoors where reasonable. Preference
-  // will be given to routes not containing indoor navigation.
-  // Applies only to the `WALK`
-  // [RouteTravelMode][google.maps.routing.v2.RouteTravelMode].
+  // When set to true, avoids navigating indoors where reasonable, giving
+  // preference to routes not containing indoor navigation. Applies only to the
+  // `WALK` [RouteTravelMode][google.maps.routing.v2.RouteTravelMode].
   bool avoid_indoor = 4;
 
   // Specifies the vehicle information.

package/build/protos/google/maps/routing/v2/route_travel_mode.proto

@@ -47,4 +47,7 @@ enum RouteTravelMode {
   // Two-wheeled, motorized vehicle. For example, motorcycle. Note that this
   // differs from the `BICYCLE` travel mode which covers human-powered mode.
   TWO_WHEELER = 4;
+
+  // Travel by public transit routes, where available.
+  TRANSIT = 7;
 }