Package google.type

색인

LatLng

위도/경도 쌍을 나타내는 객체로 위도와 경도를 나타내는 복식 쌍으로 표현됩니다. 달리 명시되지 않는 한 이 객체는 WGS84 표준을 준수해야 합니다. 값은 정규화된 범위 내에 있어야 합니다.

필드
latitude

double

위도입니다. 범위는 [-90.0, +90.0]입니다.
longitude

double

경도입니다. 범위는 [-180.0, +180.0]입니다.

PostalAddress

우편 배달 또는 수취인 주소와 같은 우편 주소를 나타냅니다. 우편 주소가 있으면 우체국이 사업장, 사서함 또는 이와 유사한 주소로 물건을 배달할 수 있습니다. 도로, 마을, 산 등 지리적 위치를 모델링하기 위한 것이 아닙니다.

일반적인 경우 주소는 프로세스 유형에 따라 사용자 입력을 통해 또는 기존 데이터를 가져와 생성됩니다.

주소 입력/수정에 관한 조언: - https://github.com/google/libaddressinput과 같은 다국어 지원 주소 위젯을 사용하세요. - 필드가 사용되는 국가 밖에서 해당 필드를 입력 또는 수정할 수 있는 UI 요소가 사용자에게 표시되어서는 안 됩니다.

이 스키마를 사용하는 방법에 관한 자세한 내용은 https://support.google.com/business/answer/6397478을 참고하세요.

필드
revision

int32

PostalAddress의 스키마 버전입니다. 0이 아닌 값을 사용하면 API에서 INVALID_ARGUMENT 오류를 반환합니다.
region_code

string

선택사항입니다. 주소의 국가/지역에 해당하는 CLDR 지역 코드입니다. 자세한 내용은 https://cldr.unicode.org/ 및 https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html을 참고하세요. 예: 스위스의 경우 'CH'. 지역 코드가 제공되지 않으면 주소에서 추론됩니다. 최상의 성능을 위해 지역 코드를 알고 있다면 포함하는 것이 좋습니다. 일치하지 않거나 반복되는 지역이 있으면 실적이 저하될 수 있습니다. 예를 들어 address_lines에 이미 지역이 포함되어 있는 경우 이 필드에 지역 코드를 다시 입력하지 마세요. 지원되는 지역은 FAQ에서 확인할 수 있습니다.
language_code

string

입력 주소의 언어 코드는 나중에 사용할 수 있도록 예약되어 있으므로 지금은 무시됩니다. API는 해당 주소가 위치한 지역의 적절한 언어로 주소를 반환합니다.
postal_code

string

선택사항입니다. 주소의 우편번호입니다. 모든 국가에서 우편번호를 사용하거나 우편번호가 있어야 하는 것은 아니지만 사용되는 경우 주소 다른 부분의 추가 유효성 검사(예: 미국의 주/우편번호 유효성 검사)가 트리거될 수 있습니다.
sorting_code

string

선택사항입니다. 국가별 추가 정렬 코드입니다. 대부분의 지역에서는 사용되지 않습니다. 이 필드가 사용되는 경우 값은 'CEDEX'와 같은 문자열(선택적으로 숫자 뒤에 오는 경우(예: 'CEDEX 7')) 또는 '섹터 코드'(자메이카), '배송 지역 지표'(말라위) 또는 '우체국 지표'(예: 코트디부아르)를 나타내는 숫자만으로 구성됩니다.
administrative_area

string

선택사항입니다. 국가 또는 지역의 우편 주소에 사용되는 최상위 행정 구역 단위입니다. 예를 들어 미국의 주, 캐나다의 주, 구소련의 주 또는 프랑스의 도가 될 수 있습니다. 특히 스페인의 경우 이 지역은 자치지구가 아닌 주입니다 (예: '카탈로니아'가 아닌 '바르셀로나'). 많은 국가에서는 우편 주소에 행정 구역을 사용하지 않습니다. 예를 들어 스위스에서는 이 필드를 채우지 않은 상태로 두어야 합니다.
locality

string

선택사항입니다. 일반적으로 주소의 시/군/구 부분을 나타냅니다. 예: 미국 시, 이탈리아 코무네, 영국 포스트타운. 지역이 잘 정의되지 않거나 이 구조에 잘 맞지 않는 경우 지역을 비워 두고 address_lines를 사용합니다.
sublocality

string

선택사항입니다. 주소의 하위 지역입니다. 예를 들어 인근 지역, 자치구, 구일 수 있습니다.
address_lines[]

string

필수 항목입니다. 주소의 하위 수준을 설명하는 구조화되지 않은 주소 입력란입니다.

address_lines의 값에는 형식 정보가 없고 경우에 따라 하나의 필드에 여러 값이 포함될 수 있으므로(예: 'Austin, TX') 행 순서가 명확해야 합니다. 주소 입력란 순서는 주소의 국가/지역의 '봉투 순서'여야 합니다.

주소에 허용되는 최소 구조 표시는 address_lines에 배치된 모든 정보로 구성됩니다. region_code이 제공되지 않으면 주소 행에서 리전이 추론됩니다.

주소 중 지역에 해당하는 부분과 행정 구역에 해당하는 부분을 추측하는 대신 address_lines만 포함된 주소를 만든 다음 지오코딩하는 것이 전혀 구조화되지 않은 주소를 처리하는 방법으로 좋습니다.
recipients[]

string

이 입력란은 설정하지 마세요. Address Validation API는 현재 이를 사용하지 않습니다. 현재 API는 이 필드가 설정된 요청을 거부하지 않지만 정보는 삭제되며 응답에 반환되지 않습니다.
organization

string

이 입력란은 설정하지 마세요. Address Validation API는 현재 이를 사용하지 않습니다. 현재 API는 이 필드가 설정된 요청을 거부하지 않지만 정보는 삭제되고 응답에서 반환되지 않습니다.