Method: validateAddress

{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}

integer

PostalAddress의 스키마 버전입니다. 0 이외의 값이 있으면 API에서 INVALID_ARGUMENT 오류를 반환합니다.

string

선택사항입니다. 주소에 해당하는 국가/지역의 CLDR 지역 코드입니다. 자세한 내용은 https://cldr.unicode.org/ 및 https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html을 참조하세요. 예: 스위스의 경우 'CH'. 지역 코드를 제공하지 않으면 주소에서 유추됩니다. 최상의 성능을 위해 지역 코드를 알고 있는 경우 포함하는 것이 좋습니다. 리전이 일관되지 않거나 반복되면 성능이 저하될 수 있습니다. 예를 들어 addressLines에 이미 리전이 포함되어 있는 경우 이 필드에 리전 코드를 다시 제공하지 마세요. 지원되는 지역은 FAQ에서 확인할 수 있습니다.

string

입력 주소의 언어 코드는 향후 사용을 위해 예약되어 있으므로 지금은 무시됩니다. API는 주소가 위치한 곳의 적절한 언어로 주소를 반환합니다.

string

선택사항입니다. 주소의 우편번호입니다. 모든 국가에서 우편번호를 사용하거나 우편번호를 지정해야 하는 것은 아니지만, 우편번호가 사용되는 경우 주소의 다른 부분에 대한 추가 확인 (예: 미국의 경우 주/우편번호 확인)이 트리거될 수 있습니다.

string

선택사항입니다. 국가별 추가 정렬 코드입니다. 대부분의 리전에서 사용되지 않습니다. 사용되는 경우 값은 선택적으로 뒤에 숫자가 오는 'CEDEX'와 같은 문자열 (예: 'CEDEX 7')이거나 '부문 코드' (자메이카), '배달 지역 표시기' (말라위) 또는 '우체국 표시기' (예: 코트디부아르)를 나타내는 숫자만 나타냅니다.

string

선택사항입니다. 국가 또는 지역의 주소에 사용되는 최상위 행정 구역 단위입니다. 예를 들어 주, 도, 주 또는 현이 될 수 있습니다. 특히 스페인의 경우 자치 공동체가 아닌 주입니다 (예: '카탈로니아'가 아니라 '바르셀로나'). 많은 국가에서 우편 주소에 행정 구역을 사용하지 않습니다. 예를 들어 스위스에서는 이 값을 비워두어야 합니다.

string

선택사항입니다. 일반적으로 주소의 시/군/구 부분을 나타냅니다. 예: 미국 도시, IT 코뮌, 영국 우체국 지역이 잘 정의되지 않거나 이 구조에 잘 맞지 않는 경우 지역을 비워두고 addressLines를 사용합니다.

string

선택사항입니다. 주소의 하위 지역입니다. 예를 들어 인근 지역, 자치구, 구일 수 있습니다.

string

필수 항목입니다. 주소의 하위 수준을 설명하는 구조화되지 않은 주소 입력란입니다.

addressLines의 값에는 유형 정보가 없으며 단일 필드에 여러 값이 포함될 수 있으므로 (예: 'Austin, TX') 행 순서가 명확해야 합니다. 주소 입력란 순서는 주소의 국가/지역의 '봉투 순서'여야 합니다.

주소에 허용되는 최소 구조 표현은 addressLines에 배치된 모든 정보로 구성됩니다. regionCode를 제공하지 않으면 주소 입력란에서 지역이 유추됩니다.

주소의 어느 부분이 지역 또는 행정 구역이어야 하는지 추측하는 대신, addressLines만 포함된 주소를 만든 다음 지오코딩하는 것이 전혀 구조화되지 않은 주소를 처리하는 권장 방법입니다.

string

이 필드는 설정하지 마세요. Address Validation API에서는 현재 이 API를 사용하지 않습니다. 현재는 API가 이 필드가 설정된 요청을 거부하지 않지만 정보가 삭제되고 응답에 반환되지 않습니다.

string

이 필드는 설정하지 마세요. Address Validation API에서는 현재 이 API를 사용하지 않습니다. 현재는 API가 이 필드가 설정된 요청을 거부하지 않지만 정보가 삭제되고 응답에 반환되지 않습니다.

{
  "returnEnglishLatinAddress": boolean
}

boolean

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

{
  "verdict": {
    object (Verdict)
  },
  "address": {
    object (Address)
  },
  "geocode": {
    object (Geocode)
  },
  "metadata": {
    object (AddressMetadata)
  },
  "uspsData": {
    object (UspsData)
  },
  "englishLatinAddress": {
    object (Address)
  }
}

object (Verdict)

전체 확인 결과 플래그

object (Address)

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

object (Geocode)

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

object (AddressMetadata)

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

object (UspsData)

USPS에서 제공한 추가 배송 여부 플래그입니다. US 및 PR 리전에서만 제공됩니다.

object (Address)

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

영어로 번역된 주소입니다.

번역된 주소는 API 입력으로 재사용할 수 없습니다. 이 서비스는 사용자가 자신의 모국어를 사용하여 원래 제공된 주소의 유효성 검사를 확인하거나 거부할 수 있도록 합니다.

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

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

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

{
  "inputGranularity": enum (Granularity),
  "validationGranularity": enum (Granularity),
  "geocodeGranularity": enum (Granularity),
  "addressComplete": boolean,
  "hasUnconfirmedComponents": boolean,
  "hasInferredComponents": boolean,
  "hasReplacedComponents": boolean
}

enum (Granularity)

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

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

enum (Granularity)

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

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

enum (Granularity)

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

경우에 따라 위의 validationGranularity와 다를 수 있습니다. 예를 들어 데이터베이스에 아파트 동호수의 존재는 기록되지만 대형 아파트 단지 내 아파트의 정확한 위치는 없을 수 있습니다. 이 경우 validationGranularity은 SUB_PREMISE이지만 geocodeGranularity는 PREMISE입니다.

boolean

해결되지 않은 토큰이나 예기치 않았거나 누락된 주소 구성요소가 없으면 주소는 완전한 것으로 간주됩니다. 설정되지 않은 경우 값이 false임을 나타냅니다. 자세한 내용은 missingComponentTypes, unresolvedTokens 또는 unexpected 필드를 참고하세요.

boolean

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

boolean

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

boolean

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

{
  "formattedAddress": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "addressComponents": [
    {
      object (AddressComponent)
    }
  ],
  "missingComponentTypes": [
    string
  ],
  "unconfirmedComponentTypes": [
    string
  ],
  "unresolvedTokens": [
    string
  ]
}

string

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

object (PostalAddress)

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

object (AddressComponent)

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

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

string

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

string

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

string

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

{
  "componentName": {
    object (ComponentName)
  },
  "componentType": string,
  "confirmationLevel": enum (ConfirmationLevel),
  "inferred": boolean,
  "spellCorrected": boolean,
  "replaced": boolean,
  "unexpected": boolean
}

object (ComponentName)

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

string

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

enum (ConfirmationLevel)

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

boolean

구성요소가 입력의 일부가 아님을 나타내지만, Google에서 주소 위치로 추론했으며 전체 주소가 제공되어야 한다고 생각합니다.

boolean

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

boolean

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

boolean

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

{
  "text": string,
  "languageCode": string
}

string

이름 텍스트입니다. 예를 들어 '5번가'는 도로명을, '1253'은 번지를 나타냅니다.

string

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

{
  "location": {
    object (LatLng)
  },
  "plusCode": {
    object (PlusCode)
  },
  "bounds": {
    object (Viewport)
  },
  "featureSizeMeters": number,
  "placeId": string,
  "placeTypes": [
    string
  ]
}

object (LatLng)

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

주소, 위도/경도 좌표 또는 플러스 코드보다 장소 ID를 사용하는 것이 좋습니다. 경로를 안내하거나 운전경로를 계산할 때 좌표를 사용하면 항상 해당 좌표에 가장 가까운 도로에 지점이 맞춰집니다. 목적지까지 빠르고 안전하게 연결되는 도로일 수 없으며 장소의 접근점과 가깝지 않을 수 있습니다. 또한 위치가 역 지오코딩되는 경우 반환된 주소가 원래 주소와 일치한다는 보장은 없습니다.

object (PlusCode)

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

object (Viewport)

지오코딩된 장소의 경계.

number

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

string

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

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

string

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

{
  "latitude": number,
  "longitude": number
}

number

위도입니다. 범위는 [-90.0, +90.0]입니다.

number

경도입니다. 범위는 [-180.0, +180.0]여야 합니다.

{
  "globalCode": string,
  "compoundCode": string
}

string

장소의 전역(전체) 코드(예: '9FWM33GV+HQ')로, 1/8000x1/8000도 영역(약 14x14미터)을 나타냅니다.

string

장소의 복합 코드(예: '33GV+HQ, Ramberg, Korean')입니다. 전역 코드의 접미사가 포함되며 접두사를 참조 항목의 형식이 지정된 이름으로 대체합니다.

{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}

object (LatLng)

필수 항목입니다. 표시 영역의 최저점입니다.

object (LatLng)

필수 항목입니다. 표시 영역의 최고점입니다.

{
  "business": boolean,
  "poBox": boolean,
  "residential": boolean
}

boolean

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

boolean

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

boolean

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

{
  "standardizedAddress": {
    object (UspsAddress)
  },
  "deliveryPointCode": string,
  "deliveryPointCheckDigit": string,
  "dpvConfirmation": string,
  "dpvFootnote": string,
  "dpvCmra": string,
  "dpvVacant": string,
  "dpvNoStat": string,
  "dpvNoStatReasonCode": integer,
  "dpvDrop": string,
  "dpvThrowback": string,
  "dpvNonDeliveryDays": string,
  "dpvNonDeliveryDaysValues": integer,
  "dpvNoSecureLocation": string,
  "dpvPbsa": string,
  "dpvDoorNotAccessible": string,
  "dpvEnhancedDeliveryCode": string,
  "carrierRoute": string,
  "carrierRouteIndicator": string,
  "ewsNoMatch": boolean,
  "postOfficeCity": string,
  "postOfficeState": string,
  "abbreviatedCity": string,
  "fipsCountyCode": string,
  "county": string,
  "elotNumber": string,
  "elotFlag": string,
  "lacsLinkReturnCode": string,
  "lacsLinkIndicator": string,
  "poBoxOnlyPostalCode": boolean,
  "suitelinkFootnote": string,
  "pmbDesignator": string,
  "pmbNumber": string,
  "addressRecordType": string,
  "defaultAddress": boolean,
  "errorMessage": string,
  "cassProcessed": boolean
}

object (UspsAddress)

USPS 표준 주소

string

2자리 배송지 코드

string

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

string

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

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

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: 후행 알파를 삭제하여 일치하는 기본 번호

string

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

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

string

빈 장소입니까? 단일 문자를 반환합니다.

• Y: 주소가 비어 있습니다.
• N: 주소가 비어 있지 않습니다.

string

이 주소는 고정 주소인가요, 아니면 사용 중인 주소인가요? 통계 주소는 지속적으로 사용되지 않거나 USPS에서 서비스를 제공하지 않는 주소를 의미합니다. 단일 문자를 반환합니다.

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

integer

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

• 1: IDA (내부 드롭 주소) – USPS에서 직접 우편물을 받지는 않지만 서비스를 제공하는 보관소 주소로 전달되는 주소입니다.
• 2: CDS - 아직 배송할 수 없는 주소입니다. 로트와 기본 번호가 결정되었지만 숙박 인원에 대한 구조가 아직 없는 새 구역을 예로 들 수 있습니다.
• 3: 충돌 - 실제 DPV 확인이 아닌 주소
• 4: CMZ (대학, 군사 및 기타 유형) - ZIP + USPS가 데이터에 통합한 기록 4개
• 5: 일반 - 배송받을 수 없는 주소이며 배송 가능한 주소로 간주되지 않음을 나타냅니다.
• 6: 보조 필수 - 주소에 보조 정보가 필요합니다.

string

플래그는 사이트에서 하나의 수신처로 메일이 전달되었음을 나타냅니다. 단일 문자를 반환합니다.

• Y: 메일이 사이트에 있는 하나의 수신처로 전달됩니다.
• N: 메일이 사이트의 단일 수신처로 전송되지 않습니다.

string

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

• Y: 우편물이 상세 주소로 전달되지 않습니다.
• N: 우편물이 상세 주소로 배달됩니다.

string

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

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

integer

미게재 일수를 식별하는 정수입니다. 비트 플래그를 사용하여 심문할 수 있습니다. 0x40 – 일요일은 미게재일 0x20, 월요일은 미게재일 0x10, 화요일은 미게재일 0x08, 수요일은 미게재일 0x04, 목요일은 미게재일, 0x02 – 금요일은 미게재일, 금요일은 미게재일 0

string

플래그는 출입구에 접근할 수 있음을 나타내지만 보안 문제로 인해 택배를 맡기지 않을 것임을 나타냅니다. 단일 문자를 반환합니다.

• Y: 보안 문제로 인해 택배를 맡길 수 없습니다.
• N: 보안 문제로 인해 택배가 배송되지 않을 것임을 나타내는 정보가 없습니다.

string

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

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

string

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

• Y: 문에 접근할 수 없습니다.
• N: 문에 접근할 수 없다고 표시되지 않습니다.

string

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

• Y: 기본 전화번호와 보조 번호의 주소가 DPV로 확인되었습니다.
• N: 기본 및 보조 번호 정보가 DPV 확인에 실패했습니다.
• S: 기본 번호에 대해서만 주소가 DPV가 확인되었고, 보조 번호 정보는 확인되지 않았습니다. 또는 기본 번호의 후행 알파 1개가 삭제되어 DPV 일치 및 보조 정보가 필요합니다.
• D: 기본 번호에 대해서만 주소가 DPV 확인되었으며 보조 번호 정보가 누락되었습니다.
• R: 주소가 확인되었으나 팬텀 경로 R777 및 R779에 할당되었으며 USPS 배송이 제공되지 않았습니다.

string

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

프리픽스:

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

string

운송업체 노선 요율 정렬 표시기입니다.

boolean

배송지 주소는 일치하지만 EWS 파일에 따르면 정확하게 일치하는 주소가 곧 제공될 예정입니다.

string

주 우체국 도시입니다.

string

기본 우체국 주/도입니다.

string

도시 이름을 축약하여 사용합니다.

string

FIPS 국가 코드입니다.

string

구/군 이름

string

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

string

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

string

LACSLink 반환 코드입니다.

string

LACSLink 표시기입니다.

boolean

사서함은 우편번호에만 사용할 수 있습니다.

string

도로 또는 고층 레코드와 스위트 정보를 매칭하는 각주 일치하는 비즈니스 이름이 있으면 보조 번호가 반환됩니다.

• A: SuiteLink 레코드가 일치하고 비즈니스 주소가 개선되었습니다.
• 00: 일치하는 항목이 없습니다. 비즈니스 주소가 개선되지 않았습니다.

string

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

string

PMB (개인 사서함) 번호

string

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

• F: FIRM입니다. 이것은 주소에 대해 사용할 수 있는 가장 정밀한 일치 수준인 Firm Record와 일치합니다.
• G: 일반 배송. 일반 게재 기록과 일치합니다.
• H: 건물 / 아파트. 이는 건물 또는 아파트 기록과 일치합니다.
• P: 우편함. 이것은 사서함과 일치합니다.
• R: RURAL ROUTE 또는 HIGHWAY CONTRACT: 시골 경로 또는 고속도로 계약 기록과 일치합니다. 둘 다 연결된 박스 번호 범위가 있을 수 있습니다.
• S: STREET RECORD: 유효한 기본 숫자 범위를 포함하는 스트리트 레코드와 일치합니다.

boolean

기본 주소를 찾았지만 더 구체적인 주소가 있다는 표시기입니다.

string

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

이 오류가 있는 경우 USPS 데이터 필드가 채워지지 않을 수 있습니다.

boolean

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

{
  "firstAddressLine": string,
  "firm": string,
  "secondAddressLine": string,
  "urbanization": string,
  "cityStateZipAddressLine": string,
  "city": string,
  "state": string,
  "zipCode": string,
  "zipCodeExtension": string
}

string

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

string

회사명

string

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

string

푸에르토리코 도시화 이름

string

시/도 + 우편번호

string

도시 이름입니다.

string

2자리 상태 코드입니다.

string

우편번호(예: 10009)

string

4자리 우편번호 확장자(예: 5023)