要从地址列表中提取城市和国家/地区，请导入包含 Location 列的 CSV 或 Excel 文件，运行 Datablist 的 Location Lookup，再将返回的 City、Country、Country Code、Latitude 和 Longitude 映射到新属性。建议先用少量数据进行测试，并在使用坐标前检查含义不明确的地名。
例如，Location = Paris, France 可以得到 City = Paris、Country = France 和 Country Code = fr。如果查询到对应坐标，系统也会一并返回。只填写 Paris 不够具体，因此在已知国家/地区时，建议同时补充该信息。
在这篇分步指南中，你将了解：
从非结构化地点文本中提取城市和国家/地区
第 1 步：导入包含地址列表的 CSV 或 Excel 文件
准备一个 CSV 或 Excel 文件，每行填写一个地点，例如 Paris, France、Leiston, Suffolk, UK 或完整的街道地址。请保留原始文本，以便核对查询结果。
首先，你需要注册一个 Datablist 账号。
注册完成后，新建一个 collection，并上传包含地址的 CSV 文件。
创建 collection，然后选择 Import CSV/Excel 上传文件。
如有需要，请查看数据导入文档。
第 2 步：配置 Location Lookup enrichment
导入后，你应该会看到一个 collection，其中至少有一个属性包含非结构化地点数据。
地点数据可以是：
- 单个国家/地区
- 单个城市
- 城市与国家/地区的组合
- 完整地址
点击 Enrich 打开 enrichment catalog。
然后选择「Location Lookup」enrichment。
Enrichment 通过「Inputs」和「Outputs」运行。
「Inputs」是你提供给 enrichment 的数据，「Outputs」则是 enrichment 返回的数据。
将你的 Location 属性映射到 Location input。请检查系统建议的映射是否正确，不要默认它一定选中了正确的列。
接下来配置「Outputs」：
- 点击「+」按钮，自动创建属性并与 output 映射
- 或从 collection 中选择现有属性
「Location Lookup」enrichment 会返回以下 outputs：
- City - 从地点信息中识别出的城市名称
- Country - 地点文本中包含的国家/地区名称，或根据城市推断出的国家/地区
- Country Code - 可获取时返回两位字母的 ISO 3166-1 alpha-2 代码
- Latitude - 可获取时返回纬度坐标（适用于城市或完整地址）
- Longitude - 可获取时返回经度坐标（适用于城市或完整地址）
- Processed GeoFinder - 用于表明系统是否已尝试查询的复选框；即使该行没有地点查询结果，也会记录处理状态
完成 output 映射后，你的 collection 将如下所示：
第 3 步：运行 enrichment，提取结构化地点信息
Datablist 会按照以下优先级，对你的「current items」运行 enrichment：
- 已选中的 items
- 已筛选的 items
- 如果以上两项均不适用，则处理 collection 中的所有 items
建议先运行少量样本。将城市、国家/地区和坐标与原始文本进行对比；确认匹配结果无误后，再处理当前视图中的其余 items。Catalog 当前标示的价格为每处理一个地点消耗 0.05 credits；只要查询值不为空，即使没有找到结果，也可能消耗 credits。
界面会显示一个计数器，展示当前 batch 中的 item 数量以及已经处理的数量。
运行完成后，请检查空白行和存在歧义的结果。系统推测出的城市或坐标不能视为已经验证的街道地址。
第 4 步：按需将数据导出为 CSV 或 Excel 文件
你可以将数据保留在 Datablist 中，用于整理 leads；也可以点击「Export」按钮，将数据导出为 CSV 或 Excel 文件。
Location Lookup Enrichment 的应用场景
从 LinkedIn 地点数据中提取城市和国家/地区
Location Lookup 可以将潜在客户列表中的地点字符串转换为结构化数据，包括从公开 LinkedIn 个人资料中复制的地点文本。请保留原始文本，以便核查名称相同的不同地点。
将 LinkedIn 个人资料导出为 CSV 文件，再导入 Datablist 处理 leads 的地点信息。
使用经纬度筛选地址列表
开展本地营销时，你可能需要筛选地址列表，排除距离某个 GPS 坐标点过远的地址。为此，需要先提取这些地址的经纬度坐标。
然后点击「Filters」按钮，打开筛选窗口。
如需建立一个近似的地理矩形区域，请分别为 Latitude 和 Longitude 设置上下限。1 纬度约等于 111 公里，而 1 经度所代表的距离会随纬度变化。矩形筛选并不等同于按半径搜索，因此在使用该分群前，请务必核查边界附近的结果。
常见问题
使用 Datablist 可以查询多少个地点？
Catalog 当前标示的价格为每处理一个地点消耗 0.05 credits。城市和国家/地区组合可能通过本地查询匹配；含义不明确的地点或完整地址则可能需要调用外部 geocoding 服务。只要查询值不为空，即使没有找到地点，也可能消耗 credits。批量运行前，请检查你的套餐、credits 余额和样本输出。
处理地点列表需要多长时间？
处理时间取决于输入数据的质量、列表大小，以及是否需要调用外部 geocoder。建议先运行一批样本，以估算整个地址列表的处理时间。
如果 output 属性中已有数据怎么办？
请检查运行设置中的 Existing data rule。目前，当现有数据发生冲突时，默认规则是覆盖已映射的 outputs。如果需要保留原数据，请选择 Skip items with existing values 或 Update only empty cells。在处理其余数据前，请先预览样本结果。
