PostalAddress

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

일반적인 사용 사례에서는 프로세스 유형에 따라 사용자 입력을 통하거나 기존 데이터를 가져와 주소를 만들 수 있습니다.

주소 입력 / 수정에 관한 조언: - https://github.com/google/libaddressinput과 같은 i18n 지원 주소 위젯을 사용하세요. - 필드가 사용되는 국가 외의 지역을 입력 또는 수정할 수 있는 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 지역 코드입니다. 이는 추론되지 않으며, 값이 올바른지 사용자가 확인해야 합니다. 자세한 내용은 http://cldr.unicode.org/ 및 http://www.unicode.org/cldr/charts/30/secondary/territory_information.html을 참조하세요. 예: 스위스의 경우 'CH'
languageCode

string

선택사항입니다. 이 주소 콘텐츠의 BCP-47 언어 코드입니다 (알려진 경우). 주로 입력 양식의 UI 언어이거나 주소의 국가/지역에 사용되는 언어 중 하나 또는 음역된 언어와 일치해야 합니다. 이는 특정 국가에서 형식을 지정하는 데 영향을 줄 수 있지만 데이터의 정확성에는 중요하지 않으며, 유효성 검사 또는 형식을 사용하지 않는 관련 작업에 영향을 주지 않습니다.

이 값을 알 수 없는 경우 잘못될 수 있는 기본값을 지정하는 대신 이 값을 생략해야 합니다.

예: 'zh-Hant', 'ja', 'ja-Latn', 'en'.
postalCode

string

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

string

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

string

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

string

선택사항입니다. 일반적으로 주소의 시/군/구 부분을 나타냅니다. 예: 미국의 도시, IT 지역, 영국의 도시 지역이 잘 정의되지 않거나 이 구조에 잘 맞지 않는 지역에서는 지역을 비워 두고 addressLines를 사용합니다.
sublocality

string

선택사항입니다. 주소의 하위 지역입니다. 예를 들어 동네, 자치구, 구 등이 해당됩니다.
addressLines[]

string

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

addressLines의 값에는 형식 정보가 없고 경우에 따라 하나의 필드에 여러 값이 포함될 수 있으므로 (예: 'Austin, TX') 행 순서가 명확해야 합니다. 주소 입력란 순서는 주소의 국가/지역에 대한 '봉투 순서'여야 합니다. 이것이 달라질 수 있는 위치 (예: 일본)에서는 address_language를 사용하여 명시적으로 표시합니다 (예: 큰 크기에서 작은 순서로는 'ja', 작은 크기에서 큰 크기 순서는 'ja-Latn' 또는 'en'). 이렇게 하면 언어를 기반으로 가장 구체적인 주소 행을 선택할 수 있습니다.

주소에 허용되는 최소 구조 표현은 나머지 모든 정보가 addressLines에 배치된 regionCode로 구성됩니다. 지오코딩 없이 이러한 주소의 형식을 매우 대략적으로 지정할 수는 있지만, 적어도 부분적으로 확인될 때까지는 주소 구성요소에 관한 의미론적 추론이 불가능합니다.

지역이나 행정 구역 주소 부분을 추측하는 대신 regionCode와 addressLines만 포함된 주소를 만든 다음 지오코딩을 통해 완전히 구조화되지 않은 주소를 처리하는 것이 좋습니다.
recipients[]

string

선택사항입니다. 주소의 수신자입니다. 이 필드에는 특정 상황에서 여러 줄 정보가 포함될 수 있습니다. 예를 들어 '관리' 정보가 포함될 수 있습니다.
organization

string

선택사항입니다. 주소에 있는 조직의 이름입니다.