UN LOCODE Location Codes API

Complete UN/LOCODE database — 100,000+ location codes for ports, airports, rail terminals, and logistics hubs worldwide. Filter by country, transport function, and IATA code.

原始信息汇总

数据集概述：UN LOCODE Location Codes API

该API提供对联合国贸易与运输地点代码（UN/LOCODE） 的编程访问，这是由联合国欧洲经济委员会（UNECE）维护的全球标准，用于标识国际贸易中涉及的港口、机场、内陆终端、铁路站和多式联运物流设施。

核心数据集

• 内容：完整的UN/LOCODE数据库，包含超过 100,000 个地点代码，覆盖全球的港口、机场、铁路终端和物流枢纽。

• 数据结构：每条记录包含以下字段：

  字段	类型	描述
  country	string	ISO 3166-1 alpha-2 国家代码（如 IT、US、DE）
  locode	string	3字符地点代码（如 GOA、LAX、HAM）
  full_code	string	完整的5字符UN/LOCODE（如 ITGOA）
  name	string	官方地点名称（可能包含变音符号）
  name_ascii	string	ASCII标准化名称，便于搜索
  subdivision	string	ISO 3166-2 行政区划代码（如 IT-GE）
  function	string	运输功能代码（见下方功能代码表）
  status	string	条目状态（如 AA, AC, AF, AI, AM, AS 等）
  coordinates	string	UNECE格式的经纬度（如 4424N 00855E）
  iata	string	适用的IATA机场代码（如 GOA、MXP）

• 运输功能代码：

  代码	含义
  1	海港
  2	铁路终端
  3	公路终端
  4	机场
  5	邮政交换
  6	多式联运/内陆集装箱堆场 (ICD)
  7	石油/石油终端
  B	边境口岸
  0	功能未知

  function字段为适用代码组成的字符串（例如 1---4--- 表示海港+机场）。

关键功能

• 完整代码查询：通过5字符UN/LOCODE（如 ITGOA）即时检索任意地点。
• 按国家列出（支持分页）：获取指定国家的所有地点，每次请求最多 1,000 条结果，按LOCODE排序。
• 按功能过滤：支持按运输模式过滤（海港、铁路终端、公路终端、机场、邮政交换、多式联运、石油终端或边境口岸）。
• IATA交叉引用：将IATA机场代码（如 MXP、JFK、CDG）直接解析为对应的UN/LOCODE记录。
• 全文搜索：按地点名称或ASCII标准化名称跨所有国家搜索，可设置国家范围限制。
• 带过滤与分页的列表：在单个请求中组合国家、功能、状态和名称过滤器，每次调用最多 500 条结果。

典型用例

• 货运代理与航运平台开发
• 海关申报与贸易合规系统
• 港口社区系统（PCS）与物流枢纽
• 供应链可视化与追踪平台
• 提单与海运单生成工具
• 机场/港口代码标准化与验证
• 企业资源规划系统（ERP）/运输管理系统（TMS）与国际地点数据集成
• IATA代码与贸易地点标识符的交叉引用

分页说明

• GET / 和 GET /country/{country} 端点支持 limit 和 offset 参数。
• 列表端点最大 limit 为 500，国家端点最大 limit 为 1,000。

快速入门示例

• 通过UN/LOCODE查询港口：GET /code/ITGOA
• 获取意大利所有海港：GET /?country=IT&function=1&limit=50
• 将IATA代码解析为UN/LOCODE：GET /iata/MXP
• 按名称搜索港口：GET /search?q=hamburg&country=DE
• 以分页形式列出德国所有地点：GET /country/DE?limit=100&offset=0