미국 주소 처리

이 문서에서는 미국과 관련된 주소 유효성 검사를 다룹니다.

워크플로의 USPS 데이터

미국의 주소를 확인할 때 Address Validation API 는 반환의 uspsData 부분을 채울 수도 있습니다.

이 객체는 항상 채워지는 것이 아니므로 이 속성을 주소를 확인하는 유일한 수단으로 사용해서는 안 되며 대신 평결 및 주소 구성요소를 시스템에 통합해야 합니다.

USPS 배송 지점 확인 (DPV)

uspsData 응답의 일부로 dpvConfirmation 필드는 USPS에서 제공된 주소로 배송할 수 있는지 알려주는 단일 문자를 반환합니다.

이 필드를 사용하여 다음을 확인할 수 있습니다.

  • 주소 유효성
  • 주소에 하위 구내 번호가 누락된 경우
  • 하위 구내 번호가 USPS 데이터 시스템에 없는 경우

서비스는 4개의 dpvConfirmation 값 중 하나를 반환하거나 dpvConfirmation 값을 전혀 반환하지 않습니다. 아래 표는 가능한 5가지 결과 각각에 대해 로직에서 사용해야 하는 권장 동작을 보여줍니다. 이 로직에 관한 자세한 내용은 워크플로 개요의 유효성 검사 로직 빌드를 참고하세요.

값

행동

설명

N

또는 비어 있음

주소 수정

주소가 DPV 확인되지 않았습니다.

즉, USPS에서 입력된 도로 (경로)에 있는 입력된 구내 번호 를 인식하지 못하며 해당 주소로 배송할 수 없습니다.

D

주소 수정

주소가 기본 번호에 대해서만 DPV 확인되었으며 보조 번호 정보가 누락되었습니다.
즉, 입력된 구내 번호가 입력된 도로에 있지만 완전히 확인되고 배송 가능한 주소에 도달하려면 유효한 하위 구내 번호도 제공해야 합니다.
즉, 입력에서 하위 구내가 누락되었습니다.

S

주소 확인

주소가 기본 번호에 대해서만 DPV 확인되었으며 보조 번호 정보가 있지만 확인되지 않았습니다.

즉, 입력된 구내 번호가 입력된 경로에 있지만 USPS에 따르면 제공된 하위 구내가 해당 건물 내에 없습니다.

Y

주소 수락

주소가 기본 번호 및 보조 번호에 대해 DPV 확인되었습니다.

즉, 주소는 하위 구내 번호(해당하는 경우)를 포함하여 USPS에서 완전히 배송할 수 있습니다.

이 섹션의 나머지 부분에서는 DPV 코드를 사용하는 실제 시나리오를 설명합니다.

DPV N 예시 - 주소 수정

이 예시에서는 유효한 주소에 존재하지 않는 도로 번호를 사용합니다.

  • 입력된 주소: 12 Amphitheatre Parkway, Mountain View, CA, 94043
  • 리전: 미국
  • dpvConfirmation 필드가 N을 반환합니다.

이는 이 경로에 이 구내 번호가 존재하지 않는다는 매우 강력한 신호 입니다. 다른 문제가 있는 주소와 마찬가지로 시스템에서 사용자에게 수정을 요청해야 합니다.

DPV D 예시 - 주소 수정

이 예시에서는 뉴욕의 Google 사무실을 사용하지만 주소의 필수 부분인 하위 구내가 포함되어 있지 않습니다. 하위 구내 정보가 없는 데모의 주소를 사용하여 이를 확인할 수 있습니다.

  • 입력된 주소: 111 8th Avenue, New York, NY, 10011
  • 리전: 미국
  • dpvConfirmation 필드가 D를 반환합니다.

이는 입력에서 하위 구내가 누락되었음을 확인합니다. DPV Y에 도달하려면 유효한 하위 구내가 입력의 일부로 포함되어야 합니다. 예를 들어 유효한 하위 구내 FL 4 (4층)를 포함하여 dpvConfirmation 값 Y를 얻을 수 있습니다.

DPV S 예시 - 주소 확인

이 예시에서는 건물 내에 존재하지 않는 하위 구내 번호를 사용합니다.

  • 입력된 주소: 1600 Amphitheatre Parkway, Suite 101, Mountain View, CA, 94043
  • 리전: 미국
  • dpvConfirmation 필드가 S를 반환합니다.

이는 1600 Amphitheatre Parkway가 우편물을 받을 수 있는 주소로 존재하지만 하위 구내 Ste 101은 주소의 유효한 부분이 아님을 나타냅니다. 시스템에서 이 정보를 사용자에게 확인하고 수정 기회를 제공해야 합니다.

DPV Y 예시 - 주소 수락

이 예시에서는 Mountain View, CA의 Googleplex 주소를 알려진 고품질 주소로 사용합니다.

  • 입력된 주소: 1600 Amphitheatre Parkway, Mountain View, CA, 94043
  • 리전: 미국
  • dpvConfirmation 필드가 Y를 반환합니다.

주소는 USPS에서 완전히 배송할 수 있습니다. 이를 통해 API가 양질의 주소를 반환했다는 확신을 가질 수 있으며 제공된 대로 사용할 수 있습니다.

참고: DPV는 Address Validation API가 맞춤법 수정과 같은 입력을 변경했는지 여부를 나타내지 않습니다.

미국 주소의 보안 메시지

이 섹션에서는 인위적으로 생성된 주소에 대해 USPS 데이터에 제공된 보안 플래그를 다룹니다. 이 보안 조치는 제출된 주소가 합법적으로 획득되지 않고 인위적으로 생성된 것으로 보이는 경우를 감지하여 주소 목록의 인위적인 생성을 방지하도록 설계되었습니다. 이는 매우 드물게 발생합니다.

USPS에서 인위적으로 생성된 주소를 식별하면 응답의 uspsData 속성의 errorMessage 필드에 문제를 설명하는 오류 메시지가 포함됩니다. 예를 들면 다음과 같습니다.

AMS API processing was terminated due to the detection of what is determined to
be an artificially created address. No address beyond this point has been
validated and/or processed. If you believe this address was identified in error,
please contact your Vendor.