README

关于

此存储库的目的是维护法国大陆、海外省和海外领地（DROM）以及海外集体（COM）的尽可能最新的地区、省份、城市和村庄列表。

使用的数据来自 INSEE 网站

提供的文件格式为 .txt，编码为 ISO-8859-15，使用 CRLF。建议将其转换为 UTF-8，使用 LF。

指示的页面是可用的资源，因此它被解析以提取 省份、城市和村庄 的实体列表。

此存储库使用您操作系统上需要的一些技术

Docker 用于创建工作环境（apache、php7 和 mysql）。
Make 用于提供简单命令（Makefile）。
将项目克隆到您的计算机上的目录中。
使用 INSEE 的新资源更新 ./storage/builder 目录中的文件
- cities.txt
- departments.txt
- regions.txt
编辑 .env.exemple 文件并保存为 .env，修改所需的变量
- APP_KEY 以确保应用正常运行。
- GOOGLE_MAPS_KEY 是访问 Google Maps API 地理编码的有效密钥。
- COM_URI 如果需要更改 INSEE 的 COM 资源。
在命令行中进入该目录。
然后执行 make start 以通过 docker 启动项目。
一旦项目初始化，执行 make builder 以通过 docker 容器启动数据恢复。
构建完成后，您可以通过 make export 命令在 ./Exports 中导出数据。

如果您愿意，可以通过改进系统来参与此项目

数据以 csv、json 和 sql 三种格式提供，以便尽可能多的人可以使用。可用的文件使用链接系统，允许使用目标元素的 INSEE 编码轻松导航列表。以下列出每个文件中的元素。

事实上，目前互联网上可用的列表显然没有更新，无论是来自像 data.gouv.fr 这样的机构，还是来自像 sql.sh 这样的网站。