색인
LatLng(메시지)LocalizedText(메시지)PostalAddress(메시지)
LatLng
위도/경도 쌍을 나타내는 객체로 위도와 경도를 나타내는 복식 쌍으로 표현됩니다. 달리 명시되지 않는 한 이 객체는 WGS84 표준을 준수해야 합니다. 값은 정규화된 범위 내에 있어야 합니다.
| 필드 | |
|---|---|
latitude |
위도입니다. 범위는 [-90.0, +90.0]입니다. |
longitude |
경도입니다. 범위는 [-180.0, +180.0]입니다. |
LocalizedText
특정 언어로 현지화된 텍스트의 변형입니다.
| 필드 | |
|---|---|
text |
아래 |
language_code |
텍스트의 BCP-47 언어 코드입니다(예: 'en-US' 또는 'sr-Latn'). 자세한 내용은 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier를 참조하세요. |
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 |
선택사항입니다. 이 주소 콘텐츠의 BCP-47 언어 코드입니다 (알려진 경우). 종종 입력 양식의 UI 언어이거나 주소의 국가/지역에서 사용되는 언어 중 하나 또는 음역된 언어와 일치해야 합니다. 이는 일부 국가에서 형식을 갖추는 데 영향을 줄 수 있지만 데이터의 정확성에는 중요하지 않으며, 유효성 검사 작업이나 형식을 갖추는 것과 관련 없는 기타 작업에는 영향이 없습니다. 이 값을 알 수 없다면 잘못될 가능성이 있는 기본값을 지정하는 대신 이 값을 생략해야 합니다. 예: 'zh-Hant', 'ja', 'ja-Latn', 'en'. |
postal_code |
선택사항입니다. 주소의 우편번호입니다. 모든 국가에서 우편번호를 사용하거나 우편번호가 있어야 하는 것은 아니지만 사용되는 경우 주소 다른 부분의 추가 유효성 검사 (예: 미국의 주 또는 우편번호 유효성 검사)가 트리거될 수 있습니다. |
sorting_code |
선택사항입니다. 국가별 추가 정렬 코드입니다. 대부분의 지역에서는 사용되지 않습니다. 이 필드가 사용되는 경우 값은 'CEDEX'와 같은 문자열(선택적으로 숫자 뒤에 오는 경우(예: 'CEDEX 7')) 또는 '섹터 코드'(자메이카), '배송 지역 지표'(말라위) 또는 '우체국 지표'(코트디부아르)를 나타내는 숫자만으로 구성됩니다. |
administrative_area |
선택사항입니다. 국가 또는 지역의 우편 주소에 사용되는 최상위 행정 구역 단위입니다. 예를 들어 미국의 주, 캐나다의 주, 구소련의 주 또는 프랑스의 도가 될 수 있습니다. 스페인의 경우 광역 자치주가 아니라 주(province)입니다(예: '카탈로니아'가 아니라 '바르셀로나'). 많은 국가에서는 우편 주소에 행정 구역을 사용하지 않습니다. 예를 들어 스위스에서는 이 필드를 채우지 않은 상태로 두어야 합니다. |
locality |
선택사항입니다. 일반적으로 주소의 시/군/구 부분을 나타냅니다. 예: 미국 시, 이탈리아 코무네, 영국 포스트타운. 지역이 잘 정의되지 않거나 이 구조에 잘 맞지 않는 경우 |
sublocality |
선택사항입니다. 주소의 하위 지역입니다. 예를 들어 인근 지역, 자치구, 구일 수 있습니다. |
address_lines[] |
주소의 하위 수준을 설명하는 구조화되지 않은 주소 입력란입니다.
주소에 허용되는 최소 구조 표시는 나머지 모든 정보가 주소 중 지역에 해당하는 부분과 행정 구역에 해당하는 부분을 추측하는 대신 |
recipients[] |
선택사항입니다. 주소의 수신자입니다. 경우에 따라 이 필드에 여러 줄로 구성된 정보가 포함될 수 있습니다. 예를 들어 '전교' 정보가 포함될 수 있습니다. |
organization |
선택사항입니다. 주소에 있는 조직의 이름입니다. |