@googlemaps/routing 1.1.0 → 1.3.0

package/build/src/v2/routes_client.d.ts

@@ -118,7 +118,7 @@ export declare class RoutesClient {
      * the input. You can provide the response field mask by using URL parameter
      * `$fields` or `fields`, or by using an HTTP/gRPC header `X-Goog-FieldMask`
      * (see the [available URL parameters and
-     * headers](https://cloud.google.com/apis/docs/system-parameters). The value
+     * headers](https://cloud.google.com/apis/docs/system-parameters)). The value
      * is a comma separated list of field paths. See detailed documentation about
      * [how to construct the field
      * paths](https://github.com/protocolbuffers/protobuf/blob/master/src/google/protobuf/field_mask.proto).
@@ -173,14 +173,16 @@ export declare class RoutesClient {
      *   Optional. The departure time. If you don't set this value, then this value
      *   defaults to the time that you made the request.
      *   NOTE: You can only specify a `departure_time` in the past when
-     *   {@link protos.google.maps.routing.v2.RouteTravelMode|RouteTravelMode} is set to
-     *   `TRANSIT`.
+     *   {@link protos.google.maps.routing.v2.RouteTravelMode|`RouteTravelMode`} is set to
+     *   `TRANSIT`. Transit trips are available for up to 7 days in the past or 100
+     *   days in the future.
      * @param {google.protobuf.Timestamp} [request.arrivalTime]
      *   Optional. The arrival time.
      *   NOTE: Can only be set when
      *   {@link protos.google.maps.routing.v2.RouteTravelMode|RouteTravelMode} is set to
-     *   `TRANSIT`. You can specify either departure_time or arrival_time, but not
-     *   both.
+     *   `TRANSIT`. You can specify either `departure_time` or `arrival_time`, but
+     *   not both. Transit trips are available for up to 7 days in the past or 100
+     *   days in the future.
      * @param {boolean} [request.computeAlternativeRoutes]
      *   Optional. Specifies whether to calculate alternate routes in addition to
      *   the route. No alternative routes are returned for requests that have
@@ -190,21 +192,22 @@ export declare class RoutesClient {
      *   calculated.
      * @param {string} [request.languageCode]
      *   Optional. The BCP-47 language code, such as "en-US" or "sr-Latn". For more
-     *   information, see
-     *   http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. See
-     *   [Language Support](https://developers.google.com/maps/faq#languagesupport)
+     *   information, see [Unicode Locale
+     *   Identifier](http://www.unicode.org/reports/tr35/#Unicode_locale_identifier).
+     *   See [Language
+     *   Support](https://developers.google.com/maps/faq#languagesupport)
      *   for the list of supported languages. When you don't provide this value, the
      *   display language is inferred from the location of the route request.
      * @param {string} [request.regionCode]
      *   Optional. The region code, specified as a ccTLD ("top-level domain")
-     *   two-character value. For more information see
-     *   https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains#Country_code_top-level_domains
+     *   two-character value. For more information see [Country code top-level
+     *   domains](https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains#Country_code_top-level_domains).
      * @param {google.maps.routing.v2.Units} [request.units]
      *   Optional. Specifies the units of measure for the display fields. These
      *   fields include the `instruction` field in
-     *   {@link protos.google.maps.routing.v2.NavigationInstruction|NavigationInstruction}. The
-     *   units of measure used for the route, leg, step distance, and duration are
-     *   not affected by this value. If you don't provide this value, then the
+     *   {@link protos.google.maps.routing.v2.NavigationInstruction|`NavigationInstruction`}.
+     *   The units of measure used for the route, leg, step distance, and duration
+     *   are not affected by this value. If you don't provide this value, then the
      *   display units are inferred from the location of the first origin.
      * @param {boolean} [request.optimizeWaypointOrder]
      *   Optional. If set to true, the service attempts to minimize the overall cost
@@ -231,19 +234,20 @@ export declare class RoutesClient {
      * @param {google.maps.routing.v2.TrafficModel} [request.trafficModel]
      *   Optional. Specifies the assumptions to use when calculating time in
      *   traffic. This setting affects the value returned in the duration field in
-     *   the {@link protos.google.maps.routing.v2.Route|Route} and
-     *   {@link protos.google.maps.routing.v2.RouteLeg|RouteLeg} which contains the predicted
+     *   the
+     *   {@link protos.google.maps.routing.v2.Route|`Route`} and
+     *   {@link protos.google.maps.routing.v2.RouteLeg|`RouteLeg`} which contains the predicted
      *   time in traffic based on historical averages.
      *   `TrafficModel` is only available for requests that have set
-     *   {@link protos.google.maps.routing.v2.RoutingPreference|RoutingPreference} to
+     *   {@link protos.google.maps.routing.v2.RoutingPreference|`RoutingPreference`} to
      *   `TRAFFIC_AWARE_OPTIMAL` and
-     *   {@link protos.google.maps.routing.v2.RouteTravelMode|RouteTravelMode} to `DRIVE`.
+     *   {@link protos.google.maps.routing.v2.RouteTravelMode|`RouteTravelMode`} to `DRIVE`.
      *   Defaults to `BEST_GUESS` if traffic is requested and `TrafficModel` is not
      *   specified.
      * @param {google.maps.routing.v2.TransitPreferences} [request.transitPreferences]
      *   Optional. Specifies preferences that influence the route returned for
      *   `TRANSIT` routes. NOTE: You can only specify a `transit_preferences` when
-     *   {@link protos.google.maps.routing.v2.RouteTravelMode|RouteTravelMode} is set to
+     *   {@link protos.google.maps.routing.v2.RouteTravelMode|`RouteTravelMode`} is set to
      *   `TRANSIT`.
      * @param {object} [options]
      *   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 {
      * the input. You can provide the response field mask by using the URL
      * parameter `$fields` or `fields`, or by using the HTTP/gRPC header
      * `X-Goog-FieldMask` (see the [available URL parameters and
-     * headers](https://cloud.google.com/apis/docs/system-parameters). The value
-     * is a comma separated list of field paths. See this detailed documentation
-     * about [how to construct the field
+     * headers](https://cloud.google.com/apis/docs/system-parameters)).
+     * The value is a comma separated list of field paths. See this detailed
+     * documentation about [how to construct the field
      * paths](https://github.com/protocolbuffers/protobuf/blob/master/src/google/protobuf/field_mask.proto).
      *
      * For example, in this method:
@@ -305,12 +309,14 @@ export declare class RoutesClient {
      *   matrix. Several size restrictions apply to the cardinality of origins and
      *   destinations:
      *
-     *   * The number of elements (origins × destinations) must be no greater than
-     *   625 in any case.
-     *   * The number of elements (origins × destinations) must be no greater than
-     *   100 if routing_preference is set to `TRAFFIC_AWARE_OPTIMAL`.
-     *   * The number of waypoints (origins + destinations) specified as `place_id`
-     *   must be no greater than 50.
+     *   * The sum of the number of origins + the number of destinations specified
+     *   as either `place_id` or `address` must be no greater than 50.
+     *   * The product of number of origins × number of destinations must be no
+     *   greater than 625 in any case.
+     *   * The product of the number of origins × number of destinations must be no
+     *   greater than 100 if routing_preference is set to `TRAFFIC_AWARE_OPTIMAL`.
+     *   * The product of the number of origins × number of destinations must be no
+     *   greater than 100 if travel_mode is set to `TRANSIT`.
      * @param {number[]} request.destinations
      *   Required. Array of destinations, which determines the columns of the
      *   response matrix.
@@ -326,25 +332,28 @@ export declare class RoutesClient {
      *   Optional. The departure time. If you don't set this value, then this value
      *   defaults to the time that you made the request.
      *   NOTE: You can only specify a `departure_time` in the past when
-     *   {@link protos.google.maps.routing.v2.RouteTravelMode|RouteTravelMode} is set to
+     *   {@link protos.google.maps.routing.v2.RouteTravelMode|`RouteTravelMode`} is set to
      *   `TRANSIT`.
      * @param {google.protobuf.Timestamp} [request.arrivalTime]
      *   Optional. The arrival time.
      *   NOTE: Can only be set when
-     *   {@link protos.google.maps.routing.v2.RouteTravelMode|RouteTravelMode} is set to
-     *   `TRANSIT`. You can specify either departure_time or arrival_time, but not
-     *   both.
+     *   {@link protos.google.maps.routing.v2.RouteTravelMode|`RouteTravelMode`} is set to
+     *   `TRANSIT`. You can specify either `departure_time` or `arrival_time`, but
+     *   not both.
      * @param {string} [request.languageCode]
      *   Optional. The BCP-47 language code, such as "en-US" or "sr-Latn". For more
-     *   information, see
-     *   http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. See
-     *   [Language Support](https://developers.google.com/maps/faq#languagesupport)
+     *   information, see [Unicode Locale
+     *   Identifier](http://www.unicode.org/reports/tr35/#Unicode_locale_identifier).
+     *   See [Language
+     *   Support](https://developers.google.com/maps/faq#languagesupport)
      *   for the list of supported languages. When you don't provide this value, the
      *   display language is inferred from the location of the first origin.
      * @param {string} [request.regionCode]
      *   Optional. The region code, specified as a ccTLD ("top-level domain")
-     *   two-character value. For more information see
-     *   https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains#Country_code_top-level_domains
+     *   two-character value. For more information see [Country code top-level
+     *   domains](https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains#Country_code_top-level_domains).
+     * @param {google.maps.routing.v2.Units} [request.units]
+     *   Optional. Specifies the units of measure for the display fields.
      * @param {number[]} [request.extraComputations]
      *   Optional. A list of extra computations which may be used to complete the
      *   request. Note: These extra computations may return extra fields on the

package/build/src/v2/routes_client.js

@@ -73,7 +73,7 @@ class RoutesClient {
      *     ```
      */
     constructor(opts, gaxInstance) {
-        var _a, _b, _c, _d;
+        var _a, _b, _c, _d, _e;
         this._terminated = false;
         this.descriptors = {
             page: {},
@@ -88,14 +88,17 @@ class RoutesClient {
             (opts === null || opts === void 0 ? void 0 : opts.universe_domain) !== (opts === null || opts === void 0 ? void 0 : opts.universeDomain)) {
             throw new Error('Please set either universe_domain or universeDomain, but not both.');
         }
+        const universeDomainEnvVar = typeof process === 'object' && typeof process.env === 'object'
+            ? process.env['GOOGLE_CLOUD_UNIVERSE_DOMAIN']
+            : undefined;
         this._universeDomain =
-            (_b = (_a = opts === null || opts === void 0 ? void 0 : opts.universeDomain) !== null && _a !== void 0 ? _a : opts === null || opts === void 0 ? void 0 : opts.universe_domain) !== null && _b !== void 0 ? _b : 'googleapis.com';
+            (_c = (_b = (_a = opts === null || opts === void 0 ? void 0 : opts.universeDomain) !== null && _a !== void 0 ? _a : opts === null || opts === void 0 ? void 0 : opts.universe_domain) !== null && _b !== void 0 ? _b : universeDomainEnvVar) !== null && _c !== void 0 ? _c : 'googleapis.com';
         this._servicePath = 'routes.' + this._universeDomain;
         const servicePath = (opts === null || opts === void 0 ? void 0 : opts.servicePath) || (opts === null || opts === void 0 ? void 0 : opts.apiEndpoint) || this._servicePath;
         this._providedCustomServicePath = !!((opts === null || opts === void 0 ? void 0 : opts.servicePath) || (opts === null || opts === void 0 ? void 0 : opts.apiEndpoint));
         const port = (opts === null || opts === void 0 ? void 0 : opts.port) || staticMembers.port;
-        const clientConfig = (_c = opts === null || opts === void 0 ? void 0 : opts.clientConfig) !== null && _c !== void 0 ? _c : {};
-        const fallback = (_d = opts === null || opts === void 0 ? void 0 : opts.fallback) !== null && _d !== void 0 ? _d : (typeof window !== 'undefined' && typeof (window === null || window === void 0 ? void 0 : window.fetch) === 'function');
+        const clientConfig = (_d = opts === null || opts === void 0 ? void 0 : opts.clientConfig) !== null && _d !== void 0 ? _d : {};
+        const fallback = (_e = opts === null || opts === void 0 ? void 0 : opts.fallback) !== null && _e !== void 0 ? _e : (typeof window !== 'undefined' && typeof (window === null || window === void 0 ? void 0 : window.fetch) === 'function');
         opts = Object.assign({ servicePath, port, clientConfig, fallback }, opts);
         // Request numeric enum values if REST transport is used.
         opts.numericEnums = true;
@@ -125,7 +128,7 @@ class RoutesClient {
         }
         // Determine the client header string.
         const clientHeader = [`gax/${this._gaxModule.version}`, `gapic/${version}`];
-        if (typeof process !== 'undefined' && 'versions' in process) {
+        if (typeof process === 'object' && 'versions' in process) {
             clientHeader.push(`gl-node/${process.versions.node}`);
         }
         else {
@@ -145,8 +148,7 @@ class RoutesClient {
         // Some of the methods on this service provide streaming responses.
         // Provide descriptors for these.
         this.descriptors.stream = {
-            computeRouteMatrix: new this._gaxModule.StreamDescriptor(this._gaxModule.StreamType.SERVER_STREAMING, !!opts.fallback, 
-            /* gaxStreamingRetries: */ false),
+            computeRouteMatrix: new this._gaxModule.StreamDescriptor(this._gaxModule.StreamType.SERVER_STREAMING, !!opts.fallback, !!opts.gaxServerStreamingRetries),
         };
         // Put together the default options sent with requests.
         this._defaults = this._gaxGrpc.constructSettings('google.maps.routing.v2.Routes', gapicConfig, opts.clientConfig || {}, { 'x-goog-api-client': clientHeader.join(' ') });
@@ -211,7 +213,7 @@ class RoutesClient {
      * @returns {string} The DNS address for this service.
      */
     static get servicePath() {
-        if (typeof process !== undefined &&
+        if (typeof process === 'object' &&
             typeof process.emitWarning === 'function') {
             process.emitWarning('Static servicePath is deprecated, please use the instance method instead.', 'DeprecationWarning');
         }
@@ -223,7 +225,7 @@ class RoutesClient {
      * @returns {string} The DNS address for this service.
      */
     static get apiEndpoint() {
-        if (typeof process !== undefined &&
+        if (typeof process === 'object' &&
             typeof process.emitWarning === 'function') {
             process.emitWarning('Static apiEndpoint is deprecated, please use the instance method instead.', 'DeprecationWarning');
         }
@@ -289,9 +291,9 @@ class RoutesClient {
      * the input. You can provide the response field mask by using the URL
      * parameter `$fields` or `fields`, or by using the HTTP/gRPC header
      * `X-Goog-FieldMask` (see the [available URL parameters and
-     * headers](https://cloud.google.com/apis/docs/system-parameters). The value
-     * is a comma separated list of field paths. See this detailed documentation
-     * about [how to construct the field
+     * headers](https://cloud.google.com/apis/docs/system-parameters)).
+     * The value is a comma separated list of field paths. See this detailed
+     * documentation about [how to construct the field
      * paths](https://github.com/protocolbuffers/protobuf/blob/master/src/google/protobuf/field_mask.proto).
      *
      * For example, in this method:
@@ -325,12 +327,14 @@ class RoutesClient {
      *   matrix. Several size restrictions apply to the cardinality of origins and
      *   destinations:
      *
-     *   * The number of elements (origins × destinations) must be no greater than
-     *   625 in any case.
-     *   * The number of elements (origins × destinations) must be no greater than
-     *   100 if routing_preference is set to `TRAFFIC_AWARE_OPTIMAL`.
-     *   * The number of waypoints (origins + destinations) specified as `place_id`
-     *   must be no greater than 50.
+     *   * The sum of the number of origins + the number of destinations specified
+     *   as either `place_id` or `address` must be no greater than 50.
+     *   * The product of number of origins × number of destinations must be no
+     *   greater than 625 in any case.
+     *   * The product of the number of origins × number of destinations must be no
+     *   greater than 100 if routing_preference is set to `TRAFFIC_AWARE_OPTIMAL`.
+     *   * The product of the number of origins × number of destinations must be no
+     *   greater than 100 if travel_mode is set to `TRANSIT`.
      * @param {number[]} request.destinations
      *   Required. Array of destinations, which determines the columns of the
      *   response matrix.
@@ -346,25 +350,28 @@ class RoutesClient {
      *   Optional. The departure time. If you don't set this value, then this value
      *   defaults to the time that you made the request.
      *   NOTE: You can only specify a `departure_time` in the past when
-     *   {@link protos.google.maps.routing.v2.RouteTravelMode|RouteTravelMode} is set to
+     *   {@link protos.google.maps.routing.v2.RouteTravelMode|`RouteTravelMode`} is set to
      *   `TRANSIT`.
      * @param {google.protobuf.Timestamp} [request.arrivalTime]
      *   Optional. The arrival time.
      *   NOTE: Can only be set when
-     *   {@link protos.google.maps.routing.v2.RouteTravelMode|RouteTravelMode} is set to
-     *   `TRANSIT`. You can specify either departure_time or arrival_time, but not
-     *   both.
+     *   {@link protos.google.maps.routing.v2.RouteTravelMode|`RouteTravelMode`} is set to
+     *   `TRANSIT`. You can specify either `departure_time` or `arrival_time`, but
+     *   not both.
      * @param {string} [request.languageCode]
      *   Optional. The BCP-47 language code, such as "en-US" or "sr-Latn". For more
-     *   information, see
-     *   http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. See
-     *   [Language Support](https://developers.google.com/maps/faq#languagesupport)
+     *   information, see [Unicode Locale
+     *   Identifier](http://www.unicode.org/reports/tr35/#Unicode_locale_identifier).
+     *   See [Language
+     *   Support](https://developers.google.com/maps/faq#languagesupport)
      *   for the list of supported languages. When you don't provide this value, the
      *   display language is inferred from the location of the first origin.
      * @param {string} [request.regionCode]
      *   Optional. The region code, specified as a ccTLD ("top-level domain")
-     *   two-character value. For more information see
-     *   https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains#Country_code_top-level_domains
+     *   two-character value. For more information see [Country code top-level
+     *   domains](https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains#Country_code_top-level_domains).
+     * @param {google.maps.routing.v2.Units} [request.units]
+     *   Optional. Specifies the units of measure for the display fields.
      * @param {number[]} [request.extraComputations]
      *   Optional. A list of extra computations which may be used to complete the
      *   request. Note: These extra computations may return extra fields on the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@googlemaps/routing",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "description": " client for Node.js",
   "repository": {
     "type": "git",
@@ -52,8 +52,8 @@
     "@types/mocha": "^9.0.0",
     "@types/node": "^20.4.5",
     "@types/sinon": "^17.0.0",
-    "c8": "^8.0.1",
-    "gapic-tools": "^0.3.0",
+    "c8": "^9.0.0",
+    "gapic-tools": "^0.4.0",
     "gts": "^5.0.0",
     "jsdoc": "^4.0.0",
     "jsdoc-fresh": "^3.0.0",