@googlemaps/routing 1.2.0 → 1.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (33) hide show
  1. package/CHANGELOG.md +17 -0
  2. package/README.md +2 -2
  3. package/build/protos/google/geo/type/viewport.proto +1 -1
  4. package/build/protos/google/maps/routing/v2/fallback_info.proto +5 -5
  5. package/build/protos/google/maps/routing/v2/geocoding_results.proto +4 -5
  6. package/build/protos/google/maps/routing/v2/localized_time.proto +1 -2
  7. package/build/protos/google/maps/routing/v2/location.proto +2 -3
  8. package/build/protos/google/maps/routing/v2/maneuver.proto +2 -3
  9. package/build/protos/google/maps/routing/v2/navigation_instruction.proto +5 -5
  10. package/build/protos/google/maps/routing/v2/polyline.proto +3 -4
  11. package/build/protos/google/maps/routing/v2/polyline_details.proto +84 -0
  12. package/build/protos/google/maps/routing/v2/route.proto +30 -23
  13. package/build/protos/google/maps/routing/v2/route_label.proto +6 -4
  14. package/build/protos/google/maps/routing/v2/route_modifiers.proto +6 -7
  15. package/build/protos/google/maps/routing/v2/route_travel_mode.proto +1 -2
  16. package/build/protos/google/maps/routing/v2/routes_service.proto +84 -44
  17. package/build/protos/google/maps/routing/v2/routing_preference.proto +6 -5
  18. package/build/protos/google/maps/routing/v2/speed_reading_interval.proto +3 -4
  19. package/build/protos/google/maps/routing/v2/toll_info.proto +5 -5
  20. package/build/protos/google/maps/routing/v2/toll_passes.proto +17 -3
  21. package/build/protos/google/maps/routing/v2/traffic_model.proto +1 -2
  22. package/build/protos/google/maps/routing/v2/transit.proto +1 -2
  23. package/build/protos/google/maps/routing/v2/transit_preferences.proto +1 -2
  24. package/build/protos/google/maps/routing/v2/units.proto +1 -2
  25. package/build/protos/google/maps/routing/v2/vehicle_emission_type.proto +2 -3
  26. package/build/protos/google/maps/routing/v2/vehicle_info.proto +2 -2
  27. package/build/protos/google/maps/routing/v2/waypoint.proto +5 -6
  28. package/build/protos/protos.d.ts +695 -248
  29. package/build/protos/protos.js +1690 -510
  30. package/build/protos/protos.json +154 -50
  31. package/build/src/v2/routes_client.d.ts +49 -37
  32. package/build/src/v2/routes_client.js +24 -20
  33. package/package.json +2 -2
package/CHANGELOG.md CHANGED
@@ -1,5 +1,22 @@
1
1
  # Changelog
2
2
 
3
+ ## [1.4.0](https://github.com/googleapis/google-cloud-node/compare/routing-v1.3.0...routing-v1.4.0) (2024-12-18)
4
+
5
+
6
+ ### Features
7
+
8
+ * [routing] add API for experimental flyover and narrow road polyline details ([#5865](https://github.com/googleapis/google-cloud-node/issues/5865)) ([24d7341](https://github.com/googleapis/google-cloud-node/commit/24d7341b387fc8f6d286ff945bc9aed54ddcc7df))
9
+ * [routing] add API for shorter distance reference routes ([#5842](https://github.com/googleapis/google-cloud-node/issues/5842)) ([99b489f](https://github.com/googleapis/google-cloud-node/commit/99b489f1170ceb45d3ce6cb8d56c8c7aa671ad03))
10
+
11
+ ## [1.3.0](https://github.com/googleapis/google-cloud-node/compare/routing-v1.2.0...routing-v1.3.0) (2024-05-21)
12
+
13
+
14
+ ### Features
15
+
16
+ * [Many APIs] update Nodejs generator to send API versions in headers for GAPICs ([#5351](https://github.com/googleapis/google-cloud-node/issues/5351)) ([01f48fc](https://github.com/googleapis/google-cloud-node/commit/01f48fce63ec4ddf801d59ee2b8c0db9f6fb8372))
17
+ * [Many APIs] update Nodejs generator to send API versions in headers for GAPICs ([#5354](https://github.com/googleapis/google-cloud-node/issues/5354)) ([a9784ed](https://github.com/googleapis/google-cloud-node/commit/a9784ed3db6ee96d171762308bbbcd57390b6866))
18
+ * [Many APIs] update Nodejs generator to send API versions in headers for GAPICs ([#5357](https://github.com/googleapis/google-cloud-node/issues/5357)) ([66111e8](https://github.com/googleapis/google-cloud-node/commit/66111e8d285a2357bc477004d1880b70934a60d2))
19
+
3
20
  ## [1.2.0](https://github.com/googleapis/google-cloud-node/compare/routing-v1.1.0...routing-v1.2.0) (2024-03-29)
4
21
 
5
22
 
package/README.md CHANGED
@@ -44,7 +44,7 @@ Google APIs Client Libraries, in [Client Libraries Explained][explained].
44
44
  1. [Select or create a Cloud Platform project][projects].
45
45
  1. [Enable billing for your project][billing].
46
46
  1. [Enable the Google Maps Routing API][enable_api].
47
- 1. [Set up authentication with a service account][auth] so you can access the
47
+ 1. [Set up authentication][auth] so you can access the
48
48
  API from your local workstation.
49
49
 
50
50
  ### Installing the client library
@@ -233,4 +233,4 @@ See [LICENSE](https://github.com/googleapis/google-cloud-node/blob/main/LICENSE)
233
233
  [projects]: https://console.cloud.google.com/project
234
234
  [billing]: https://support.google.com/cloud/answer/6293499#enable-billing
235
235
  [enable_api]: https://console.cloud.google.com/flows/enableapi?apiid=routes.googleapis.com
236
- [auth]: https://cloud.google.com/docs/authentication/getting-started
236
+ [auth]: https://cloud.google.com/docs/authentication/external/set-up-adc-local
@@ -1,4 +1,4 @@
1
- // Copyright 2019 Google LLC.
1
+ // Copyright 2024 Google LLC
2
2
  //
3
3
  // Licensed under the Apache License, Version 2.0 (the "License");
4
4
  // you may not use this file except in compliance with the License.
@@ -1,4 +1,4 @@
1
- // Copyright 2023 Google LLC
1
+ // Copyright 2024 Google LLC
2
2
  //
3
3
  // Licensed under the Apache License, Version 2.0 (the "License");
4
4
  // you may not use this file except in compliance with the License.
@@ -16,7 +16,6 @@ syntax = "proto3";
16
16
 
17
17
  package google.maps.routing.v2;
18
18
 
19
- option cc_enable_arenas = true;
20
19
  option csharp_namespace = "Google.Maps.Routing.V2";
21
20
  option go_package = "cloud.google.com/go/maps/routing/apiv2/routingpb;routingpb";
22
21
  option java_multiple_files = true;
@@ -62,12 +61,13 @@ enum FallbackRoutingMode {
62
61
  // Not used.
63
62
  FALLBACK_ROUTING_MODE_UNSPECIFIED = 0;
64
63
 
65
- // Indicates the `TRAFFIC_UNAWARE` [google.maps.routing.v2.RoutingPreference]
66
- // was used to compute the response.
64
+ // Indicates the `TRAFFIC_UNAWARE`
65
+ // [`RoutingPreference`][google.maps.routing.v2.RoutingPreference] was used to
66
+ // compute the response.
67
67
  FALLBACK_TRAFFIC_UNAWARE = 1;
68
68
 
69
69
  // Indicates the `TRAFFIC_AWARE`
70
- // [RoutingPreference][google.maps.routing.v2.RoutingPreference] was used to
70
+ // [`RoutingPreference`][google.maps.routing.v2.RoutingPreference] was used to
71
71
  // compute the response.
72
72
  FALLBACK_TRAFFIC_AWARE = 2;
73
73
  }
@@ -1,4 +1,4 @@
1
- // Copyright 2023 Google LLC
1
+ // Copyright 2024 Google LLC
2
2
  //
3
3
  // Licensed under the Apache License, Version 2.0 (the "License");
4
4
  // you may not use this file except in compliance with the License.
@@ -18,7 +18,6 @@ package google.maps.routing.v2;
18
18
 
19
19
  import "google/rpc/status.proto";
20
20
 
21
- option cc_enable_arenas = true;
22
21
  option csharp_namespace = "Google.Maps.Routing.V2";
23
22
  option go_package = "cloud.google.com/go/maps/routing/apiv2/routingpb;routingpb";
24
23
  option java_multiple_files = true;
@@ -28,7 +27,7 @@ option objc_class_prefix = "GMRV2";
28
27
  option php_namespace = "Google\\Maps\\Routing\\V2";
29
28
  option ruby_package = "Google::Maps::Routing::V2";
30
29
 
31
- // Contains [GeocodedWaypoints][google.maps.routing.v2.GeocodedWaypoint] for
30
+ // Contains [`GeocodedWaypoints`][google.maps.routing.v2.GeocodedWaypoint] for
32
31
  // origin, destination and intermediate waypoints. Only populated for address
33
32
  // waypoints.
34
33
  message GeocodingResults {
@@ -57,8 +56,8 @@ message GeocodedWaypoint {
57
56
  optional int32 intermediate_waypoint_request_index = 2;
58
57
 
59
58
  // The type(s) of the result, in the form of zero or more type tags.
60
- // Supported types:
61
- // https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types
59
+ // Supported types: [Address types and address component
60
+ // types](https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types).
62
61
  repeated string type = 3;
63
62
 
64
63
  // Indicates that the geocoder did not return an exact match for the original
@@ -1,4 +1,4 @@
1
- // Copyright 2023 Google LLC
1
+ // Copyright 2024 Google LLC
2
2
  //
3
3
  // Licensed under the Apache License, Version 2.0 (the "License");
4
4
  // you may not use this file except in compliance with the License.
@@ -18,7 +18,6 @@ package google.maps.routing.v2;
18
18
 
19
19
  import "google/type/localized_text.proto";
20
20
 
21
- option cc_enable_arenas = true;
22
21
  option csharp_namespace = "Google.Maps.Routing.V2";
23
22
  option go_package = "cloud.google.com/go/maps/routing/apiv2/routingpb;routingpb";
24
23
  option java_multiple_files = true;
@@ -1,4 +1,4 @@
1
- // Copyright 2023 Google LLC
1
+ // Copyright 2024 Google LLC
2
2
  //
3
3
  // Licensed under the Apache License, Version 2.0 (the "License");
4
4
  // you may not use this file except in compliance with the License.
@@ -19,7 +19,6 @@ package google.maps.routing.v2;
19
19
  import "google/protobuf/wrappers.proto";
20
20
  import "google/type/latlng.proto";
21
21
 
22
- option cc_enable_arenas = true;
23
22
  option csharp_namespace = "Google.Maps.Routing.V2";
24
23
  option go_package = "cloud.google.com/go/maps/routing/apiv2/routingpb;routingpb";
25
24
  option java_multiple_files = true;
@@ -39,6 +38,6 @@ message Location {
39
38
  // values can be from 0 to 360, where 0 specifies a heading of due North, 90
40
39
  // specifies a heading of due East, and so on. You can use this field only for
41
40
  // `DRIVE` and `TWO_WHEELER`
42
- // [RouteTravelMode][google.maps.routing.v2.RouteTravelMode].
41
+ // [`RouteTravelMode`][google.maps.routing.v2.RouteTravelMode].
43
42
  google.protobuf.Int32Value heading = 2;
44
43
  }
@@ -1,4 +1,4 @@
1
- // Copyright 2023 Google LLC
1
+ // Copyright 2024 Google LLC
2
2
  //
3
3
  // Licensed under the Apache License, Version 2.0 (the "License");
4
4
  // you may not use this file except in compliance with the License.
@@ -16,7 +16,6 @@ syntax = "proto3";
16
16
 
17
17
  package google.maps.routing.v2;
18
18
 
19
- option cc_enable_arenas = true;
20
19
  option csharp_namespace = "Google.Maps.Routing.V2";
21
20
  option go_package = "cloud.google.com/go/maps/routing/apiv2/routingpb;routingpb";
22
21
  option java_multiple_files = true;
@@ -27,7 +26,7 @@ option php_namespace = "Google\\Maps\\Routing\\V2";
27
26
  option ruby_package = "Google::Maps::Routing::V2";
28
27
 
29
28
  // A set of values that specify the navigation action to take for the current
30
- // step (e.g., turn left, merge, straight, etc.).
29
+ // step (for example, turn left, merge, or straight).
31
30
  enum Maneuver {
32
31
  // Not used.
33
32
  MANEUVER_UNSPECIFIED = 0;
@@ -1,4 +1,4 @@
1
- // Copyright 2023 Google LLC
1
+ // Copyright 2024 Google LLC
2
2
  //
3
3
  // Licensed under the Apache License, Version 2.0 (the "License");
4
4
  // you may not use this file except in compliance with the License.
@@ -18,7 +18,6 @@ package google.maps.routing.v2;
18
18
 
19
19
  import "google/maps/routing/v2/maneuver.proto";
20
20
 
21
- option cc_enable_arenas = true;
22
21
  option csharp_namespace = "Google.Maps.Routing.V2";
23
22
  option go_package = "cloud.google.com/go/maps/routing/apiv2/routingpb;routingpb";
24
23
  option java_multiple_files = true;
@@ -29,10 +28,11 @@ option php_namespace = "Google\\Maps\\Routing\\V2";
29
28
  option ruby_package = "Google::Maps::Routing::V2";
30
29
 
31
30
  // Encapsulates navigation instructions for a
32
- // [RouteLegStep][google.maps.routing.v2.RouteLegStep]
31
+ // [`RouteLegStep`][google.maps.routing.v2.RouteLegStep].
33
32
  message NavigationInstruction {
34
- // Encapsulates the navigation instructions for the current step (e.g., turn
35
- // left, merge, straight, etc.). This field determines which icon to display.
33
+ // Encapsulates the navigation instructions for the current step (for example,
34
+ // turn left, merge, or straight). This field determines which icon to
35
+ // display.
36
36
  Maneuver maneuver = 1;
37
37
 
38
38
  // Instructions for navigating this step.
@@ -1,4 +1,4 @@
1
- // Copyright 2023 Google LLC
1
+ // Copyright 2024 Google LLC
2
2
  //
3
3
  // Licensed under the Apache License, Version 2.0 (the "License");
4
4
  // you may not use this file except in compliance with the License.
@@ -18,7 +18,6 @@ package google.maps.routing.v2;
18
18
 
19
19
  import "google/protobuf/struct.proto";
20
20
 
21
- option cc_enable_arenas = true;
22
21
  option csharp_namespace = "Google.Maps.Routing.V2";
23
22
  option go_package = "cloud.google.com/go/maps/routing/apiv2/routingpb;routingpb";
24
23
  option java_multiple_files = true;
@@ -37,7 +36,7 @@ message Polyline {
37
36
  string encoded_polyline = 1;
38
37
 
39
38
  // Specifies a polyline using the [GeoJSON LineString
40
- // format](https://tools.ietf.org/html/rfc7946#section-3.1.4)
39
+ // format](https://tools.ietf.org/html/rfc7946#section-3.1.4).
41
40
  google.protobuf.Struct geo_json_linestring = 2;
42
41
  }
43
42
  }
@@ -65,7 +64,7 @@ enum PolylineEncoding {
65
64
  POLYLINE_ENCODING_UNSPECIFIED = 0;
66
65
 
67
66
  // Specifies a polyline encoded using the [polyline encoding
68
- // algorithm](https://developers.google.com/maps/documentation/utilities/polylinealgorithm).
67
+ // algorithm](/maps/documentation/utilities/polylinealgorithm).
69
68
  ENCODED_POLYLINE = 1;
70
69
 
71
70
  // Specifies a polyline using the [GeoJSON LineString
@@ -0,0 +1,84 @@
1
+ // Copyright 2024 Google LLC
2
+ //
3
+ // Licensed under the Apache License, Version 2.0 (the "License");
4
+ // you may not use this file except in compliance with the License.
5
+ // You may obtain a copy of the License at
6
+ //
7
+ // http://www.apache.org/licenses/LICENSE-2.0
8
+ //
9
+ // Unless required by applicable law or agreed to in writing, software
10
+ // distributed under the License is distributed on an "AS IS" BASIS,
11
+ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
+ // See the License for the specific language governing permissions and
13
+ // limitations under the License.
14
+
15
+ syntax = "proto3";
16
+
17
+ package google.maps.routing.v2;
18
+
19
+ import "google/api/field_behavior.proto";
20
+
21
+ option csharp_namespace = "Google.Maps.Routing.V2";
22
+ option go_package = "cloud.google.com/go/maps/routing/apiv2/routingpb;routingpb";
23
+ option java_multiple_files = true;
24
+ option java_outer_classname = "PolylineDetailsProto";
25
+ option java_package = "com.google.maps.routing.v2";
26
+ option objc_class_prefix = "GMRV2";
27
+ option php_namespace = "Google\\Maps\\Routing\\V2";
28
+ option ruby_package = "Google::Maps::Routing::V2";
29
+
30
+ // Details corresponding to a given index or contiguous segment of a polyline.
31
+ // Given a polyline with points P_0, P_1, ... , P_N (zero-based index), the
32
+ // `PolylineDetails` defines an interval and associated metadata.
33
+ message PolylineDetails {
34
+ // Encapsulates the start and end indexes for a polyline detail.
35
+ // For instances where the data corresponds to a single point, `start_index`
36
+ // and `end_index` will be equal.
37
+ message PolylinePointIndex {
38
+ // The start index of this detail in the polyline.
39
+ optional int32 start_index = 1;
40
+
41
+ // The end index of this detail in the polyline.
42
+ optional int32 end_index = 2;
43
+ }
44
+
45
+ // Encapsulates the states of road features along a stretch of polyline.
46
+ enum RoadFeatureState {
47
+ // The road feature's state was not computed (default value).
48
+ ROAD_FEATURE_STATE_UNSPECIFIED = 0;
49
+
50
+ // The road feature exists.
51
+ EXISTS = 1;
52
+
53
+ // The road feature does not exist.
54
+ DOES_NOT_EXIST = 2;
55
+ }
56
+
57
+ // Encapsulates information about flyovers along the polyline.
58
+ message FlyoverInfo {
59
+ // Output only. Denotes whether a flyover exists for a given stretch of the
60
+ // polyline.
61
+ RoadFeatureState flyover_presence = 1
62
+ [(google.api.field_behavior) = OUTPUT_ONLY];
63
+
64
+ // The location of flyover related information along the polyline.
65
+ PolylinePointIndex polyline_point_index = 2;
66
+ }
67
+
68
+ // Encapsulates information about narrow roads along the polyline.
69
+ message NarrowRoadInfo {
70
+ // Output only. Denotes whether a narrow road exists for a given stretch of
71
+ // the polyline.
72
+ RoadFeatureState narrow_road_presence = 1
73
+ [(google.api.field_behavior) = OUTPUT_ONLY];
74
+
75
+ // The location of narrow road related information along the polyline.
76
+ PolylinePointIndex polyline_point_index = 2;
77
+ }
78
+
79
+ // Flyover details along the polyline.
80
+ repeated FlyoverInfo flyover_info = 12;
81
+
82
+ // Narrow road details along the polyline.
83
+ repeated NarrowRoadInfo narrow_road_info = 13;
84
+ }
@@ -1,4 +1,4 @@
1
- // Copyright 2023 Google LLC
1
+ // Copyright 2024 Google LLC
2
2
  //
3
3
  // Licensed under the Apache License, Version 2.0 (the "License");
4
4
  // you may not use this file except in compliance with the License.
@@ -21,6 +21,7 @@ import "google/maps/routing/v2/localized_time.proto";
21
21
  import "google/maps/routing/v2/location.proto";
22
22
  import "google/maps/routing/v2/navigation_instruction.proto";
23
23
  import "google/maps/routing/v2/polyline.proto";
24
+ import "google/maps/routing/v2/polyline_details.proto";
24
25
  import "google/maps/routing/v2/route_label.proto";
25
26
  import "google/maps/routing/v2/route_travel_mode.proto";
26
27
  import "google/maps/routing/v2/speed_reading_interval.proto";
@@ -31,7 +32,6 @@ import "google/protobuf/timestamp.proto";
31
32
  import "google/type/localized_text.proto";
32
33
  import "google/type/money.proto";
33
34
 
34
- option cc_enable_arenas = true;
35
35
  option csharp_namespace = "Google.Maps.Routing.V2";
36
36
  option go_package = "cloud.google.com/go/maps/routing/apiv2/routingpb;routingpb";
37
37
  option java_multiple_files = true;
@@ -49,13 +49,14 @@ message Route {
49
49
  // Travel distance represented in text form.
50
50
  google.type.LocalizedText distance = 1;
51
51
 
52
- // Duration taking traffic conditions into consideration, represented in
53
- // text form. Note: If you did not request traffic information, this value
54
- // will be the same value as static_duration.
52
+ // Duration, represented in text form and localized to the region of the
53
+ // query. Takes traffic conditions into consideration. Note: If you did not
54
+ // request traffic information, this value is the same value as
55
+ // `static_duration`.
55
56
  google.type.LocalizedText duration = 2;
56
57
 
57
- // Duration without taking traffic conditions into
58
- // consideration, represented in text form.
58
+ // Duration without taking traffic conditions into consideration,
59
+ // represented in text form.
59
60
  google.type.LocalizedText static_duration = 3;
60
61
 
61
62
  // Transit fare represented in text form.
@@ -68,8 +69,8 @@ message Route {
68
69
 
69
70
  // A collection of legs (path segments between waypoints) that make up the
70
71
  // route. Each leg corresponds to the trip between two non-`via`
71
- // [Waypoints][google.maps.routing.v2.Waypoint]. For example, a route with no
72
- // intermediate waypoints has only one leg. A route that includes one
72
+ // [`Waypoints`][google.maps.routing.v2.Waypoint]. For example, a route with
73
+ // no intermediate waypoints has only one leg. A route that includes one
73
74
  // non-`via` intermediate waypoint has two legs. A route that includes one
74
75
  // `via` intermediate waypoint has one leg. The order of the legs matches the
75
76
  // order of waypoints from `origin` to `intermediates` to `destination`.
@@ -106,7 +107,7 @@ message Route {
106
107
  RouteTravelAdvisory travel_advisory = 9;
107
108
 
108
109
  // If you set
109
- // [optimize_waypoint_order][google.maps.routing.v2.ComputeRoutesRequest.optimize_waypoint_order]
110
+ // [`optimize_waypoint_order`][google.maps.routing.v2.ComputeRoutesRequest.optimize_waypoint_order]
110
111
  // to true, this field contains the optimized ordering of intermediate
111
112
  // waypoints. Otherwise, this field is empty.
112
113
  // For example, if you give an input of Origin: LA; Intermediate waypoints:
@@ -119,16 +120,21 @@ message Route {
119
120
  // Text representations of properties of the `Route`.
120
121
  RouteLocalizedValues localized_values = 11;
121
122
 
122
- // A web-safe, base64-encoded route token that can be passed to the Navigation
123
- // SDK, that allows the Navigation SDK to reconstruct the route during
124
- // navigation, and, in the event of rerouting, honor the original intention
125
- // when you created the route by calling ComputeRoutes. Customers should treat
126
- // this token as an opaque blob. It is not meant for reading or mutating.
123
+ // An opaque token that can be passed to [Navigation
124
+ // SDK](https://developers.google.com/maps/documentation/navigation) to
125
+ // reconstruct the route during navigation, and, in the event of rerouting,
126
+ // honor the original intention when the route was created. Treat this token
127
+ // as an opaque blob. Don't compare its value across requests as its value
128
+ // may change even if the service returns the exact same route.
129
+ //
127
130
  // NOTE: `Route.route_token` is only available for requests that have set
128
131
  // `ComputeRoutesRequest.routing_preference` to `TRAFFIC_AWARE` or
129
132
  // `TRAFFIC_AWARE_OPTIMAL`. `Route.route_token` is not supported for requests
130
133
  // that have Via waypoints.
131
134
  string route_token = 12;
135
+
136
+ // Contains information about details along the polyline.
137
+ PolylineDetails polyline_details = 14;
132
138
  }
133
139
 
134
140
  // Contains the additional information that the user should be informed
@@ -136,7 +142,7 @@ message Route {
136
142
  message RouteTravelAdvisory {
137
143
  // Contains information about tolls on the route. This field is only populated
138
144
  // if tolls are expected on the route. If this field is set, but the
139
- // estimatedPrice subfield is not populated, then the route contains tolls,
145
+ // `estimatedPrice` subfield is not populated, then the route contains tolls,
140
146
  // but the estimated price is unknown. If this field is not set, then there
141
147
  // are no tolls expected on the route.
142
148
  TollInfo toll_info = 2;
@@ -204,9 +210,10 @@ message RouteLeg {
204
210
  // Travel distance represented in text form.
205
211
  google.type.LocalizedText distance = 1;
206
212
 
207
- // Duration taking traffic conditions into consideration represented in text
208
- // form. Note: If you did not request traffic information, this value will
209
- // be the same value as static_duration.
213
+ // Duration, represented in text form and localized to the region of the
214
+ // query. Takes traffic conditions into consideration. Note: If you did not
215
+ // request traffic information, this value is the same value as
216
+ // static_duration.
210
217
  google.type.LocalizedText duration = 2;
211
218
 
212
219
  // Duration without taking traffic conditions into
@@ -287,7 +294,7 @@ message RouteLeg {
287
294
  StepsOverview steps_overview = 10;
288
295
  }
289
296
 
290
- // Contains a segment of a [RouteLeg][google.maps.routing.v2.RouteLeg]. A
297
+ // Contains a segment of a [`RouteLeg`][google.maps.routing.v2.RouteLeg]. A
291
298
  // step corresponds to a single navigation instruction. Route legs are made up
292
299
  // of steps.
293
300
  message RouteLegStep {
@@ -338,7 +345,7 @@ message RouteLegStep {
338
345
 
339
346
  // Additional information for the `RouteLegStep` related to `TRANSIT` routes.
340
347
  message RouteLegStepTransitDetails {
341
- // Details about the transit stops for the `RouteLegStep`
348
+ // Details about the transit stops for the `RouteLegStep`.
342
349
  message TransitStopDetails {
343
350
  // Information about the arrival stop for the step.
344
351
  TransitStop arrival_stop = 1;
@@ -353,7 +360,7 @@ message RouteLegStepTransitDetails {
353
360
  google.protobuf.Timestamp departure_time = 4;
354
361
  }
355
362
 
356
- // Localized descriptions of values for RouteTransitDetails.
363
+ // Localized descriptions of values for `RouteTransitDetails`.
357
364
  message TransitDetailsLocalizedValues {
358
365
  // Time in its formatted text representation with a corresponding time zone.
359
366
  LocalizedTime arrival_time = 1;
@@ -384,7 +391,7 @@ message RouteLegStepTransitDetails {
384
391
  // The number of stops from the departure to the arrival stop. This count
385
392
  // includes the arrival stop, but excludes the departure stop. For example, if
386
393
  // your route leaves from Stop A, passes through stops B and C, and arrives at
387
- // stop D, stop_count will return 3.
394
+ // stop D, <code>stop_count</code> returns 3.
388
395
  int32 stop_count = 6;
389
396
 
390
397
  // The text that appears in schedules and sign boards to identify a transit
@@ -1,4 +1,4 @@
1
- // Copyright 2023 Google LLC
1
+ // Copyright 2024 Google LLC
2
2
  //
3
3
  // Licensed under the Apache License, Version 2.0 (the "License");
4
4
  // you may not use this file except in compliance with the License.
@@ -16,7 +16,6 @@ syntax = "proto3";
16
16
 
17
17
  package google.maps.routing.v2;
18
18
 
19
- option cc_enable_arenas = true;
20
19
  option csharp_namespace = "Google.Maps.Routing.V2";
21
20
  option go_package = "cloud.google.com/go/maps/routing/apiv2/routingpb;routingpb";
22
21
  option java_multiple_files = true;
@@ -26,7 +25,7 @@ option objc_class_prefix = "GMRV2";
26
25
  option php_namespace = "Google\\Maps\\Routing\\V2";
27
26
  option ruby_package = "Google::Maps::Routing::V2";
28
27
 
29
- // Labels for the [Route][google.maps.routing.v2.Route] that are useful to
28
+ // Labels for the [`Route`][google.maps.routing.v2.Route] that are useful to
30
29
  // identify specific properties of the route to compare against others.
31
30
  enum RouteLabel {
32
31
  // Default - not used.
@@ -37,11 +36,14 @@ enum RouteLabel {
37
36
 
38
37
  // An alternative to the default "best" route. Routes like this will be
39
38
  // returned when
40
- // [compute_alternative_routes][google.maps.routing.v2.ComputeRoutesRequest.compute_alternative_routes]
39
+ // [`compute_alternative_routes`][google.maps.routing.v2.ComputeRoutesRequest.compute_alternative_routes]
41
40
  // is specified.
42
41
  DEFAULT_ROUTE_ALTERNATE = 2;
43
42
 
44
43
  // Fuel efficient route. Routes labeled with this value are determined to be
45
44
  // optimized for Eco parameters such as fuel consumption.
46
45
  FUEL_EFFICIENT = 3;
46
+
47
+ // Shorter travel distance route. This is an experimental feature.
48
+ SHORTER_DISTANCE = 4;
47
49
  }
@@ -1,4 +1,4 @@
1
- // Copyright 2023 Google LLC
1
+ // Copyright 2024 Google LLC
2
2
  //
3
3
  // Licensed under the Apache License, Version 2.0 (the "License");
4
4
  // you may not use this file except in compliance with the License.
@@ -19,7 +19,6 @@ package google.maps.routing.v2;
19
19
  import "google/maps/routing/v2/toll_passes.proto";
20
20
  import "google/maps/routing/v2/vehicle_info.proto";
21
21
 
22
- option cc_enable_arenas = true;
23
22
  option csharp_namespace = "Google.Maps.Routing.V2";
24
23
  option go_package = "cloud.google.com/go/maps/routing/apiv2/routingpb;routingpb";
25
24
  option java_multiple_files = true;
@@ -34,22 +33,22 @@ option ruby_package = "Google::Maps::Routing::V2";
34
33
  message RouteModifiers {
35
34
  // When set to true, avoids toll roads where reasonable, giving preference to
36
35
  // routes not containing toll roads. Applies only to the `DRIVE` and
37
- // `TWO_WHEELER` [RouteTravelMode][google.maps.routing.v2.RouteTravelMode].
36
+ // `TWO_WHEELER` [`RouteTravelMode`][google.maps.routing.v2.RouteTravelMode].
38
37
  bool avoid_tolls = 1;
39
38
 
40
39
  // When set to true, avoids highways where reasonable, giving preference to
41
40
  // routes not containing highways. Applies only to the `DRIVE` and
42
- // `TWO_WHEELER` [RouteTravelMode][google.maps.routing.v2.RouteTravelMode].
41
+ // `TWO_WHEELER` [`RouteTravelMode`][google.maps.routing.v2.RouteTravelMode].
43
42
  bool avoid_highways = 2;
44
43
 
45
44
  // When set to true, avoids ferries where reasonable, giving preference to
46
45
  // routes not containing ferries. Applies only to the `DRIVE` and`TWO_WHEELER`
47
- // [RouteTravelMode][google.maps.routing.v2.RouteTravelMode].
46
+ // [`RouteTravelMode`][google.maps.routing.v2.RouteTravelMode].
48
47
  bool avoid_ferries = 3;
49
48
 
50
49
  // When set to true, avoids navigating indoors where reasonable, giving
51
50
  // preference to routes not containing indoor navigation. Applies only to the
52
- // `WALK` [RouteTravelMode][google.maps.routing.v2.RouteTravelMode].
51
+ // `WALK` [`RouteTravelMode`][google.maps.routing.v2.RouteTravelMode].
53
52
  bool avoid_indoor = 4;
54
53
 
55
54
  // Specifies the vehicle information.
@@ -60,6 +59,6 @@ message RouteModifiers {
60
59
  // toll passes are not provided, the API treats the toll pass as unknown and
61
60
  // tries to return the cash price.
62
61
  // Applies only to the `DRIVE` and `TWO_WHEELER`
63
- // [RouteTravelMode][google.maps.routing.v2.RouteTravelMode].
62
+ // [`RouteTravelMode`][google.maps.routing.v2.RouteTravelMode].
64
63
  repeated TollPass toll_passes = 6;
65
64
  }
@@ -1,4 +1,4 @@
1
- // Copyright 2023 Google LLC
1
+ // Copyright 2024 Google LLC
2
2
  //
3
3
  // Licensed under the Apache License, Version 2.0 (the "License");
4
4
  // you may not use this file except in compliance with the License.
@@ -16,7 +16,6 @@ syntax = "proto3";
16
16
 
17
17
  package google.maps.routing.v2;
18
18
 
19
- option cc_enable_arenas = true;
20
19
  option csharp_namespace = "Google.Maps.Routing.V2";
21
20
  option go_package = "cloud.google.com/go/maps/routing/apiv2/routingpb;routingpb";
22
21
  option java_multiple_files = true;