@googlemaps/places 1.3.0 → 1.5.0

package/build/protos/protos.json

@@ -34,6 +34,21 @@
                 }
               }
             },
+            "Edition": {
+              "values": {
+                "EDITION_UNKNOWN": 0,
+                "EDITION_PROTO2": 998,
+                "EDITION_PROTO3": 999,
+                "EDITION_2023": 1000,
+                "EDITION_2024": 1001,
+                "EDITION_1_TEST_ONLY": 1,
+                "EDITION_2_TEST_ONLY": 2,
+                "EDITION_99997_TEST_ONLY": 99997,
+                "EDITION_99998_TEST_ONLY": 99998,
+                "EDITION_99999_TEST_ONLY": 99999,
+                "EDITION_MAX": 2147483647
+              }
+            },
             "FileDescriptorProto": {
               "fields": {
                 "name": {
@@ -98,8 +113,8 @@
                   "id": 12
                 },
                 "edition": {
-                  "type": "string",
-                  "id": 13
+                  "type": "Edition",
+                  "id": 14
                 }
               }
             },
@@ -191,6 +206,26 @@
                   "rule": "repeated",
                   "type": "UninterpretedOption",
                   "id": 999
+                },
+                "declaration": {
+                  "rule": "repeated",
+                  "type": "Declaration",
+                  "id": 2,
+                  "options": {
+                    "retention": "RETENTION_SOURCE"
+                  }
+                },
+                "features": {
+                  "type": "FeatureSet",
+                  "id": 50
+                },
+                "verification": {
+                  "type": "VerificationState",
+                  "id": 3,
+                  "options": {
+                    "default": "UNVERIFIED",
+                    "retention": "RETENTION_SOURCE"
+                  }
                 }
               },
               "extensions": [
@@ -198,7 +233,45 @@
                   1000,
                   536870911
                 ]
-              ]
+              ],
+              "nested": {
+                "Declaration": {
+                  "fields": {
+                    "number": {
+                      "type": "int32",
+                      "id": 1
+                    },
+                    "fullName": {
+                      "type": "string",
+                      "id": 2
+                    },
+                    "type": {
+                      "type": "string",
+                      "id": 3
+                    },
+                    "reserved": {
+                      "type": "bool",
+                      "id": 5
+                    },
+                    "repeated": {
+                      "type": "bool",
+                      "id": 6
+                    }
+                  },
+                  "reserved": [
+                    [
+                      4,
+                      4
+                    ]
+                  ]
+                },
+                "VerificationState": {
+                  "values": {
+                    "DECLARATION": 0,
+                    "UNVERIFIED": 1
+                  }
+                }
+              }
             },
             "FieldDescriptorProto": {
               "fields": {
@@ -273,8 +346,8 @@
                 "Label": {
                   "values": {
                     "LABEL_OPTIONAL": 1,
-                    "LABEL_REQUIRED": 2,
-                    "LABEL_REPEATED": 3
+                    "LABEL_REPEATED": 3,
+                    "LABEL_REQUIRED": 2
                   }
                 }
               }
@@ -462,13 +535,6 @@
                     "default": false
                   }
                 },
-                "phpGenericServices": {
-                  "type": "bool",
-                  "id": 42,
-                  "options": {
-                    "default": false
-                  }
-                },
                 "deprecated": {
                   "type": "bool",
                   "id": 23,
@@ -511,6 +577,10 @@
                   "type": "string",
                   "id": 45
                 },
+                "features": {
+                  "type": "FeatureSet",
+                  "id": 50
+                },
                 "uninterpretedOption": {
                   "rule": "repeated",
                   "type": "UninterpretedOption",
@@ -524,6 +594,10 @@
                 ]
               ],
               "reserved": [
+                [
+                  42,
+                  42
+                ],
                 [
                   38,
                   38
@@ -573,6 +647,10 @@
                     "deprecated": true
                   }
                 },
+                "features": {
+                  "type": "FeatureSet",
+                  "id": 12
+                },
                 "uninterpretedOption": {
                   "rule": "repeated",
                   "type": "UninterpretedOption",
@@ -667,9 +745,22 @@
                   "type": "OptionRetention",
                   "id": 17
                 },
-                "target": {
+                "targets": {
+                  "rule": "repeated",
                   "type": "OptionTargetType",
-                  "id": 18
+                  "id": 19,
+                  "options": {
+                    "packed": false
+                  }
+                },
+                "editionDefaults": {
+                  "rule": "repeated",
+                  "type": "EditionDefault",
+                  "id": 20
+                },
+                "features": {
+                  "type": "FeatureSet",
+                  "id": 21
                 },
                 "uninterpretedOption": {
                   "rule": "repeated",
@@ -687,6 +778,10 @@
                 [
                   4,
                   4
+                ],
+                [
+                  18,
+                  18
                 ]
               ],
               "nested": {
@@ -724,11 +819,27 @@
                     "TARGET_TYPE_SERVICE": 8,
                     "TARGET_TYPE_METHOD": 9
                   }
+                },
+                "EditionDefault": {
+                  "fields": {
+                    "edition": {
+                      "type": "Edition",
+                      "id": 3
+                    },
+                    "value": {
+                      "type": "string",
+                      "id": 2
+                    }
+                  }
                 }
               }
             },
             "OneofOptions": {
               "fields": {
+                "features": {
+                  "type": "FeatureSet",
+                  "id": 1
+                },
                 "uninterpretedOption": {
                   "rule": "repeated",
                   "type": "UninterpretedOption",
@@ -762,6 +873,10 @@
                     "deprecated": true
                   }
                 },
+                "features": {
+                  "type": "FeatureSet",
+                  "id": 7
+                },
                 "uninterpretedOption": {
                   "rule": "repeated",
                   "type": "UninterpretedOption",
@@ -790,6 +905,17 @@
                     "default": false
                   }
                 },
+                "features": {
+                  "type": "FeatureSet",
+                  "id": 2
+                },
+                "debugRedact": {
+                  "type": "bool",
+                  "id": 3,
+                  "options": {
+                    "default": false
+                  }
+                },
                 "uninterpretedOption": {
                   "rule": "repeated",
                   "type": "UninterpretedOption",
@@ -805,6 +931,10 @@
             },
             "ServiceOptions": {
               "fields": {
+                "features": {
+                  "type": "FeatureSet",
+                  "id": 34
+                },
                 "deprecated": {
                   "type": "bool",
                   "id": 33,
@@ -841,6 +971,10 @@
                     "default": "IDEMPOTENCY_UNKNOWN"
                   }
                 },
+                "features": {
+                  "type": "FeatureSet",
+                  "id": 35
+                },
                 "uninterpretedOption": {
                   "rule": "repeated",
                   "type": "UninterpretedOption",
@@ -912,6 +1046,166 @@
                 }
               }
             },
+            "FeatureSet": {
+              "fields": {
+                "fieldPresence": {
+                  "type": "FieldPresence",
+                  "id": 1,
+                  "options": {
+                    "retention": "RETENTION_RUNTIME",
+                    "targets": "TARGET_TYPE_FILE",
+                    "edition_defaults.edition": "EDITION_2023",
+                    "edition_defaults.value": "EXPLICIT"
+                  }
+                },
+                "enumType": {
+                  "type": "EnumType",
+                  "id": 2,
+                  "options": {
+                    "retention": "RETENTION_RUNTIME",
+                    "targets": "TARGET_TYPE_FILE",
+                    "edition_defaults.edition": "EDITION_PROTO3",
+                    "edition_defaults.value": "OPEN"
+                  }
+                },
+                "repeatedFieldEncoding": {
+                  "type": "RepeatedFieldEncoding",
+                  "id": 3,
+                  "options": {
+                    "retention": "RETENTION_RUNTIME",
+                    "targets": "TARGET_TYPE_FILE",
+                    "edition_defaults.edition": "EDITION_PROTO3",
+                    "edition_defaults.value": "PACKED"
+                  }
+                },
+                "utf8Validation": {
+                  "type": "Utf8Validation",
+                  "id": 4,
+                  "options": {
+                    "retention": "RETENTION_RUNTIME",
+                    "targets": "TARGET_TYPE_FILE",
+                    "edition_defaults.edition": "EDITION_PROTO3",
+                    "edition_defaults.value": "VERIFY"
+                  }
+                },
+                "messageEncoding": {
+                  "type": "MessageEncoding",
+                  "id": 5,
+                  "options": {
+                    "retention": "RETENTION_RUNTIME",
+                    "targets": "TARGET_TYPE_FILE",
+                    "edition_defaults.edition": "EDITION_PROTO2",
+                    "edition_defaults.value": "LENGTH_PREFIXED"
+                  }
+                },
+                "jsonFormat": {
+                  "type": "JsonFormat",
+                  "id": 6,
+                  "options": {
+                    "retention": "RETENTION_RUNTIME",
+                    "targets": "TARGET_TYPE_FILE",
+                    "edition_defaults.edition": "EDITION_PROTO3",
+                    "edition_defaults.value": "ALLOW"
+                  }
+                }
+              },
+              "extensions": [
+                [
+                  1000,
+                  1000
+                ],
+                [
+                  1001,
+                  1001
+                ],
+                [
+                  9995,
+                  9999
+                ]
+              ],
+              "reserved": [
+                [
+                  999,
+                  999
+                ]
+              ],
+              "nested": {
+                "FieldPresence": {
+                  "values": {
+                    "FIELD_PRESENCE_UNKNOWN": 0,
+                    "EXPLICIT": 1,
+                    "IMPLICIT": 2,
+                    "LEGACY_REQUIRED": 3
+                  }
+                },
+                "EnumType": {
+                  "values": {
+                    "ENUM_TYPE_UNKNOWN": 0,
+                    "OPEN": 1,
+                    "CLOSED": 2
+                  }
+                },
+                "RepeatedFieldEncoding": {
+                  "values": {
+                    "REPEATED_FIELD_ENCODING_UNKNOWN": 0,
+                    "PACKED": 1,
+                    "EXPANDED": 2
+                  }
+                },
+                "Utf8Validation": {
+                  "values": {
+                    "UTF8_VALIDATION_UNKNOWN": 0,
+                    "VERIFY": 2,
+                    "NONE": 3
+                  }
+                },
+                "MessageEncoding": {
+                  "values": {
+                    "MESSAGE_ENCODING_UNKNOWN": 0,
+                    "LENGTH_PREFIXED": 1,
+                    "DELIMITED": 2
+                  }
+                },
+                "JsonFormat": {
+                  "values": {
+                    "JSON_FORMAT_UNKNOWN": 0,
+                    "ALLOW": 1,
+                    "LEGACY_BEST_EFFORT": 2
+                  }
+                }
+              }
+            },
+            "FeatureSetDefaults": {
+              "fields": {
+                "defaults": {
+                  "rule": "repeated",
+                  "type": "FeatureSetEditionDefault",
+                  "id": 1
+                },
+                "minimumEdition": {
+                  "type": "Edition",
+                  "id": 4
+                },
+                "maximumEdition": {
+                  "type": "Edition",
+                  "id": 5
+                }
+              },
+              "nested": {
+                "FeatureSetEditionDefault": {
+                  "fields": {
+                    "edition": {
+                      "type": "Edition",
+                      "id": 3
+                    },
+                    "features": {
+                      "type": "FeatureSet",
+                      "id": 2
+                    }
+                  }
+                }
+              }
+            },
             "SourceCodeInfo": {
               "fields": {
                 "location": {
@@ -2888,7 +3182,8 @@
                 "INPUT_ONLY": 4,
                 "IMMUTABLE": 5,
                 "UNORDERED_LIST": 6,
-                "NON_EMPTY_DEFAULT": 7
+                "NON_EMPTY_DEFAULT": 7,
+                "IDENTIFIER": 8
               }
             },
             "resourceReference": {
@@ -3175,6 +3470,10 @@
                   "rule": "repeated",
                   "type": "ClientLibrarySettings",
                   "id": 109
+                },
+                "protoReferenceDocumentationUri": {
+                  "type": "string",
+                  "id": 110
                 }
               }
             },
@@ -3232,6 +3531,31 @@
                 "common": {
                   "type": "CommonLanguageSettings",
                   "id": 1
+                },
+                "renamedServices": {
+                  "keyType": "string",
+                  "type": "string",
+                  "id": 2
+                },
+                "renamedResources": {
+                  "keyType": "string",
+                  "type": "string",
+                  "id": 3
+                },
+                "ignoredResources": {
+                  "rule": "repeated",
+                  "type": "string",
+                  "id": 4
+                },
+                "forcedNamespaceAliases": {
+                  "rule": "repeated",
+                  "type": "string",
+                  "id": 5
+                },
+                "handwrittenSignatures": {
+                  "rule": "repeated",
+                  "type": "string",
+                  "id": 6
                 }
               }
             },
@@ -3260,6 +3584,11 @@
                 "longRunning": {
                   "type": "LongRunning",
                   "id": 2
+                },
+                "autoPopulatedFields": {
+                  "rule": "repeated",
+                  "type": "string",
+                  "id": 3
                 }
               },
               "nested": {
@@ -3291,7 +3620,10 @@
                 "CLOUD": 1,
                 "ADS": 2,
                 "PHOTOS": 3,
-                "STREET_VIEW": 4
+                "STREET_VIEW": 4,
+                "SHOPPING": 5,
+                "GEO": 6,
+                "GENERATIVE_AI": 7
               }
             },
             "ClientLibraryDestination": {

package/build/src/v1/places_client.d.ts

@@ -3,11 +3,10 @@ import type { Callback, CallOptions, Descriptors, ClientOptions } from 'google-g
 import * as protos from '../../protos/protos';
 /**
  *  Service definition for the Places API.
- *  Note: every request actually requires a field mask set outside of
- *  the request proto (all/'*', is not assumed).  That can be set via either a
- *  side channel (SystemParameterContext) over RPC, or a header
- *  (X-Goog-FieldMask) over HTTP. See:
- *  https://cloud.google.com/apis/docs/system-parameters
+ *  Note: every request (except for Autocomplete requests) requires a field mask
+ *  set outside of the request proto (`all/*`, is not assumed). The field mask
+ *  can be set via the HTTP header `X-Goog-FieldMask`. See:
+ *  https://developers.google.com/maps/documentation/places/web-service/choose-fields
  * @class
  * @memberof v1
  */
@@ -403,21 +402,23 @@ export declare class PlacesClient {
      *
      *   Note that 3-digit region codes are not currently supported.
      * @param {string} [request.sessionToken]
-     *   Optional. An arbitrary string which identifies an autocomplete session for
-     *   billing purposes. Must be at most 36 characters in length. Otherwise an
-     *   INVALID_ARGUMENT error is returned.
+     *   Optional. A string which identifies an Autocomplete session for billing
+     *   purposes. Must be a URL and filename safe base64 string with at most 36
+     *   ASCII characters in length. Otherwise an INVALID_ARGUMENT error is
+     *   returned.
      *
      *   The session begins when the user starts typing a query, and concludes when
      *   they select a place and a call to Place Details or Address Validation is
-     *   made. Each session can have multiple queries, followed by one Place
-     *   selection. The credentials used for each request within a session must
-     *   belong to the same Google Cloud Console project. Once a session has
-     *   concluded, the token is no longer valid; your app must generate a fresh
-     *   token for each session. If the `session_token` parameter is omitted, or if
-     *   you reuse a session token, the session is charged as if no session token
-     *   was provided (each request is billed separately).
+     *   made. Each session can have multiple queries, followed by one Place Details
+     *   or Address Validation request. The credentials used for each request within
+     *   a session must belong to the same Google Cloud Console project. Once a
+     *   session has concluded, the token is no longer valid; your app must generate
+     *   a fresh token for each session. If the `session_token` parameter is
+     *   omitted, or if you reuse a session token, the session is charged as if no
+     *   session token was provided (each request is billed separately).
      *
      *   We recommend the following guidelines:
+     *
      *   * Use session tokens for all Place Autocomplete calls.
      *   * Generate a fresh token for each session. Using a version 4 UUID is
      *     recommended.
@@ -465,8 +466,8 @@ export declare class PlacesClient {
      *   address will be mapped to an imprecise location and used as a biasing
      *   signal.
      * @param {string[]} [request.includedPrimaryTypes]
-     *   Optional. Included primary Place type (e.g. "restaurant" or "gas_station")
-     *   from
+     *   Optional. Included primary Place type (for example, "restaurant" or
+     *   "gas_station") from
      *   https://developers.google.com/maps/documentation/places/web-service/place-types.
      *   A Place is only returned if its primary type is included in this list. Up
      *   to 5 values can be specified. If no types are specified, all Place types
@@ -500,21 +501,23 @@ export declare class PlacesClient {
      *   Optional. If true, the response will include both Place and query
      *   predictions. Otherwise the response will only return Place predictions.
      * @param {string} [request.sessionToken]
-     *   Optional. An arbitrary string which identifies an autocomplete session for
-     *   billing purposes. Must be at most 36 characters in length. Otherwise an
-     *   INVALID_ARGUMENT error is returned.
+     *   Optional. A string which identifies an Autocomplete session for billing
+     *   purposes. Must be a URL and filename safe base64 string with at most 36
+     *   ASCII characters in length. Otherwise an INVALID_ARGUMENT error is
+     *   returned.
      *
      *   The session begins when the user starts typing a query, and concludes when
      *   they select a place and a call to Place Details or Address Validation is
-     *   made. Each session can have multiple queries, followed by one Place
-     *   selection. The credentials used for each request within a session must
-     *   belong to the same Google Cloud Console project. Once a session has
-     *   concluded, the token is no longer valid; your app must generate a fresh
-     *   token for each session. If the `session_token` parameter is omitted, or if
-     *   you reuse a session token, the session is charged as if no session token
-     *   was provided (each request is billed separately).
+     *   made. Each session can have multiple queries, followed by one Place Details
+     *   or Address Validation request. The credentials used for each request within
+     *   a session must belong to the same Google Cloud Console project. Once a
+     *   session has concluded, the token is no longer valid; your app must generate
+     *   a fresh token for each session. If the `session_token` parameter is
+     *   omitted, or if you reuse a session token, the session is charged as if no
+     *   session token was provided (each request is billed separately).
      *
      *   We recommend the following guidelines:
+     *
      *   * Use session tokens for all Place Autocomplete calls.
      *   * Generate a fresh token for each session. Using a version 4 UUID is
      *     recommended.

package/build/src/v1/places_client.js

@@ -28,11 +28,10 @@ const gapicConfig = require("./places_client_config.json");
 const version = require('../../../package.json').version;
 /**
  *  Service definition for the Places API.
- *  Note: every request actually requires a field mask set outside of
- *  the request proto (all/'*', is not assumed).  That can be set via either a
- *  side channel (SystemParameterContext) over RPC, or a header
- *  (X-Goog-FieldMask) over HTTP. See:
- *  https://cloud.google.com/apis/docs/system-parameters
+ *  Note: every request (except for Autocomplete requests) requires a field mask
+ *  set outside of the request proto (`all/*`, is not assumed). The field mask
+ *  can be set via the HTTP header `X-Goog-FieldMask`. See:
+ *  https://developers.google.com/maps/documentation/places/web-service/choose-fields
  * @class
  * @memberof v1
  */
@@ -77,7 +76,7 @@ class PlacesClient {
      *     ```
      */
     constructor(opts, gaxInstance) {
-        var _a, _b, _c, _d;
+        var _a, _b, _c, _d, _e;
         this._terminated = false;
         this.descriptors = {
             page: {},
@@ -92,14 +91,17 @@ class PlacesClient {
             (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 = 'places.' + 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;
@@ -129,7 +131,7 @@ class PlacesClient {
         }
         // 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 {
@@ -217,7 +219,7 @@ class PlacesClient {
      * @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');
         }
@@ -229,7 +231,7 @@ class PlacesClient {
      * @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');
         }