- HTTP 요청
- 요청 본문
- 응답 본문
- PostalAddress
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- LanguageOptions
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- ValidationResult
- 결과
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- 세부사항
- 주소
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- AddressComponent
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- ComponentName
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- ConfirmationLevel
- 지오코드
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- LatLng
- PlusCode
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- 표시 영역
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- AddressMetadata
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- UspsData
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- UspsAddress
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
주소를 검증합니다.
HTTP 요청
POST https://addressvalidation.googleapis.com/v1:validateAddress
URL은 gRPC 트랜스코딩 구문을 사용합니다.
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{ "address": { object ( |
필드 | |
---|---|
address |
필수 항목입니다. 확인할 주소입니다. 형식이 지정되지 않은 주소는 이 입력에서 필드의 전체 길이는 280자(영문 기준) 이하여야 합니다. 지원되는 리전은 여기에서 확인할 수 있습니다. 입력 주소의 Address Validation API는 |
previousResponseId |
첫 번째 주소 확인 요청의 경우 이 필드가 비어 있어야 합니다. 단일 주소를 완전히 검증하는 데 더 많은 요청이 필요한 경우 (예: 초기 유효성 검사 후 사용자가 변경한 사항을 다시 검증해야 하는 경우) 각 후속 요청에서는 유효성 검사 시퀀스의 첫 번째 응답에서 이 필드를 |
enableUspsCass |
USPS CASS 호환 모드를 사용 설정합니다. 이는 구성요소화된 |
languageOptions |
선택사항입니다. 미리보기: 이 기능은 미리보기 (GA 이전) 버전입니다. GA 이전 제품과 기능은 지원이 제한될 수 있으며, GA 이전 제품과 기능이 변경된 경우 다른 GA 이전 버전과 호환되지 않을 수 있습니다. GA 이전 버전 제품 및 서비스에는 Google Maps Platform 서비스별 약관이 적용됩니다. 자세한 내용은 출시 단계 설명을 참조하세요. Address Validation API가 응답에 추가 정보를 포함하도록 사용 설정합니다. |
sessionToken |
선택사항입니다. 결제 목적으로 자동 완성 세션을 식별하는 문자열입니다. ASCII 문자 길이가 최대 36자인 URL 및 파일 이름 안전 base64 문자열이어야 합니다. 그렇지 않으면 INVALID_ARGUMENT 오류가 반환됩니다. 세션은 사용자가 자동 완성 쿼리를 할 때 시작되고, 사용자가 장소를 선택하고 장소 세부정보 또는 주소 검증을 호출하면 종료됩니다. 각 세션에는 여러 개의 Autocomplete 쿼리가 포함될 수 있으며, 이어서 하나의 장소 세부정보 또는 주소 확인 요청이 있을 수 있습니다. 세션 내의 각 요청에 사용되는 사용자 인증 정보는 동일한 Google Cloud 콘솔 프로젝트에 속해야 합니다. 세션이 종료되면 토큰이 더 이상 유효하지 않습니다. 각 세션에 대해 새 토큰을 생성해야 합니다. 참고: 주소 확인은 Autocomplete API가 아닌 Autocomplete (New) API를 사용하는 세션에서만 사용할 수 있습니다. 자세한 내용은 https://developers.google.com/maps/documentation/places/web-service/session-pricing을 참고하세요. |
응답 본문
주소 확인 요청에 대한 응답입니다.
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{
"result": {
object ( |
필드 | |
---|---|
result |
주소 유효성 검사 결과입니다. |
responseId |
이 응답을 식별하는 UUID입니다. 주소의 유효성을 다시 검사해야 하는 경우 이 UUID가 새 요청에 따라야 합니다. |
PostalAddress
우편 주소를 나타냅니다. 예: 우편번호를 입력하세요. 우편 주소가 주어지면 우편 서비스는 사업장(P.O. Box 또는 이와 유사한 제품 도로, 마을, 산 등 지리적 위치를 모델링하기 위한 것이 아닙니다.
일반적으로 주소는 프로세스 유형에 따라 사용자 입력을 통해 또는 기존 데이터 가져오기를 통해 만들어집니다.
주소 입력 / 수정에 관한 조언: - https://github.com/google/libaddressinput과 같이 국제화가 가능한 주소 위젯 사용) - 해당 입력란이 사용되는 국가 이외의 국가에서는 입력란을 입력하거나 수정할 수 있는 UI 요소가 사용자에게 표시되어서는 안 됩니다.
이 스키마를 사용하는 방법에 관한 자세한 내용은 https://support.google.com/business/answer/6397478을 참고하세요.
JSON 표현 |
---|
{ "revision": integer, "regionCode": string, "languageCode": string, "postalCode": string, "sortingCode": string, "administrativeArea": string, "locality": string, "sublocality": string, "addressLines": [ string ], "recipients": [ string ], "organization": string } |
필드 | |
---|---|
revision |
|
regionCode |
선택사항입니다. 주소의 국가/지역의 CLDR 지역 코드입니다. 자세한 내용은 https://cldr.unicode.org/ 및 https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html을 참고하세요. 예: 'CH' 되었습니다. 지역 코드가 제공되지 않으면 주소에서 유추됩니다. 최상의 성능을 위해 아는 경우 지역 코드를 포함하는 것이 좋습니다. 리전이 일관되지 않거나 반복되면 성능이 저하될 수 있습니다. 예를 들어 |
languageCode |
입력 주소의 언어 코드는 나중에 사용할 수 있도록 예약되어 있으므로 오늘 무시됩니다. API는 주소가 위치한 지역의 적절한 언어로 주소를 반환합니다. |
postalCode |
선택사항입니다. 주소의 우편번호입니다. 모든 국가에서 우편번호를 사용하거나 표시해야 하는 것은 아니지만, 우편번호가 사용되는 지역에서는 주소의 다른 부분에 대한 추가 유효성 검사 (예: 미국의 주/우편번호 유효성 검사)가 트리거될 수 있습니다. |
sortingCode |
선택사항입니다. 국가별 추가 정렬 코드입니다. 대부분의 리전에서 사용되지 않습니다. 사용할 경우 값은 'CEDEX'와 같이 선택적으로 뒤에 숫자가 오는 문자열 (예: 'CEDEX 7')이거나 '섹터 코드'를 나타내는 숫자만 사용할 수 있습니다. (자메이카), '배송 지역 표시기' (말라위) 또는 '우체국 지표' (예: 코트디부아르) |
administrativeArea |
선택사항입니다. 국가 또는 지역의 주소에 사용되는 최상위 행정 구역 단위입니다. 예를 들어 주, 도, 현을 입력할 수 있습니다. 특히 스페인의 경우 이 지역은 자치지구가 아닌 주입니다 (예: '카탈로니아'가 아닌 '바르셀로나'). 많은 국가에서는 우편 주소에 행정 구역을 사용하지 않습니다. 예: 스위스에서는 값을 입력하지 않은 상태로 두어야 합니다. |
locality |
선택사항입니다. 일반적으로 주소의 시/군/구 부분을 나타냅니다. 예: 미국 도시, IT 코뮤, 영국 우체국 지역이 잘 정의되지 않거나 이 구조에 잘 맞지 않는 경우 지역을 비워 두고 addressLines를 사용합니다. |
sublocality |
선택사항입니다. 주소의 하위 지역입니다. 예를 들어 인근 지역, 자치구, 구역이 될 수 있습니다. |
addressLines[] |
필수 항목입니다. 주소의 하위 수준을 설명하는 구조화되지 않은 주소 입력란입니다. |
recipients[] |
이 필드는 설정하지 마세요. Address Validation API에서는 현재 이를 사용하지 않습니다. 현재 API에서 이 필드가 설정된 요청을 거부하지는 않지만, 정보는 삭제되고 응답에 반환되지 않습니다. |
organization |
이 필드는 설정하지 마세요. Address Validation API에서는 현재 이를 사용하지 않습니다. 현재 API에서 이 필드가 설정된 요청을 거부하지는 않지만, 정보는 삭제되고 응답에 반환되지 않습니다. |
LanguageOptions
미리보기: 이 기능은 미리보기 (GA 이전) 버전입니다. GA 이전 제품과 기능은 지원이 제한될 수 있으며, GA 이전 제품과 기능이 변경된 경우 다른 GA 이전 버전과 호환되지 않을 수 있습니다. GA 이전 버전 제품 및 서비스에는 Google Maps Platform 서비스별 약관이 적용됩니다. 자세한 내용은 출시 단계 설명을 참조하세요.
Address Validation API가 응답에 추가 정보를 포함하도록 사용 설정합니다.
JSON 표현 |
---|
{ "returnEnglishLatinAddress": boolean } |
필드 | |
---|---|
returnEnglishLatinAddress |
미리보기: 영어로 |
ValidationResult
주소를 확인한 결과입니다.
JSON 표현 |
---|
{ "verdict": { object ( |
필드 | |
---|---|
verdict |
전체 확인 결과 플래그 |
address |
지오코드가 아닌 주소 자체에 대한 정보입니다. |
geocode |
주소가 지오코딩된 위치 및 장소에 대한 정보입니다. |
metadata |
게재와 관련된 기타 정보입니다. Address Validation API로 전송되는 모든 주소에 |
uspsData |
USPS에서 제공하는 추가 배송 가능 플래그입니다. |
englishLatinAddress |
미리보기: 이 기능은 미리보기 (GA 이전) 버전입니다. GA 이전 제품과 기능은 지원이 제한될 수 있으며, GA 이전 제품과 기능이 변경된 경우 다른 GA 이전 버전과 호환되지 않을 수 있습니다. GA 이전 버전 제품 및 서비스에는 Google Maps Platform 서비스별 약관이 적용됩니다. 자세한 내용은 출시 단계 설명을 참조하세요. 영어로 번역된 주소입니다. 번역된 주소는 API 입력으로 재사용할 수 없습니다. 이 서비스에서는 사용자가 자신의 모국어를 사용하여 원래 제공된 주소의 확인을 확인하거나 거부할 수 있습니다. 주소의 일부에 영어 번역이 없는 경우 서비스는 해당 부분을 라틴 자모를 사용하는 대체 언어로 반환합니다. 대체 언어가 선택되는 방법에 대한 설명은 여기를 참조하세요. 주소의 일부에 라틴 자모를 사용하는 언어의 번역 또는 음역이 없는 경우 서비스는 해당 주소와 연결된 현지 언어로 해당 부분을 반환합니다.
참고: |
결과
주소 확인 결과 및 지오코드에 대한 대략적인 개요.
JSON 표현 |
---|
{ "inputGranularity": enum ( |
필드 | |
---|---|
inputGranularity |
입력 주소의 세부사항입니다. 이는 입력 주소를 파싱한 결과이며 유효성 검사 신호는 제공하지 않습니다. 유효성 검사 신호는 아래의 예를 들어 입력한 주소에 특정 아파트 동호수가 포함된 경우 여기서 |
validationGranularity |
API가 주소를 완전히 검증할 수 있는 세부사항 수준입니다. 예를 들어 주소별 구성요소 유효성 검사 결과는 |
geocodeGranularity |
경우에 따라 위의 |
addressComplete |
해결되지 않은 토큰이 없거나 예기치 않거나 누락된 주소 구성요소가 없는 경우 주소가 완전한 것으로 간주됩니다. 설정되지 않은 경우 값이 |
hasUnconfirmedComponents |
하나 이상의 주소 구성요소를 분류하거나 확인할 수 없습니다. 자세한 내용은 |
hasInferredComponents |
입력에 없는 주소 구성요소가 하나 이상 추론 (추가)되었습니다. 자세한 내용은 |
hasReplacedComponents |
하나 이상의 주소 구성요소가 교체되었습니다. 자세한 내용은 |
세부사항
주소 또는 지오코드가 가질 수 있는 다양한 세부사항입니다. 주소의 세부사항을 나타내는 데 사용되는 경우 이 값은 주소가 우편 목적지를 얼마나 세분화하여 식별하는지를 나타냅니다. 예: '123 Main Street, Redwood City, CA, 94061'과 같은 주소 'Redwood City, CA, 94061'와 같은 형식으로 PREMISE
를 식별합니다. LOCALITY
를 식별합니다. 그러나 '중앙로 123'에 대한 지오코드를 찾을 수 없는 경우 레드우드 시티에서는 주소가 더 세분화되어 있더라도 반환된 지오코드의 세부사항이 LOCALITY
일 수 있습니다.
열거형 | |
---|---|
GRANULARITY_UNSPECIFIED |
기본값 이 값은 사용되지 않습니다. |
SUB_PREMISE |
아파트와 같은 건물 수준 미만의 결과입니다. |
PREMISE |
건물 수준 결과입니다. |
PREMISE_PROXIMITY |
주소의 건물 수준 위치에 가까운 지오코드입니다. |
BLOCK |
주소 또는 지오코드가 블록을 나타냅니다. 일본과 같이 블록 수준 주소가 있는 리전에서만 사용됩니다. |
ROUTE |
지오코드 또는 주소는 거리, 도로 또는 고속도로와 같이 경로에 따라 세분화됩니다. |
OTHER |
기타 모든 세분화 항목은 결과물이 아니므로 함께 버케팅됩니다. |
주소
후처리된 주소의 세부정보입니다. 후처리에는 주소의 맞춤법이 틀린 부분 수정, 잘못된 부분 교체, 누락된 부분 추론이 포함됩니다.
JSON 표현 |
---|
{ "formattedAddress": string, "postalAddress": { object ( |
필드 | |
---|---|
formattedAddress |
후처리된 주소로, 주소가 위치한 지역의 주소 형식 규칙에 따라 한 줄 형식으로 형식이 지정됩니다. |
postalAddress |
우편 주소로 표시되는 후처리 주소입니다. |
addressComponents[] |
순서가 지정되지 않은 목록입니다. 유효성 검사 정보와 함께 형식이 지정되고 수정된 주소의 개별 주소 구성요소입니다. 이를 통해 개별 구성요소의 유효성 검사 상태에 관한 정보를 확인할 수 있습니다. 주소 구성요소는 특정 방식으로 정렬되지 않습니다. 목록에 있는 주소 구성요소의 순서를 가정하지 마세요. |
missingComponentTypes[] |
올바른 형식의 우편 주소에 있을 것으로 예상되었지만 입력 데이터에서 찾을 수 없고 추론할 수 없는 구성요소 유형입니다. 이 유형의 구성요소는 |
unconfirmedComponentTypes[] |
|
unresolvedTokens[] |
결정할 수 없는 입력 토큰이 있습니다. 주소의 유효한 부분으로 인식되지 않은 입력일 수 있습니다. 예를 들어 '123235253253 Main St, San Francisco, CA, 94105'와 같은 입력에서 확인되지 않은 토큰은 유효한 번지수가 아니므로 |
AddressComponent
도로, 시 또는 주와 같은 주소 구성요소를 나타냅니다.
JSON 표현 |
---|
{ "componentName": { object ( |
필드 | |
---|---|
componentName |
이 구성요소의 이름입니다. |
componentType |
주소 구성요소의 유형입니다. 가능한 유형 목록은 표 2: 장소 서비스에서 반환하는 추가 유형을 참고하세요. |
confirmationLevel |
구성요소가 올바른지에 대한 확실성 수준을 나타냅니다. |
inferred |
구성요소가 입력의 일부가 아니지만 주소 위치로 추론했으며 전체 주소에 제공되어야 한다고 나타냅니다. |
spellCorrected |
구성요소 이름의 맞춤법 오류에 대한 수정을 나타냅니다. API는 '센터'를 변경할 때와 같이 한 맞춤법 변형에서 다른 철자로 변경되는 변경사항에 대해 항상 표시하지는 않습니다. '가운데'로 설정합니다. 또한 'Amphitheater Pkwy'를 변경할 때와 같이 일반적인 맞춤법 오류를 항상 표시하는 것은 아닙니다. 'Amphitheatre Pkwy'로 바꾸었습니다. |
replaced |
구성요소의 이름이 완전히 다른 이름으로 대체되었음을 나타냅니다. 예를 들어 잘못된 우편번호가 주소에 맞는 우편번호로 바뀌었을 수 있습니다. 외형적인 변경사항은 아니며, 입력 구성요소가 다른 구성요소로 변경되었습니다. |
unexpected |
지정된 지역의 우편 주소에 표시되지 않을 것으로 예상되는 주소 구성요소를 나타냅니다. 데이터가 입력의 일부였기 때문에 보관했습니다. |
ComponentName
구성요소 이름에 대한 래퍼입니다.
JSON 표현 |
---|
{ "text": string, "languageCode": string } |
필드 | |
---|---|
text |
이름 텍스트입니다. 예: '5번가' '1253' 검색 제공합니다. |
languageCode |
BCP-47 언어 코드입니다. 구성요소 이름이 번지와 같은 언어와 연결되지 않은 경우에는 표시되지 않습니다. |
ConfirmationLevel
확인 수준에 사용할 수 있는 다양한 값입니다.
열거형 | |
---|---|
CONFIRMATION_LEVEL_UNSPECIFIED |
기본값 이 값은 사용되지 않습니다. |
CONFIRMED |
이 구성 요소가 존재하고 주소의 나머지 부분에서 의미가 있음을 확인할 수 있었습니다. |
UNCONFIRMED_BUT_PLAUSIBLE |
이 구성요소는 확인할 수 없으나 존재할 가능성이 있습니다. 예를 들어 특정 번지수를 알 수 없는 도로의 알려진 유효한 번호 범위 내에 있는 번지입니다. |
UNCONFIRMED_AND_SUSPICIOUS |
이 구성요소는 확인되지 않았으며 잘못되었을 가능성이 있습니다. 예를 들어 주소의 나머지 부분과 맞지 않는 동네가 있습니다. |
지오코드
입력이 지오코딩된 장소에 대한 정보를 포함합니다.
JSON 표현 |
---|
{ "location": { object ( |
필드 | |
---|---|
location |
입력의 지오코딩된 위치입니다. 주소, 위도/경도 좌표 또는 플러스 코드보다 장소 ID를 사용하는 것이 더 좋습니다. 경로를 지정하거나 운전 경로를 계산할 때 좌표를 사용하면 항상 해당 좌표에 가장 가까운 도로에 지점이 맞춰집니다. 이 도로는 목적지로 빠르고 안전하게 연결되는 도로가 아니며 건물의 접근 지점 근처에 있지 않을 수도 있습니다. 또한 위치가 역 지오코딩되는 경우 반환된 주소가 원래 주소와 일치하지 않을 수도 있습니다. |
plusCode |
|
bounds |
지오코딩된 장소의 경계입니다. |
featureSizeMeters |
지오코딩된 장소의 크기(미터) 이 값은 지오코딩된 위치의 대략적인 정도를 측정하는 또 다른 방법이지만 의미론적 의미가 아닌 실제 크기로 측정됩니다. |
placeId |
이 입력이 지오코딩되는 장소의 PlaceID입니다. 장소 ID에 대한 자세한 내용은 여기를 참고하세요. |
placeTypes[] |
입력이 지오코딩된 장소의 유형입니다. 예를 들면 |
LatLng
위도/경도 쌍을 나타내는 객체로 위도(도)와 경도(도)를 나타내는 double의 쌍으로 표현됩니다. 달리 명시되지 않는 한 이 객체는 WGS84 표준을 준수해야 합니다. 값은 정규화된 범위 내에 있어야 합니다.
JSON 표현 |
---|
{ "latitude": number, "longitude": number } |
필드 | |
---|---|
latitude |
위도입니다. 범위는 [-90.0, +90.0]입니다. |
longitude |
경도입니다. 범위는 [-180.0, +180.0]입니다. |
PlusCode
Plus Code (http://plus.codes)는 위치 참조로서, 14mx14m (도의 1/8000)을 정의하는 글로벌 코드와 접두어를 참조 위치로 대체하는 복합 코드입니다.
JSON 표현 |
---|
{ "globalCode": string, "compoundCode": string } |
필드 | |
---|---|
globalCode |
'9FWM33GV+HQ'와 같은 장소의 전역 (전체) 코드로, 1/8000x1/8000도 영역 (~14x14미터)을 나타냅니다. |
compoundCode |
장소의 복합 코드(예: '33GV+HQ, Ramberg, Norway'). 글로벌 코드의 접미사를 포함하고 접두사를 참조 항목의 형식이 지정된 이름으로 대체합니다. |
표시 영역
대각선 반대쪽에 있는 두 개의 low
및 high
지점으로 표시되는 위도-경도 표시 영역입니다. 표시 영역은 경계가 포함된 닫힌 영역으로 간주됩니다. 위도 경계는 -90도 이상 90도 이하로 설정할 수 있으며, 경도는 -180도 이상 180도 이하로 설정할 수 있습니다. 다양한 사례는 다음과 같습니다.
low
=high
인 경우 표시 영역은 단일 점으로 구성됩니다.low.longitude
>high.longitude
인 경우 경도 범위가 반전됩니다 (표시 영역이 180도 경도선을 교차함).low.longitude
= -180도이고high.longitude
= 180도이면 표시 영역에 모든 경도가 포함됩니다.low.longitude
= 180도이고high.longitude
= -180도인 경우 경도 범위는 비어 있습니다.low.latitude
>high.latitude
, 위도 범위가 비어 있습니다.
low
과 high
를 모두 채워야 하며, 표시된 상자는 (위 정의에 명시된 대로) 비워둘 수 없습니다. 표시 영역이 비어 있으면 오류가 발생합니다.
예를 들어 이 표시 영역은 뉴욕시를 완전히 둘러쌉니다.
{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }
JSON 표현 |
---|
{ "low": { object ( |
필드 | |
---|---|
low |
필수 항목입니다. 표시 영역의 낮은 지점입니다. |
high |
필수 항목입니다. 표시 영역의 높은 지점입니다. |
AddressMetadata
주소의 메타데이터입니다. Address Validation API로 전송되는 모든 주소에 metadata
가 완전히 채워지는 것은 아닙니다.
JSON 표현 |
---|
{ "business": boolean, "poBox": boolean, "residential": boolean } |
필드 | |
---|---|
business |
비즈니스의 주소임을 나타냅니다. 설정되지 않은 경우 값을 알 수 없음을 나타냅니다. |
poBox |
사서함의 주소를 나타냅니다. 설정되지 않은 경우 값을 알 수 없음을 나타냅니다. |
residential |
이 주소가 거주지 주소임을 나타냅니다. 설정되지 않은 경우 값을 알 수 없음을 나타냅니다. |
UspsData
주소의 USPS 데이터입니다. Address Validation API로 전송되는 모든 미국 또는 푸에르토리코 주소에 uspsData
주소가 완전히 입력되지 않을 수도 있습니다. uspsData를 응답의 기본 부분으로 활용하는 경우 응답에 백업 주소 입력란을 통합하는 것이 좋습니다.
JSON 표현 |
---|
{
"standardizedAddress": {
object ( |
필드 | |
---|---|
standardizedAddress |
USPS 표준 주소입니다. |
deliveryPointCode |
2자리 배송 지점 코드 |
deliveryPointCheckDigit |
배송 지점 검사 숫자입니다. 이 번호는 기계 스캔으로 스캔한 메일의 delivery_point_barcode 끝에 추가됩니다. delivery_point_barcode, deliveryPointCheckDigit, postal code, ZIP+4를 모두 더하면 10으로 나눌 수 있는 숫자가 생성됩니다. |
dpvConfirmation |
DPV 확인을 위해 사용할 수 있는 값입니다. 단일 문자를 반환하거나 값을 반환하지 않습니다.
|
dpvFootnote |
배송 지점 확인의 각주입니다. 여러 개의 각주를 동일한 문자열에 연결할 수 있습니다.
|
dpvCmra |
주소가 고객 대신 메일을 수신하는 개인 비즈니스인 CMRA (상업용 우편물 수신소)인지 여부를 나타냅니다. 단일 문자를 반환합니다.
|
dpvVacant |
비어 있는 장소인가요? 단일 문자를 반환합니다.
|
dpvNoStat |
이 주소는 통계 없음 주소인가요, 아니면 활성화된 주소인가요? 지속적으로 점유되지 않는 주소 또는 USPS가 서비스를 제공하지 않는 주소: 단일 문자를 반환합니다.
|
dpvNoStatReasonCode |
NoStat 유형을 나타냅니다. 이유 코드를 int로 반환합니다.
|
dpvDrop |
플래그는 메일이 사이트의 단일 수신자로 전송되었음을 나타냅니다. 단일 문자를 반환합니다.
|
dpvThrowback |
우편물이 상세 주소로 배달되지 않았음을 나타냅니다. 단일 문자를 반환합니다.
|
dpvNonDeliveryDays |
플래그는 매일 메일 전송이 수행되지 않음을 나타냅니다. 단일 문자를 반환합니다.
|
dpvNonDeliveryDaysValues |
미게재 기간을 식별하는 정수입니다. 비트 플래그를 사용하여 조사할 수 있습니다. 0x40 – 일요일은 미게재 날짜 0x20, 월요일은 미게재 날짜 0x10, 화요일은 미게재 날짜 0x08, 수요일은 미게재 날짜 0x04, 목요일은 미게재 날짜 0x02, 금요일은 미게재 날짜 0x1일, 0x02는 미게재 날짜입니다. 0 |
dpvNoSecureLocation |
깃발은 문에 접근할 수 있음을 나타내지만, 보안 문제로 인해 택배물을 두고 갈 수 없습니다. 단일 문자를 반환합니다.
|
dpvPbsa |
주소가 PBSA 레코드와 일치했음을 나타냅니다. 단일 문자를 반환합니다.
|
dpvDoorNotAccessible |
깃발은 USPS가 우편물을 배달할 수 없는 지역의 주소를 나타냅니다. 단일 문자를 반환합니다.
|
dpvEnhancedDeliveryCode |
주소에 대해 2개 이상의 DPV 반환 코드가 유효함을 나타냅니다. 단일 문자를 반환합니다.
|
carrierRoute |
운송업체 경로 코드입니다. 1자로 된 접두사와 3자리 경로 지정자로 구성된 4자리 코드입니다. 프리픽스:
|
carrierRouteIndicator |
운송업체 경로 비율 정렬 표시기입니다. |
ewsNoMatch |
배송 주소는 일치 가능하지만 EWS 파일에 정확한 일치 항목이 곧 제공된다고 표시됩니다. |
postOfficeCity |
기본 우체국 도시입니다. |
postOfficeState |
기본 우체국 주입니다. |
abbreviatedCity |
도시 약어입니다. |
fipsCountyCode |
FIPS 카운티 코드입니다. |
county |
구/군 이름입니다. |
elotNumber |
향상된 여행 노선 (eLOT) 번호입니다. |
elotFlag |
eLOT 오름차순/내림차순 플래그 (A/D). |
lacsLinkReturnCode |
LACSLink 반환 코드입니다. |
lacsLinkIndicator |
LACSLink 표시기 |
poBoxOnlyPostalCode |
사서함 전용 우편번호입니다. |
suitelinkFootnote |
거리 또는 고층 건물의 기록부터 건물 정보와 일치하는 각주 일치하는 업체 이름이 발견되면 보조 번호가 반환됩니다.
|
pmbDesignator |
PMB (Private Mail Box) 단위 지정자. |
pmbNumber |
PMB(Private Mail Box)(개인 메일함) 번호 |
addressRecordType |
입력 주소와 일치하는 주소 레코드의 유형입니다.
|
defaultAddress |
기본 주소가 발견되었지만 더 구체적인 주소가 존재함을 나타냅니다. |
errorMessage |
USPS 데이터 검색에 대한 오류 메시지입니다. 인위적으로 생성된 주소가 감지되어 USPS 처리가 정지되면 채워집니다. 이 오류가 있으면 USPS 데이터 필드가 채워지지 않을 수 있습니다. |
cassProcessed |
요청이 CASS 처리되었음을 나타내는 표시기입니다. |
UspsAddress
미국 주소의 USPS 표현
JSON 표현 |
---|
{ "firstAddressLine": string, "firm": string, "secondAddressLine": string, "urbanization": string, "cityStateZipAddressLine": string, "city": string, "state": string, "zipCode": string, "zipCodeExtension": string } |
필드 | |
---|---|
firstAddressLine |
첫 번째 주소 입력란입니다. |
firm |
회사 이름. |
secondAddressLine |
두 번째 주소 입력란입니다. |
urbanization |
푸에르토리코 도시명입니다. |
cityStateZipAddressLine |
시/도 + 우편번호 |
city |
도시 이름입니다. |
state |
2자리 주 코드입니다. |
zipCode |
우편번호 예: 10009입니다. |
zipCodeExtension |
4자리 우편번호 확장자 예: 5023입니다. |