当前位置：首页 > news >正文

OpenAddresses完整教程：从零开始贡献地址数据源

news 2026/4/2 9:48:58

OpenAddresses完整教程：从零开始贡献地址数据源

【免费下载链接】openaddressesA global repository of open address data.项目地址: https://gitcode.com/gh_mirrors/op/openaddresses

OpenAddresses是一个全球开源地址数据仓库，收集来自世界各地的权威地址、地块、建筑物和街道中心线数据。这个项目为开发者和研究人员提供了免费、开放的地址数据基础设施，支持从地图应用到城市规划的各种创新项目。无论你是数据爱好者、GIS专家还是开发者，本教程将指导你如何从零开始为OpenAddresses贡献地址数据源。🚀

📋 OpenAddresses项目概览

OpenAddresses项目位于https://gitcode.com/gh_mirrors/op/openaddresses，是一个全球性的开源地址数据集合。项目结构清晰，按照国家和地区组织数据源，每个数据源都以JSON格式描述其元数据和访问方式。

项目的核心目录结构包括：

sources/- 包含全球各地地址数据源的JSON配置文件
schema/- 定义数据源的结构和验证规则
scripts/- 数据处理和转换脚本
test/- 测试文件

🔍 如何查找和验证新数据源

在贡献新数据源之前，首先需要确认该数据源尚未存在于项目中：

检查现有数据源：浏览sources/目录下的国家和地区子目录
验证数据权威性：确保数据来自官方或权威机构，如政府GIS部门、邮政服务等
确认数据格式：支持CSV、GeoJSON、Shapefile或ArcGIS服务等多种格式

例如，要检查美国田纳西州的数据源，可以查看sources/us/tn/目录，其中包含多个县的地址数据配置文件。

📝 创建新数据源的完整步骤

1. 理解数据源JSON结构

每个数据源都遵循标准JSON格式，包含以下核心字段：

{ "schema": 2, "coverage": { "country": "us", "state": "tn", "county": "Blount" }, "layers": { "addresses": [ { "name": "county", "data": "https://services3.arcgis.com/NIOS5f3vobGvnGtD/ArcGIS/rest/services/BlountAddressPoints/FeatureServer/0", "protocol": "ESRI", "conform": { "format": "geojson", "number": "STNUM", "street": ["PREDIR", "PRETYPE", "NAME", "SUFTYPE", "SUFDIR"], "city": "CITY", "postcode": "ZIP" } } ] } }

2. 命名文件和目录规范

OpenAddresses使用标准化的文件命名和目录结构：

国家代码：使用ISO 3166-1 alpha-2国家代码（如us、cn、de）
地区代码：使用ISO 3166-2地区代码（如tn、ca、ny）
文件名：使用地理实体名称（如countywide.json、city_of_new_york.json）

目录结构示例：sources/us/tn/blount.json

3. 配置conform对象

conform对象是数据转换的核心，它定义了如何从原始数据中提取标准化字段：

format：数据格式（geojson、csv、shapefile等）
number：门牌号字段
street：街道名称字段
city：城市字段
postcode：邮政编码字段
unit：单元号字段（如公寓号）

田纳西州政府GIS服务使用地址数据支持财产查询系统，展示了地址数据在实际应用中的价值

4. 验证数据源配置

在提交前，确保你的JSON配置通过项目验证：

运行本地测试：npm test（如果项目包含测试脚本）
检查JSON语法：确保没有语法错误
验证必需字段：所有必需字段都已正确填写

🛠️ 实用贡献技巧和最佳实践

处理不同类型的数据源

ESRI ArcGIS服务：

"protocol": "ESRI", "data": "https://example.com/ArcGIS/rest/services/AddressPoints/FeatureServer/0"

HTTP/HTTPS文件下载：

"protocol": "http", "data": "https://data.example.com/addresses.csv", "compression": "zip" // 可选：如果文件被压缩

FTP文件下载：

"protocol": "ftp", "data": "ftp://data.example.com/addresses.shp"

处理地址数据转换

地址数据标准化是OpenAddresses的核心功能。conform对象支持复杂的数据转换：

"conform": { "format": "geojson", "number": { "function": "prefixed_number", "field": "HOUSE_NUM" }, "street": [ "PRE_DIR", "STREET_NAME", "STREET_TYPE", "SUF_DIR" ], "city": "MUNICIPALITY", "postcode": "POSTAL_CODE" }