道

逆地理编码是连接数字坐标与现实世界的桥梁。在地理信息领域，坐标是抽象的数字，而地址是人们能够理解和使用的现实标识。本工具通过坐标反查地址，实现从数字空间到现实世界的映射，让地理数据获得实际意义。

坐标与地址的转换不仅是技术操作，更是数据价值的提升过程。通过将冰冷的数字坐标转换为鲜活的地址信息，我们赋予数据以现实意义，使其能够被更多人理解和应用。这是地理信息服务的核心价值所在。

法

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

查询流程

1. 数据准备：收集待查询的坐标数据，包含点位名称和经纬度信息。

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

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

4. 结果解析：解析API返回的JSON数据，提取行政区划信息（省、市、区）和详细地址。

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

请求策略

• 速率控制：通过延迟设置控制请求频率，避免触发API限流
• 随机延迟：支持添加随机延迟，模拟自然请求模式
• 密钥轮换：支持多个API密钥轮换使用，提高查询成功率
• 混合模式：可选择单一密钥或轮换密钥模式

坐标系统处理

• 输入坐标：支持WGS84坐标系
• 内部转换：自动处理坐标系差异
• 结果精度：返回精确到街道级别的地址信息

错误处理机制

• 请求失败：记录错误信息，继续处理后续数据
• 超时处理：设置合理的请求超时时间
• 结果验证：检查返回数据的完整性和有效性

术

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

核心技术依赖

axios

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

GeocodeBatchService（内部模块）

• 用途：封装批量地理编码的延迟控制、错误重试和进度回调逻辑
• 位置：src/utils/GeocodeBatchService.ts

amapService（内部模块）

• 用途：高德地图 API Key 验证，提供商接口抽象
• 位置：src/utils/amapService.ts

关键实现

API查询函数

async function querySingleAddress(longitude, latitude, apiKey, provider) {
  const params = {
    key: apiKey,
    location: `${longitude},${latitude}`,
    output: 'json',
  }
  
  const response = await axios.get(config.url, { params, timeout: 10000 })
  
  if (response.status === 200) {
    const parsed = config.responseParser(response.data)
    return { ...parsed, longitude, latitude, provider }
  }
  
  throw new Error('查询失败')
}

批量查询实现

export async function batchQueryAddresses(points, apiKeys, options, onProgress) {
  const results = []
  
  for (let i = 0; i < points.length; i++) {
    const point = points[i]
    
    await new Promise(resolve => 
      setTimeout(resolve, getRandomDelay(options))
    )
    
    const result = await querySingleAddress(
      point.longitude, point.latitude, 
      selectedKey.key, selectedKey.provider
    )
    
    results.push(result)
  }
  
  return results
}

技术架构

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