道

地理编码是将人类语言转换为数字坐标的桥梁。在地理信息领域，地址是人们日常使用的空间描述方式，而坐标是计算机能够理解的空间定位方式。本工具通过地址查询坐标，实现从自然语言到数字空间的映射，为各种地理应用提供基础数据支撑。

地址与坐标的转换不仅是技术操作，更是空间数据的数字化过程。通过将自然语言描述转换为精确的坐标，我们让地址获得了在数字世界中的定位能力，为地图展示、路径规划、空间分析等应用奠定基础。这是数字地理时代的基础能力之一。

法

地理编码遵循标准化的查询流程，通过调用地理编码服务实现地址到坐标的转换。

查询流程

1. 数据准备：收集待查询的地址数据，包含完整的行政区划信息（省、市、区、乡镇、社区）和详细地址。

2. 地址构建：将各层级地址信息拼接为完整的查询地址字符串，提高查询准确性。

3. API配置：配置地理编码服务的API密钥和请求参数，支持多个密钥轮换使用。

4. 批量查询：按顺序处理每个地址，调用地理编码API获取坐标信息。采用限流策略，避免请求频率过高。

5. 结果解析：解析API返回的JSON数据，提取经纬度坐标，并进行坐标系转换（GCJ02转WGS84）。

6. 边界校验：根据配置的边界范围，判断坐标是否在指定区域内。

7. 结果整合：将查询结果与原始地址数据对应，生成完整的坐标信息表。

请求策略

• 速率控制：通过延迟设置控制请求频率，避免触发API限流
• 随机延迟：支持添加随机延迟，模拟自然请求模式
• 密钥轮换：支持多个API密钥轮换使用，提高查询成功率
• 城市约束：利用城市信息缩小查询范围，提高匹配准确性

坐标系处理

• 输入数据：结构化地址信息
• API返回：GCJ02坐标系坐标
• 输出结果：自动转换为WGS84坐标系

边界校验机制

• 支持自定义边界范围（西南角和东北角坐标）
• 判断查询结果是否在边界范围内
• 为超出边界的结果标记特殊标识

术

本工具采用现代化前端技术栈，实现高效的地理编码功能。

核心技术依赖

axios

• 用途：发送HTTP请求调用地理编码API
• 官网：https://axios-http.com/
• 特点：Promise-based、支持拦截器、自动转换JSON

gcoord

• 用途：处理坐标系转换（GCJ02转WGS84）
• 官网：https://github.com/hujiulong/gcoord
• 特点：轻量级、纯JavaScript实现

关键实现

地址构建函数

function buildFullAddress(addressData) {
  const parts = []
  if (addressData.province) parts.push(addressData.province)
  if (addressData.city) parts.push(addressData.city)
  if (addressData.district) parts.push(addressData.district)
  if (addressData.township) parts.push(addressData.township)
  if (addressData.community) parts.push(addressData.community)
  if (addressData.address) parts.push(addressData.address)
  return parts.join('')
}

GCJ02转WGS84

const [wgsLng, wgsLat] = gcoord.transform(
  [gcjLng, gcjLat], 
  gcoord.GCJ02, 
  gcoord.WGS84
) as [number, number]

边界判断

function isInBounds(lng, lat, bounds) {
  return lng >= bounds.southwest.lng && 
         lng <= bounds.northeast.lng && 
         lat >= bounds.southwest.lat && 
         lat <= bounds.northeast.lat
}

技术架构

采用模块化设计：ApiService负责API调用和坐标转换，TemplateReader负责文件读取，TemplateExporter负责结果导出。支持多种地理编码服务提供商的扩展。