색인
AddressValidation
(인터페이스)Address
(메시지)AddressComponent
(메시지)AddressComponent.ConfirmationLevel
(열거형)AddressMetadata
(메시지)ComponentName
(메시지)Geocode
(메시지)LanguageOptions
(메시지)PlusCode
(메시지)ProvideValidationFeedbackRequest
(메시지)ProvideValidationFeedbackRequest.ValidationConclusion
(열거형)ProvideValidationFeedbackResponse
(메시지)UspsAddress
(메시지)UspsData
(메시지)ValidateAddressRequest
(메시지)ValidateAddressResponse
(메시지)ValidationResult
(메시지)Verdict
(메시지)Verdict.Granularity
(열거형)
AddressValidation
주소 유효성 검사를 위한 서비스입니다.
ProvideValidationFeedback |
---|
유효성 검사 시도 순서의 결과에 대한 의견입니다. 이는 동일한 주소에 대한 일련의 유효성 검사 호출 후에 이루어진 마지막 호출이어야 하며, 거래가 완료된 후에 호출해야 합니다. 주소를 완전히 확인하는 데 필요한 일련의 |
ValidateAddress |
---|
주소를 확인합니다. |
주소
후처리된 주소의 세부정보입니다. 후속 처리에는 맞춤법이 틀린 주소 수정, 잘못된 부분 교체, 누락된 부분 추론 등이 포함됩니다.
입력란 | |
---|---|
formatted_address |
주소가 있는 지역의 주소 형식 규칙에 따라 한 줄 주소로 형식이 지정된 후처리된 주소입니다. |
postal_address |
우편 주소로 표시되는 후처리된 주소입니다. |
address_components[] |
순서가 지정되지 않은 목록입니다. 유효성 검사 정보와 함께 형식이 지정되고 수정된 주소의 개별 주소 구성요소입니다. 개별 구성요소의 유효성 검사 상태 정보를 제공합니다. 주소 구성요소는 특정한 방식으로 정렬되지 않습니다. 목록에서 주소 구성요소의 순서를 가정하지 마세요. |
missing_component_types[] |
올바른 형식의 우편 주소에 있어야 하지만 입력에서 찾을 수 없으며 추론할 수 없는 구성요소 유형입니다. 이 유형의 구성요소는 |
unconfirmed_component_types[] |
|
unresolved_tokens[] |
입력에 해결할 수 없는 모든 토큰입니다. 이는 주소의 유효한 부분으로 인식되지 않은 입력일 수 있습니다 (예: '123235253253 Main St, San Francisco, CA, 94105'와 같은 입력에서 확인되지 않은 토큰은 유효한 번지수로 보이지 않으므로 |
AddressComponent
거리, 도시, 주와 같은 주소 구성요소를 나타냅니다.
입력란 | |
---|---|
component_name |
이 구성요소의 이름입니다. |
component_type |
주소 구성요소의 유형입니다. 가능한 유형 목록은 표 2: 장소 서비스에서 반환하는 추가 유형을 참고하세요. |
confirmation_level |
구성요소가 올바른지 확실성 수준을 나타냅니다. |
inferred |
구성요소가 입력의 일부가 아님을 나타내지만, Google에서 주소 위치로 추론했으며 전체 주소가 제공되어야 한다고 생각합니다. |
spell_corrected |
구성요소 이름의 맞춤법 오류 수정을 나타냅니다. 'centre'를 'center'로 변경하는 경우와 같이 API가 철자가 다른 변형의 변경사항에 대해 항상 플래그를 지정하는 것은 아닙니다. 또한 'Amphitheater Pkwy'를 'Amphitheatre Pkwy'로 변경하는 경우와 같이 자주 발생하는 맞춤법 오류를 신고하지 않을 수도 있습니다. |
replaced |
구성요소의 이름이 완전히 다른 이름으로 대체되었음을 나타냅니다(예: 잘못된 우편번호가 주소에 맞는 우편번호로 대체됨). 이는 외관상의 변화가 아니며 입력 구성요소가 다른 구성요소로 변경되었습니다. |
unexpected |
지정된 지역의 우편 주소에 없을 것으로 예상되는 주소 구성요소를 나타냅니다. 입력 내용에 포함되었기 때문에 그대로 유지되었습니다. |
ConfirmationLevel
확인 수준에 사용할 수 있는 다양한 값입니다.
열거형 | |
---|---|
CONFIRMATION_LEVEL_UNSPECIFIED |
기본값 이 값은 사용되지 않습니다. |
CONFIRMED |
이 구성요소가 존재하고 주소의 나머지 부분의 맥락에서 의미가 있는지 확인할 수 있었습니다. |
UNCONFIRMED_BUT_PLAUSIBLE |
확인할 수 없는 구성요소이지만 존재할 가능성이 있습니다. 예를 들어 특정 번지수를 알 수 없는 도로의 알려진 유효한 번호 범위 내에 있는 번지가 있습니다. |
UNCONFIRMED_AND_SUSPICIOUS |
확인되지 않은 구성요소이므로 잘못되었을 가능성이 있습니다. 예를 들어 주소의 나머지 부분에 맞지 않는 동네입니다. |
AddressMetadata
주소의 메타데이터입니다. Address Validation API로 전송되는 모든 주소에 metadata
가 완전히 채워지지 않을 수도 있습니다.
입력란 | |
---|---|
business |
비즈니스의 주소임을 나타냅니다. 설정되지 않은 경우 값을 알 수 없음을 나타냅니다. |
po_box |
사서함의 주소를 나타냅니다. 설정되지 않은 경우 값을 알 수 없음을 나타냅니다. |
residential |
거주지 주소임을 나타냅니다. 설정되지 않은 경우 값을 알 수 없음을 나타냅니다. |
ComponentName
구성요소 이름의 래퍼입니다.
입력란 | |
---|---|
text |
이름 텍스트입니다. 예를 들어 '5번가'는 도로명을, '1253'은 번지를 나타냅니다. |
language_code |
BCP-47 언어 코드입니다. 구성요소 이름이 번지와 같은 언어와 연결되지 않은 경우에는 표시되지 않습니다. |
지오코드
입력이 지오코딩된 장소에 대한 정보를 포함합니다.
입력란 | |
---|---|
location |
입력의 지오코딩된 위치입니다. 주소, 위도/경도 좌표 또는 플러스 코드보다 장소 ID를 사용하는 것이 좋습니다. 경로를 안내하거나 운전경로를 계산할 때 좌표를 사용하면 항상 해당 좌표에 가장 가까운 도로에 지점이 맞춰집니다. 목적지까지 빠르고 안전하게 연결되는 도로일 수 없으며 장소의 접근점과 가깝지 않을 수 있습니다. 또한 위치가 역 지오코딩되는 경우 반환된 주소가 원래 주소와 일치한다는 보장은 없습니다. |
plus_code |
|
bounds |
지오코딩된 장소의 경계. |
feature_size_meters |
지오코딩된 장소의 크기(미터)입니다. 이는 지오코딩된 위치의 대략적인 정도를 측정하는 또 다른 방법이지만 의미론적 의미보다는 실제 크기입니다. |
place_id |
이 입력이 지오코딩되는 장소의 PlaceID입니다. 장소 ID에 대한 자세한 내용은 여기를 참고하세요. |
place_types[] |
입력이 지오코딩된 장소의 유형입니다. 예를 들면 다음과 같습니다. |
LanguageOptions
미리보기: 이 기능은 미리보기 (GA 이전) 버전입니다. GA 이전 제품과 기능은 지원이 제한될 수 있으며, GA 이전 제품과 기능이 변경된 경우 다른 GA 이전 버전과 호환되지 않을 수 있습니다. GA 이전 버전 제품 및 서비스에는 Google Maps Platform 서비스별 약관이 적용됩니다. 자세한 내용은 출시 단계 설명을 참조하세요.
Address Validation API를 사용 설정하여 응답에 추가 정보를 포함할 수 있습니다.
입력란 | |
---|---|
return_english_latin_address |
미리보기: 영어로 |
PlusCode
플러스 코드 (http://plus.codes)는 두 가지 형식으로 위치 참조입니다. 하나는 14mx14m (1/8000의 1/8000) 또는 작은 직사각형을 정의하는 글로벌 코드이고 다른 하나는 복합 코드로 접두어를 참조 위치로 대체합니다.
입력란 | |
---|---|
global_code |
장소의 전역(전체) 코드(예: '9FWM33GV+HQ')로, 1/8000x1/8000도 영역(약 14x14미터)을 나타냅니다. |
compound_code |
장소의 복합 코드(예: '33GV+HQ, Ramberg, Korean')입니다. 전역 코드의 접미사가 포함되며 접두사를 참조 항목의 형식이 지정된 이름으로 대체합니다. |
ProvideValidationFeedbackRequest
유효성 검사 의견 전송 요청입니다.
입력란 | |
---|---|
conclusion |
필수 항목입니다. 유효성 검사 시도 순서의 결과입니다. 이 필드가 |
response_id |
필수 항목입니다. 이 의견에 해당하는 응답의 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 |
첫 번째 주소 입력란입니다. |
firm |
회사명 |
second_address_line |
두 번째 주소 입력란입니다. |
urbanization |
푸에르토리코 도시화 이름 |
city_state_zip_address_line |
시/도 + 우편번호 |
city |
도시 이름입니다. |
state |
2자리 상태 코드입니다. |
zip_code |
우편번호(예: 10009) |
zip_code_extension |
4자리 우편번호 확장자(예: 5023) |
UspsData
주소에 대한 USPS 데이터입니다. Address Validation API로 전송된 모든 미국 또는 PR 주소에 uspsData
가 완전히 채워지지 않을 수도 있습니다. 응답의 기본 부분으로 uspsData를 활용하는 경우 백업 주소 필드를 응답에 통합하는 것이 좋습니다.
입력란 | |
---|---|
standardized_address |
USPS 표준 주소 |
delivery_point_code |
2자리 배송지 코드 |
delivery_point_check_digit |
배송 지점 검사 숫자입니다. 이 번호는 기계적으로 스캔한 메일의 delivery_point_barcode 끝에 추가됩니다. Delivery_point_barcode, delivery_point_check_Digi, 우편번호, ZIP+4의 자릿수를 모두 더하면 10으로 나눌 수 있는 숫자가 생성됩니다. |
dpv_confirmation |
DPV 확인에 가능한 값입니다. 단일 문자를 반환하거나 값을 반환하지 않습니다.
|
dpv_footnote |
배송 지점 유효성 검사의 각주 여러 각주가 동일한 문자열 안에 함께 표시될 수 있습니다.
|
dpv_cmra |
주소가 고객에게 메일을 수신하는 민간 기업인 CMRA (상업 우편 수신 대행사)인지 여부를 나타냅니다. 단일 문자를 반환합니다.
|
dpv_vacant |
빈 장소입니까? 단일 문자를 반환합니다.
|
dpv_no_stat |
이 주소는 고정 주소인가요, 아니면 사용 중인 주소인가요? 통계 주소는 지속적으로 사용되지 않거나 USPS에서 서비스를 제공하지 않는 주소를 의미합니다. 단일 문자를 반환합니다.
|
dpv_no_stat_reason_code |
NoStat 유형을 나타냅니다. 이유 코드를 int로 반환합니다.
|
dpv_drop |
플래그는 사이트에서 하나의 수신처로 메일이 전달되었음을 나타냅니다. 단일 문자를 반환합니다.
|
dpv_throwback |
메일이 상세 주소로 전송되지 않았음을 나타냅니다. 단일 문자를 반환합니다.
|
dpv_non_delivery_days |
플래그는 한 주 중 매일 메일 전송이 수행되지 않음을 나타냅니다. 단일 문자를 반환합니다.
|
dpv_non_delivery_days_values |
미게재 일수를 식별하는 정수입니다. 비트 플래그를 사용하여 심문할 수 있습니다. 0x40 – 일요일은 미게재일 0x20, 월요일은 미게재일 0x10, 화요일은 미게재일 0x08, 수요일은 미게재일 0x04, 목요일은 미게재일, 0x02 – 금요일은 미게재일, 금요일은 미게재일 0 |
dpv_no_secure_location |
플래그는 출입구에 접근할 수 있음을 나타내지만 보안 문제로 인해 택배를 맡기지 않을 것임을 나타냅니다. 단일 문자를 반환합니다.
|
dpv_pbsa |
주소가 PBSA 레코드와 일치했음을 나타냅니다. 단일 문자를 반환합니다.
|
dpv_door_not_accessible |
플래그는 USPS에서 우편물을 배달하기 위해 문을 두드릴 수 없는 주소를 나타냅니다. 단일 문자를 반환합니다.
|
dpv_enhanced_delivery_code |
주소에 2개 이상의 DPV 반환 코드가 유효함을 나타냅니다. 단일 문자를 반환합니다.
|
carrier_route |
운송업체 경로 코드입니다. 1자 접두사와 3자리 경로 지정자로 구성된 4자리 코드입니다. 프리픽스:
|
carrier_route_indicator |
운송업체 노선 요율 정렬 표시기입니다. |
ews_no_match |
배송지 주소는 일치하지만 EWS 파일에 따르면 정확하게 일치하는 주소가 곧 제공될 예정입니다. |
post_office_city |
주 우체국 도시입니다. |
post_office_state |
기본 우체국 주/도입니다. |
abbreviated_city |
도시 이름을 축약하여 사용합니다. |
fips_county_code |
FIPS 국가 코드입니다. |
county |
구/군 이름 |
elot_number |
향상된 이동 경로 (eLOT) 번호입니다. |
elot_flag |
eLOT 오름차순/내림차순 플래그 (A/D) |
lacs_link_return_code |
LACSLink 반환 코드입니다. |
lacs_link_indicator |
LACSLink 표시기입니다. |
po_box_only_postal_code |
사서함은 우편번호에만 사용할 수 있습니다. |
suitelink_footnote |
도로 또는 고층 레코드와 스위트 정보를 매칭하는 각주 일치하는 비즈니스 이름이 있으면 보조 번호가 반환됩니다.
|
pmb_designator |
PMB (개인 우편함) 단위 지정자. |
pmb_number |
PMB (개인 사서함) 번호 |
address_record_type |
입력 주소와 일치하는 주소 레코드의 유형입니다.
|
default_address |
기본 주소를 찾았지만 더 구체적인 주소가 있다는 표시기입니다. |
error_message |
USPS 데이터 검색에 대한 오류 메시지입니다. 인위적으로 생성된 주소가 감지되어 USPS 처리가 정지된 경우 채워집니다. 이 오류가 있는 경우 USPS 데이터 필드가 채워지지 않을 수 있습니다. |
cass_processed |
요청이 CASS 처리되었음을 나타내는 표시기입니다. |
ValidateAddressRequest
주소 검증 요청입니다.
입력란 | |
---|---|
address |
필수 항목입니다. 주소를 확인하려는 주소입니다. 형식이 지정되지 않은 주소는 이 입력에 있는 입력란의 총 길이는 280자를 초과할 수 없습니다. 지원되는 지역은 여기에서 확인할 수 있습니다. 입력 주소의 Address Validation API는 |
previous_response_id |
첫 번째 주소 유효성 검사를 요청하려면 이 필드를 비워 두어야 합니다. 단일 주소를 완전히 확인하는 데 더 많은 요청이 필요한 경우 (예: 초기 유효성 검사 후 사용자가 변경한 내용을 다시 검증해야 하는 경우) 각 후속 요청에서 유효성 검사 시퀀스의 첫 번째 응답에서 가져온 |
enable_usps_cass |
USPS CASS 호환 모드를 사용 설정합니다. 이는 구성요소화된 |
language_options |
선택사항입니다. 미리보기: 이 기능은 미리보기 (GA 이전) 버전입니다. GA 이전 제품과 기능은 지원이 제한될 수 있으며, GA 이전 제품과 기능이 변경된 경우 다른 GA 이전 버전과 호환되지 않을 수 있습니다. GA 이전 버전 제품 및 서비스에는 Google Maps Platform 서비스별 약관이 적용됩니다. 자세한 내용은 출시 단계 설명을 참조하세요. Address Validation API를 사용 설정하여 응답에 추가 정보를 포함할 수 있습니다. |
session_token |
선택사항입니다. 결제 목적으로 자동 완성 세션을 식별하는 문자열입니다. ASCII 문자 36자 이하의 URL 및 파일 이름 안전 base64 문자열이어야 합니다. 그렇지 않으면 INVALID_ARGUMENT 오류가 반환됩니다. 세션은 사용자가 Autocomplete 쿼리를 실행할 때 시작되고, 사용자가 장소를 선택하고 장소 세부정보 또는 주소 확인에 대한 호출을 수행하면 종료됩니다. 세션마다 여러 개의 Autocomplete 쿼리가 포함될 수 있으며 하나의 Place Details 또는 Address Validation 요청이 있을 수 있습니다. 세션 내에서 각 요청에 사용되는 사용자 인증 정보는 동일한 Google Cloud 콘솔 프로젝트에 속해야 합니다. 세션이 종료되면 토큰이 더 이상 유효하지 않습니다. 앱은 세션별로 새 토큰을 생성해야 합니다. 참고: 주소 확인은 Autocomplete API가 아닌 Autocomplete (New) API가 있는 세션에서만 사용할 수 있습니다. 자세한 내용은 https://developers.google.com/maps/documentation/places/web-service/session-pricing을 참고하세요. |
ValidateAddressResponse
주소 유효성 검사 요청에 대한 응답입니다.
입력란 | |
---|---|
result |
주소 유효성 검사의 결과입니다. |
response_id |
이 응답을 식별하는 UUID입니다. 주소를 다시 검증해야 하는 경우 이 UUID는 반드시 새 요청에 수반되어야 합니다. |
ValidationResult
주소 검증 결과입니다.
입력란 | |
---|---|
verdict |
전체 확인 결과 플래그 |
address |
지오코드가 아닌 주소 자체에 대한 정보입니다. |
geocode |
주소가 지오코딩된 위치 및 장소에 대한 정보입니다. |
metadata |
배송 가능성과 관련된 기타 정보입니다. Address Validation API로 전송되는 모든 주소에 |
usps_data |
USPS에서 제공한 추가 배송 여부 플래그입니다. |
english_latin_address |
미리보기: 이 기능은 미리보기 (GA 이전) 버전입니다. GA 이전 제품과 기능은 지원이 제한될 수 있으며, GA 이전 제품과 기능이 변경된 경우 다른 GA 이전 버전과 호환되지 않을 수 있습니다. GA 이전 버전 제품 및 서비스에는 Google Maps Platform 서비스별 약관이 적용됩니다. 자세한 내용은 출시 단계 설명을 참조하세요. 영어로 번역된 주소입니다. 번역된 주소는 API 입력으로 재사용할 수 없습니다. 이 서비스는 사용자가 자신의 모국어를 사용하여 원래 제공된 주소의 유효성 검사를 확인하거나 거부할 수 있도록 합니다. 주소의 일부분에 영어 번역이 없는 경우 서비스에서 해당 부분을 라틴 자모를 사용하는 대체 언어로 반환합니다. 대체 언어가 선택되는 방법에 대한 설명은 여기를 참조하세요. 주소의 일부분에 라틴 자모를 사용하는 언어로 된 번역이나 음역이 없는 경우, 서비스는 해당 주소와 연결된 현지 언어로 해당 부분을 반환합니다.
참고: |
결과
주소 유효성 검사 결과 및 지오코드에 대한 높은 수준의 개요입니다.
입력란 | |
---|---|
input_granularity |
입력 주소의 세부사항입니다. 이는 입력 주소를 파싱한 결과이며 유효성 검사 신호를 제공하지 않습니다. 검증 신호는 아래 예를 들어 입력한 주소에 특정 아파트 동호수가 포함되어 있으면 여기서 |
validation_granularity |
API가 주소를 완전히 validate할 수 있는 세부사항 수준입니다. 예를 들어 주소별 구성요소 유효성 검사 결과는 |
geocode_granularity |
경우에 따라 위의 |
address_complete |
해결되지 않은 토큰이나 예기치 않았거나 누락된 주소 구성요소가 없으면 주소는 완전한 것으로 간주됩니다. 설정되지 않은 경우 값이 |
has_unconfirmed_components |
하나 이상의 주소 구성요소를 분류하거나 확인할 수 없습니다. 자세한 내용은 |
has_inferred_components |
입력에 없는 주소 구성요소 중 하나 이상이 추론 (추가됨)되었습니다. 자세한 내용은 |
has_replaced_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 |
기타 모든 세분화는 제공할 수 없으므로 함께 버케팅됩니다. |