Package google.type

索引

LatLng

表示纬度/经度对的对象。该对象以一对双精度数表示，分别代表纬度度数和经度度数。除非另有说明，否则该对象必须符合 WGS84 标准。值必须介于标准化范围内。

字段
latitude

double

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

double

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

PostalAddress

表示邮政地址，例如邮政递送或付款地址。给定邮政地址后，邮政服务可以将物品投递到处所、邮政信箱或其他投递地点。邮政地址不适用于描述道路、城镇或山区等地理位置。

在典型的使用场景中，地址将通过用户输入或导入现有数据来创建，具体取决于进程的类型。

关于输入或修改地址的建议：

  • 使用支持国际化的地址微件，例如 https://github.com/google/libaddressinput。
  • 在使用某个字段的国家/地区之外，不应向用户显示用于输入或修改该字段的界面元素。

如需详细了解如何使用此架构，请参阅：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 已包含相应区域，请勿在此字段中再次提供该区域代码。如需了解支持的地区，请参阅常见问题解答。
language_code

string

输入地址中的语言代码预留以供日后使用，目前会被忽略。该 API 会以相应地址所在地所用语言返回地址。
postal_code

string

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

string

可选。特定于国家/地区的额外排序代码。大多数区域都未使用此功能。在使用时，此值可以是字符串（例如“CEDEX”），可选地后跟数字（例如“CEDEX 7”），也可以是单独的数字，表示“部门代码”（牙买加）、“配送区域指标”（马拉维）或“邮局指标”（科特迪瓦）。
administrative_area

string

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

string

可选。一般是指地址的城市或城镇部分。示例：美国的城市、意大利的市镇、英国的邮镇。对于没有明确定义市行政区或者其无法很好地对应这个结构的地区，应将 locality 留空并使用 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 不会拒绝设置了此字段的请求，但系统会舍弃相应信息，不会在响应中返回。