Package google.maps.addressvalidation.v1

색인

AddressValidation

주소 검증 서비스입니다.

ProvideValidationFeedback

rpc ProvideValidationFeedback(ProvideValidationFeedbackRequest) returns (ProvideValidationFeedbackResponse)

일련의 유효성 검사 시도 결과에 관한 의견입니다. 이 호출은 동일한 주소에 대한 일련의 유효성 검사 호출 후 마지막 호출이어야 하며 거래가 완료된 후에 호출해야 합니다. 주소를 완전히 확인하는 데 필요한 일련의 ValidateAddress 요청에서만 한 번만 전송해야 합니다.
ValidateAddress

rpc ValidateAddress(ValidateAddressRequest) returns (ValidateAddressResponse)

주소 유효성을 검사합니다.

주소

후처리된 주소의 세부정보입니다. 후처리에는 주소의 맞춤법이 틀린 부분 수정, 잘못된 부분 교체, 누락된 부분 추론이 포함됩니다.

필드
formatted_address

string

주소가 있는 지역의 주소 형식 지정 규칙에 따라 단선형 주소로 형식이 지정된 후처리된 주소입니다.
postal_address

PostalAddress

우편 주소로 표시되는 후처리된 주소입니다.
address_components[]

AddressComponent

순서가 지정되지 않은 목록입니다. 유효성 검사 정보와 함께 형식이 지정되고 수정된 주소의 개별 주소 구성요소입니다. 여기에서는 개별 구성요소의 유효성 검사 상태에 관한 정보를 제공합니다.

주소 구성요소는 특정한 방식으로 정렬되지 않습니다. 목록에서 주소 구성요소의 순서를 가정하지 마세요.
missing_component_types[]

string

올바른 형식의 우편 주소에 있어야 하지만 입력에서 찾을 수 없으며 추론할 수 없는 구성요소 유형입니다. 이 유형의 구성요소는 formatted_address, postal_address 또는 address_components에 없습니다. 'Boulder, Colorado, 80301, USA'와 같은 입력의 경우 ['street_number', 'route']이라고 할 수 있습니다. 가능한 유형 목록은 여기에서 확인할 수 있습니다.
unconfirmed_component_types[]

string

address_components에 있지만 올바른지 확인할 수 없는 구성요소의 유형입니다. 이 필드는 편의를 위해 제공됩니다. 이 필드는 confirmation_level가 CONFIRMED가 아니거나 inferred 플래그가 true로 설정되지 않은 모든 구성요소의 유형을 찾기 위해 address_components를 반복하는 것과 같습니다. 가능한 유형 목록은 여기에서 확인할 수 있습니다.
unresolved_tokens[]

string

입력에서 확인할 수 없는 모든 토큰입니다. 이는 주소의 유효한 부분으로 인식되지 않은 입력일 수 있습니다 (예: '123235253253 Main St, San Francisco, CA, 94105'와 같은 입력의 경우, 확인되지 않은 토큰은 유효한 번지로 보이지 않으므로 ["123235253253"]과 같이 표시될 수 있습니다.

AddressComponent

거리, 도시 또는 주와 같은 주소 구성요소를 나타냅니다.

필드
component_name

ComponentName

이 구성요소의 이름입니다.
component_type

string

주소 구성요소의 유형입니다. 가능한 유형 목록은 표 2: 장소 서비스에서 반환하는 추가 유형을 참고하세요.
confirmation_level

ConfirmationLevel

구성요소가 올바른지에 대한 확실성 수준을 나타냅니다.
inferred

bool

구성요소가 입력의 일부가 아니었지만 주소 위치로 추론되었으며 전체 주소에 제공되어야 함을 나타냅니다.
spell_corrected

bool

구성요소 이름의 맞춤법 오류에 대한 수정을 나타냅니다. API가 'centre'를 'center'로 변경하는 경우와 같이 철자 변형의 변경사항에 관해 항상 플래그를 표시하지는 않습니다. 또한 'Amphitheater Pkwy'를 'Amphitheatre Pkwy'로 변경할 때 자주 발생하는 철자 오류를 항상 신고하지는 않습니다.
replaced

bool

구성요소의 이름이 완전히 다른 이름으로 대체되었음을 나타냅니다(예: 잘못된 우편번호가 주소에 맞는 우편번호로 바뀜). 외관상의 변경사항은 아니며 입력 구성요소가 다른 구성요소로 변경되었습니다.
unexpected

bool

지정된 지역의 우편 주소에 없을 것으로 예상되는 주소 구성요소를 나타냅니다. 입력된 내용이므로 그대로 유지했습니다.

ConfirmationLevel

확인 수준에 사용할 수 있는 다양한 값입니다.

열거형
CONFIRMATION_LEVEL_UNSPECIFIED 기본값 이 값은 사용되지 않습니다.
CONFIRMED 이 구성요소가 존재하며 나머지 주소 맥락에서 의미가 있는지 확인할 수 있었습니다.
UNCONFIRMED_BUT_PLAUSIBLE 이 구성요소는 확인할 수 없지만 존재할 가능성이 있습니다. 특정 번지수를 알 수 없는 거리에서 알려진 유효한 번호 범위 내에 있는 번지를 예로 들 수 있습니다.
UNCONFIRMED_AND_SUSPICIOUS 확인되지 않은 구성요소이며 잘못되었을 가능성이 있습니다. 예를 들어 주소의 나머지 부분에 맞지 않는 인근 지역이 있습니다.

AddressMetadata

주소의 메타데이터입니다. Address Validation API에 전송된 모든 주소에 metadata가 완전히 채워지지 않을 수도 있습니다.

필드
business

bool

비즈니스의 주소임을 나타냅니다. 설정되지 않은 경우 값을 알 수 없음을 나타냅니다.
po_box

bool

사서함의 주소를 나타냅니다. 설정되지 않은 경우 값을 알 수 없음을 나타냅니다.
residential

bool

이 주소가 거주지 주소임을 나타냅니다. 설정되지 않은 경우 값을 알 수 없음을 나타냅니다.

ComponentName

구성요소 이름의 래퍼입니다.

필드
text

string

이름 텍스트입니다. 예를 들어 도로명은 '5번가', 도로명은 '1253'을 사용합니다.
language_code

string

BCP-47 언어 코드입니다. 구성요소 이름이 번지와 같은 언어와 연결되지 않은 경우에는 표시되지 않습니다.

지오코드

입력이 지오코딩된 장소에 대한 정보를 포함합니다.

필드
location

LatLng

입력의 지오코딩된 위치입니다.

주소, 위도/경도 좌표 또는 플러스 코드보다 장소 ID를 사용하는 것이 좋습니다. 경로를 지정하거나 운전 경로를 계산할 때 좌표를 사용하면 항상 해당 좌표에 가장 가까운 도로에 지점이 맞춰집니다. 목적지에 빠르고 안전하게 도착하는 도로가 아니어야 하며 부동산의 액세스 포인트 근처에 있어서도 안 됩니다. 또한 위치가 역 지오코딩되는 경우 반환된 주소가 원래 주소와 일치한다는 보장은 없습니다.
plus_code

PlusCode

location에 해당하는 플러스 코드입니다.
bounds

Viewport

지오코딩된 장소의 경계.
feature_size_meters

float

지오코딩된 장소의 크기(미터)입니다. 이는 지오코딩된 위치의 대략적인 정도를 측정하는 또 다른 값이지만 의미론적 의미보다는 실제 크기입니다.
place_id

string

이 입력이 지오코딩되는 장소의 PlaceID입니다.

장소 ID에 대한 자세한 내용은 여기를 참고하세요.
place_types[]

string

입력이 지오코딩된 장소의 유형입니다. ['locality', 'political']을 예로 들 수 있습니다. 전체 유형 목록은 여기에서 확인할 수 있습니다.

LanguageOptions

미리보기: 이 기능은 미리보기 (GA 이전) 버전입니다. GA 이전 제품과 기능은 지원이 제한될 수 있으며, GA 이전 제품과 기능이 변경된 경우 다른 GA 이전 버전과 호환되지 않을 수 있습니다. GA 이전 버전 제품 또는 서비스에는 Google Maps Platform 서비스별 약관이 적용됩니다. 자세한 내용은 출시 단계 설명을 참조하세요.

Address Validation API를 사용하여 응답에 추가 정보를 포함할 수 있습니다.

필드
return_english_latin_address

bool

미리보기: 영어로 google.maps.addressvalidation.v1.Address를 반환합니다. 자세한 내용은 google.maps.addressvalidation.v1.ValidationResult.english_latin_address를 참고하세요.

PlusCode

플러스 코드 (http://plus.codes)는 14mx14m (1/8000의 1/8000) 또는 작은 직사각형을 정의하는 글로벌 코드와 접두사를 참조 위치로 대체하는 복합 코드의 두 가지 형식으로 위치 참조입니다.

필드
global_code

string

'9FWM33GV+HQ'와 같이 1/8000 x 1/8000도 면적 (약 14x14m)을 나타내는 장소의 글로벌 (전체) 코드입니다.
compound_code

string

장소의 복합 코드(예: '33GV+HQ, Ramberg, Norway')로, 글로벌 코드의 접미사를 포함하고 접두사를 형식이 지정된 참조 항목의 이름으로 바꿉니다.

ProvideValidationFeedbackRequest

유효성 검사 의견 전송 요청입니다.

필드
conclusion

ValidationConclusion

필수 항목입니다. 일련의 유효성 검사 시도 결과입니다.

이 필드가 VALIDATION_CONCLUSION_UNSPECIFIED로 설정되면 INVALID_ARGUMENT 오류가 반환됩니다.
response_id

string

필수 항목입니다. 이 의견이 적용되는 응답의 ID입니다. 일련의 주소 확인 시도 중 첫 번째 응답의 [response_id][google.maps.addressvalidation.v1.ValidateAddressRequest.response_id] 여야 합니다.

ValidationConclusion

주소를 확인하는 데 필요한 일련의 주소 유효성 검사 요청 시퀀스의 가능한 최종 결과입니다.

열거형
VALIDATION_CONCLUSION_UNSPECIFIED 이 값은 사용되지 않습니다. ProvideValidationFeedbackRequest.conclusion 필드가 VALIDATION_CONCLUSION_UNSPECIFIED로 설정되면 INVALID_ARGUMENT 오류가 반환됩니다.
VALIDATED_VERSION_USED Address Validation API에서 반환된 주소의 버전이 거래에 사용되었습니다.
USER_VERSION_USED 사용자가 제공한 주소 버전이 거래에 사용되었습니다.
UNVALIDATED_VERSION_USED 마지막 유효성 검사 시도 후 입력되었지만 재확인되지 않은 주소 버전이 거래에 사용되었습니다.
UNUSED 거래가 포기되었으며 주소가 사용되지 않았습니다.

ProvideValidationFeedbackResponse

이 유형에는 필드가 없습니다.

유효성 검사 의견에 대한 응답입니다.

의견이 성공적으로 전송되면 응답이 비어 있습니다.

UspsAddress

미국 주소의 USPS 표현입니다.

필드
first_address_line

string

첫 번째 주소 입력란입니다.
firm

string

회사 이름입니다.
second_address_line

string

두 번째 주소 입력란입니다.
urbanization

string

푸에르토리코 도시화 이름입니다.
city_state_zip_address_line

string

시/도 + 우편번호
city

string

도시 이름입니다.
state

string

2자리 상태 코드입니다.
zip_code

string

우편번호입니다(예: 10009).
zip_code_extension

string

4자리 우편번호 확장자입니다(예: 5023).

UspsData

주소에 대한 USPS 데이터입니다. Address Validation API로 전송된 모든 미국 또는 PR 주소에 uspsData가 완전히 채워지지 않을 수도 있습니다. 응답의 주요 부분으로 uspsData를 활용하는 경우 백업 주소 필드를 응답에 통합하는 것이 좋습니다.

필드
standardized_address

UspsAddress

USPS 표준 주소입니다.
delivery_point_code

string

2자리 배송 지점 코드
delivery_point_check_digit

string

배송 지점 검사 숫자입니다. 이 번호는 기계적으로 스캔한 메일의 shipping_point_barcode 끝에 추가됩니다. Delivery_point_barcode, shipping_point_check_numeric, 우편번호, ZIP+4의 모든 자릿수를 더하면 10으로 나눌 수 있는 숫자가 생성됩니다.
dpv_confirmation

string

DPV 확인에 가능한 값입니다. 단일 문자를 반환하거나 값을 반환하지 않습니다.

  • N: 기본 및 보조 번호 정보가 DPV 확인을 통과하지 못했습니다.
  • D: 기본 번호에 대해서만 DPV가 확인되었으며 보조 번호 정보가 누락되었습니다.
  • S: 기본 번호에 대해서만 DPV가 확인되었으며 보조 번호 정보는 있었지만 확인되지 않았습니다.
  • Y: 기본 번호와 보조 번호의 DPV가 확인되었습니다.
  • 비어 있음: 응답에 dpv_confirmation 값이 없으면 주소가 DPV 확인을 위해 제출되지 않은 것입니다.
dpv_footnote

string

배송 지점 확인의 각주 여러 각주가 동일한 문자열 안에 묶여 있을 수 있습니다.

  • AA: ZIP+4 파일과 일치하는 입력 주소
  • A1: 입력 주소가 ZIP+4 파일과 일치하지 않음
  • BB: DPV와 일치 (모든 구성요소)
  • CC: 보조 번호가 일치하지 않고 필요하지도 않습니다.
  • C1: 보조 전화번호와 일치하지 않지만 필수임
  • N1: 고층 주소에 보조 전화번호가 누락됨
  • M1: 기본 전화번호 누락
  • M3: 기본 전화번호가 잘못됨
  • P1: 입력 주소 PO, RR 또는 HC 상자 번호 누락
  • P3: 입력 주소 PO, RR 또는 HC 상자 번호가 잘못됨
  • F1: 입력 주소가 군대 주소와 일치합니다.
  • G1: 입력 주소가 일반 배송지 주소와 일치합니다.
  • U1: 고유한 우편번호와 일치하는 입력 주소
  • PB: PBSA 레코드와 일치하는 입력 주소
  • RR: PMB 정보가 있는 DPV 확인 주소
  • R1: PMB 정보가 없는 DPV 확인된 주소
  • R7: 운송업체 경로 R777 또는 R779 레코드
  • IA: 통지된 주소가 식별됨
  • TA: 후행 알파를 삭제하여 일치하는 기본 숫자
dpv_cmra

string

주소가 고객을 위해 메일을 받는 민간 기업인 CMRA (상업 우편 수신 대행사)인지 여부를 나타냅니다. 단일 문자를 반환합니다.

  • Y: 주소가 CMRA입니다.
  • N: 주소가 CMRA가 아닙니다.
dpv_vacant

string

비어 있는 장소인가요? 단일 문자를 반환합니다.

  • Y: 비어 있는 주소입니다.
  • N: 비어 있는 주소가 아닙니다.
dpv_no_stat

string

일반 주소인가요, 아니면 활성 주소인가요? 통계 주소란 지속적으로 점유되지 않거나 USPS에서 서비스를 제공하지 않는 주소를 의미합니다. 단일 문자를 반환합니다.

  • Y: 주소가 활성화되지 않았습니다.
  • N: 주소가 활성 상태입니다.
dpv_no_stat_reason_code

int32

NoStat 유형을 나타냅니다. 이유 코드를 int로 반환합니다.

  • 1: IDA (Internal Drop Address) – USPS에서 직접 메일을 받지는 않지만 서비스를 제공하는 배송지 주소로 전달된 주소입니다.
  • 2: CDS - 아직 배송할 수 없는 주소입니다. 예를 들어 부동산과 기본 번호가 결정되었지만 숙박 인원을 위한 구조가 아직 없는 새 하위 구역이 있을 수 있습니다.
  • 3: 충돌 - 실제로 DPV를 확인하지 않는 주소입니다.
  • 4: CMZ (대학, 군사 및 기타 유형) - ZIP + 4개의 기록 USPS가 데이터에 통합됨
  • 5: 일반 - 배송을 받지 않는 주소이며 배송 가능한 주소로 집계되지 않음을 나타냅니다.
  • 6: 보조 필수 - 주소에 보조 정보가 필요합니다.
dpv_drop

string

플래그는 사이트에 있는 단일 수용소로 메일이 전달되었음을 나타냅니다. 단일 문자를 반환합니다.

  • Y: 메일이 사이트의 단일 수용 가능 저장소로 전송됩니다.
  • N: 메일이 사이트의 단일 수용 가능 주소로 전송되지 않습니다.
dpv_throwback

string

메일이 상세 주소로 전송되지 않았음을 나타냅니다. 단일 문자를 반환합니다.

  • Y: 메일이 상세 주소로 전송되지 않습니다.
  • N: 메일이 상세 주소로 전달됩니다.
dpv_non_delivery_days

string

플래그는 메일이 일주일 내내 전송되지 않음을 나타냅니다. 단일 문자를 반환합니다.

  • Y: 메일 전송이 요일마다 수행되지는 않습니다.
  • N: 메일 전송이 요일마다 수행되지 않는다는 표시는 없습니다.
dpv_non_delivery_days_values

int32

미게재 기간을 식별하는 정수입니다. 비트 플래그 0x40을 사용하여 심문할 수 있습니다. - 일요일은 0x20, 월요일은 미배송일 0x10, 화요일은 0x08, 수요일은 미게재일입니다. 0x04 – 목요일은 미게재 날짜, 0x02는 목요일, 0x02는 토요일이며, 금요일은 미배송일입니다.
dpv_no_secure_location

string

깃발은 현관에 접근할 수 있음을 나타내지만 보안상의 이유로 택배를 맡길 수는 없습니다. 단일 문자를 반환합니다.

  • Y: 보안상의 이유로 택배가 배송되지 않습니다.
  • N: 보안 문제로 인해 택배가 배송되지 않을 것이라는 징후는 없습니다.
dpv_pbsa

string

주소가 PBSA 레코드와 일치했음을 나타냅니다. 단일 문자를 반환합니다.

  • Y: 주소가 PBSA 레코드와 일치합니다.
  • N: 주소가 PBSA 레코드와 일치하지 않습니다.
dpv_door_not_accessible

string

플래그는 USPS에서 우편물을 배달할 문을 두드려 놓을 수 없는 주소를 나타냅니다. 단일 문자를 반환합니다.

  • Y: 문에 접근할 수 없습니다.
  • N: 문에 접근할 수 없다는 표시가 없습니다.
dpv_enhanced_delivery_code

string

주소에 2개 이상의 DPV 반환 코드가 유효함을 나타냅니다. 단일 문자를 반환합니다.

  • Y: 기본 번호와 보조 번호의 DPV가 확인되었습니다.
  • N: 기본 및 보조 번호 정보가 DPV 확인을 통과하지 못했습니다.
  • S: DPV 일치를 위해 기본 번호에 대해서만 주소가 DPV로 확인되었고, 보조 번호 정보는 확인되지 않음으로 인해 존재했거나, DPV 일치 및 보조 정보가 필요하도록 기본 번호의 후행 알파 하나가 삭제되었습니다.
  • D: 기본 번호에 대해서만 DPV가 확인되었으며 보조 번호 정보가 누락되었습니다.
  • R: 확인되었지만 팬텀 경로 R777 및 R779 및 USPS 배송에 할당된 주소가 제공되지 않았습니다.
carrier_route

string

운송업체 경로 코드입니다. 1문자 접두사와 3자리 경로 지정자로 구성된 4자리 코드입니다.

접두어:

  • C: 운송업체 노선 (또는 도시 도로)
  • R: 지방도
  • H: 고속도로 약정 경로
  • B: 사서함 섹션
  • G: 일반 게재 단위
carrier_route_indicator

string

운송업체 배송비 정렬 표시기
ews_no_match

bool

배송지 주소는 일치할 수 있지만 EWS 파일에 따르면 정확하게 일치하는 주소를 곧 사용할 수 있습니다.
post_office_city

string

기본 우체국 도시입니다.
post_office_state

string

기본 우체국입니다.
abbreviated_city

string

도시 약칭입니다.
fips_county_code

string

FIPS 카운티 코드입니다.
county

string

구/군 이름
elot_number

string

향상된 이동 경로 (eLOT) 번호입니다.
elot_flag

string

eLOT 오름차순/내림차순 플래그 (A/D)
po_box_only_postal_code

bool

사서함 전용 우편번호.
pmb_designator

string

PMB (우편함) 단위 지정자.
pmb_number

string

PMB (우편함) 번호
address_record_type

string

입력 주소와 일치하는 주소 레코드의 유형입니다.

  • F: FIRM입니다. 이는 주소에 대해 사용할 수 있는 가장 정밀한 일치 수준인 Firm Record와 일치합니다.
  • G: 일반 배송. 일반 전송 기록과 일치합니다.
  • H: 건물 / 아파트. 이는 건물 또는 아파트 기록과 일치합니다.
  • P: 우편함. 사서함과 일치합니다.
  • R: RURAL ROUTE 또는 HIGHWAY CONTRACT: 이것은 지방도로 또는 고속도로 계약 기록과 일치하는 것이며 두 기록 모두 연관된 Box Number 범위를 가질 수 있습니다.
  • S: STREET 레코드: 유효한 기본 숫자 범위를 포함하는 스트리트 레코드와 일치합니다.
default_address

bool

기본 주소가 있었지만 더 구체적인 주소가 존재함을 나타내는 표시기입니다.
error_message

string

USPS 데이터 검색에 대한 오류 메시지입니다. 인위적으로 생성된 주소가 감지되어 USPS 처리가 정지된 경우 채워집니다.

이 오류가 있으면 USPS 데이터 필드가 채워지지 않을 수 있습니다.
cass_processed

bool

요청이 CASS 처리되었음을 나타내는 표시기입니다.

ValidateAddressRequest

주소 확인 요청입니다.

필드
address

PostalAddress

필수 항목입니다. 확인할 주소입니다. 형식이 지정되지 않은 주소는 address_lines를 통해 제출해야 합니다.

이 입력에 포함된 필드의 전체 길이는 280자(영문 기준)를 초과할 수 없습니다.

지원되는 지역은 여기에서 확인할 수 있습니다.

입력 주소의 language_code 값은 향후 사용을 위해 예약되며 현재는 무시됩니다. 확인된 주소 결과는 시스템에서 식별한 대로 해당 주소의 기본 언어를 기반으로 채워집니다.

Address Validation API는 recipients 및 organization의 값을 무시합니다. 이러한 필드의 값은 삭제되며 반환되지 않습니다. 설정하지 마세요.
previous_response_id

string

첫 번째 주소 검증 요청의 경우 이 필드가 비어 있어야 합니다. 단일 주소를 완전히 확인하는 데 더 많은 요청이 필요한 경우 (예: 초기 유효성 검사 이후 사용자가 변경한 내용의 유효성을 다시 검사해야 하는 경우) 각 후속 요청에서 유효성 검사 시퀀스의 첫 번째 응답에서 얻은 response_id로 이 필드를 채워야 합니다.
enable_usps_cass

bool

USPS CASS 호환 모드를 사용 설정합니다. 이는 google.maps.addressvalidation.v1.ValidationResult의 google.maps.addressvalidation.v1.ValidationResult.usps_data 필드에만 영향을 줍니다. 참고: 푸에르토리코 내 주소에 대한 USPS CASS 지원 요청의 경우 address의 google.type.PostalAddress.region_code를 'PR'으로 제공하거나 address의 google.type.PostalAddress.administrative_area를 '푸에르토리코' (대소문자를 구분하지 않음) 또는 'PR'으로 제공해야 합니다.

구성요소화된 address를 사용하거나 첫 번째 줄에는 번지와 이름이, 두 번째 줄에 시, 도, 우편번호가 포함된 google.type.PostalAddress.address_lines를 두 개 이상 지정하는 것이 좋습니다.
language_options

LanguageOptions

선택사항입니다. 미리보기: 이 기능은 미리보기 (GA 이전) 버전입니다. GA 이전 제품과 기능은 지원이 제한될 수 있으며, GA 이전 제품과 기능이 변경된 경우 다른 GA 이전 버전과 호환되지 않을 수 있습니다. GA 이전 버전 제품 또는 서비스에는 Google Maps Platform 서비스별 약관이 적용됩니다. 자세한 내용은 출시 단계 설명을 참조하세요.

Address Validation API를 사용하여 응답에 추가 정보를 포함할 수 있습니다.

ValidateAddressResponse

주소 확인 요청에 대한 응답입니다.

필드
result

ValidationResult

주소 확인 결과입니다.
response_id

string

이 응답을 식별하는 UUID입니다. 주소의 유효성을 다시 검사해야 하는 경우 이 UUID는 반드시 새 요청에 포함되어야 합니다.

ValidationResult

주소 검증 결과입니다.

필드
verdict

Verdict

전체 확인 결과 플래그
address

Address

지오코드가 아닌 주소 자체에 대한 정보입니다.
geocode

Geocode

주소가 지오코딩된 위치 및 장소에 대한 정보입니다.
metadata

AddressMetadata

전송 가능성과 관련된 기타 정보입니다. Address Validation API에 전송된 모든 주소에 metadata가 완전히 채워지지 않을 수도 있습니다.
usps_data

UspsData

USPS에서 제공하는 추가 배송 가능 플래그입니다. US 및 PR 리전에서만 제공됩니다.
english_latin_address

Address

미리보기: 이 기능은 미리보기 (GA 이전) 버전입니다. GA 이전 제품과 기능은 지원이 제한될 수 있으며, GA 이전 제품과 기능이 변경된 경우 다른 GA 이전 버전과 호환되지 않을 수 있습니다. GA 이전 버전 제품 또는 서비스에는 Google Maps Platform 서비스별 약관이 적용됩니다. 자세한 내용은 출시 단계 설명을 참조하세요.

영어로 번역된 주소입니다. 주소의 일부에 영어 번역이 없으면 라틴 자모를 사용하는 대체 언어로 해당 부분을 반환합니다. 대체 언어가 어떻게 선택되는지에 대한 설명은 여기를 참고하세요. 주소의 일부에 라틴 자모를 사용하는 언어의 번역이나 음역이 없는 경우 주소와 연결된 현지 언어로 해당 부분을 반환합니다.

google.maps.addressvalidation.v1.LanguageOptions.return_english_latin_address 플래그를 사용하여 이 출력을 사용 설정했습니다.

참고: english_latin_address의 google.maps.addressvalidation.v1.Address.unconfirmed_component_types 필드와 english_latin_address.address_components의 google.maps.addressvalidation.v1.AddressComponent.confirmation_level 필드는 채워지지 않습니다.

결과

주소 유효성 검사 결과 및 지오코드에 대한 높은 수준의 개요입니다.

필드
input_granularity

Granularity

입력 주소의 세부사항입니다. 입력 주소를 파싱한 결과이며 유효성 검사 신호를 제공하지 않습니다. 유효성 검사 신호는 아래 validation_granularity를 참고하세요.

예를 들어 입력한 주소에 특정 아파트 호수가 포함되어 있으면 여기서 input_granularity는 SUB_PREMISE입니다. 데이터베이스에서 아파트 호수를 일치시킬 수 없거나 아파트 번호가 유효하지 않으면 validation_granularity은 PREMISE 이하일 수 있습니다.
validation_granularity

Granularity

API가 주소를 완전히 validate할 수 있는 세부사항 수준입니다. 예를 들어 validation_granularity이 PREMISE이면 대략적인 수준이 PREMISE인 모든 주소 구성요소를 검증할 수 있음을 나타냅니다.

주소별 구성요소 유효성 검사 결과는 google.maps.addressvalidation.v1.Address.address_components에서 확인할 수 있습니다.
geocode_granularity

Granularity

geocode의 세부사항에 관한 정보입니다. 이는 지오코딩된 위치의 대략적 또는 미세한 정도에 대한 의미론적 의미로 이해할 수 있습니다.

가끔 위의 validation_granularity와 다를 수 있습니다. 예를 들어, 데이터베이스가 아파트 호수의 존재는 기록하지만 대형 아파트 단지 내 아파트의 정확한 위치는 알 수 없습니다. 이 경우 validation_granularity은 SUB_PREMISE이지만 geocode_granularity는 PREMISE입니다.
address_complete

bool

확인되지 않은 토큰이 없거나, 예상치 못했거나 누락된 주소 구성요소가 없는 경우 주소는 완전한 것으로 간주됩니다. 자세한 내용은 missing_component_types, unresolved_tokens 또는 unexpected 필드를 참고하세요.
has_unconfirmed_components

bool

하나 이상의 주소 구성요소를 분류하거나 확인할 수 없습니다. 자세한 내용은 google.maps.addressvalidation.v1.Address.address_components을 참고하세요.
has_inferred_components

bool

입력에 없는 주소 구성요소가 하나 이상 추론 (추가됨)되었습니다. 자세한 내용은 google.maps.addressvalidation.v1.Address.address_components를 참고하세요.
has_replaced_components

bool

하나 이상의 주소 구성요소가 교체되었습니다. 자세한 내용은 google.maps.addressvalidation.v1.Address.address_components 페이지를 참고하세요.

세부사항

주소 또는 지오코드가 가질 수 있는 다양한 세분화 정도입니다. 주소의 세부사항을 나타내는 데 사용되는 경우 이 값은 해당 주소가 우편 발송 대상을 식별하는 정도를 세분화하여 나타냅니다. 예를 들어 '123 Main Street, Redwood City, CA, 94061'과 같은 주소는 PREMISE을 식별하는 반면 'Redwood City, CA, 94061'과 같은 주소는 LOCALITY을 식별합니다. 그러나 Redwood City에서 '123 Main Street'에 대한 지오코드를 찾을 수 없는 경우 주소가 더 세분화되어 있더라도 반환된 지오코드가 LOCALITY 세분화 정도일 수 있습니다.

열거형
GRANULARITY_UNSPECIFIED 기본값 이 값은 사용되지 않습니다.
SUB_PREMISE 아파트 건물과 같은 건물 아래층 결과입니다.
PREMISE 건물 수준 결과입니다.
PREMISE_PROXIMITY 주소의 건물 수준 위치에 가까운 지오코드입니다.
BLOCK 주소 또는 지오코드는 블록을 나타냅니다. 일본과 같이 블록 수준 주소 지정이 있는 리전에서만 사용됩니다.
ROUTE 지오코드 또는 주소는 거리, 도로 또는 고속도로와 같은 경로에 대해 세분화됩니다.
OTHER 다른 모든 세분화는 전달할 수 없으므로 함께 버케팅됩니다.