색인
LatLng
(메시지)PostalAddress
(메시지)
LatLng
위도/경도 쌍을 나타내는 객체로 위도와 경도를 나타내는 복식 쌍으로 표현됩니다. 달리 명시되지 않는 한 이 객체는 WGS84 표준을 준수해야 합니다. 값은 정규화된 범위 내에 있어야 합니다.
필드 | |
---|---|
latitude |
위도입니다. 범위는 [-90.0, +90.0]입니다. |
longitude |
경도입니다. 범위는 [-180.0, +180.0]입니다. |
PostalAddress
우편 배달 주소나 수취인 주소와 같은 우편 주소를 나타냅니다. 우편 주소가 있으면 우체국이 사업장, 사서함 또는 이와 유사한 주소로 물건을 배달할 수 있습니다. 우편 주소는 도로, 마을, 산과 같은 지리적 위치를 모델링하기 위한 것이 아닙니다.
일반적인 경우 주소는 프로세스 유형에 따라 사용자 입력을 통해 또는 기존 데이터를 가져와 생성됩니다.
주소 입력 또는 수정에 관한 도움말:
- https://github.com/google/libaddressinput과 같은 다국어 지원 주소 위젯을 사용하세요.
- 필드가 사용되는 국가 밖에서 해당 필드를 입력 또는 수정할 수 있는 UI 요소가 사용자에게 표시되어서는 안 됩니다.
이 스키마를 사용하는 방법에 대한 자세한 내용은 https://support.google.com/business/answer/6397478을 참고하세요.
필드 | |
---|---|
revision |
|
region_code |
선택사항입니다. 주소의 국가/지역에 해당하는 CLDR 지역 코드입니다. 자세한 내용은 https://cldr.unicode.org/ 및 https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html을 참고하세요. 예: 스위스의 경우 'CH'. 지역 코드를 제공하지 않으면 주소에서 추론됩니다. 최상의 성능을 위해 지역 코드를 알고 있다면 포함하는 것이 좋습니다. 일치하지 않거나 반복되는 지역이 있으면 실적이 저하될 수 있습니다. 예를 들어 |
language_code |
입력 주소의 언어 코드는 향후 사용을 위해 예약되어 있으며 현재는 무시됩니다. API는 주소가 있는 위치에 적합한 언어로 주소를 반환합니다. |
postal_code |
선택사항입니다. 주소의 우편번호입니다. 모든 국가에서 우편번호를 사용하거나 우편번호가 있어야 하는 것은 아니지만 사용되는 경우 주소 다른 부분의 추가 유효성 검사 (예: 미국의 주 또는 우편번호 유효성 검사)가 트리거될 수 있습니다. |
sorting_code |
선택사항입니다. 국가별 추가 정렬 코드입니다. 대부분의 지역에서는 사용되지 않습니다. 이 필드가 사용되는 경우 값은 'CEDEX'와 같은 문자열(선택적으로 숫자 뒤에 오는 경우(예: 'CEDEX 7')) 또는 '섹터 코드'(자메이카), '배송 지역 지표'(말라위) 또는 '우체국 지표'(코트디부아르)를 나타내는 숫자만으로 구성됩니다. |
administrative_area |
선택사항입니다. 국가 또는 지역의 우편 주소에 사용되는 최상위 행정 구역 단위입니다. 예를 들어 미국의 주, 캐나다의 주, 구소련의 주 또는 프랑스의 도가 될 수 있습니다. 스페인의 경우 광역 자치주가 아니라 주(province)입니다(예: '카탈로니아'가 아니라 '바르셀로나'). 많은 국가에서는 우편 주소에 행정 구역을 사용하지 않습니다. 예를 들어 스위스에서는 이 필드를 채우지 않은 상태로 두어야 합니다. |
locality |
선택사항입니다. 일반적으로 주소의 시/군/구 부분을 나타냅니다. 예: 미국 시, 이탈리아 코무네, 영국 포스트타운. 지역이 잘 정의되지 않거나 이 구조에 잘 맞지 않는 경우 |
sublocality |
선택사항입니다. 주소의 하위 지역입니다. 예를 들어 인근 지역, 자치구, 구일 수 있습니다. |
address_lines[] |
필수 항목입니다. 주소의 하위 수준을 설명하는 구조화되지 않은 주소 입력란입니다. |
recipients[] |
이 입력란은 설정하지 마세요. Address Validation API는 현재 이를 사용하지 않습니다. 현재 API는 이 필드가 설정된 요청을 거부하지 않지만 정보는 삭제되며 응답에 반환되지 않습니다. |
organization |
이 입력란은 설정하지 마세요. Address Validation API는 현재 이를 사용하지 않습니다. 현재 API는 이 필드가 설정된 요청을 거부하지 않지만 정보는 삭제되며 응답에 반환되지 않습니다. |