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。示例:“瑞士”代表瑞士。如果未提供区号,系统将根据地址推断出该区号。为获得最佳性能,建议您添加区号(如果您知道)。如果地区不一致或重复,可能会导致性能不佳,例如,如果 address_lines 已包含地区,请勿在此字段中再次提供地区代码。如需查看支持的区域,请参阅常见问题解答

language_code

string

输入地址中的语言代码已预留供日后使用,目前会被忽略。API 会返回地址所在位置的相应语言的地址。

postal_code

string

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

sorting_code

string

可选。特定于国家/地区的额外排序代码。大多数区域都未使用此功能。在使用它的地方,此值可以是一个类似“CEDEX”的字符串,后面可能会跟一个数字(例如“CEDEX 7”),或者只有一个数字,代表“管制区代码”(牙买加),“投递区域指标”(马拉维)或“邮局指标”(例如科特迪瓦)。

administrative_area

string

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

locality

string

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