Address Validation

AddressValidation 클래스

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

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

const {AddressValidation} = await google.maps.importLibrary("addressValidation");

정적 메소드
fetchAddressValidation	fetchAddressValidation(request) 매개변수: request: AddressValidationRequest 반환 값: Promise<AddressValidation> 주소를 검증합니다. https://developers.google.com/maps/documentation/javascript/address-validation/validate-address를 참고하세요.

속성
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	유형: PostalAddressLiteral 검증 중인 주소입니다. 형식이 지정되지 않은 주소는 PostalAddress.addressLines를 통해 제출해야 합니다.
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	유형: Array<AddressComponent> 형식이 지정되고 수정된 주소의 개별 주소 구성요소와 검증 정보입니다. 개별 구성요소의 검증 상태에 관한 정보를 제공합니다.
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"

알림: v=베타 채널에서만 사용할 수 있습니다.

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를 참고하세요.
possibleNextAction readonly	알림: v=베타 채널에서만 사용할 수 있습니다. 유형: PossibleNextAction optional API 응답의 다른 필드를 기반으로 취할 수 있는 다음 작업입니다. 자세한 내용은 PossibleNextAction을 참조하세요.
validationGranularity readonly	유형: Granularity optional API가 주소를 완전히 검증할 수 있는 세분화 수준입니다. 예를 들어 validationGranularity가 PREMISE이면 PREMISE 수준 이상의 모든 주소 구성요소를 검증할 수 있습니다.