@googlemaps/routing 1.2.0 → 1.3.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 (31) hide show
  1. package/CHANGELOG.md +9 -0
  2. package/build/protos/google/geo/type/viewport.proto +1 -1
  3. package/build/protos/google/maps/routing/v2/fallback_info.proto +5 -4
  4. package/build/protos/google/maps/routing/v2/geocoding_results.proto +4 -4
  5. package/build/protos/google/maps/routing/v2/localized_time.proto +1 -1
  6. package/build/protos/google/maps/routing/v2/location.proto +2 -2
  7. package/build/protos/google/maps/routing/v2/maneuver.proto +2 -2
  8. package/build/protos/google/maps/routing/v2/navigation_instruction.proto +5 -4
  9. package/build/protos/google/maps/routing/v2/polyline.proto +3 -3
  10. package/build/protos/google/maps/routing/v2/route.proto +11 -11
  11. package/build/protos/google/maps/routing/v2/route_label.proto +3 -3
  12. package/build/protos/google/maps/routing/v2/route_modifiers.proto +6 -6
  13. package/build/protos/google/maps/routing/v2/route_travel_mode.proto +1 -1
  14. package/build/protos/google/maps/routing/v2/routes_service.proto +49 -40
  15. package/build/protos/google/maps/routing/v2/routing_preference.proto +6 -4
  16. package/build/protos/google/maps/routing/v2/speed_reading_interval.proto +3 -3
  17. package/build/protos/google/maps/routing/v2/toll_info.proto +5 -5
  18. package/build/protos/google/maps/routing/v2/toll_passes.proto +17 -2
  19. package/build/protos/google/maps/routing/v2/traffic_model.proto +1 -1
  20. package/build/protos/google/maps/routing/v2/transit.proto +1 -1
  21. package/build/protos/google/maps/routing/v2/transit_preferences.proto +1 -1
  22. package/build/protos/google/maps/routing/v2/units.proto +1 -1
  23. package/build/protos/google/maps/routing/v2/vehicle_emission_type.proto +2 -2
  24. package/build/protos/google/maps/routing/v2/vehicle_info.proto +2 -2
  25. package/build/protos/google/maps/routing/v2/waypoint.proto +5 -5
  26. package/build/protos/protos.d.ts +9 -0
  27. package/build/protos/protos.js +68 -0
  28. package/build/protos/protos.json +10 -0
  29. package/build/src/v2/routes_client.d.ts +45 -36
  30. package/build/src/v2/routes_client.js +24 -20
  31. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -1,5 +1,14 @@
1
1
  # Changelog
2
2
 
3
+ ## [1.3.0](https://github.com/googleapis/google-cloud-node/compare/routing-v1.2.0...routing-v1.3.0) (2024-05-21)
4
+
5
+
6
+ ### Features
7
+
8
+ * [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))
9
+ * [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))
10
+ * [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))
11
+
3
12
  ## [1.2.0](https://github.com/googleapis/google-cloud-node/compare/routing-v1.1.0...routing-v1.2.0) (2024-03-29)
4
13
 
5
14
 
@@ -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.
@@ -62,12 +62,13 @@ enum FallbackRoutingMode {
62
62
  // Not used.
63
63
  FALLBACK_ROUTING_MODE_UNSPECIFIED = 0;
64
64
 
65
- // Indicates the `TRAFFIC_UNAWARE` [google.maps.routing.v2.RoutingPreference]
66
- // was used to compute the response.
65
+ // Indicates the `TRAFFIC_UNAWARE`
66
+ // [`RoutingPreference`][google.maps.routing.v2.RoutingPreference] was used to
67
+ // compute the response.
67
68
  FALLBACK_TRAFFIC_UNAWARE = 1;
68
69
 
69
70
  // Indicates the `TRAFFIC_AWARE`
70
- // [RoutingPreference][google.maps.routing.v2.RoutingPreference] was used to
71
+ // [`RoutingPreference`][google.maps.routing.v2.RoutingPreference] was used to
71
72
  // compute the response.
72
73
  FALLBACK_TRAFFIC_AWARE = 2;
73
74
  }
@@ -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.
@@ -28,7 +28,7 @@ option objc_class_prefix = "GMRV2";
28
28
  option php_namespace = "Google\\Maps\\Routing\\V2";
29
29
  option ruby_package = "Google::Maps::Routing::V2";
30
30
 
31
- // Contains [GeocodedWaypoints][google.maps.routing.v2.GeocodedWaypoint] for
31
+ // Contains [`GeocodedWaypoints`][google.maps.routing.v2.GeocodedWaypoint] for
32
32
  // origin, destination and intermediate waypoints. Only populated for address
33
33
  // waypoints.
34
34
  message GeocodingResults {
@@ -57,8 +57,8 @@ message GeocodedWaypoint {
57
57
  optional int32 intermediate_waypoint_request_index = 2;
58
58
 
59
59
  // 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
60
+ // Supported types: [Address types and address component
61
+ // types](https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types).
62
62
  repeated string type = 3;
63
63
 
64
64
  // 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.
@@ -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.
@@ -39,6 +39,6 @@ message Location {
39
39
  // values can be from 0 to 360, where 0 specifies a heading of due North, 90
40
40
  // specifies a heading of due East, and so on. You can use this field only for
41
41
  // `DRIVE` and `TWO_WHEELER`
42
- // [RouteTravelMode][google.maps.routing.v2.RouteTravelMode].
42
+ // [`RouteTravelMode`][google.maps.routing.v2.RouteTravelMode].
43
43
  google.protobuf.Int32Value heading = 2;
44
44
  }
@@ -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.
@@ -27,7 +27,7 @@ option php_namespace = "Google\\Maps\\Routing\\V2";
27
27
  option ruby_package = "Google::Maps::Routing::V2";
28
28
 
29
29
  // A set of values that specify the navigation action to take for the current
30
- // step (e.g., turn left, merge, straight, etc.).
30
+ // step (for example, turn left, merge, or straight).
31
31
  enum Maneuver {
32
32
  // Not used.
33
33
  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.
@@ -29,10 +29,11 @@ option php_namespace = "Google\\Maps\\Routing\\V2";
29
29
  option ruby_package = "Google::Maps::Routing::V2";
30
30
 
31
31
  // Encapsulates navigation instructions for a
32
- // [RouteLegStep][google.maps.routing.v2.RouteLegStep]
32
+ // [`RouteLegStep`][google.maps.routing.v2.RouteLegStep].
33
33
  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.
34
+ // Encapsulates the navigation instructions for the current step (for example,
35
+ // turn left, merge, or straight). This field determines which icon to
36
+ // display.
36
37
  Maneuver maneuver = 1;
37
38
 
38
39
  // 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.
@@ -37,7 +37,7 @@ message Polyline {
37
37
  string encoded_polyline = 1;
38
38
 
39
39
  // Specifies a polyline using the [GeoJSON LineString
40
- // format](https://tools.ietf.org/html/rfc7946#section-3.1.4)
40
+ // format](https://tools.ietf.org/html/rfc7946#section-3.1.4).
41
41
  google.protobuf.Struct geo_json_linestring = 2;
42
42
  }
43
43
  }
@@ -65,7 +65,7 @@ enum PolylineEncoding {
65
65
  POLYLINE_ENCODING_UNSPECIFIED = 0;
66
66
 
67
67
  // Specifies a polyline encoded using the [polyline encoding
68
- // algorithm](https://developers.google.com/maps/documentation/utilities/polylinealgorithm).
68
+ // algorithm](/maps/documentation/utilities/polylinealgorithm).
69
69
  ENCODED_POLYLINE = 1;
70
70
 
71
71
  // Specifies a polyline using the [GeoJSON LineString
@@ -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.
@@ -51,11 +51,11 @@ message Route {
51
51
 
52
52
  // Duration taking traffic conditions into consideration, represented in
53
53
  // text form. Note: If you did not request traffic information, this value
54
- // will be the same value as static_duration.
54
+ // will be the same value as `static_duration`.
55
55
  google.type.LocalizedText duration = 2;
56
56
 
57
- // Duration without taking traffic conditions into
58
- // consideration, represented in text form.
57
+ // Duration without taking traffic conditions into consideration,
58
+ // represented in text form.
59
59
  google.type.LocalizedText static_duration = 3;
60
60
 
61
61
  // Transit fare represented in text form.
@@ -68,8 +68,8 @@ message Route {
68
68
 
69
69
  // A collection of legs (path segments between waypoints) that make up the
70
70
  // 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
71
+ // [`Waypoints`][google.maps.routing.v2.Waypoint]. For example, a route with
72
+ // no intermediate waypoints has only one leg. A route that includes one
73
73
  // non-`via` intermediate waypoint has two legs. A route that includes one
74
74
  // `via` intermediate waypoint has one leg. The order of the legs matches the
75
75
  // order of waypoints from `origin` to `intermediates` to `destination`.
@@ -106,7 +106,7 @@ message Route {
106
106
  RouteTravelAdvisory travel_advisory = 9;
107
107
 
108
108
  // If you set
109
- // [optimize_waypoint_order][google.maps.routing.v2.ComputeRoutesRequest.optimize_waypoint_order]
109
+ // [`optimize_waypoint_order`][google.maps.routing.v2.ComputeRoutesRequest.optimize_waypoint_order]
110
110
  // to true, this field contains the optimized ordering of intermediate
111
111
  // waypoints. Otherwise, this field is empty.
112
112
  // For example, if you give an input of Origin: LA; Intermediate waypoints:
@@ -136,7 +136,7 @@ message Route {
136
136
  message RouteTravelAdvisory {
137
137
  // Contains information about tolls on the route. This field is only populated
138
138
  // 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,
139
+ // `estimatedPrice` subfield is not populated, then the route contains tolls,
140
140
  // but the estimated price is unknown. If this field is not set, then there
141
141
  // are no tolls expected on the route.
142
142
  TollInfo toll_info = 2;
@@ -287,7 +287,7 @@ message RouteLeg {
287
287
  StepsOverview steps_overview = 10;
288
288
  }
289
289
 
290
- // Contains a segment of a [RouteLeg][google.maps.routing.v2.RouteLeg]. A
290
+ // Contains a segment of a [`RouteLeg`][google.maps.routing.v2.RouteLeg]. A
291
291
  // step corresponds to a single navigation instruction. Route legs are made up
292
292
  // of steps.
293
293
  message RouteLegStep {
@@ -338,7 +338,7 @@ message RouteLegStep {
338
338
 
339
339
  // Additional information for the `RouteLegStep` related to `TRANSIT` routes.
340
340
  message RouteLegStepTransitDetails {
341
- // Details about the transit stops for the `RouteLegStep`
341
+ // Details about the transit stops for the `RouteLegStep`.
342
342
  message TransitStopDetails {
343
343
  // Information about the arrival stop for the step.
344
344
  TransitStop arrival_stop = 1;
@@ -353,7 +353,7 @@ message RouteLegStepTransitDetails {
353
353
  google.protobuf.Timestamp departure_time = 4;
354
354
  }
355
355
 
356
- // Localized descriptions of values for RouteTransitDetails.
356
+ // Localized descriptions of values for `RouteTransitDetails`.
357
357
  message TransitDetailsLocalizedValues {
358
358
  // Time in its formatted text representation with a corresponding time zone.
359
359
  LocalizedTime arrival_time = 1;
@@ -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.
@@ -26,7 +26,7 @@ option objc_class_prefix = "GMRV2";
26
26
  option php_namespace = "Google\\Maps\\Routing\\V2";
27
27
  option ruby_package = "Google::Maps::Routing::V2";
28
28
 
29
- // Labels for the [Route][google.maps.routing.v2.Route] that are useful to
29
+ // Labels for the [`Route`][google.maps.routing.v2.Route] that are useful to
30
30
  // identify specific properties of the route to compare against others.
31
31
  enum RouteLabel {
32
32
  // Default - not used.
@@ -37,7 +37,7 @@ enum RouteLabel {
37
37
 
38
38
  // An alternative to the default "best" route. Routes like this will be
39
39
  // returned when
40
- // [compute_alternative_routes][google.maps.routing.v2.ComputeRoutesRequest.compute_alternative_routes]
40
+ // [`compute_alternative_routes`][google.maps.routing.v2.ComputeRoutesRequest.compute_alternative_routes]
41
41
  // is specified.
42
42
  DEFAULT_ROUTE_ALTERNATE = 2;
43
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.
@@ -34,22 +34,22 @@ option ruby_package = "Google::Maps::Routing::V2";
34
34
  message RouteModifiers {
35
35
  // When set to true, avoids toll roads where reasonable, giving preference to
36
36
  // routes not containing toll roads. Applies only to the `DRIVE` and
37
- // `TWO_WHEELER` [RouteTravelMode][google.maps.routing.v2.RouteTravelMode].
37
+ // `TWO_WHEELER` [`RouteTravelMode`][google.maps.routing.v2.RouteTravelMode].
38
38
  bool avoid_tolls = 1;
39
39
 
40
40
  // When set to true, avoids highways where reasonable, giving preference to
41
41
  // routes not containing highways. Applies only to the `DRIVE` and
42
- // `TWO_WHEELER` [RouteTravelMode][google.maps.routing.v2.RouteTravelMode].
42
+ // `TWO_WHEELER` [`RouteTravelMode`][google.maps.routing.v2.RouteTravelMode].
43
43
  bool avoid_highways = 2;
44
44
 
45
45
  // When set to true, avoids ferries where reasonable, giving preference to
46
46
  // routes not containing ferries. Applies only to the `DRIVE` and`TWO_WHEELER`
47
- // [RouteTravelMode][google.maps.routing.v2.RouteTravelMode].
47
+ // [`RouteTravelMode`][google.maps.routing.v2.RouteTravelMode].
48
48
  bool avoid_ferries = 3;
49
49
 
50
50
  // When set to true, avoids navigating indoors where reasonable, giving
51
51
  // preference to routes not containing indoor navigation. Applies only to the
52
- // `WALK` [RouteTravelMode][google.maps.routing.v2.RouteTravelMode].
52
+ // `WALK` [`RouteTravelMode`][google.maps.routing.v2.RouteTravelMode].
53
53
  bool avoid_indoor = 4;
54
54
 
55
55
  // Specifies the vehicle information.
@@ -60,6 +60,6 @@ message RouteModifiers {
60
60
  // toll passes are not provided, the API treats the toll pass as unknown and
61
61
  // tries to return the cash price.
62
62
  // Applies only to the `DRIVE` and `TWO_WHEELER`
63
- // [RouteTravelMode][google.maps.routing.v2.RouteTravelMode].
63
+ // [`RouteTravelMode`][google.maps.routing.v2.RouteTravelMode].
64
64
  repeated TollPass toll_passes = 6;
65
65
  }
@@ -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.
@@ -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.
@@ -56,7 +56,7 @@ service Routes {
56
56
  // the input. You can provide the response field mask by using URL parameter
57
57
  // `$fields` or `fields`, or by using an HTTP/gRPC header `X-Goog-FieldMask`
58
58
  // (see the [available URL parameters and
59
- // headers](https://cloud.google.com/apis/docs/system-parameters). The value
59
+ // headers](https://cloud.google.com/apis/docs/system-parameters)). The value
60
60
  // is a comma separated list of field paths. See detailed documentation about
61
61
  // [how to construct the field
62
62
  // paths](https://github.com/protocolbuffers/protobuf/blob/master/src/google/protobuf/field_mask.proto).
@@ -98,9 +98,9 @@ service Routes {
98
98
  // the input. You can provide the response field mask by using the URL
99
99
  // parameter `$fields` or `fields`, or by using the HTTP/gRPC header
100
100
  // `X-Goog-FieldMask` (see the [available URL parameters and
101
- // headers](https://cloud.google.com/apis/docs/system-parameters). The value
102
- // is a comma separated list of field paths. See this detailed documentation
103
- // about [how to construct the field
101
+ // headers](https://cloud.google.com/apis/docs/system-parameters)).
102
+ // The value is a comma separated list of field paths. See this detailed
103
+ // documentation about [how to construct the field
104
104
  // paths](https://github.com/protocolbuffers/protobuf/blob/master/src/google/protobuf/field_mask.proto).
105
105
  //
106
106
  // For example, in this method:
@@ -161,8 +161,7 @@ message ComputeRoutesRequest {
161
161
  // Traffic aware polylines for the route(s).
162
162
  TRAFFIC_ON_POLYLINE = 3;
163
163
 
164
- // [Navigation
165
- // Instructions][google.maps.routing.v2.NavigationInstructions.instructions]
164
+ // [`NavigationInstructions`](google.maps.routing.v2.NavigationInstructions.instructions)
166
165
  // presented as a formatted HTML text string. This content
167
166
  // is meant to be read as-is. This content is for display only.
168
167
  // Do not programmatically parse it.
@@ -201,16 +200,18 @@ message ComputeRoutesRequest {
201
200
  // Optional. The departure time. If you don't set this value, then this value
202
201
  // defaults to the time that you made the request.
203
202
  // NOTE: You can only specify a `departure_time` in the past when
204
- // [RouteTravelMode][google.maps.routing.v2.RouteTravelMode] is set to
205
- // `TRANSIT`.
203
+ // [`RouteTravelMode`][google.maps.routing.v2.RouteTravelMode] is set to
204
+ // `TRANSIT`. Transit trips are available for up to 7 days in the past or 100
205
+ // days in the future.
206
206
  google.protobuf.Timestamp departure_time = 7
207
207
  [(google.api.field_behavior) = OPTIONAL];
208
208
 
209
209
  // Optional. The arrival time.
210
210
  // NOTE: Can only be set when
211
211
  // [RouteTravelMode][google.maps.routing.v2.RouteTravelMode] is set to
212
- // `TRANSIT`. You can specify either departure_time or arrival_time, but not
213
- // both.
212
+ // `TRANSIT`. You can specify either `departure_time` or `arrival_time`, but
213
+ // not both. Transit trips are available for up to 7 days in the past or 100
214
+ // days in the future.
214
215
  google.protobuf.Timestamp arrival_time = 19
215
216
  [(google.api.field_behavior) = OPTIONAL];
216
217
 
@@ -224,23 +225,24 @@ message ComputeRoutesRequest {
224
225
  RouteModifiers route_modifiers = 9 [(google.api.field_behavior) = OPTIONAL];
225
226
 
226
227
  // Optional. The BCP-47 language code, such as "en-US" or "sr-Latn". For more
227
- // information, see
228
- // http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. See
229
- // [Language Support](https://developers.google.com/maps/faq#languagesupport)
228
+ // information, see [Unicode Locale
229
+ // Identifier](http://www.unicode.org/reports/tr35/#Unicode_locale_identifier).
230
+ // See [Language
231
+ // Support](https://developers.google.com/maps/faq#languagesupport)
230
232
  // for the list of supported languages. When you don't provide this value, the
231
233
  // display language is inferred from the location of the route request.
232
234
  string language_code = 10 [(google.api.field_behavior) = OPTIONAL];
233
235
 
234
236
  // Optional. The region code, specified as a ccTLD ("top-level domain")
235
- // two-character value. For more information see
236
- // https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains#Country_code_top-level_domains
237
+ // two-character value. For more information see [Country code top-level
238
+ // domains](https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains#Country_code_top-level_domains).
237
239
  string region_code = 16 [(google.api.field_behavior) = OPTIONAL];
238
240
 
239
241
  // Optional. Specifies the units of measure for the display fields. These
240
242
  // fields include the `instruction` field in
241
- // [NavigationInstruction][google.maps.routing.v2.NavigationInstruction]. The
242
- // units of measure used for the route, leg, step distance, and duration are
243
- // not affected by this value. If you don't provide this value, then the
243
+ // [`NavigationInstruction`][google.maps.routing.v2.NavigationInstruction].
244
+ // The units of measure used for the route, leg, step distance, and duration
245
+ // are not affected by this value. If you don't provide this value, then the
244
246
  // display units are inferred from the location of the first origin.
245
247
  Units units = 11 [(google.api.field_behavior) = OPTIONAL];
246
248
 
@@ -273,20 +275,21 @@ message ComputeRoutesRequest {
273
275
 
274
276
  // Optional. Specifies the assumptions to use when calculating time in
275
277
  // traffic. This setting affects the value returned in the duration field in
276
- // the [Route][google.maps.routing.v2.Route] and
277
- // [RouteLeg][google.maps.routing.v2.RouteLeg] which contains the predicted
278
+ // the
279
+ // [`Route`][google.maps.routing.v2.Route] and
280
+ // [`RouteLeg`][google.maps.routing.v2.RouteLeg] which contains the predicted
278
281
  // time in traffic based on historical averages.
279
282
  // `TrafficModel` is only available for requests that have set
280
- // [RoutingPreference][google.maps.routing.v2.RoutingPreference] to
283
+ // [`RoutingPreference`][google.maps.routing.v2.RoutingPreference] to
281
284
  // `TRAFFIC_AWARE_OPTIMAL` and
282
- // [RouteTravelMode][google.maps.routing.v2.RouteTravelMode] to `DRIVE`.
285
+ // [`RouteTravelMode`][google.maps.routing.v2.RouteTravelMode] to `DRIVE`.
283
286
  // Defaults to `BEST_GUESS` if traffic is requested and `TrafficModel` is not
284
287
  // specified.
285
288
  TrafficModel traffic_model = 18 [(google.api.field_behavior) = OPTIONAL];
286
289
 
287
290
  // Optional. Specifies preferences that influence the route returned for
288
291
  // `TRANSIT` routes. NOTE: You can only specify a `transit_preferences` when
289
- // [RouteTravelMode][google.maps.routing.v2.RouteTravelMode] is set to
292
+ // [`RouteTravelMode`][google.maps.routing.v2.RouteTravelMode] is set to
290
293
  // `TRANSIT`.
291
294
  TransitPreferences transit_preferences = 20
292
295
  [(google.api.field_behavior) = OPTIONAL];
@@ -295,7 +298,7 @@ message ComputeRoutesRequest {
295
298
  // ComputeRoutes the response message.
296
299
  message ComputeRoutesResponse {
297
300
  // Contains an array of computed routes (up to three) when you specify
298
- // compute_alternatives_routes, and contains just one route when you don't.
301
+ // `compute_alternatives_routes`, and contains just one route when you don't.
299
302
  // When this array contains multiple entries, the first one is the most
300
303
  // recommended route. If the array is empty, then it means no route could be
301
304
  // found.
@@ -326,12 +329,14 @@ message ComputeRouteMatrixRequest {
326
329
  // matrix. Several size restrictions apply to the cardinality of origins and
327
330
  // destinations:
328
331
  //
329
- // * The number of elements (origins × destinations) must be no greater than
330
- // 625 in any case.
331
- // * The number of elements (origins × destinations) must be no greater than
332
- // 100 if routing_preference is set to `TRAFFIC_AWARE_OPTIMAL`.
333
- // * The number of waypoints (origins + destinations) specified as `place_id`
334
- // must be no greater than 50.
332
+ // * The sum of the number of origins + the number of destinations specified
333
+ // as either `place_id` or `address` must be no greater than 50.
334
+ // * The product of number of origins × number of destinations must be no
335
+ // greater than 625 in any case.
336
+ // * The product of the number of origins × number of destinations must be no
337
+ // greater than 100 if routing_preference is set to `TRAFFIC_AWARE_OPTIMAL`.
338
+ // * The product of the number of origins × number of destinations must be no
339
+ // greater than 100 if travel_mode is set to `TRANSIT`.
335
340
  repeated RouteMatrixOrigin origins = 1
336
341
  [(google.api.field_behavior) = REQUIRED];
337
342
 
@@ -354,32 +359,36 @@ message ComputeRouteMatrixRequest {
354
359
  // Optional. The departure time. If you don't set this value, then this value
355
360
  // defaults to the time that you made the request.
356
361
  // NOTE: You can only specify a `departure_time` in the past when
357
- // [RouteTravelMode][google.maps.routing.v2.RouteTravelMode] is set to
362
+ // [`RouteTravelMode`][google.maps.routing.v2.RouteTravelMode] is set to
358
363
  // `TRANSIT`.
359
364
  google.protobuf.Timestamp departure_time = 5
360
365
  [(google.api.field_behavior) = OPTIONAL];
361
366
 
362
367
  // Optional. The arrival time.
363
368
  // NOTE: Can only be set when
364
- // [RouteTravelMode][google.maps.routing.v2.RouteTravelMode] is set to
365
- // `TRANSIT`. You can specify either departure_time or arrival_time, but not
366
- // both.
369
+ // [`RouteTravelMode`][google.maps.routing.v2.RouteTravelMode] is set to
370
+ // `TRANSIT`. You can specify either `departure_time` or `arrival_time`, but
371
+ // not both.
367
372
  google.protobuf.Timestamp arrival_time = 11
368
373
  [(google.api.field_behavior) = OPTIONAL];
369
374
 
370
375
  // Optional. The BCP-47 language code, such as "en-US" or "sr-Latn". For more
371
- // information, see
372
- // http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. See
373
- // [Language Support](https://developers.google.com/maps/faq#languagesupport)
376
+ // information, see [Unicode Locale
377
+ // Identifier](http://www.unicode.org/reports/tr35/#Unicode_locale_identifier).
378
+ // See [Language
379
+ // Support](https://developers.google.com/maps/faq#languagesupport)
374
380
  // for the list of supported languages. When you don't provide this value, the
375
381
  // display language is inferred from the location of the first origin.
376
382
  string language_code = 6 [(google.api.field_behavior) = OPTIONAL];
377
383
 
378
384
  // Optional. The region code, specified as a ccTLD ("top-level domain")
379
- // two-character value. For more information see
380
- // https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains#Country_code_top-level_domains
385
+ // two-character value. For more information see [Country code top-level
386
+ // domains](https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains#Country_code_top-level_domains).
381
387
  string region_code = 9 [(google.api.field_behavior) = OPTIONAL];
382
388
 
389
+ // Optional. Specifies the units of measure for the display fields.
390
+ Units units = 7 [(google.api.field_behavior) = OPTIONAL];
391
+
383
392
  // Optional. A list of extra computations which may be used to complete the
384
393
  // request. Note: These extra computations may return extra fields on the
385
394
  // response. These extra fields must also be specified in the field mask to be
@@ -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.
@@ -35,9 +35,11 @@ enum RoutingPreference {
35
35
  // Computes routes without taking live traffic conditions into consideration.
36
36
  // Suitable when traffic conditions don't matter or are not applicable.
37
37
  // Using this value produces the lowest latency.
38
- // Note: For [RouteTravelMode][google.maps.routing.v2.RouteTravelMode] `DRIVE`
39
- // and `TWO_WHEELER` choice of route and duration are based on road network
40
- // and average time-independent traffic conditions. Results for a given
38
+ // Note: For [`RouteTravelMode`][google.maps.routing.v2.RouteTravelMode]
39
+ // `DRIVE` and `TWO_WHEELER`, the route and duration chosen are based on road
40
+ // network and average time-independent traffic conditions, not current road
41
+ // conditions. Consequently, routes may include roads that are temporarily
42
+ // closed. Results for a given
41
43
  // request may vary over time due to changes in the road network, updated
42
44
  // average traffic conditions, and the distributed nature of the service.
43
45
  // Results may also vary between nearly-equivalent routes at any time or
@@ -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.
@@ -28,8 +28,8 @@ option ruby_package = "Google::Maps::Routing::V2";
28
28
 
29
29
  // Traffic density indicator on a contiguous segment of a polyline or path.
30
30
  // Given a path with points P_0, P_1, ... , P_N (zero-based index), the
31
- // SpeedReadingInterval defines an interval and describes its traffic using the
32
- // following categories.
31
+ // `SpeedReadingInterval` defines an interval and describes its traffic using
32
+ // the following categories.
33
33
  message SpeedReadingInterval {
34
34
  // The classification of polyline speed based on traffic data.
35
35
  enum Speed {
@@ -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.
@@ -28,12 +28,12 @@ option objc_class_prefix = "GMRV2";
28
28
  option php_namespace = "Google\\Maps\\Routing\\V2";
29
29
  option ruby_package = "Google::Maps::Routing::V2";
30
30
 
31
- // Encapsulates toll information on a [Route][google.maps.routing.v2.Route] or
32
- // on a [RouteLeg][google.maps.routing.v2.RouteLeg].
31
+ // Encapsulates toll information on a [`Route`][google.maps.routing.v2.Route] or
32
+ // on a [`RouteLeg`][google.maps.routing.v2.RouteLeg].
33
33
  message TollInfo {
34
34
  // The monetary amount of tolls for the corresponding
35
- // [Route][google.maps.routing.v2.Route] or
36
- // [RouteLeg][google.maps.routing.v2.RouteLeg]. This list contains a money
35
+ // [`Route`][google.maps.routing.v2.Route] or
36
+ // [`RouteLeg`][google.maps.routing.v2.RouteLeg]. This list contains a money
37
37
  // amount for each currency that is expected to be charged by the toll
38
38
  // stations. Typically this list will contain only one item for routes with
39
39
  // tolls in one currency. For international trips, this list may contain
@@ -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.
@@ -31,7 +31,8 @@ enum TollPass {
31
31
  // Not used. If this value is used, then the request fails.
32
32
  TOLL_PASS_UNSPECIFIED = 0;
33
33
 
34
- // Sydney toll pass. See additional details at https://www.myetoll.com.au.
34
+ // Sydney toll pass. See additional details at
35
+ // https://www.myetoll.com.au.
35
36
  AU_ETOLL_TAG = 82;
36
37
 
37
38
  // Sydney toll pass. See additional details at https://www.tollpay.com.au.
@@ -95,6 +96,17 @@ enum TollPass {
95
96
  // India, HP state plate exemption.
96
97
  IN_LOCAL_HP_PLATE_EXEMPT = 79;
97
98
 
99
+ // Japan
100
+ // ETC. Electronic wireless system to collect tolls.
101
+ // https://www.go-etc.jp/
102
+ JP_ETC = 98;
103
+
104
+ // Japan
105
+ // ETC2.0. New version of ETC with further discount and bidirectional
106
+ // communication between devices on vehicles and antennas on the road.
107
+ // https://www.go-etc.jp/etc2/index.html
108
+ JP_ETC2 = 99;
109
+
98
110
  // Mexico toll pass.
99
111
  // https://iave.capufe.gob.mx/#/
100
112
  MX_IAVE = 90;
@@ -329,6 +341,9 @@ enum TollPass {
329
341
  // WV, USA.
330
342
  US_WV_MEMORIAL_BRIDGE_TICKETS = 63;
331
343
 
344
+ // WV, USA
345
+ US_WV_MOV_PASS = 100;
346
+
332
347
  // WV, USA.
333
348
  US_WV_NEWELL_TOLL_BRIDGE_TICKET = 64;
334
349
  }
@@ -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.
@@ -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.
@@ -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.
@@ -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.
@@ -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.
@@ -28,7 +28,7 @@ option ruby_package = "Google::Maps::Routing::V2";
28
28
 
29
29
  // A set of values describing the vehicle's emission type.
30
30
  // Applies only to the `DRIVE`
31
- // [RouteTravelMode][google.maps.routing.v2.RouteTravelMode].
31
+ // [`RouteTravelMode`][google.maps.routing.v2.RouteTravelMode].
32
32
  enum VehicleEmissionType {
33
33
  // No emission type specified. Default to `GASOLINE`.
34
34
  VEHICLE_EMISSION_TYPE_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.
@@ -32,6 +32,6 @@ option ruby_package = "Google::Maps::Routing::V2";
32
32
  message VehicleInfo {
33
33
  // Describes the vehicle's emission type.
34
34
  // Applies only to the `DRIVE`
35
- // [RouteTravelMode][google.maps.routing.v2.RouteTravelMode].
35
+ // [`RouteTravelMode`][google.maps.routing.v2.RouteTravelMode].
36
36
  VehicleEmissionType emission_type = 2;
37
37
  }
@@ -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.
@@ -47,7 +47,7 @@ message Waypoint {
47
47
 
48
48
  // Marks this waypoint as a milestone rather a stopping point. For
49
49
  // each non-via waypoint in the request, the response appends an entry to the
50
- // [legs][google.maps.routing.v2.Route.legs]
50
+ // [`legs`][google.maps.routing.v2.Route.legs]
51
51
  // array to provide the details for stopovers on that leg of the trip. Set
52
52
  // this value to true when you want the route to pass through this waypoint
53
53
  // without stopping over. Via waypoints don't cause an entry to be added to
@@ -63,14 +63,14 @@ message Waypoint {
63
63
  // calculated route won't include non-`via` waypoints on roads that are
64
64
  // unsuitable for pickup and drop-off. This option works only for `DRIVE` and
65
65
  // `TWO_WHEELER` travel modes, and when the `location_type` is
66
- // [Location][google.maps.routing.v2.Location].
66
+ // [`Location`][google.maps.routing.v2.Location].
67
67
  bool vehicle_stopover = 4;
68
68
 
69
69
  // Indicates that the location of this waypoint is meant to have a preference
70
70
  // for the vehicle to stop at a particular side of road. When you set this
71
71
  // value, the route will pass through the location so that the vehicle can
72
72
  // stop at the side of road that the location is biased towards from the
73
- // center of the road. This option works only for 'DRIVE' and 'TWO_WHEELER'
74
- // [RouteTravelMode][google.maps.routing.v2.RouteTravelMode].
73
+ // center of the road. This option works only for `DRIVE` and `TWO_WHEELER`
74
+ // [`RouteTravelMode`][google.maps.routing.v2.RouteTravelMode].
75
75
  bool side_of_road = 5;
76
76
  }
@@ -9456,6 +9456,8 @@ export namespace google {
9456
9456
  ID_E_TOLL = 16,
9457
9457
  IN_FASTAG = 78,
9458
9458
  IN_LOCAL_HP_PLATE_EXEMPT = 79,
9459
+ JP_ETC = 98,
9460
+ JP_ETC2 = 99,
9459
9461
  MX_IAVE = 90,
9460
9462
  MX_PASE = 91,
9461
9463
  MX_QUICKPASS = 93,
@@ -9531,6 +9533,7 @@ export namespace google {
9531
9533
  US_WA_GOOD_TO_GO = 1,
9532
9534
  US_WV_EZPASSWV = 62,
9533
9535
  US_WV_MEMORIAL_BRIDGE_TICKETS = 63,
9536
+ US_WV_MOV_PASS = 100,
9534
9537
  US_WV_NEWELL_TOLL_BRIDGE_TICKET = 64
9535
9538
  }
9536
9539
 
@@ -10065,6 +10068,9 @@ export namespace google {
10065
10068
  /** ComputeRouteMatrixRequest regionCode */
10066
10069
  regionCode?: (string|null);
10067
10070
 
10071
+ /** ComputeRouteMatrixRequest units */
10072
+ units?: (google.maps.routing.v2.Units|keyof typeof google.maps.routing.v2.Units|null);
10073
+
10068
10074
  /** ComputeRouteMatrixRequest extraComputations */
10069
10075
  extraComputations?: (google.maps.routing.v2.ComputeRouteMatrixRequest.ExtraComputation[]|null);
10070
10076
 
@@ -10108,6 +10114,9 @@ export namespace google {
10108
10114
  /** ComputeRouteMatrixRequest regionCode. */
10109
10115
  public regionCode: string;
10110
10116
 
10117
+ /** ComputeRouteMatrixRequest units. */
10118
+ public units: (google.maps.routing.v2.Units|keyof typeof google.maps.routing.v2.Units);
10119
+
10111
10120
  /** ComputeRouteMatrixRequest extraComputations. */
10112
10121
  public extraComputations: google.maps.routing.v2.ComputeRouteMatrixRequest.ExtraComputation[];
10113
10122
 
@@ -25331,6 +25331,8 @@
25331
25331
  case 16:
25332
25332
  case 78:
25333
25333
  case 79:
25334
+ case 98:
25335
+ case 99:
25334
25336
  case 90:
25335
25337
  case 91:
25336
25338
  case 93:
@@ -25406,6 +25408,7 @@
25406
25408
  case 1:
25407
25409
  case 62:
25408
25410
  case 63:
25411
+ case 100:
25409
25412
  case 64:
25410
25413
  break;
25411
25414
  }
@@ -25529,6 +25532,14 @@
25529
25532
  case 79:
25530
25533
  message.tollPasses[i] = 79;
25531
25534
  break;
25535
+ case "JP_ETC":
25536
+ case 98:
25537
+ message.tollPasses[i] = 98;
25538
+ break;
25539
+ case "JP_ETC2":
25540
+ case 99:
25541
+ message.tollPasses[i] = 99;
25542
+ break;
25532
25543
  case "MX_IAVE":
25533
25544
  case 90:
25534
25545
  message.tollPasses[i] = 90;
@@ -25829,6 +25840,10 @@
25829
25840
  case 63:
25830
25841
  message.tollPasses[i] = 63;
25831
25842
  break;
25843
+ case "US_WV_MOV_PASS":
25844
+ case 100:
25845
+ message.tollPasses[i] = 100;
25846
+ break;
25832
25847
  case "US_WV_NEWELL_TOLL_BRIDGE_TICKET":
25833
25848
  case 64:
25834
25849
  message.tollPasses[i] = 64;
@@ -25931,6 +25946,8 @@
25931
25946
  * @property {number} ID_E_TOLL=16 ID_E_TOLL value
25932
25947
  * @property {number} IN_FASTAG=78 IN_FASTAG value
25933
25948
  * @property {number} IN_LOCAL_HP_PLATE_EXEMPT=79 IN_LOCAL_HP_PLATE_EXEMPT value
25949
+ * @property {number} JP_ETC=98 JP_ETC value
25950
+ * @property {number} JP_ETC2=99 JP_ETC2 value
25934
25951
  * @property {number} MX_IAVE=90 MX_IAVE value
25935
25952
  * @property {number} MX_PASE=91 MX_PASE value
25936
25953
  * @property {number} MX_QUICKPASS=93 MX_QUICKPASS value
@@ -26006,6 +26023,7 @@
26006
26023
  * @property {number} US_WA_GOOD_TO_GO=1 US_WA_GOOD_TO_GO value
26007
26024
  * @property {number} US_WV_EZPASSWV=62 US_WV_EZPASSWV value
26008
26025
  * @property {number} US_WV_MEMORIAL_BRIDGE_TICKETS=63 US_WV_MEMORIAL_BRIDGE_TICKETS value
26026
+ * @property {number} US_WV_MOV_PASS=100 US_WV_MOV_PASS value
26009
26027
  * @property {number} US_WV_NEWELL_TOLL_BRIDGE_TICKET=64 US_WV_NEWELL_TOLL_BRIDGE_TICKET value
26010
26028
  */
26011
26029
  v2.TollPass = (function() {
@@ -26030,6 +26048,8 @@
26030
26048
  values[valuesById[16] = "ID_E_TOLL"] = 16;
26031
26049
  values[valuesById[78] = "IN_FASTAG"] = 78;
26032
26050
  values[valuesById[79] = "IN_LOCAL_HP_PLATE_EXEMPT"] = 79;
26051
+ values[valuesById[98] = "JP_ETC"] = 98;
26052
+ values[valuesById[99] = "JP_ETC2"] = 99;
26033
26053
  values[valuesById[90] = "MX_IAVE"] = 90;
26034
26054
  values[valuesById[91] = "MX_PASE"] = 91;
26035
26055
  values[valuesById[93] = "MX_QUICKPASS"] = 93;
@@ -26105,6 +26125,7 @@
26105
26125
  values[valuesById[1] = "US_WA_GOOD_TO_GO"] = 1;
26106
26126
  values[valuesById[62] = "US_WV_EZPASSWV"] = 62;
26107
26127
  values[valuesById[63] = "US_WV_MEMORIAL_BRIDGE_TICKETS"] = 63;
26128
+ values[valuesById[100] = "US_WV_MOV_PASS"] = 100;
26108
26129
  values[valuesById[64] = "US_WV_NEWELL_TOLL_BRIDGE_TICKET"] = 64;
26109
26130
  return values;
26110
26131
  })();
@@ -27738,6 +27759,7 @@
27738
27759
  * @property {google.protobuf.ITimestamp|null} [arrivalTime] ComputeRouteMatrixRequest arrivalTime
27739
27760
  * @property {string|null} [languageCode] ComputeRouteMatrixRequest languageCode
27740
27761
  * @property {string|null} [regionCode] ComputeRouteMatrixRequest regionCode
27762
+ * @property {google.maps.routing.v2.Units|null} [units] ComputeRouteMatrixRequest units
27741
27763
  * @property {Array.<google.maps.routing.v2.ComputeRouteMatrixRequest.ExtraComputation>|null} [extraComputations] ComputeRouteMatrixRequest extraComputations
27742
27764
  * @property {google.maps.routing.v2.TrafficModel|null} [trafficModel] ComputeRouteMatrixRequest trafficModel
27743
27765
  * @property {google.maps.routing.v2.ITransitPreferences|null} [transitPreferences] ComputeRouteMatrixRequest transitPreferences
@@ -27825,6 +27847,14 @@
27825
27847
  */
27826
27848
  ComputeRouteMatrixRequest.prototype.regionCode = "";
27827
27849
 
27850
+ /**
27851
+ * ComputeRouteMatrixRequest units.
27852
+ * @member {google.maps.routing.v2.Units} units
27853
+ * @memberof google.maps.routing.v2.ComputeRouteMatrixRequest
27854
+ * @instance
27855
+ */
27856
+ ComputeRouteMatrixRequest.prototype.units = 0;
27857
+
27828
27858
  /**
27829
27859
  * ComputeRouteMatrixRequest extraComputations.
27830
27860
  * @member {Array.<google.maps.routing.v2.ComputeRouteMatrixRequest.ExtraComputation>} extraComputations
@@ -27887,6 +27917,8 @@
27887
27917
  $root.google.protobuf.Timestamp.encode(message.departureTime, writer.uint32(/* id 5, wireType 2 =*/42).fork()).ldelim();
27888
27918
  if (message.languageCode != null && Object.hasOwnProperty.call(message, "languageCode"))
27889
27919
  writer.uint32(/* id 6, wireType 2 =*/50).string(message.languageCode);
27920
+ if (message.units != null && Object.hasOwnProperty.call(message, "units"))
27921
+ writer.uint32(/* id 7, wireType 0 =*/56).int32(message.units);
27890
27922
  if (message.extraComputations != null && message.extraComputations.length) {
27891
27923
  writer.uint32(/* id 8, wireType 2 =*/66).fork();
27892
27924
  for (var i = 0; i < message.extraComputations.length; ++i)
@@ -27971,6 +28003,10 @@
27971
28003
  message.regionCode = reader.string();
27972
28004
  break;
27973
28005
  }
28006
+ case 7: {
28007
+ message.units = reader.int32();
28008
+ break;
28009
+ }
27974
28010
  case 8: {
27975
28011
  if (!(message.extraComputations && message.extraComputations.length))
27976
28012
  message.extraComputations = [];
@@ -28081,6 +28117,15 @@
28081
28117
  if (message.regionCode != null && message.hasOwnProperty("regionCode"))
28082
28118
  if (!$util.isString(message.regionCode))
28083
28119
  return "regionCode: string expected";
28120
+ if (message.units != null && message.hasOwnProperty("units"))
28121
+ switch (message.units) {
28122
+ default:
28123
+ return "units: enum value expected";
28124
+ case 0:
28125
+ case 1:
28126
+ case 2:
28127
+ break;
28128
+ }
28084
28129
  if (message.extraComputations != null && message.hasOwnProperty("extraComputations")) {
28085
28130
  if (!Array.isArray(message.extraComputations))
28086
28131
  return "extraComputations: array expected";
@@ -28213,6 +28258,26 @@
28213
28258
  message.languageCode = String(object.languageCode);
28214
28259
  if (object.regionCode != null)
28215
28260
  message.regionCode = String(object.regionCode);
28261
+ switch (object.units) {
28262
+ default:
28263
+ if (typeof object.units === "number") {
28264
+ message.units = object.units;
28265
+ break;
28266
+ }
28267
+ break;
28268
+ case "UNITS_UNSPECIFIED":
28269
+ case 0:
28270
+ message.units = 0;
28271
+ break;
28272
+ case "METRIC":
28273
+ case 1:
28274
+ message.units = 1;
28275
+ break;
28276
+ case "IMPERIAL":
28277
+ case 2:
28278
+ message.units = 2;
28279
+ break;
28280
+ }
28216
28281
  if (object.extraComputations) {
28217
28282
  if (!Array.isArray(object.extraComputations))
28218
28283
  throw TypeError(".google.maps.routing.v2.ComputeRouteMatrixRequest.extraComputations: array expected");
@@ -28289,6 +28354,7 @@
28289
28354
  object.routingPreference = options.enums === String ? "ROUTING_PREFERENCE_UNSPECIFIED" : 0;
28290
28355
  object.departureTime = null;
28291
28356
  object.languageCode = "";
28357
+ object.units = options.enums === String ? "UNITS_UNSPECIFIED" : 0;
28292
28358
  object.regionCode = "";
28293
28359
  object.trafficModel = options.enums === String ? "TRAFFIC_MODEL_UNSPECIFIED" : 0;
28294
28360
  object.arrivalTime = null;
@@ -28312,6 +28378,8 @@
28312
28378
  object.departureTime = $root.google.protobuf.Timestamp.toObject(message.departureTime, options);
28313
28379
  if (message.languageCode != null && message.hasOwnProperty("languageCode"))
28314
28380
  object.languageCode = message.languageCode;
28381
+ if (message.units != null && message.hasOwnProperty("units"))
28382
+ object.units = options.enums === String ? $root.google.maps.routing.v2.Units[message.units] === undefined ? message.units : $root.google.maps.routing.v2.Units[message.units] : message.units;
28315
28383
  if (message.extraComputations && message.extraComputations.length) {
28316
28384
  object.extraComputations = [];
28317
28385
  for (var j = 0; j < message.extraComputations.length; ++j)
@@ -2326,6 +2326,8 @@
2326
2326
  "ID_E_TOLL": 16,
2327
2327
  "IN_FASTAG": 78,
2328
2328
  "IN_LOCAL_HP_PLATE_EXEMPT": 79,
2329
+ "JP_ETC": 98,
2330
+ "JP_ETC2": 99,
2329
2331
  "MX_IAVE": 90,
2330
2332
  "MX_PASE": 91,
2331
2333
  "MX_QUICKPASS": 93,
@@ -2401,6 +2403,7 @@
2401
2403
  "US_WA_GOOD_TO_GO": 1,
2402
2404
  "US_WV_EZPASSWV": 62,
2403
2405
  "US_WV_MEMORIAL_BRIDGE_TICKETS": 63,
2406
+ "US_WV_MOV_PASS": 100,
2404
2407
  "US_WV_NEWELL_TOLL_BRIDGE_TICKET": 64
2405
2408
  }
2406
2409
  },
@@ -2695,6 +2698,13 @@
2695
2698
  "(google.api.field_behavior)": "OPTIONAL"
2696
2699
  }
2697
2700
  },
2701
+ "units": {
2702
+ "type": "Units",
2703
+ "id": 7,
2704
+ "options": {
2705
+ "(google.api.field_behavior)": "OPTIONAL"
2706
+ }
2707
+ },
2698
2708
  "extraComputations": {
2699
2709
  "rule": "repeated",
2700
2710
  "type": "ExtraComputation",
@@ -118,7 +118,7 @@ export declare class RoutesClient {
118
118
  * the input. You can provide the response field mask by using URL parameter
119
119
  * `$fields` or `fields`, or by using an HTTP/gRPC header `X-Goog-FieldMask`
120
120
  * (see the [available URL parameters and
121
- * headers](https://cloud.google.com/apis/docs/system-parameters). The value
121
+ * headers](https://cloud.google.com/apis/docs/system-parameters)). The value
122
122
  * is a comma separated list of field paths. See detailed documentation about
123
123
  * [how to construct the field
124
124
  * paths](https://github.com/protocolbuffers/protobuf/blob/master/src/google/protobuf/field_mask.proto).
@@ -173,14 +173,16 @@ export declare class RoutesClient {
173
173
  * Optional. The departure time. If you don't set this value, then this value
174
174
  * defaults to the time that you made the request.
175
175
  * NOTE: You can only specify a `departure_time` in the past when
176
- * {@link protos.google.maps.routing.v2.RouteTravelMode|RouteTravelMode} is set to
177
- * `TRANSIT`.
176
+ * {@link protos.google.maps.routing.v2.RouteTravelMode|`RouteTravelMode`} is set to
177
+ * `TRANSIT`. Transit trips are available for up to 7 days in the past or 100
178
+ * days in the future.
178
179
  * @param {google.protobuf.Timestamp} [request.arrivalTime]
179
180
  * Optional. The arrival time.
180
181
  * NOTE: Can only be set when
181
182
  * {@link protos.google.maps.routing.v2.RouteTravelMode|RouteTravelMode} is set to
182
- * `TRANSIT`. You can specify either departure_time or arrival_time, but not
183
- * both.
183
+ * `TRANSIT`. You can specify either `departure_time` or `arrival_time`, but
184
+ * not both. Transit trips are available for up to 7 days in the past or 100
185
+ * days in the future.
184
186
  * @param {boolean} [request.computeAlternativeRoutes]
185
187
  * Optional. Specifies whether to calculate alternate routes in addition to
186
188
  * the route. No alternative routes are returned for requests that have
@@ -190,21 +192,22 @@ export declare class RoutesClient {
190
192
  * calculated.
191
193
  * @param {string} [request.languageCode]
192
194
  * Optional. The BCP-47 language code, such as "en-US" or "sr-Latn". For more
193
- * information, see
194
- * http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. See
195
- * [Language Support](https://developers.google.com/maps/faq#languagesupport)
195
+ * information, see [Unicode Locale
196
+ * Identifier](http://www.unicode.org/reports/tr35/#Unicode_locale_identifier).
197
+ * See [Language
198
+ * Support](https://developers.google.com/maps/faq#languagesupport)
196
199
  * for the list of supported languages. When you don't provide this value, the
197
200
  * display language is inferred from the location of the route request.
198
201
  * @param {string} [request.regionCode]
199
202
  * Optional. The region code, specified as a ccTLD ("top-level domain")
200
- * two-character value. For more information see
201
- * https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains#Country_code_top-level_domains
203
+ * two-character value. For more information see [Country code top-level
204
+ * domains](https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains#Country_code_top-level_domains).
202
205
  * @param {google.maps.routing.v2.Units} [request.units]
203
206
  * Optional. Specifies the units of measure for the display fields. These
204
207
  * fields include the `instruction` field in
205
- * {@link protos.google.maps.routing.v2.NavigationInstruction|NavigationInstruction}. The
206
- * units of measure used for the route, leg, step distance, and duration are
207
- * not affected by this value. If you don't provide this value, then the
208
+ * {@link protos.google.maps.routing.v2.NavigationInstruction|`NavigationInstruction`}.
209
+ * The units of measure used for the route, leg, step distance, and duration
210
+ * are not affected by this value. If you don't provide this value, then the
208
211
  * display units are inferred from the location of the first origin.
209
212
  * @param {boolean} [request.optimizeWaypointOrder]
210
213
  * Optional. If set to true, the service attempts to minimize the overall cost
@@ -231,19 +234,20 @@ export declare class RoutesClient {
231
234
  * @param {google.maps.routing.v2.TrafficModel} [request.trafficModel]
232
235
  * Optional. Specifies the assumptions to use when calculating time in
233
236
  * traffic. This setting affects the value returned in the duration field in
234
- * the {@link protos.google.maps.routing.v2.Route|Route} and
235
- * {@link protos.google.maps.routing.v2.RouteLeg|RouteLeg} which contains the predicted
237
+ * the
238
+ * {@link protos.google.maps.routing.v2.Route|`Route`} and
239
+ * {@link protos.google.maps.routing.v2.RouteLeg|`RouteLeg`} which contains the predicted
236
240
  * time in traffic based on historical averages.
237
241
  * `TrafficModel` is only available for requests that have set
238
- * {@link protos.google.maps.routing.v2.RoutingPreference|RoutingPreference} to
242
+ * {@link protos.google.maps.routing.v2.RoutingPreference|`RoutingPreference`} to
239
243
  * `TRAFFIC_AWARE_OPTIMAL` and
240
- * {@link protos.google.maps.routing.v2.RouteTravelMode|RouteTravelMode} to `DRIVE`.
244
+ * {@link protos.google.maps.routing.v2.RouteTravelMode|`RouteTravelMode`} to `DRIVE`.
241
245
  * Defaults to `BEST_GUESS` if traffic is requested and `TrafficModel` is not
242
246
  * specified.
243
247
  * @param {google.maps.routing.v2.TransitPreferences} [request.transitPreferences]
244
248
  * Optional. Specifies preferences that influence the route returned for
245
249
  * `TRANSIT` routes. NOTE: You can only specify a `transit_preferences` when
246
- * {@link protos.google.maps.routing.v2.RouteTravelMode|RouteTravelMode} is set to
250
+ * {@link protos.google.maps.routing.v2.RouteTravelMode|`RouteTravelMode`} is set to
247
251
  * `TRANSIT`.
248
252
  * @param {object} [options]
249
253
  * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
@@ -269,9 +273,9 @@ export declare class RoutesClient {
269
273
  * the input. You can provide the response field mask by using the URL
270
274
  * parameter `$fields` or `fields`, or by using the HTTP/gRPC header
271
275
  * `X-Goog-FieldMask` (see the [available URL parameters and
272
- * headers](https://cloud.google.com/apis/docs/system-parameters). The value
273
- * is a comma separated list of field paths. See this detailed documentation
274
- * about [how to construct the field
276
+ * headers](https://cloud.google.com/apis/docs/system-parameters)).
277
+ * The value is a comma separated list of field paths. See this detailed
278
+ * documentation about [how to construct the field
275
279
  * paths](https://github.com/protocolbuffers/protobuf/blob/master/src/google/protobuf/field_mask.proto).
276
280
  *
277
281
  * For example, in this method:
@@ -305,12 +309,14 @@ export declare class RoutesClient {
305
309
  * matrix. Several size restrictions apply to the cardinality of origins and
306
310
  * destinations:
307
311
  *
308
- * * The number of elements (origins × destinations) must be no greater than
309
- * 625 in any case.
310
- * * The number of elements (origins × destinations) must be no greater than
311
- * 100 if routing_preference is set to `TRAFFIC_AWARE_OPTIMAL`.
312
- * * The number of waypoints (origins + destinations) specified as `place_id`
313
- * must be no greater than 50.
312
+ * * The sum of the number of origins + the number of destinations specified
313
+ * as either `place_id` or `address` must be no greater than 50.
314
+ * * The product of number of origins × number of destinations must be no
315
+ * greater than 625 in any case.
316
+ * * The product of the number of origins × number of destinations must be no
317
+ * greater than 100 if routing_preference is set to `TRAFFIC_AWARE_OPTIMAL`.
318
+ * * The product of the number of origins × number of destinations must be no
319
+ * greater than 100 if travel_mode is set to `TRANSIT`.
314
320
  * @param {number[]} request.destinations
315
321
  * Required. Array of destinations, which determines the columns of the
316
322
  * response matrix.
@@ -326,25 +332,28 @@ export declare class RoutesClient {
326
332
  * Optional. The departure time. If you don't set this value, then this value
327
333
  * defaults to the time that you made the request.
328
334
  * NOTE: You can only specify a `departure_time` in the past when
329
- * {@link protos.google.maps.routing.v2.RouteTravelMode|RouteTravelMode} is set to
335
+ * {@link protos.google.maps.routing.v2.RouteTravelMode|`RouteTravelMode`} is set to
330
336
  * `TRANSIT`.
331
337
  * @param {google.protobuf.Timestamp} [request.arrivalTime]
332
338
  * Optional. The arrival time.
333
339
  * NOTE: Can only be set when
334
- * {@link protos.google.maps.routing.v2.RouteTravelMode|RouteTravelMode} is set to
335
- * `TRANSIT`. You can specify either departure_time or arrival_time, but not
336
- * both.
340
+ * {@link protos.google.maps.routing.v2.RouteTravelMode|`RouteTravelMode`} is set to
341
+ * `TRANSIT`. You can specify either `departure_time` or `arrival_time`, but
342
+ * not both.
337
343
  * @param {string} [request.languageCode]
338
344
  * Optional. The BCP-47 language code, such as "en-US" or "sr-Latn". For more
339
- * information, see
340
- * http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. See
341
- * [Language Support](https://developers.google.com/maps/faq#languagesupport)
345
+ * information, see [Unicode Locale
346
+ * Identifier](http://www.unicode.org/reports/tr35/#Unicode_locale_identifier).
347
+ * See [Language
348
+ * Support](https://developers.google.com/maps/faq#languagesupport)
342
349
  * for the list of supported languages. When you don't provide this value, the
343
350
  * display language is inferred from the location of the first origin.
344
351
  * @param {string} [request.regionCode]
345
352
  * Optional. The region code, specified as a ccTLD ("top-level domain")
346
- * two-character value. For more information see
347
- * https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains#Country_code_top-level_domains
353
+ * two-character value. For more information see [Country code top-level
354
+ * domains](https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains#Country_code_top-level_domains).
355
+ * @param {google.maps.routing.v2.Units} [request.units]
356
+ * Optional. Specifies the units of measure for the display fields.
348
357
  * @param {number[]} [request.extraComputations]
349
358
  * Optional. A list of extra computations which may be used to complete the
350
359
  * request. Note: These extra computations may return extra fields on the
@@ -148,8 +148,7 @@ class RoutesClient {
148
148
  // Some of the methods on this service provide streaming responses.
149
149
  // Provide descriptors for these.
150
150
  this.descriptors.stream = {
151
- computeRouteMatrix: new this._gaxModule.StreamDescriptor(this._gaxModule.StreamType.SERVER_STREAMING, !!opts.fallback,
152
- /* gaxStreamingRetries: */ false),
151
+ computeRouteMatrix: new this._gaxModule.StreamDescriptor(this._gaxModule.StreamType.SERVER_STREAMING, !!opts.fallback, !!opts.gaxServerStreamingRetries),
153
152
  };
154
153
  // Put together the default options sent with requests.
155
154
  this._defaults = this._gaxGrpc.constructSettings('google.maps.routing.v2.Routes', gapicConfig, opts.clientConfig || {}, { 'x-goog-api-client': clientHeader.join(' ') });
@@ -292,9 +291,9 @@ class RoutesClient {
292
291
  * the input. You can provide the response field mask by using the URL
293
292
  * parameter `$fields` or `fields`, or by using the HTTP/gRPC header
294
293
  * `X-Goog-FieldMask` (see the [available URL parameters and
295
- * headers](https://cloud.google.com/apis/docs/system-parameters). The value
296
- * is a comma separated list of field paths. See this detailed documentation
297
- * about [how to construct the field
294
+ * headers](https://cloud.google.com/apis/docs/system-parameters)).
295
+ * The value is a comma separated list of field paths. See this detailed
296
+ * documentation about [how to construct the field
298
297
  * paths](https://github.com/protocolbuffers/protobuf/blob/master/src/google/protobuf/field_mask.proto).
299
298
  *
300
299
  * For example, in this method:
@@ -328,12 +327,14 @@ class RoutesClient {
328
327
  * matrix. Several size restrictions apply to the cardinality of origins and
329
328
  * destinations:
330
329
  *
331
- * * The number of elements (origins × destinations) must be no greater than
332
- * 625 in any case.
333
- * * The number of elements (origins × destinations) must be no greater than
334
- * 100 if routing_preference is set to `TRAFFIC_AWARE_OPTIMAL`.
335
- * * The number of waypoints (origins + destinations) specified as `place_id`
336
- * must be no greater than 50.
330
+ * * The sum of the number of origins + the number of destinations specified
331
+ * as either `place_id` or `address` must be no greater than 50.
332
+ * * The product of number of origins × number of destinations must be no
333
+ * greater than 625 in any case.
334
+ * * The product of the number of origins × number of destinations must be no
335
+ * greater than 100 if routing_preference is set to `TRAFFIC_AWARE_OPTIMAL`.
336
+ * * The product of the number of origins × number of destinations must be no
337
+ * greater than 100 if travel_mode is set to `TRANSIT`.
337
338
  * @param {number[]} request.destinations
338
339
  * Required. Array of destinations, which determines the columns of the
339
340
  * response matrix.
@@ -349,25 +350,28 @@ class RoutesClient {
349
350
  * Optional. The departure time. If you don't set this value, then this value
350
351
  * defaults to the time that you made the request.
351
352
  * NOTE: You can only specify a `departure_time` in the past when
352
- * {@link protos.google.maps.routing.v2.RouteTravelMode|RouteTravelMode} is set to
353
+ * {@link protos.google.maps.routing.v2.RouteTravelMode|`RouteTravelMode`} is set to
353
354
  * `TRANSIT`.
354
355
  * @param {google.protobuf.Timestamp} [request.arrivalTime]
355
356
  * Optional. The arrival time.
356
357
  * NOTE: Can only be set when
357
- * {@link protos.google.maps.routing.v2.RouteTravelMode|RouteTravelMode} is set to
358
- * `TRANSIT`. You can specify either departure_time or arrival_time, but not
359
- * both.
358
+ * {@link protos.google.maps.routing.v2.RouteTravelMode|`RouteTravelMode`} is set to
359
+ * `TRANSIT`. You can specify either `departure_time` or `arrival_time`, but
360
+ * not both.
360
361
  * @param {string} [request.languageCode]
361
362
  * Optional. The BCP-47 language code, such as "en-US" or "sr-Latn". For more
362
- * information, see
363
- * http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. See
364
- * [Language Support](https://developers.google.com/maps/faq#languagesupport)
363
+ * information, see [Unicode Locale
364
+ * Identifier](http://www.unicode.org/reports/tr35/#Unicode_locale_identifier).
365
+ * See [Language
366
+ * Support](https://developers.google.com/maps/faq#languagesupport)
365
367
  * for the list of supported languages. When you don't provide this value, the
366
368
  * display language is inferred from the location of the first origin.
367
369
  * @param {string} [request.regionCode]
368
370
  * Optional. The region code, specified as a ccTLD ("top-level domain")
369
- * two-character value. For more information see
370
- * https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains#Country_code_top-level_domains
371
+ * two-character value. For more information see [Country code top-level
372
+ * domains](https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains#Country_code_top-level_domains).
373
+ * @param {google.maps.routing.v2.Units} [request.units]
374
+ * Optional. Specifies the units of measure for the display fields.
371
375
  * @param {number[]} [request.extraComputations]
372
376
  * Optional. A list of extra computations which may be used to complete the
373
377
  * request. Note: These extra computations may return extra fields on the
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@googlemaps/routing",
3
- "version": "1.2.0",
3
+ "version": "1.3.0",
4
4
  "description": " client for Node.js",
5
5
  "repository": {
6
6
  "type": "git",