PostalAddress

• JSON 표현

우편 배송 또는 결제 주소와 같은 우편 주소를 나타냅니다. 우편 주소를 사용하면 우편 서비스에서 구내, 사서함 등으로 물품을 배송할 수 있습니다. 우편 주소는 도로, 마을, 산과 같은 지리적 위치를 모델링하기 위한 것이 아닙니다.

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

주소 입력 또는 수정에 관한 조언:

• https://github.com/google/libaddressinput과 같은 국제화 지원 주소 위젯을 사용합니다.
• 사용자에게 해당 필드가 사용되는 국가 이외의 국가에서 필드를 입력하거나 수정할 수 있는 UI 요소가 표시되어서는 안 됩니다.

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

JSON 표현
{ "revision": integer, "regionCode": string, "languageCode": string, "postalCode": string, "sortingCode": string, "administrativeArea": string, "locality": string, "sublocality": string, "addressLines": [ string ], "recipients": [ string ], "organization": string }

필드
revision	integer PostalAddress의 스키마 버전입니다. 최신 버전인 0으로 설정해야 합니다. 모든 새 버전은 이전 버전과 하위 호환되어야 합니다.
regionCode	string 필수 항목입니다. 주소의 국가/지역에 해당하는 CLDR 지역 코드입니다. 이 값은 추론되지 않으며 값이 올바른지 확인하는 것은 사용자의 책임입니다. 자세한 내용은 https://cldr.unicode.org/ 및 https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html을 참고하세요. 예: 스위스의 경우 'CH'
languageCode	string (선택사항) 이 주소 콘텐츠의 BCP-47 언어 코드입니다 (알려진 경우). 이는 입력 양식의 UI 언어인 경우가 많으며, 주소의 국가/지역에서 사용되는 언어 중 하나 또는 이에 상응하는 음역과 일치할 것으로 예상됩니다. 이는 특정 국가의 형식에 영향을 미칠 수 있지만 데이터의 정확성에는 중요하지 않으며 유효성 검사나 기타 형식과 관련 없는 작업에는 영향을 미치지 않습니다. 이 값을 알 수 없는 경우 잘못된 기본값을 지정하는 대신 생략해야 합니다. 예: 'zh-Hant', 'ja', 'ja-Latn', 'en'.
postalCode	string (선택사항) 주소의 우편번호입니다. 모든 국가에서 우편번호를 사용하거나 요구하는 것은 아니지만, 우편번호를 사용하는 경우 주소의 다른 부분 (예: 미국의 주 또는 우편번호 유효성 검사)과 함께 추가 유효성 검사가 트리거될 수 있습니다.
sortingCode	string (선택사항) 국가별 추가 분류 코드입니다. 대부분의 지역에서는 사용되지 않습니다. 사용되는 경우 값은 'CEDEX'와 같은 문자열이며, 뒤에 숫자 (예: 'CEDEX 7')가 오거나 숫자만으로 '부문 코드' (자메이카), '배송 지역 표시기' (말라위) 또는 '우체국 표시기' (코트디부아르)를 나타냅니다.
administrativeArea	string (선택사항) 국가 또는 지역의 주소에 사용되는 최상위 행정 구역 단위입니다. 예를 들어 주, 지방, 주(oblast) 또는 현이 될 수 있습니다. 스페인의 경우 자치구가 아닌 주입니다 (예: '카탈루냐'가 아닌 '바르셀로나'). 많은 국가에서 우편 주소에 행정 구역을 사용하지 않습니다. 예를 들어 스위스에서는 이 항목을 입력하지 않은 상태로 두어야 합니다.
locality	string (선택사항) 일반적으로 주소의 시/군/구 부분을 나타냅니다. 예: 미국 도시, 이탈리아 코무네, 영국 우편 도시 지역이 명확하게 정의되지 않거나 이 구조에 잘 맞지 않는 지역에서는 locality를 비워 두고 addressLines를 사용합니다.
sublocality	string (선택사항) 주소의 하위 지역입니다. 예를 들어 인근 지역, 자치구 또는 구역일 수 있습니다.
addressLines[]	string 주소의 하위 수준을 설명하는 구조화되지 않은 주소 입력란입니다. addressLines의 값에는 유형 정보가 없으며 단일 필드에 여러 값 (예: 'Austin, TX')이 포함될 수 있으므로 줄 순서가 명확해야 합니다. 주소 입력란의 순서는 주소의 국가 또는 지역에 대한 '봉투 순서'여야 합니다. 이 순서가 달라질 수 있는 지역 (예: 일본)에서는 address_language를 사용하여 명시적으로 지정합니다 (예: 큰 단위에서 작은 단위 순서의 경우 'ja', 작은 단위에서 큰 단위 순서의 경우 'ja-Latn' 또는 'en'). 이렇게 하면 언어에 따라 가장 구체적인 주소 줄을 선택할 수 있습니다. 허용되는 최소한의 구조적 주소 표현은 regionCode로 구성되며 나머지 모든 정보는 addressLines에 배치됩니다. 지오코딩 없이 이러한 주소의 형식을 대략적으로 지정할 수는 있지만, 적어도 부분적으로 해결될 때까지는 주소 구성요소에 대한 의미론적 추론을 할 수 없습니다. regionCode 및 addressLines만 포함하는 주소를 만든 다음 지오코딩하는 것이 완전히 구조화되지 않은 주소를 처리하는 데 권장되는 방법입니다 (주소의 어느 부분이 지역 또는 행정 구역인지 추측하는 것과 반대).
recipients[]	string (선택사항) 주소의 수신자입니다. 이 필드에는 특정 상황에서 여러 줄의 정보가 포함될 수 있습니다. 예를 들어 '수취인' 정보가 포함될 수 있습니다.
organization	string (선택사항) 주소에 있는 조직의 이름입니다.