Package google.type

double

纬度（以度为单位）。它必须在 [-90.0, +90.0] 范围内。

double

经度（以度为单位）。它必须在 [-180.0, +180.0] 范围内。

string

采用与下方 language_code 对应的语言的本地化字符串。

string

文本的 BCP-47 语言代码，例如“en-US”或“sr-Latn”。

如需了解详情，请参阅 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier。

int32

PostalAddress 的架构修订版本。必须将其设置为 0，也就是最新版本。

所有新版本必须向后兼容旧版本。

string

必需。地址的国家/地区的 CLDR 地区代码。系统不会推断此字段，该值由用户确保正确。如需了解详情，请参阅 https://cldr.unicode.org/ 和 https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html。例如：瑞士的地区代码为“CH”。

string

选填。此地址内容的 BCP-47 语言代码（如果已知）。这通常是输入表单的界面语言，或者与地址的“国家/地区”中使用的某种语言或其转换后的其他语言相匹配。这可能会影响某些国家/地区的格式，但对数据的正确性并不重要，也不会影响任何验证或其他与格式无关的操作。

如果此值未知，则应省略（而不是指定可能不正确的默认值）。

示例：“zh-Hant”、“ja”、“ja-Latn”、“en”。

string

可选。地址的邮政编码。并非所有国家/地区都使用或要求使用邮政编码，但在使用邮政编码时，它们可能会触发以地址其他部分为参照的额外验证（例如美国的州或邮政编码验证）。

string

可选。特定于国家/地区的额外排序代码。大多数区域都未使用此功能。如果使用此元素，相应的值可以是“CEDEX”之类的字符串（可以选择后跟一个数字，例如“CEDEX 7”），也可以只是一个数字，表示“邮政区号”（牙买加）、“送达区域指示符”（马拉维）或“邮局指示符”（科特迪瓦）。

string

可选。最高行政区划，用于国家或地区的邮政地址。例如，此值可以是州、省、州（俄罗斯）或县。对于西班牙，此值为省而非自治区（例如此值为“巴塞罗那”而非“加泰罗尼亚”）。许多国家在邮政地址中不使用行政区划。例如，对于瑞士，此字段应留空。

string

可选。一般是指地址的城市或城镇部分。示例：美国的城市、意大利的市镇、英国的邮镇。对于没有明确定义市行政区或者其无法很好地对应这个结构的地区，应将 locality 留空并使用 address_lines。

string

可选。地址的子级市行政区。例如，此值可以是社区、自治市/镇/区或街区。

string

描述详细地址的非结构化地址行。

由于 address_lines 中的值没有类型信息，并且有时可能在单个字段中包含多个值（例如“Austin, TX”），因此清楚的行顺序很重要。地址行的顺序应该是地址所在“国家/地区”的“信封顺序”。在某些地方，此顺序有可能不同（例如日本），在这种情况下可以使用 address_language 来明确顺序（例如，“ja”表示从大到小排序，“ja-Latn”或“en”表示从小到大排序）。这样就可以根据语言选择地址中最具体的行。

地址的最小结构化表示形式由 region_code 和 address_lines 组成，其中所有其他信息都放在 address_lines 中。可以在没有地理编码的情况下非常近似地设置此地址的格式，但是在至少部分完成之前，不能对任何地址组成部分进行语义推理。

创建仅包含 region_code 和 address_lines 的地址然后进行地理编码，这是处理完全非结构化地址的推荐方法（而不是猜测地址的哪些部分是市行政区或行政区）。

string

可选。此地址的收件人。在某些情况下，该字段可能包含多行信息。例如，它可能包含“转交”信息。

string

可选。地址对应的组织的名称。