索引
日期
表示整个或部分日历日期，例如生日。一天中的时间和时区要么在别处指定，要么不重要。该日期相对于公历。它可以表示以下其中一项：
- 包含非零年、月和日值的完整日期
- 月份和日期值，年份值为零，例如周年纪念日
- 单独的年份，月份值和日期值为零
- 年份值和月份值，日期值为零，例如信用卡失效日期
相关类型为 google.type.TimeOfDay 和 google.protobuf.Timestamp。
| 字段 | |
|---|---|
year |
日期中的年份。必须是 1 到 9999 之间的数字，如果使用 0，则可以指定不含年份的日期。 |
month |
一年中的某月。必须是 1 到 12 之间的数字，如果为 0，则表示不包含月份和日期。 |
day |
一个月中的第几天。必须是 1 到 31 之间的数字，并且对年份和月份有效，或者为 0 表示单独指定年份，或者在日期不重要的情况下指定年份和月份。 |
DayOfWeek
表示星期几。
| 枚举 | |
|---|---|
DAY_OF_WEEK_UNSPECIFIED |
未指定星期几。 |
MONDAY |
星期一 |
TUESDAY |
星期二 |
WEDNESDAY |
星期三 |
THURSDAY |
星期四 |
FRIDAY |
星期五 |
SATURDAY |
星期六 |
SUNDAY |
星期日 |
LatLng
表示纬度/经度对的对象。该对象以一对双精度数表示，分别代表纬度度数和经度度数。除非另有说明，否则该对象必须符合 WGS84 标准。值必须介于标准化范围内。
| 字段 | |
|---|---|
latitude |
纬度（以度为单位）。它必须在 [-90.0, +90.0] 范围内。 |
longitude |
经度（以度为单位）。它必须在 [-180.0, +180.0] 范围内。 |
Money
表示含有货币类型的金额。
| 字段 | |
|---|---|
currency_code |
ISO 4217 中定义的由三个字母组成的货币代码。 |
units |
金额的整数单位。例如，如果 |
nanos |
金额的纳米 (10^-9) 单位数。这个值必须在 -999999999（含）和 +999999999（含）之间。如果 |
PostalAddress
表示邮政地址，例如邮政递送或付款地址。给定邮政地址时，邮政服务可以将物品投递到处所、邮政信箱或其他投递地点。此对象不模拟地理位置（道路、城镇、山区）。
在典型的使用场景中，地址将通过用户输入或导入现有数据来创建，具体取决于进程的类型。
有关输入/修改地址的建议：- 使用国际化地址微件，例如 https://github.com/google/libaddressinput。在使用某个字段的国家/地区之外，不应向用户显示界面元素，供其输入或修改字段。
如需详细了解如何使用此架构，请参阅：https://support.google.com/business/answer/6397478
| 字段 | |
|---|---|
revision |
所有新版本必须向后兼容旧版本。 |
region_code |
必需。地址的国家/地区的 CLDR 地区代码。系统不会推断此字段，该值由用户确保正确。如需了解详情，请参阅 http://cldr.unicode.org/ 和 http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html。例如：瑞士的地区代码为“CH”。 |
language_code |
可选。此地址内容的 BCP-47 语言代码（如果已知）。这通常是输入表单的界面语言，或者与地址的“国家/地区”中使用的某种语言或其转换后的其他语言相匹配。这可能会影响某些国家/地区的格式，但对数据的正确性并不重要，也不会影响任何验证或其他与格式无关的操作。 如果此值未知，则应省略（而不是指定可能不正确的默认值）。 示例：“zh-Hant”、“ja”、“ja-Latn”、“en”。 |
postal_code |
可选。地址的邮政编码。并非所有国家/地区都使用或要求使用邮政编码，但在使用邮政编码时，它们可能会触发地址其他部分的额外验证（例如美国的州/邮政编码验证）。 |
sorting_code |
可选。特定于国家/地区的额外排序代码。大多数区域都未使用此功能。在使用它的地方，此值可以是一个类似“CEDEX”的字符串，后面可能会跟一个数字（例如“CEDEX 7”），或者只有一个数字，代表“管制区代码”（牙买加），“投递区域指标”（马拉维）或“邮局指标”（例如科特迪瓦）。 |
administrative_area |
可选。最高行政区划，用于国家或地区的邮政地址。例如，此值可以是州、省、州（俄罗斯）或县。具体来说，对于西班牙，此值为省而非自治区（例如此值为“巴塞罗那”而非“加泰罗尼亚”）。许多国家在邮政地址中不使用行政区划。例如对于瑞士，此字段应留空。 |
locality |
可选。一般是指地址的城市/城镇部分。示例：美国的城市、意大利的市镇、英国的邮镇。对于没有明确定义 locality 或者其无法很好地对应这个结构的区域，应将 locality 留空并使用 address_lines。 |
sublocality |
可选。地址的子级市行政区。例如，此值可以是社区、自治市/镇/区、行政区。 |
address_lines[] |
描述详细地址的非结构化地址行。 由于 address_lines 中的值没有类型信息，并且有时可能在单个字段中包含多个值（例如“Austin, TX”），因此清楚的行顺序很重要。地址行的顺序应该是地址的国家/地区的“信封顺序”。在某些地方，此顺序有可能不同（例如日本），address_language 有助于使其明确（例如，“ja”表示从大到小排序，“ja-Latn”或“en”表示从小到大排序）。这样就可以根据语言选择地址的具体行。 地址的最小结构化表示形式由 region_code 和 address_lines 组成，其中所有其他信息都放在 address_lines 中。可以在没有地理编码的情况下非常近似地设置此地址的格式，但是在至少部分完成之前，不能对任何地址组成部分进行语义推理。 创建仅包含 region_code 和 address_lines 的地址，然后进行地理编码是处理完全非结构化地址的推荐方法（而不是猜测地址的哪些部分是城市/市镇或行政区）。 |
recipients[] |
可选。此地址的收件人。在某些情况下，该字段可能包含多行信息。例如，它可能包含“转交”信息。 |
organization |
可选。地址对应的组织的名称。 |
TimeOfDay
表示一天中的某个时间。日期和时区不重要，或在别处指定。API 可以选择允许闰秒。相关类型为 google.type.Date 和 google.protobuf.Timestamp。
| 字段 | |
|---|---|
hours |
一天中的小时（采用 24 小时制）。值应为 0 到 23。对于业务结束时间等场景，API 可以选择允许“24:00:00”一值。 |
minutes |
一天中某小时的分钟数。值必须是介于 0 和 59 之间的数字。 |
seconds |
时间的秒数部分。通常必须是介于 0 和 59 之间的数字。如果 API 允许闰秒，则 API 可以允许 60 一值。 |
nanos |
秒数的小数部分（以纳秒为单位）。值必须是介于 0 和 999999999 之间的数字。 |