Address Validation (beta)

AddressValidation 클래스

google.maps.addressValidation.AddressValidation 클래스

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

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

const {AddressValidation} = await google.maps.importLibrary("addressValidation")를 호출하여 액세스
Maps JavaScript API의 라이브러리를 참고하세요.

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

속성
address	유형:  Address optional 지오코드와는 다른 주소 자체에 관한 정보입니다.
geocode	유형:  Geocode optional 주소가 지오코딩된 위치 및 장소에 관한 정보입니다.
metadata	유형:  AddressMetadata optional 전송 가능성과 관련된 기타 정보 Address Validation API로 전송된 모든 주소에 대해 metadata가 완전히 채워진다는 보장은 없습니다.
responseId	유형:  string optional 이 응답을 식별하는 UUID입니다. 주소를 다시 검증해야 하는 경우 이 UUID가 새 요청과 함께 제공되어야 합니다.
uspsData	유형:  USPSData optional USPS에서 제공하는 추가 수신 가능성 플래그입니다. US 및 PR 리전에서만 제공됩니다.
verdict	유형:  Verdict optional 전체 결과 플래그

메서드
toJSON	toJSON() 매개변수:  없음 반환 값:  Object AddressValidation 클래스를 속성이 동일한 JSON 객체로 변환합니다.

AddressValidationRequest 인터페이스

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

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

AddressValidation.fetchAddressValidation 요청 인터페이스

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

Address 클래스

google.maps.addressValidation.Address 클래스

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

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

const {Address} = await google.maps.importLibrary("addressValidation")를 호출하여 액세스
Maps JavaScript API의 라이브러리를 참고하세요.

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

AddressComponent 클래스

google.maps.addressValidation.AddressComponent 클래스

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

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

const {AddressComponent} = await google.maps.importLibrary("addressValidation")를 호출하여 액세스
Maps JavaScript API의 라이브러리를 참고하세요.

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

AddressMetadata 클래스

google.maps.addressValidation.AddressMetadata 클래스

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

주소의 메타데이터입니다. AddressMetadata는 Address Validation API로 전송된 모든 주소에 대해 완전히 채워지지 않을 수 있습니다.

const {AddressMetadata} = await google.maps.importLibrary("addressValidation")를 호출하여 액세스
Maps JavaScript API의 라이브러리를 참고하세요.

속성
business	유형:  boolean
poBox	유형:  boolean
residential	유형:  boolean

ConfirmationLevel 상수

google.maps.addressValidation.ConfirmationLevel 상수

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

구성요소가 올바르다는 확실성의 수준을 나타내는 다양한 가능한 값입니다.

const {ConfirmationLevel} = await google.maps.importLibrary("addressValidation")를 호출하여 액세스
Maps JavaScript API의 라이브러리를 참고하세요.

상수
CONFIRMED
UNCONFIRMED_AND_SUSPICIOUS
UNCONFIRMED_BUT_PLAUSIBLE

Geocode 클래스

google.maps.addressValidation.Geocode 클래스

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

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

const {Geocode} = await google.maps.importLibrary("addressValidation")를 호출하여 액세스
Maps JavaScript API의 라이브러리를 참고하세요.

속성
bounds	유형:  LatLngBounds optional 지오코딩된 장소의 경계입니다.
featureSizeMeters	유형:  number optional 지오코딩된 장소의 크기(미터)입니다. 지오코딩된 위치의 대략성을 나타내는 또 다른 측정값이지만, 의미론적 의미가 아닌 실제 크기로 나타냅니다.
location	유형:  LatLngAltitude optional 입력의 지오코딩된 위치입니다.
placeId	유형:  string optional 지오코딩된 장소의 장소 ID입니다. 주소, 위도/경도 좌표 또는 Plus Code를 사용하는 것보다 장소를 사용하는 것이 좋습니다. 좌표를 사용하여 경로를 지정하거나 운전 경로를 계산하면 항상 해당 좌표에 가장 가까운 도로에 포인트가 스냅됩니다. 이 길은 목적지로 빠르고 안전하게 이어지지 않을 수 있으며 숙소의 진입로와 가까이 있지 않을 수도 있습니다. 또한 위치가 역지오코딩될 때 반환된 주소가 원본과 일치한다는 보장은 없습니다.
placeTypes	유형:  Array<string> 입력이 지오코딩된 장소의 유형입니다. 예를 들면 ['locality', 'political']입니다. 전체 유형 목록은 Geocoding API 문서에서 확인할 수 있습니다.
plusCode	유형:  PlusCode optional location에 해당하는 Plus Code입니다.

메서드
fetchPlace	fetchPlace() 매개변수:  없음 반환 값:  None 이 Geocode의 장소 표현을 반환합니다. 전체 장소 세부정보를 가져오려면 place.fetchFields()를 호출해야 합니다.

세부사항 상수

google.maps.addressValidation.Granularity 상수

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

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

const {Granularity} = await google.maps.importLibrary("addressValidation")를 호출하여 액세스
Maps JavaScript API의 라이브러리를 참고하세요.

상수
BLOCK	주소 또는 지오코드에 블록이 표시됩니다. 일본과 같이 블록 수준 주소가 있는 지역에서만 사용됩니다.
OTHER	게재할 수 없으므로 함께 버킷팅된 기타 모든 세부사항
PREMISE	건물 수준 결과입니다.
PREMISE_PROXIMITY	주소의 건물 수준 위치를 대략적으로 나타내는 지오코드입니다.
ROUTE	지오코드 또는 주소가 도로, 길, 고속도로와 같은 경로로 세분화됩니다.
SUB_PREMISE	건물 아래 수준 결과(예: 아파트)입니다.

PossibleNextAction 상수

google.maps.addressValidation.PossibleNextAction 상수

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

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

const {PossibleNextAction} = await google.maps.importLibrary("addressValidation")를 호출하여 액세스
Maps JavaScript API의 라이브러리를 참고하세요.

상수
ACCEPT	API 응답에 다른 PossibleNextAction 값 중 하나를 보증하는 신호가 포함되어 있지 않습니다. 고객에게 추가로 프롬프트를 표시하지 않고 후처리된 주소를 사용하는 것이 좋습니다. 하지만 이렇게 해도 주소가 유효하다는 보장은 없으며 주소에 수정사항이 포함되어 있을 수 있습니다. 자체 위험 평가에 따라 고객에게 프롬프트를 표시할지 여부와 방법을 결정하는 것은 개발자의 책임입니다.
CONFIRM	API 응답의 하나 이상의 필드에 후처리된 주소에 사소한 문제가 있을 수 있음이 표시됩니다(예: postal_code 주소 구성요소가 replaced임). 고객에게 주소를 검토하도록 요청하면 주소의 품질을 개선하는 데 도움이 될 수 있습니다.
CONFIRM_ADD_SUBPREMISES	API 응답은 후처리된 주소에 하위 구역이 누락되었을 수 있음을 나타냅니다. 고객에게 주소를 검토하고 동 번호를 추가하도록 안내하면 주소의 품질을 개선하는 데 도움이 될 수 있습니다. 후처리된 주소에 다른 사소한 문제가 있을 수도 있습니다. 참고: 이 enum 값은 미국 주소에 대해서만 반환될 수 있습니다.
FIX	API 응답의 하나 이상의 필드에 후처리된 주소에 문제가 있을 수 있음을 나타냅니다(예: verdict.validation_granularity이 OTHER임). 고객에게 주소를 수정하도록 요청하면 주소의 품질을 개선하는 데 도움이 될 수 있습니다.

USPSAddress 클래스

google.maps.addressValidation.USPSAddress 클래스

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

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

const {USPSAddress} = await google.maps.importLibrary("addressValidation")를 호출하여 액세스
Maps JavaScript API의 라이브러리를 참고하세요.

속성
city	유형:  string optional 도시 이름입니다.
cityStateZipAddressLine	유형:  string optional 도시, 주, 우편번호가 포함된 주소 줄입니다.
firm	유형:  string optional 회사 이름입니다.
firstAddressLine	유형:  string optional 주소의 첫 번째 줄입니다.
secondAddressLine	유형:  string optional 주소의 두 번째 줄입니다.
state	유형:  string optional 2자리 주 코드입니다.
urbanization	유형:  string optional 푸에르토리코 도시화 이름입니다.
zipCode	유형:  string optional 우편번호입니다(예: '10009').
zipCodeExtension	유형:  string optional 4자리 우편번호 확장입니다(예: '5023').

USPSData 클래스

google.maps.addressValidation.USPSData 클래스

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

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

const {USPSData} = await google.maps.importLibrary("addressValidation")를 호출하여 액세스
Maps JavaScript API의 라이브러리를 참고하세요.

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

Verdict 클래스

google.maps.addressValidation.Verdict 클래스

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

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

const {Verdict} = await google.maps.importLibrary("addressValidation")를 호출하여 액세스
Maps JavaScript API의 라이브러리를 참고하세요.

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