diff --git a/packages/google-maps-addressvalidation/protos/google/maps/addressvalidation/v1/address.proto b/packages/google-maps-addressvalidation/protos/google/maps/addressvalidation/v1/address.proto index 9e7e192b99c..c24a3bf9618 100644 --- a/packages/google-maps-addressvalidation/protos/google/maps/addressvalidation/v1/address.proto +++ b/packages/google-maps-addressvalidation/protos/google/maps/addressvalidation/v1/address.proto @@ -1,4 +1,4 @@ -// Copyright 2022 Google LLC +// Copyright 2023 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -29,22 +29,25 @@ option objc_class_prefix = "GMPAVV1"; option php_namespace = "Google\\Maps\\AddressValidation\\V1"; option ruby_package = "Google::Maps::AddressValidation::V1"; -// Details of the address parsed from the input. +// Details of the post-processed address. Post-processing includes +// correcting misspelled parts of the address, replacing incorrect parts, and +// inferring missing parts. message Address { - // The corrected address, formatted as a single-line address following the - // address formatting rules of the region where the address is located. + // The post-processed address, formatted as a single-line address following + // the address formatting rules of the region where the address is located. string formatted_address = 2; - // The validated address represented as a postal address. + // The post-processed address represented as a postal address. google.type.PostalAddress postal_address = 3; - // Unordered list. The individual address components of the formatted and corrected address, - // along with validation information. This provides information on the - // validation status of the individual components. + // Unordered list. The individual address components of the formatted and + // corrected address, along with validation information. This provides + // information on the validation status of the individual components. // // Address components are not ordered in a particular way. Do not make any // assumptions on the ordering of the address components in the list. - repeated AddressComponent address_components = 4 [(google.api.field_behavior) = UNORDERED_LIST]; + repeated AddressComponent address_components = 4 + [(google.api.field_behavior) = UNORDERED_LIST]; // The types of components that were expected to be present in a correctly // formatted mailing address but were not found in the input AND could diff --git a/packages/google-maps-addressvalidation/protos/google/maps/addressvalidation/v1/address_validation_service.proto b/packages/google-maps-addressvalidation/protos/google/maps/addressvalidation/v1/address_validation_service.proto index 95c8c760f2c..ff19440eede 100644 --- a/packages/google-maps-addressvalidation/protos/google/maps/addressvalidation/v1/address_validation_service.proto +++ b/packages/google-maps-addressvalidation/protos/google/maps/addressvalidation/v1/address_validation_service.proto @@ -1,4 +1,4 @@ -// Copyright 2022 Google LLC +// Copyright 2023 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -175,7 +175,8 @@ message ValidationResult { // Information about the location and place that the address geocoded to. Geocode geocode = 3; - // Other information relevant to deliverability. + // Other information relevant to deliverability. `metadata` is not guaranteed + // to be fully populated for every address sent to the Address Validation API. AddressMetadata metadata = 4; // Extra deliverability flags provided by USPS. Only provided in region `US` diff --git a/packages/google-maps-addressvalidation/protos/google/maps/addressvalidation/v1/geocode.proto b/packages/google-maps-addressvalidation/protos/google/maps/addressvalidation/v1/geocode.proto index ffb71b8aa6b..2caa88a4cd5 100644 --- a/packages/google-maps-addressvalidation/protos/google/maps/addressvalidation/v1/geocode.proto +++ b/packages/google-maps-addressvalidation/protos/google/maps/addressvalidation/v1/geocode.proto @@ -1,4 +1,4 @@ -// Copyright 2022 Google LLC +// Copyright 2023 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. diff --git a/packages/google-maps-addressvalidation/protos/google/maps/addressvalidation/v1/metadata.proto b/packages/google-maps-addressvalidation/protos/google/maps/addressvalidation/v1/metadata.proto index 914f0c34228..b65b4984127 100644 --- a/packages/google-maps-addressvalidation/protos/google/maps/addressvalidation/v1/metadata.proto +++ b/packages/google-maps-addressvalidation/protos/google/maps/addressvalidation/v1/metadata.proto @@ -1,4 +1,4 @@ -// Copyright 2022 Google LLC +// Copyright 2023 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -26,7 +26,8 @@ option objc_class_prefix = "GMPAVV1"; option php_namespace = "Google\\Maps\\AddressValidation\\V1"; option ruby_package = "Google::Maps::AddressValidation::V1"; -// The metadata for the address. +// The metadata for the address. `metadata` is not guaranteed to be fully +// populated for every address sent to the Address Validation API. message AddressMetadata { // Indicates that this is the address of a business. // If unset, indicates that the value is unknown. diff --git a/packages/google-maps-addressvalidation/protos/google/maps/addressvalidation/v1/usps_data.proto b/packages/google-maps-addressvalidation/protos/google/maps/addressvalidation/v1/usps_data.proto index 10334d51fcf..c1680a12779 100644 --- a/packages/google-maps-addressvalidation/protos/google/maps/addressvalidation/v1/usps_data.proto +++ b/packages/google-maps-addressvalidation/protos/google/maps/addressvalidation/v1/usps_data.proto @@ -1,4 +1,4 @@ -// Copyright 2022 Google LLC +// Copyright 2023 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -56,7 +56,10 @@ message UspsAddress { string zip_code_extension = 9; } -// The USPS data for the address. +// The USPS data for the address. `uspsData` is not guaranteed to be fully +// populated for every US or PR address sent to the Address Validation API. It's +// recommended to integrate the backup address fields in the response if you +// utilize uspsData as the primary part of the response. message UspsData { // USPS standardized address. UspsAddress standardized_address = 1; diff --git a/packages/google-maps-addressvalidation/samples/generated/v1/snippet_metadata.google.maps.addressvalidation.v1.json b/packages/google-maps-addressvalidation/samples/generated/v1/snippet_metadata.google.maps.addressvalidation.v1.json index e632a307e3d..e9697ce4e35 100644 --- a/packages/google-maps-addressvalidation/samples/generated/v1/snippet_metadata.google.maps.addressvalidation.v1.json +++ b/packages/google-maps-addressvalidation/samples/generated/v1/snippet_metadata.google.maps.addressvalidation.v1.json @@ -1,7 +1,7 @@ { "clientLibrary": { "name": "nodejs-addressvalidation", - "version": "1.0.1", + "version": "1.0.2", "language": "TYPESCRIPT", "apis": [ { diff --git a/packages/google-maps-addressvalidation/webpack.config.js b/packages/google-maps-addressvalidation/webpack.config.js index b1fb80b0e30..7eccfa8e0fd 100644 --- a/packages/google-maps-addressvalidation/webpack.config.js +++ b/packages/google-maps-addressvalidation/webpack.config.js @@ -1,4 +1,4 @@ -// Copyright 2023 Google LLC +// Copyright 2021 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License.