AddressValidation 클래스
google.maps.addressValidation.AddressValidation 클래스
AddressValidation API에 액세스하기 위한 정적 클래스입니다.
const {AddressValidation} = await google.maps.importLibrary("addressValidation")를 호출하여 액세스
Maps JavaScript API의 라이브러리를 참고하세요.
정적 메소드 | |
|---|---|
fetchAddressValidation |
fetchAddressValidation(request)매개변수:
반환 값:
Promise<AddressValidation> |
속성 | |
|---|---|
address |
유형:
Address optional지오코드와는 다른 주소 자체에 관한 정보입니다. |
geocode |
유형:
Geocode optional주소가 지오코딩된 위치 및 장소에 관한 정보입니다. |
metadata |
유형:
AddressMetadata optional전송 가능성과 관련된 기타 정보 Address Validation API로 전송된 모든 주소에 대해 metadata가 완전히 채워진다는 보장은 없습니다. |
responseId |
유형:
string optional이 응답을 식별하는 UUID입니다. 주소를 다시 검증해야 하는 경우 이 UUID가 새 요청과 함께 제공되어야 합니다. |
uspsData |
유형:
USPSData optionalUSPS에서 제공하는 추가 수신 가능성 플래그입니다. US 및 PR 리전에서만 제공됩니다. |
verdict |
유형:
Verdict optional전체 결과 플래그 |
메서드 | |
|---|---|
toJSON |
toJSON()매개변수: 없음
반환 값:
ObjectAddressValidation 클래스를 속성이 동일한 JSON 객체로 변환합니다. |
AddressValidationRequest 인터페이스
google.maps.addressValidation.AddressValidationRequest
인터페이스
AddressValidation.fetchAddressValidation 요청 인터페이스
속성 | |
|---|---|
address |
유효성을 검사할 주소입니다. 형식이 지정되지 않은 주소는 PostalAddress.addressLines를 통해 제출해야 합니다. |
placeAutocompleteElement optional |
유형:
PlaceAutocompleteElement optionalPlaceAutocompleteElement를 사용하는 경우 여기에 포함하여 AddressValidation API 호출을 자동 완성 세션 토큰과 연결합니다. |
previousResponseId optional |
유형:
string optional첫 번째 주소 유효성 검사 요청에서는 이 필드를 설정하면 안 됩니다. 단일 주소를 완전히 검증하는 데 요청이 더 필요한 경우 (예: 초기 검증 후 사용자가 변경한 사항을 다시 검증해야 하는 경우) 각 후속 요청은 검증 시퀀스의 첫 번째 응답에서 AddressValidation.responseId로 이 필드를 채워야 합니다. |
sessionToken optional |
유형:
AutocompleteSessionToken optional결제 목적으로 자동 완성 세션을 식별하는 토큰입니다. |
uspsCASSEnabled optional |
유형:
boolean optionalUSPS CASS 호환 모드를 사용 설정합니다. 이는 AddressValidation의 AddressValidation.uspsData 필드에만 영향을 미칩니다. 참고: 푸에르토리코 주소에 대한 USPS CASS 지원 요청의 경우 address의 PostalAddress.regionCode를 'PR'로 제공하거나 address의 PostalAddress.administrativeArea를 'Puerto Rico' (대소문자 구분 안 함) 또는 'PR'로 제공해야 합니다. |
Address 클래스
google.maps.addressValidation.Address 클래스
후처리된 주소의 세부정보입니다. 후처리에는 주소의 철자가 잘못된 부분을 수정하고, 잘못된 부분을 대체하고, 누락된 부분을 추론하는 작업이 포함됩니다.
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 클래스
주소의 단일 구성요소 (예: 도로명, 도시)를 나타냅니다.
const {AddressComponent} = await google.maps.importLibrary("addressValidation")를 호출하여 액세스
Maps JavaScript API의 라이브러리를 참고하세요.
속성 | |
|---|---|
componentName |
유형:
string optional구성요소 이름 텍스트입니다. 예를 들어 도로 이름의 경우 '5th Avenue', 도로 번호의 경우 '1253' |
componentNameLanguageCode |
유형:
string optionalBCP-47 언어 코드입니다. 구성요소 이름이 언어와 연결되지 않은 경우(예: 번지) 이 필드는 표시되지 않습니다. |
componentType |
유형:
string optional주소 구성요소의 유형입니다. 가능한 유형 목록은 표 2: 장소 서비스에서 반환하는 추가 유형을 참고하세요. |
confirmationLevel |
유형:
ConfirmationLevel optional구성요소가 올바르다는 확신의 정도를 나타냅니다. |
inferred |
유형:
booleantrue인 경우 이 구성요소는 입력의 일부가 아니지만 주소 위치에 대해 추론되었습니다. 전체 주소에는 이 구성요소를 포함하는 것이 좋습니다. |
replaced |
유형:
boolean구성요소의 이름이 완전히 다른 이름으로 대체되었음을 나타냅니다. 예를 들어 잘못된 우편번호를 주소에 맞는 올바른 우편번호로 대체합니다. 외형 변경이 아닙니다. 입력 구성요소가 다른 구성요소로 변경되었습니다. |
spellCorrected |
유형:
boolean구성요소 이름의 오타 수정 사항을 나타냅니다. API는 'centre'에서 'center'로와 같이 철자 변형 간의 변경사항을 항상 표시하지는 않습니다. |
unexpected |
유형:
booleantrue인 경우 이 구성요소는 지정된 지역의 우편 주소에 포함되지 않습니다. 입력의 일부였기 때문에만 유지되었습니다. |
AddressMetadata 클래스
google.maps.addressValidation.AddressMetadata 클래스
주소의 메타데이터입니다. 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
상수
구성요소가 올바르다는 확실성의 수준을 나타내는 다양한 가능한 값입니다.
const {ConfirmationLevel} = await google.maps.importLibrary("addressValidation")를 호출하여 액세스
Maps JavaScript API의 라이브러리를 참고하세요.
상수 | |
|---|---|
CONFIRMED |
|
UNCONFIRMED_AND_SUSPICIOUS |
|
UNCONFIRMED_BUT_PLAUSIBLE |
|
Geocode 클래스
google.maps.addressValidation.Geocode 클래스
입력이 지오코딩된 장소에 관한 정보를 포함합니다.
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 optionallocation에 해당하는 Plus Code입니다. |
메서드 | |
|---|---|
fetchPlace |
fetchPlace()매개변수: 없음
반환 값: None
이 Geocode의 장소 표현을 반환합니다. 전체 장소 세부정보를 가져오려면 place.fetchFields()를 호출해야 합니다. |
세부사항 상수
google.maps.addressValidation.Granularity
상수
주소 또는 지오코드에 있을 수 있는 다양한 세부사항입니다. 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
상수
취해야 할 잠재적인 후속 조치를 결정하는 데 도움이 되도록 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 클래스
미국 주소의 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 optional2자리 주 코드입니다. |
urbanization |
유형:
string optional푸에르토리코 도시화 이름입니다. |
zipCode |
유형:
string optional우편번호입니다(예: '10009'). |
zipCodeExtension |
유형:
string optional4자리 우편번호 확장입니다(예: '5023'). |
USPSData 클래스
google.maps.addressValidation.USPSData 클래스
주소의 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 optional2자리 배송 지점 코드입니다. |
dpvCMRA |
유형:
string optional주소가 CMRA (상업용 우편 수신 대행업체)인지 여부를 나타냅니다. CMRA는 고객을 위해 우편을 수신하는 사설 비즈니스입니다. 단일 문자를 반환합니다. |
dpvConfirmation |
유형:
string optionalDPV 확인에 가능한 값입니다. 단일 문자를 반환하거나 값을 반환하지 않습니다. |
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 optionalNoStat 유형을 나타냅니다. 이유 코드를 int로 반환합니다. |
dpvPBSA |
유형:
string optional주소가 PBSA 레코드와 일치함을 나타냅니다. 단일 문자를 반환합니다. |
dpvThrowback |
유형:
string optional우편물이 번지 주소로 배송되지 않음을 나타냅니다. 단일 문자를 반환합니다. |
dpvVacant |
유형:
string optional주소가 비어 있는지 여부를 나타냅니다. 단일 문자를 반환합니다. |
elotFlag |
유형:
string optionaleLOT 오름차순/내림차순 플래그 (A/D) |
elotNumber |
유형:
string optional향상된 이동 경로 (eLOT) 번호입니다. |
errorMessage |
유형:
string optionalUSPS 데이터 검색 오류 메시지입니다. 인위적으로 생성된 주소가 감지되어 USPS 처리가 일시중지된 경우에 값이 입력됩니다. |
fipsCountyCode |
유형:
string optionalFIPS 카운티 코드입니다. |
hasDefaultAddress |
유형:
boolean기본 주소가 발견되었지만 더 구체적인 주소가 있음을 나타내는 표시기입니다. |
hasNoEWSMatch |
유형:
boolean배송 주소는 일치할 수 있지만 EWS 파일에 곧 정확한 일치가 제공될 예정이라고 표시되어 있습니다. |
lacsLinkIndicator |
유형:
string optionalLACSLink 표시기입니다. |
lacsLinkReturnCode |
유형:
string optionalLACSLink 반환 코드입니다. |
pmbDesignator |
유형:
string optionalPMB (Private Mail Box) 단위 지정자입니다. |
pmbNumber |
유형:
string optionalPMB (Private Mail Box) 번호입니다. |
poBoxOnlyPostalCode |
유형:
boolean사서함 전용 우편번호입니다. |
postOfficeCity |
유형:
string optional주 우체국 도시입니다. |
postOfficeState |
유형:
string optional주 우체국 주입니다. |
standardizedAddress |
유형:
USPSAddress optionalUSPS 표준화된 주소입니다. |
suiteLinkFootnote |
유형:
string optional거리 또는 고층 건물 레코드를 스위트 정보와 일치시켜 생성된 각주입니다. 업체 이름 일치 항목이 발견되면 보조 번호가 반환됩니다. |
Verdict 클래스
google.maps.addressValidation.Verdict 클래스
제공된 주소의 후처리된 주소를 나타냅니다.
const {Verdict} = await google.maps.importLibrary("addressValidation")를 호출하여 액세스
Maps JavaScript API의 라이브러리를 참고하세요.
속성 | |
|---|---|
addressComplete |
유형:
boolean해결되지 않은 토큰이 없고 예상치 못한 주소 구성요소나 누락된 주소 구성요소가 없으면 주소가 완전한 것으로 간주됩니다. 설정되지 않은 경우 값이 false임을 나타냅니다. 자세한 내용은 Address.missingComponentTypes, Address.unresolvedTokens 또는 AddressComponent.unexpected 필드를 참고하세요. |
geocodeGranularity |
유형:
Granularity optionalGeocode의 세부사항에 관한 정보입니다. 이는 지오코딩된 위치가 얼마나 대략적인지 또는 세부적인지의 의미로 이해할 수 있습니다. |
hasInferredComponents |
유형:
boolean입력에 없던 주소 구성요소가 하나 이상 추론 (즉, 추가)되었습니다. 자세한 내용은 AddressComponent를 참고하세요. |
hasReplacedComponents |
유형:
boolean optional하나 이상의 주소 구성요소가 대체되었습니다. 자세한 내용은 AddressComponent를 참고하세요. |
hasUnconfirmedComponents |
유형:
boolean하나 이상의 주소 구성요소를 분류하거나 확인할 수 없습니다. 자세한 내용은 AddressComponent를 참고하세요. |
inputGranularity |
유형:
Granularity optional입력 주소의 세부사항입니다. 이는 입력 주소를 파싱한 결과이며 유효성 검사 신호를 제공하지 않습니다. 유효성 검사 신호는 validationGranularity를 참고하세요. |
possibleNextAction |
유형:
PossibleNextAction optionalAPI 응답의 다른 필드를 기반으로 취할 수 있는 다음 작업입니다. 자세한 내용은 PossibleNextAction을 참조하세요. |
validationGranularity |
유형:
Granularity optionalAPI가 주소를 완전히 검증할 수 있는 세부사항 수준입니다. 예를 들어 validationGranularity이 PREMISE이면 PREMISE 이상의 모든 주소 구성요소를 검증할 수 있습니다. |