MigrationsMap.net 项目技术文档

1. 安装指南

环境准备

在开始安装之前，请确保您的系统已经安装了以下软件：

• Python 3.x
• pip（Python 包管理工具）

安装依赖

1. 克隆项目代码到本地：

   git clone https://github.com/madewulf/MigrationsMap.net.git
   cd MigrationsMap.net
   

2. 安装所需的 Python 库：

   pip install requests
   

2. 项目的使用说明

数据生成流程

MigrationsMap.net 项目的主要功能是生成用于地图展示的 JSON 数据文件。以下是数据生成的详细步骤：

1. 运行 parser.py：

   • 该脚本从 global_migrant_origin_database_version_4.csv 文件中读取数据，生成两个文件：
     • code_to_name.json：包含国家代码与全英文名称的映射。
     • geoloc.json：包含所有国家中心坐标的 JSON 对象。

2. 运行 arrowcomputer2.py：

   • 该脚本根据 parser.py 生成的数据和 geoloc.json 中的坐标，生成每个国家的进出移民数据的 SVG 路径文件，并生成 code_to_coordinates.json 文件。

3. 运行 geojsontosvg.py：

   • 该脚本从 world.json 文件中读取国家边界数据，生成 world_svg_paths.json 文件，包含每个国家的 SVG 边界路径。

4. 运行 associate_map_to_db.py：

   • 该脚本用于解决 CSV 文件和 world.json 文件中国家名称不匹配的问题，生成 reconciliation.json 文件。

5. 运行 jsoncsvunifier.py：

   • 该脚本根据 world_svg_paths.json 和 reconciliation.json 文件，生成最终的 world_svg_paths_by_code.json 文件。

6. 运行 worlBankDataGetter.py：

   • 该脚本从世界银行 API 下载各种指标数据，并存储为 JSON 文件，如 GDP.json、UNDER-FIVE-MORTALITY.json 等。

运行项目

在完成数据生成后，您可以将生成的 JSON 文件用于地图展示。具体的使用方式可以参考项目的 README 文件或 Wiki 页面。

3. 项目API使用文档

数据生成API

• parser.py：

  • 功能：从 CSV 文件生成国家代码与名称的映射以及国家中心坐标。
  • 输出：code_to_name.json 和 geoloc.json。

• arrowcomputer2.py：

  • 功能：生成每个国家的进出移民数据的 SVG 路径文件。
  • 输出：in{CountryCode}.json 和 out{CountryCode}.json。

• geojsontosvg.py：

  • 功能：生成国家边界数据的 SVG 路径文件。
  • 输出：world_svg_paths.json。

• associate_map_to_db.py：

  • 功能：解决国家名称不匹配问题。
  • 输出：reconciliation.json。

• jsoncsvunifier.py：

  • 功能：生成最终的国家边界 SVG 路径文件。
  • 输出：world_svg_paths_by_code.json。

• worlBankDataGetter.py：

  • 功能：从世界银行 API 下载指标数据。
  • 输出：GDP.json、UNDER-FIVE-MORTALITY.json 等。

4. 项目安装方式

克隆项目

git clone https://github.com/madewulf/MigrationsMap.net.git
cd MigrationsMap.net

安装依赖

pip install requests

运行数据生成脚本

按照上述数据生成流程，依次运行各个 Python 脚本，生成所需的 JSON 数据文件。

通过以上步骤，您可以成功安装并使用 MigrationsMap.net 项目。