Package google.type

색인

• LatLng(메시지)
• PostalAddress(메시지)

LatLng

위도/경도 쌍을 나타내는 객체로 위도(도)와 경도(도)를 나타내는 double의 쌍으로 표현됩니다. 달리 명시되지 않는 한 이 객체는 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 선택사항입니다. 일반적으로 주소의 시/군/구 부분을 나타냅니다. 예: 미국 도시, IT 코뮌, 영국 우체국 지역이 잘 정의되지 않거나 이 구조에 잘 맞지 않는 경우 지역을 비워 두고 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가 이 필드가 설정된 요청을 거부하지 않지만 정보가 삭제되고 응답에 반환되지 않습니다.