地址填写指南

本文档旨在为用户提供指导，以正确填写不同国家/地区的地址信息，介绍地址相关字段的含义与使用方式。

通用地址字段说明

地理库

• country_region：必填项，指定地址所在的国家或地区。
• region：必填项，指定地址所在的省份/州等
• city_v2：必填项，指定地址所在的城市或城镇。
• district_v2：指定地址所在的区县，仅中国香港要求必须填写。

address_line_X

用于存储地址详细信息的字段，address_line_1对于大多数国家/地区是必填项，但在一些国家/地区可能是选填项，其余address_line_X均为选填项。具体用途可能因国家/地区而异：

• address_line_1：通常用于详细地址或街道地址
• address_line_2：通常用于补充地址信息，如门牌号、街道号等
• ...

不同国家/地区有不同的 address_line 字段由于各国的地址格式和组成部分存在差异。

local_address_line_X

用于存储使用当地文字或字符集的地址信息，主要用于使用非拉丁字母的国家/地区。local_address_line_1是否必填因国家/地区而异，其余local_address_line_X均为选填项。

postal_code

邮政编码，是否必填因国家/地区而异。

地址填写规则示例

中国 (China)

| 地址填写字段 | 英文名 | 中文名 | 是否必填 |排序| | --------- | -------------------- | ----- | ----------- | --------- |-----| |country_region|Country/Region|国家 / 地区|是|1| |region|Province/City|省份|是|2| |city_v2|City|城市|是|7| |district_v2|District|区县|否|8| |local_address_line_1 | Address Line - Chinese | 详细地址 - 中文 | 是 |9| |address_line_1 | Address Line - Western Script | 详细地址 - 拼音或英文 | 否 |10| |postal_code|Postal Code|邮政编码|是|11| 地址结构为：4 级地理库（国家、省份、城市、区县）+详细地址（local_address_line_1）+邮政编码

注意事项

当传入请求包含 local_address_line_X 或 address_line_X，而该国家/地区定义的字段中不包含这些字段时，系统将忽略这些字段传入的值。这意味着：

• 只有在国家/地区特定规则中定义的字段才会被处理
• 传入未定义的字段不会导致错误，但这些字段的值将不会被使用

常见问题

Q：local_address_line_X与address_line_X的区别是什么？

• local_address_line_X 使用本地文字，而 address_line_X 通常使用拉丁字母。
• 例如，在波斯尼亚和黑塞哥维那，有使用斯拉夫文的 local_address_line 字段。
• 只有中国、日本等少数国家/地区包含local_address_line_X字段。

Q：字段的“排序”表示什么？

当某些展示场景需要展示全地址的时候，系统会根据字段的排序拼接完整地址。

Q：完整的地址结构是怎样的？

完整的地址结构为：n 级地理库（国家、省份、城市、区县）+详细地址（local_address_line_1/address_line_1）+邮政编码

地址结构因国家/地区而不同，差异包括地理库级别、是否包含邮政编码等。

附录：完整的国家/地区地址字段列表

飞书人事-地址填写规则 提供了不同国家/地区关于 address_line_X 和 local_address_line_X 等字段的详细说明。