nicolasverlhiac/geocode-csv

使用多地理编码提供商对CSV文件进行地理编码

本镜像提供了一个地理编码解决方案，用于处理包含联系地址的CSV文件，支持多个地理编码服务提供商。地理编码是将地址转换为地理坐标（纬度和经度）的过程，使企业和数据分析师能够在其应用程序和分析中利用基于位置的信息。

• 项目仓库：https://github.com/nicolasverlhiac/geocode-csv
• 获取帮助：https://github.com/nicolasverlhiac/geocode-csv/issues
• 维护者：来自.LOUD公司的Nicolas Verlhiac

核心功能和特性

• 使用指定的地理编码提供商对包含联系地址的CSV文件进行地理编码
• 为每个地址检索纬度和经度信息
• 在CSV文件中添加新列以存储纬度和经度
• 可灵活配置地理编码提供商（基于提供的API密钥）
• 适用于处理地址数据的企业和数据分析师

支持的地理编码提供商

• Google Maps
• MapBox
• OpenCage
• MapTiler
• Geoapify

使用场景和适用范围

适用于需要将地址数据转换为地理坐标的场景，例如：

• 企业客户地址地理分布分析
• 物流和配送路线优化
• 基于位置的市场分析
• 地理空间数据可视化项目

使用方法和配置说明

您可以通过直接从Docker Hub拉取镜像或从源代码构建镜像来使用此地理编码解决方案。

注意： 在执行Docker命令前，请确保您的系统已安装并运行Docker。

🐳 使用Docker Hub

1. 从Docker Hub拉取镜像：

bash
docker pull nicolasverlhiac/geocode-csv

2. 创建data目录并将输入CSV文件放入该目录：

   • CSV文件必须命名为input.csv
   • 您可以使用提供的sample-input.csv作为基础，复制该文件并将副本重命名为input.csv。该文件已包含所需的CSV结构，可作为您自己数据的模板。

3. 设置环境变量：根据您要使用的地理编码提供商，将相应的API密钥设置为环境变量。支持的环境变量包括：

   • GOOGLE_API_KEY：Google Maps API密钥
   • MAPBOX_API_KEY：MapBox API密钥
   • OPENCAGE_API_KEY：OpenCage API密钥
   • MAPTILER_API_KEY：MapTiler API密钥
   • GEOAPIFY_API_KEY：Geoapify API密钥

4. 使用选定的环境变量执行Docker容器：

bash
docker run --rm -v "$(pwd)/data:/app/csv" -e GOOGLE_API_KEY=your_key nicolasverlhiac/geocode-csv

5. 执行完成后，您将在data目录中找到包含纬度和经度信息的地理编码CSV文件output.csv。

🔧 本地构建镜像

1. 构建Docker镜像：

bash
docker build -t nicolasverlhiac/geocode-csv .

此命令使用当前目录中的Dockerfile构建镜像。-t标志允许您指定镜像的标签或名称。在此示例中，镜像被标记为nicolasverlhiac/geocode-csv。

2. 镜像构建完成后，您可以按照"使用Docker Hub"部分中描述的方式使用它。请遵循"使用Docker Hub"部分中提到的步骤2至5来对您的CSV文件进行地理编码。

通过本地构建镜像，您可以更好地控制镜像，必要时可以进行修改。此外，本地构建确保您拥有最新版本的代码和依赖项。

所需的CSV字段（input.csv示例）

在执行Docker命令前，需将CSV文件放置在data/input.csv路径下。以下是CSV文件的示例结构：

您可以使用位于/data目录中的sample-input.csv作为基础，复制该文件并将副本重命名为input.csv。该文件已包含所需的CSV结构，可作为您自己数据的模板。

系统要求

• Docker环境
• 地理编码提供商的API密钥

支持的架构

此地理编码解决方案支持以下架构：

• linux/386
• linux/amd64
• linux/arm/v5
• linux/arm/v7
• linux/arm64/v8
• linux/mips64le
• linux/ppc64le
• linux/s390x

无论您运行在传统的x86架构还是基于ARM的设备上，都可以使用此地理编码解决方案处理CSV文件。

贡献

欢迎贡献！如果您遇到任何问题或有改进建议，请提交issue或pull request。

许可

本项目采用MIT许可证。

致谢

此地理编码解决方案基于地理编码提供商的API构建。特别感谢https://github.com/geopy/geopy%E5%BA%93%E7%9A%84%E8%B4%A1%E7%8C%AE%E8%80%85%E3%80%82

参考资料

• Geopy文档
• https://github.com/geopy/geopy

赞助商

Geocode CSV是免费的开源软件，由以下优秀赞助商支持。

https://github.com/nicolasverlhiac/geocode-csv/assets/5034521/f2a5a8c4-ac8d-4d4e-acd2-de90e234a33a]([***] )