Skip to content

Commit bbaa0c0

Browse files
docs: Document that PREMISE_PROXIMITY is a valid value for an address granularity (#3506)
- [ ] Regenerate this pull request now. PiperOrigin-RevId: 493546802 Source-Link: https://togithub.com/googleapis/googleapis/commit/2592f50ec97486ad3bee438350dbac2e8f478f7f Source-Link: https://togithub.com/googleapis/googleapis-gen/commit/a31ebbb51b9c946eacbd2666366e4a48521a5b8e Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLW1hcHMtYWRkcmVzc3ZhbGlkYXRpb24vLk93bEJvdC55YW1sIiwiaCI6ImEzMWViYmI1MWI5Yzk0NmVhY2JkMjY2NjM2NmU0YTQ4NTIxYTViOGUifQ== BEGIN_NESTED_COMMIT chore: Enable requesting numeric enums in "transport=rest" responses for services supporting this (Java, Go, Python, PHP, TypeScript, C#, and Ruby), even if they do not yet turn on REST transport chore: disallow "transport=rest" for services where numeric enums are not confirmed to be supported (except in PHP and Java) PiperOrigin-RevId: 493113566 Source-Link: https://togithub.com/googleapis/googleapis/commit/758f0d1217d9c7fe398aa5efb1057ce4b6409e55 Source-Link: https://togithub.com/googleapis/googleapis-gen/commit/78bd8f05e1276363eb14eae70e91fe4bc20703ab Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLW1hcHMtYWRkcmVzc3ZhbGlkYXRpb24vLk93bEJvdC55YW1sIiwiaCI6Ijc4YmQ4ZjA1ZTEyNzYzNjNlYjE0ZWFlNzBlOTFmZTRiYzIwNzAzYWIifQ== END_NESTED_COMMIT BEGIN_NESTED_COMMIT feat!: remove deprecated fields `highrise` and `multi_family` docs: minor documentation updates PiperOrigin-RevId: 487257549 Source-Link: https://togithub.com/googleapis/googleapis/commit/9df6fcaf991f1b05de7fb4e1a1211755d346a40f Source-Link: https://togithub.com/googleapis/googleapis-gen/commit/e2b3cfca29024cf4cb9247564a89818b86bc8542 Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLW1hcHMtYWRkcmVzc3ZhbGlkYXRpb24vLk93bEJvdC55YW1sIiwiaCI6ImUyYjNjZmNhMjkwMjRjZjRjYjkyNDc1NjRhODk4MThiODZiYzg1NDIifQ== END_NESTED_COMMIT
1 parent e117ac7 commit bbaa0c0

12 files changed

Lines changed: 32 additions & 160 deletions

packages/google-maps-addressvalidation/protos/google/maps/addressvalidation/v1/address.proto

Lines changed: 7 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -38,22 +38,21 @@ message Address {
3838
// The validated address represented as a postal address.
3939
google.type.PostalAddress postal_address = 3;
4040

41-
// The individual address components of the formatted and corrected address,
41+
// Unordered list. The individual address components of the formatted and corrected address,
4242
// along with validation information. This provides information on the
4343
// validation status of the individual components.
4444
//
45-
// Address components are not ordered in a particular way. DO NOT make any
45+
// Address components are not ordered in a particular way. Do not make any
4646
// assumptions on the ordering of the address components in the list.
47-
repeated AddressComponent address_components = 4
48-
[(google.api.field_behavior) = UNORDERED_LIST];
47+
repeated AddressComponent address_components = 4 [(google.api.field_behavior) = UNORDERED_LIST];
4948

5049
// The types of components that were expected to be present in a correctly
5150
// formatted mailing address but were not found in the input AND could
5251
// not be inferred. Components of this type are not present in
5352
// `formatted_address`, `postal_address`, or `address_components`. An
5453
// example might be `['street_number', 'route']` for an input like
55-
// "Boulder, Colorado, 80301, USA." The list of possible types can be found
56-
// [here](https://developers.google.com/maps/documentation/geocoding/overview#Types).
54+
// "Boulder, Colorado, 80301, USA". The list of possible types can be found
55+
// [here](https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types).
5756
repeated string missing_component_types = 5;
5857

5958
// The types of the components that are present in the `address_components`
@@ -65,8 +64,8 @@ message Address {
6564
// [CONFIRMED][google.maps.addressvalidation.v1.AddressComponent.ConfirmationLevel.CONFIRMED]
6665
// or the
6766
// [inferred][google.maps.addressvalidation.v1.AddressComponent.inferred]
68-
// flag is not set to `true`.The list of possible types can be found
69-
// [here](https://developers.google.com/maps/documentation/geocoding/overview#Types).
67+
// flag is not set to `true`. The list of possible types can be found
68+
// [here](https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types).
7069
repeated string unconfirmed_component_types = 6;
7170

7271
// Any tokens in the input that could not be resolved. This might be an

packages/google-maps-addressvalidation/protos/google/maps/addressvalidation/v1/address_validation_service.proto

Lines changed: 11 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,8 @@ service AddressValidation {
4040
option (google.api.default_host) = "addressvalidation.googleapis.com";
4141

4242
// Validates an address.
43-
rpc ValidateAddress(ValidateAddressRequest) returns (ValidateAddressResponse) {
43+
rpc ValidateAddress(ValidateAddressRequest)
44+
returns (ValidateAddressResponse) {
4445
option (google.api.http) = {
4546
post: "/v1:validateAddress"
4647
body: "*"
@@ -52,7 +53,8 @@ service AddressValidation {
5253
// same address, and should be called once the transaction is concluded. This
5354
// should only be sent once for the sequence of `ValidateAddress` requests
5455
// needed to validate an address fully.
55-
rpc ProvideValidationFeedback(ProvideValidationFeedbackRequest) returns (ProvideValidationFeedbackResponse) {
56+
rpc ProvideValidationFeedback(ProvideValidationFeedbackRequest)
57+
returns (ProvideValidationFeedbackResponse) {
5658
option (google.api.http) = {
5759
post: "/v1:provideValidationFeedback"
5860
body: "*"
@@ -65,7 +67,7 @@ message ValidateAddressRequest {
6567
// Required. The address being validated. Unformatted addresses should be
6668
// submitted via [`address_lines`][google.type.PostalAddress.address_lines].
6769
//
68-
// The total length of the fields in this input must not exceed 300
70+
// The total length of the fields in this input must not exceed 280
6971
// characters.
7072
//
7173
// Supported regions can be found in the
@@ -80,7 +82,8 @@ message ValidateAddressRequest {
8082
// [recipients][google.type.PostalAddress.recipients] and
8183
// [organization][google.type.PostalAddress.organization]. Any values in those
8284
// fields will be discarded and not returned. Please do not set them.
83-
google.type.PostalAddress address = 1 [(google.api.field_behavior) = REQUIRED];
85+
google.type.PostalAddress address = 1
86+
[(google.api.field_behavior) = REQUIRED];
8487

8588
// This field must be empty for the first address validation request. If
8689
// more requests are necessary to fully validate a single address (for
@@ -149,7 +152,8 @@ message ProvideValidationFeedbackRequest {
149152
// `INVALID_ARGUMENT` error will be returned.
150153
ValidationConclusion conclusion = 1 [(google.api.field_behavior) = REQUIRED];
151154

152-
// Required. The ID of the response that this feedback is for. This should be the
155+
// Required. The ID of the response that this feedback is for. This should be
156+
// the
153157
// [response_id][google.maps.addressvalidation.v1.ValidateAddressRequest.response_id]
154158
// from the first response in a series of address validation attempts.
155159
string response_id = 2 [(google.api.field_behavior) = REQUIRED];
@@ -158,9 +162,7 @@ message ProvideValidationFeedbackRequest {
158162
// The response for validation feedback.
159163
//
160164
// The response is empty if the feedback is sent successfully.
161-
message ProvideValidationFeedbackResponse {
162-
163-
}
165+
message ProvideValidationFeedbackResponse {}
164166

165167
// The result of validating an address.
166168
message ValidationResult {
@@ -202,7 +204,7 @@ message Verdict {
202204
PREMISE = 2;
203205

204206
// A geocode that should be very close to the building-level location of
205-
// the address. Only used for geocodes and not for addresses.
207+
// the address.
206208
PREMISE_PROXIMITY = 3;
207209

208210
// The address or geocode indicates a block. Only used in regions which

packages/google-maps-addressvalidation/protos/google/maps/addressvalidation/v1/geocode.proto

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -62,7 +62,7 @@ message Geocode {
6262

6363
// The type(s) of place that the input geocoded to. For example,
6464
// `['locality', 'political']`. The full list of types can be found
65-
// [here](https://developers.google.com/maps/documentation/geocoding/overview#Types).
65+
// [here](https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types).
6666
repeated string place_types = 7;
6767
}
6868

packages/google-maps-addressvalidation/protos/google/maps/addressvalidation/v1/metadata.proto

Lines changed: 0 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -28,14 +28,6 @@ option ruby_package = "Google::Maps::AddressValidation::V1";
2828

2929
// The metadata for the address.
3030
message AddressMetadata {
31-
// Indicates that this address is a high-rise building.
32-
// If unset, indicates that the value is unknown.
33-
//
34-
// DEPRECATED: Please use
35-
// [`address_record_type`](google.maps.addressvalidation.v1.ValidationResult.usps_data.address_record_type)
36-
// instead. This field will be removed with the GA release.
37-
optional bool highrise = 1 [deprecated = true];
38-
3931
// Indicates that this is the address of a business.
4032
// If unset, indicates that the value is unknown.
4133
optional bool business = 2;
@@ -44,12 +36,6 @@ message AddressMetadata {
4436
// If unset, indicates that the value is unknown.
4537
optional bool po_box = 3;
4638

47-
// Indicates that the address is of a multi-family building.
48-
// If unset, indicates that the value is unknown.
49-
//
50-
// DEPRECATED: this field will be removed with the GA release.
51-
optional bool multi_family = 4 [deprecated = true];
52-
5339
// Indicates that this is the address of a residence.
5440
// If unset, indicates that the value is unknown.
5541
optional bool residential = 6;

packages/google-maps-addressvalidation/protos/google/maps/addressvalidation/v1/usps_data.proto

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -125,8 +125,8 @@ message UspsData {
125125
string dpv_no_stat = 8;
126126

127127
// The carrier route code.
128-
// A four character code--a one letter prefix and a three digit route
129-
// designator.
128+
// A four character code consisting of a one letter prefix and a three digit
129+
// route designator.
130130
//
131131
// Prefixes:
132132
//
@@ -210,7 +210,7 @@ message UspsData {
210210
// processing is suspended because of the detection of artificially created
211211
// addresses.
212212
//
213-
// The USPS data fields may not be populated when this error is present.
213+
// The USPS data fields might not be populated when this error is present.
214214
string error_message = 27;
215215

216216
// Indicator that the request has been CASS processed.

packages/google-maps-addressvalidation/protos/protos.d.ts

Lines changed: 0 additions & 18 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

packages/google-maps-addressvalidation/protos/protos.js

Lines changed: 0 additions & 76 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

0 commit comments

Comments
 (0)