Address Validation

AddressValidation 클래스

google.maps.addressValidation.AddressValidation 클래스
라이브러리 "addressValidation"

AddressValidation API에 액세스하기 위한 정적 클래스입니다.

const {AddressValidation} = await google.maps.importLibrary("addressValidation");
fetchAddressValidation
fetchAddressValidation(request)
매개변수:
address
readonly
유형: Address optional
지오코드가 아닌 주소 자체에 대한 정보입니다.
geocode
readonly
유형: Geocode optional
주소가 지오코딩된 위치 및 장소에 대한 정보입니다.
metadata
readonly
유형: AddressMetadata optional
전송 가능성과 관련된 기타 정보 Address Validation API로 전송되는 모든 주소에 대해 metadata가 완전히 채워진다고 보장할 수 없습니다.
responseId
readonly
유형: string optional
이 응답을 식별하는 UUID입니다. 주소를 다시 검증해야 하는 경우 이 UUID를 새 요청과 함께 제공해야 합니다.
uspsData
readonly
유형: USPSData optional
USPS에서 제공하는 추가 배송 가능 여부 플래그입니다. US 및 PR 리전에서만 제공됩니다.
verdict
readonly
유형: Verdict optional
전체 확인 결과 플래그
상속됨: toJSON

AddressValidationRequest 인터페이스

인터페이스 google.maps.addressValidation.AddressValidationRequest

AddressValidation.fetchAddressValidation의 요청 인터페이스입니다.

address
검증 중인 주소입니다. 형식이 지정되지 않은 주소는 PostalAddress.addressLines를 통해 제출해야 합니다.
internalUsageAttributionIds
선택사항
유형: Iterable<string> optional
특정 패키지 또는 OSS 라이브러리에 대한 호출을 식별하는 데 사용되는 식별자입니다.
placeAutocompleteElement
선택사항
유형: PlaceAutocompleteElement optional
PlaceAutocompleteElement를 사용하는 경우 AddressValidation API 호출을 자동 완성 세션 토큰과 연결하려면 여기에 포함하세요.
previousResponseId
선택사항
유형: string optional
첫 번째 주소 확인 요청에는 이 필드를 설정하면 안 됩니다. 단일 주소를 완전히 검증하기 위해 더 많은 요청이 필요한 경우 (예: 초기 검증 후 사용자가 변경한 사항을 다시 검증해야 하는 경우) 각 후속 요청은 검증 시퀀스의 첫 번째 응답에서 AddressValidation.responseId로 이 필드를 채워야 합니다.
sessionToken
선택사항
유형: AutocompleteSessionToken optional
결제 목적으로 자동 완성 세션을 식별하는 토큰입니다.
uspsCASSEnabled
선택사항
유형: boolean optional
USPS CASS 호환 모드를 사용 설정합니다. 이는 AddressValidation의 AddressValidation.uspsData 필드에만 영향을 미칩니다. 참고: 푸에르토리코 주소에 대해 USPS CASS가 사용 설정된 요청의 경우 address의 PostalAddress.regionCode를 'PR'로 제공하거나 address의 PostalAddress.administrativeArea를 'Puerto Rico' (대소문자를 구분하지 않음) 또는 'PR'로 제공해야 합니다.

Address 클래스

google.maps.addressValidation.Address 클래스
라이브러리 "addressValidation"

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

const {Address} = await google.maps.importLibrary("addressValidation");
components
readonly
형식이 지정되고 수정된 주소의 개별 주소 구성요소와 검증 정보입니다. 개별 구성요소의 검증 상태에 관한 정보를 제공합니다.
formattedAddress
readonly
유형: string optional
주소가 있는 지역의 주소 형식 지정 규칙에 따라 한 줄 주소로 형식이 지정된 후처리 주소입니다.
missingComponentTypes
readonly
유형: Array<string>
올바른 형식의 우편 주소에 있어야 하지만 입력에서 찾을 수 없고 추론할 수 없는 구성요소 유형입니다. 이 유형의 구성요소는 formatted_address, postal_address 또는 address_components에 없습니다. 예를 들어 'Boulder, Colorado, 80301, USA'와 같은 입력의 경우 ['street_number', 'route']입니다. 가능한 유형 목록은 여기에서 확인할 수 있습니다.
postalAddress
readonly
유형: PostalAddress optional
우편 주소로 표시되는 후처리된 주소입니다.
unconfirmedComponentTypes
readonly
유형: Array<string>
address_components에 있지만 올바른지 확인할 수 없는 구성요소의 유형입니다. 이 필드는 편의를 위해 제공됩니다. 이 필드의 콘텐츠는 address_components를 반복하여 AddressComponent.confirmationLevel가 ConfirmationLevel.CONFIRMED가 아니거나 AddressComponent.inferred 플래그가 true로 설정되지 않은 모든 구성요소의 유형을 찾는 것과 같습니다. 가능한 유형 목록은 여기에서 확인할 수 있습니다.
unresolvedTokens
readonly
유형: Array<string>
확인할 수 없는 입력의 토큰입니다. 이는 주소의 유효한 부분으로 인식되지 않은 입력일 수 있습니다 (예: '123235253253 Main St, San Francisco, CA, 94105'와 같은 입력에서 유효한 번지수가 아닌 것으로 보이므로 미해결 토큰이 ["123235253253"]처럼 보일 수 있음).
상속됨: toJSON

AddressComponent 클래스

google.maps.addressValidation.AddressComponent 클래스
라이브러리 "addressValidation"

주소의 단일 구성요소 (예: 도로명, 도시)를 나타냅니다.

const {AddressComponent} = await google.maps.importLibrary("addressValidation");
componentName
readonly
유형: string optional
구성요소 이름 텍스트입니다. 예를 들어 도로 이름의 경우 '5th Avenue', 번지의 경우 '1253'입니다.
componentNameLanguageCode
readonly
유형: string optional
BCP-47 언어 코드입니다. 구성요소 이름이 언어와 연결되지 않은 경우(예: 번지) 이 필드는 표시되지 않습니다.
componentType
readonly
유형: string optional
주소 구성요소의 유형입니다. 가능한 유형 목록은 표 2: 장소 서비스에서 반환하는 추가 유형을 참고하세요.
confirmationLevel
readonly
유형: ConfirmationLevel optional
구성요소가 올바른지 확실한 정도를 나타냅니다.
inferred
readonly
유형: boolean
true인 경우 이 구성요소는 입력의 일부가 아니지만 주소 위치에 대해 추론되었습니다. 완전한 주소를 위해 이 구성요소를 포함하는 것이 좋습니다.
replaced
readonly
유형: boolean
구성요소 이름이 완전히 다른 이름으로 대체되었음을 나타냅니다. 예를 들어 잘못된 우편번호를 주소에 맞는 올바른 우편번호로 바꿉니다. 이는 외형적 변경이 아니며 입력 구성요소가 다른 구성요소로 변경되었습니다.
spellCorrected
readonly
유형: boolean
구성요소 이름의 맞춤법 오류를 수정했음을 나타냅니다. API는 'centre'에서 'center'로의 변경과 같은 철자 변형을 항상 플래그 지정하지는 않습니다.
unexpected
readonly
유형: boolean
true인 경우 이 구성요소는 지정된 지역의 우편 주소에 표시되지 않습니다. 입력의 일부였기 때문에 유지되었습니다.

AddressMetadata 클래스

google.maps.addressValidation.AddressMetadata 클래스
라이브러리 "addressValidation"

주소의 메타데이터입니다. Address Validation API로 전송되는 모든 주소에 대해 AddressMetadata가 완전히 채워진다고 보장할 수 없습니다.

const {AddressMetadata} = await google.maps.importLibrary("addressValidation");
business
readonly
유형: boolean
poBox
readonly
유형: boolean
residential
readonly
유형: boolean
상속됨: toJSON

ConfirmationLevel 상수

상수 google.maps.addressValidation.ConfirmationLevel
라이브러리 "addressValidation"

구성요소가 올바른지 확실한 정도를 나타내는 다양한 값입니다.

이러한 상수는 문자열로도 사용할 수 있습니다. TypeScript에서 문자열 리터럴은 ConfirmationLevelString 유형으로 정의됩니다.

const {ConfirmationLevel} = await google.maps.importLibrary("addressValidation");
CONFIRMED
UNCONFIRMED_AND_SUSPICIOUS
UNCONFIRMED_BUT_PLAUSIBLE

Geocode 클래스

google.maps.addressValidation.Geocode 클래스
라이브러리 "addressValidation"

입력이 지오코딩된 장소에 관한 정보가 포함됩니다.

const {Geocode} = await google.maps.importLibrary("addressValidation");
bounds
readonly
유형: LatLngBounds optional
지오코딩된 장소의 경계입니다.
featureSizeMeters
readonly
유형: number optional
지오코딩된 장소의 크기(미터)입니다. 이는 지오코딩된 위치의 조악함을 나타내는 또 다른 측정항목이지만 의미론적 의미가 아닌 물리적 크기입니다.
location
readonly
유형: LatLngAltitude optional
입력의 지오코딩된 위치입니다.
placeId
readonly
유형: string optional
지오코딩된 장소의 장소 ID입니다. 주소, 위도/경도 좌표 또는 Plus Code를 사용하는 것보다 장소를 사용하는 것이 좋습니다. 경로를 지정하거나 운전 경로를 계산하는 데 좌표를 사용하면 항상 해당 좌표에 가장 가까운 도로에 지점이 스냅됩니다. 이 도로는 목적지로 빠르고 안전하게 연결되지 않을 수 있으며, 숙박 시설의 출입 지점 근처에 있지 않을 수 있습니다. 또한 위치가 역 지오코딩되면 반환된 주소가 원본과 일치한다고 보장할 수 없습니다.
placeTypes
readonly
유형: Array<string>
입력이 지오코딩된 장소의 유형입니다. 예를 들면 ['locality', 'political']입니다. 전체 유형 목록은 Geocoding API 문서에서 확인할 수 있습니다.
plusCode
readonly
유형: PlusCode optional
location에 해당하는 Plus Code입니다.
fetchPlace
fetchPlace()
매개변수: 없음
반환 값: 없음
이 지오코딩의 장소 표현을 반환합니다. 전체 장소 세부정보를 가져오려면 place.fetchFields()를 호출해야 합니다.
상속됨: toJSON

Granularity 상수

상수 google.maps.addressValidation.Granularity
라이브러리 "addressValidation"

주소 또는 지오코드가 가질 수 있는 다양한 세분화 수준입니다. 주소의 세부사항을 나타내는 데 사용되는 경우 이러한 값은 주소가 우편물 수신지를 얼마나 세부적으로 식별하는지 나타냅니다. 예를 들어 '123 Main Street, Redwood City, CA, 94061'과 같은 주소는 PREMISE를 식별하고 'Redwood City, CA, 94061'과 같은 주소는 LOCALITY를 식별합니다. 하지만 Redwood City의 '123 Main Street'에 대한 지오코드를 찾을 수 없는 경우 주소가 더 세분화되어 있더라도 반환되는 지오코드는 LOCALITY 세분성일 수 있습니다.

이러한 상수는 문자열로도 사용할 수 있습니다. TypeScript에서 문자열 리터럴은 GranularityString 유형으로 정의됩니다.

const {Granularity} = await google.maps.importLibrary("addressValidation");
BLOCK 주소 또는 지오코드가 블록을 나타냅니다. 일본과 같이 블록 수준 주소 지정이 있는 지역에서만 사용됩니다.
OTHER 게재할 수 없으므로 함께 버케팅되는 다른 모든 세분화 수준입니다.
PREMISE 건물 수준 결과입니다.
PREMISE_PROXIMITY 주소의 건물 수준 위치를 근사치로 나타내는 지오코드입니다.
ROUTE 지오코드 또는 주소가 거리, 도로, 고속도로와 같은 경로로 세분화됩니다.
SUB_PREMISE 아파트와 같은 건물 하위 수준 결과입니다.

PossibleNextAction 상수

상수 google.maps.addressValidation.PossibleNextAction
라이브러리 "addressValidation"

API 응답에 대한 해석적 요약을 제공하며, 이는 잠재적인 후속 조치를 결정하는 데 도움을 주기 위한 것입니다. 이 필드는 API 응답의 다른 필드에서 파생되며 주소 정확성 또는 배송 가능성을 보장하는 것으로 간주해서는 안 됩니다.

이러한 상수는 문자열로도 사용할 수 있습니다. TypeScript에서 문자열 리터럴은 PossibleNextActionString 유형으로 정의됩니다.

const {PossibleNextAction} = await google.maps.importLibrary("addressValidation");
ACCEPT API 응답에 다른 PossibleNextAction 값 중 하나를 보장하는 신호가 포함되어 있지 않습니다. 고객에게 추가 메시지를 표시하지 않고 후처리된 주소를 사용할 수 있지만, 이 경우 주소가 유효하다고 보장할 수 없으며 주소에 여전히 수정사항이 포함되어 있을 수 있습니다. 자체 위험 평가에 따라 고객에게 메시지를 표시할지 여부와 방법을 결정하는 것은 개발자의 책임입니다.
CONFIRM API 응답의 하나 이상의 필드가 후처리된 주소에 잠재적인 사소한 문제가 있음을 나타냅니다(예: postal_code 주소 구성요소가 replaced). 고객에게 주소를 검토하라는 메시지를 표시하면 주소 품질을 개선하는 데 도움이 될 수 있습니다.
CONFIRM_ADD_SUBPREMISES API 응답은 후처리된 주소에 하위 구내가 누락되었을 수 있음을 나타냅니다. 고객에게 주소를 검토하고 호수를 추가하도록 요청하면 주소 품질을 개선하는 데 도움이 될 수 있습니다. 후처리된 주소에 다른 사소한 문제가 있을 수도 있습니다. 참고: 이 enum 값은 미국 주소에만 반환될 수 있습니다.
FIX API 응답의 하나 이상의 필드가 후처리된 주소에 잠재적인 문제가 있음을 나타냅니다(예: verdict.validation_granularity가 OTHER임). 고객에게 주소를 수정하라는 메시지를 표시하면 주소 품질을 개선하는 데 도움이 될 수 있습니다.

USPSAddress 클래스

google.maps.addressValidation.USPSAddress 클래스
라이브러리 "addressValidation"

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

const {USPSAddress} = await google.maps.importLibrary("addressValidation");
city
readonly
유형: string optional
도시 이름입니다.
cityStateZipAddressLine
readonly
유형: string optional
구/군/시, 시/도, 우편번호가 포함된 주소 입력란입니다.
firm
readonly
유형: string optional
회사 이름입니다.
firstAddressLine
readonly
유형: string optional
주소의 첫 번째 줄입니다.
secondAddressLine
readonly
유형: string optional
주소의 두 번째 줄입니다.
state
readonly
유형: string optional
2자리 주 코드입니다.
urbanization
readonly
유형: string optional
푸에르토리코 도시화 이름입니다.
zipCode
readonly
유형: string optional
우편번호(예: '10009')입니다.
zipCodeExtension
readonly
유형: string optional
4자리 우편번호 확장자(예: '5023')입니다.
상속됨: toJSON

USPSData 클래스

google.maps.addressValidation.USPSData 클래스
라이브러리 "addressValidation"

주소의 USPS 데이터입니다. Address Validation API로 전송되는 모든 미국 또는 푸에르토리코 주소에 대해 USPSData가 완전히 채워진다고 보장할 수 없습니다. uspsData를 응답의 기본 부분으로 사용하는 경우 응답에 백업 주소 필드를 통합하는 것이 좋습니다.

const {USPSData} = await google.maps.importLibrary("addressValidation");
abbreviatedCity
readonly
유형: string optional
도시 이름의 약어입니다.
addressRecordType
readonly
유형: string optional
입력 주소와 일치하는 주소 레코드의 유형입니다.
carrierRoute
readonly
유형: string optional
운송업체 경로 코드입니다. 한 자리 문자 프리픽스와 세 자리 경로 지정자로 구성된 네 자리 문자 코드입니다.
carrierRouteIndicator
readonly
유형: string optional
운송업체 경로 요금 정렬 표시기입니다.
cassProcessed
readonly
유형: boolean
요청이 CASS 처리되었음을 나타내는 표시기입니다.
county
readonly
유형: string optional
구/군 이름입니다.
deliveryPointCheckDigit
readonly
유형: string optional
배송 지점 검사 숫자입니다. 이 숫자는 기계로 스캔한 우편물의 delivery_point_barcode 끝에 추가됩니다. delivery_point_barcode, delivery_point_check_digit, 우편번호, ZIP+4의 모든 숫자를 더하면 10으로 나눌 수 있는 숫자가 됩니다.
deliveryPointCode
readonly
유형: string optional
2자리 배송지 코드입니다.
dpvCMRA
readonly
유형: string optional
주소가 CMRA (상업용 우편 수신 대행업체, 고객의 우편물을 수신하는 민간 기업)인지 여부를 나타냅니다. 단일 문자를 반환합니다.
dpvConfirmation
readonly
유형: string optional
DPV 확인에 가능한 값입니다. 단일 문자를 반환하거나 값을 반환하지 않습니다.
dpvDoorNotAccessible
readonly
유형: string optional
USPS에서 우편물을 배송하기 위해 문을 두드릴 수 없는 주소를 나타내는 플래그입니다. 단일 문자를 반환합니다.
dpvDrop
readonly
유형: string optional
플래그는 우편물이 사이트의 단일 수신함으로 배달됨을 나타냅니다. 단일 문자를 반환합니다.
dpvEnhancedDeliveryCode
readonly
유형: string optional
주소에 유효한 DPV 반환 코드가 두 개 이상 있음을 나타냅니다. 단일 문자를 반환합니다.
dpvFootnote
readonly
유형: string optional
배송 지점 검증의 각주입니다. 여러 각주가 동일한 문자열에 함께 연결될 수 있습니다.
dpvNonDeliveryDays
readonly
유형: string optional
플래그는 우편 배송이 매일 수행되지 않음을 나타냅니다. 단일 문자를 반환합니다.
dpvNonDeliveryDaysValues
readonly
유형: number optional
배송되지 않는 날을 식별하는 정수입니다. 비트 플래그를 사용하여 쿼리할 수 있습니다. 0x40 – 일요일은 배송 불가일 0x20 – 월요일은 배송 불가일 0x10 – 화요일은 배송 불가일 0x08 – 수요일은 배송 불가일 0x04 – 목요일은 배송 불가일 0x02 – 금요일은 배송 불가일 0x01 – 토요일은 배송 불가일
dpvNoSecureLocation
readonly
유형: string optional
플래그는 문에 접근할 수 있지만 보안 문제로 인해 택배를 두고 가지 않을 것임을 나타냅니다. 단일 문자를 반환합니다.
dpvNoStat
readonly
유형: string optional
주소가 통계 없음 주소인지 활성 주소인지 나타냅니다. No stat 주소는 지속적으로 점유되지 않는 주소 또는 USPS에서 서비스를 제공하지 않는 주소입니다. 단일 문자를 반환합니다.
dpvNoStatReasonCode
readonly
유형: number optional
NoStat 유형을 나타냅니다. 이유 코드를 int로 반환합니다.
dpvPBSA
readonly
유형: string optional
주소가 PBSA 레코드와 일치함을 나타냅니다. 단일 문자를 반환합니다.
dpvThrowback
readonly
유형: string optional
우편물이 상세 주소로 배송되지 않음을 나타냅니다. 단일 문자를 반환합니다.
dpvVacant
readonly
유형: string optional
주소가 비어 있는지 여부를 나타냅니다. 단일 문자를 반환합니다.
elotFlag
readonly
유형: string optional
eLOT 오름차순/내림차순 플래그 (A/D)
elotNumber
readonly
유형: string optional
eLOT (Enhanced Line of Travel) 번호입니다.
errorMessage
readonly
유형: string optional
USPS 데이터 검색 오류 메시지 인위적으로 생성된 주소가 감지되어 USPS 처리가 정지되면 이 필드가 채워집니다.
fipsCountyCode
readonly
유형: string optional
FIPS 카운티 코드입니다.
hasDefaultAddress
readonly
유형: boolean
기본 주소가 발견되었지만 더 구체적인 주소가 있음을 나타내는 표시기입니다.
hasNoEWSMatch
readonly
유형: boolean
배송지 주소가 일치하지만 EWS 파일에 정확한 일치가 곧 제공될 예정이라고 표시됩니다.
lacsLinkIndicator
readonly
유형: string optional
LACSLink 표시기입니다.
lacsLinkReturnCode
readonly
유형: string optional
LACSLink 반환 코드입니다.
pmbDesignator
readonly
유형: string optional
PMB (개인 우편함) 단위 지정자입니다.
pmbNumber
readonly
유형: string optional
PMB (개인 사서함) 번호
poBoxOnlyPostalCode
readonly
유형: boolean
사서함 전용 우편번호입니다.
postOfficeCity
readonly
유형: string optional
주 우체국 도시입니다.
postOfficeState
readonly
유형: string optional
주 우체국 주/도입니다.
standardizedAddress
readonly
유형: USPSAddress optional
USPS 표준화된 주소
suiteLinkFootnote
readonly
유형: string optional
도로 또는 고층 건물 레코드를 스위트 정보와 일치시키는 각주입니다. 비즈니스 이름이 일치하면 보조 전화번호가 반환됩니다.
상속됨: toJSON

Verdict 클래스

google.maps.addressValidation.Verdict 클래스
라이브러리 "addressValidation"

제공된 주소의 후처리된 주소를 나타냅니다.

const {Verdict} = await google.maps.importLibrary("addressValidation");
addressComplete
readonly
유형: boolean
해결되지 않은 토큰이 없고 예상치 못한 주소 구성요소나 누락된 주소 구성요소가 없는 경우 주소가 완전한 것으로 간주됩니다. 설정하지 않으면 값이 false임을 나타냅니다. 자세한 내용은 Address.missingComponentTypes, Address.unresolvedTokens 또는 AddressComponent.unexpected 필드를 참고하세요.
geocodeGranularity
readonly
유형: Granularity optional
Geocode의 세분화에 대한 정보입니다. 이는 지오코딩된 위치가 얼마나 대략적인지 또는 세부적인지에 대한 의미론적 의미로 이해할 수 있습니다.
hasInferredComponents
readonly
유형: boolean
입력에 없는 주소 구성요소가 하나 이상 추론 (즉, 추가)되었습니다. 자세한 내용은 AddressComponent를 참고하세요.
hasReplacedComponents
readonly
유형: boolean optional
하나 이상의 주소 구성요소가 대체되었습니다. 자세한 내용은 AddressComponent을 참고하세요.
hasUnconfirmedComponents
readonly
유형: boolean
하나 이상의 주소 구성요소를 분류하거나 검증할 수 없습니다. 자세한 내용은 AddressComponent를 참고하세요.
inputGranularity
readonly
유형: Granularity optional
입력 주소의 세분화 수준입니다. 이는 입력 주소를 파싱한 결과이며 유효성 검사 신호를 제공하지 않습니다. 검증 신호는 validationGranularity를 참고하세요.
BetapossibleNextAction
readonly
유형: PossibleNextAction optional
API 응답의 다른 필드를 기반으로 취할 수 있는 다음 작업입니다. 자세한 내용은 PossibleNextAction을 참조하세요.
validationGranularity
readonly
유형: Granularity optional
API가 주소를 완전히 검증할 수 있는 세분화 수준입니다. 예를 들어 validationGranularity가 PREMISE이면 PREMISE 수준 이상의 모든 주소 구성요소를 검증할 수 있습니다.