位置服务 · 同步接口

逆地理编码API（经纬度转地址）接入指南

逆地理编码API把经纬度坐标翻译成人类可读的中文地址：传入longitude与latitude，返回国家、省、市、县区、街道、乡镇以及拼接好的formatted_address。适合GPS设备上报、用户定位展示、打卡签到地点描述等场景，约0.035元/次。

2026年8月20日更新 · 参数与计费已按当前生产接口核对

在线调试接口免费在线工具

接口速览

以下信息来自轻语API开放平台生产环境接口元数据，可直接用于技术选型评估。

接口地址	GET /data/api/reverseGeocoder
计费	约0.035元/次
频率限制	100次/分钟
超时时间	30秒
鉴权方式	apikey（URL参数）
请求方式	Query String传参

请求参数

参数名	必填	类型	说明
`apikey`	必填	`string`	用户的apikey，身份凭证（URL查询参数）
`longitude`	必填	`string`	Float，经度，如119.547729
`latitude`	必填	`string`	Float，纬度，如26.666222

响应示例

成功响应（HTTP 200）

{
  "msg": "操作成功",
  "code": 200,
  "data": {
    "code": 200,
    "data": {
      "country": "中国",
      "country_code": "CN",
      "province": "福建省",
      "city": "福州市",
      "county": "连江县",
      "street": "",
      "town": "",
      "formatted_address": "连江县, 福州市, 福建省, 350500, 中国",
      "longitude": "120.3444",
      "latitude": "26.2122",
      "type": "city"
    },
    "message": "解析成功"
  }
}

调用示例

cURL 示例

curl 'https://5555api.com/data/api/reverseGeocoder?longitude=119.547729&latitude=26.666222&apikey=YOUR_APIKEY'

JavaScript 示例

const lng = 119.547729, lat = 26.666222;
const url = `https://5555api.com/data/api/reverseGeocoder?longitude=${lng}&latitude=${lat}&apikey=YOUR_APIKEY`;

const resp = await fetch(url);
const result = await resp.json();
if (result.code === 200) {
  const info = result.data.data;
  console.log('完整地址:', info.formatted_address);
}

Python 示例

import requests

resp = requests.get(
    'https://5555api.com/data/api/reverseGeocoder',
    params={
        'longitude': 119.547729,
        'latitude': 26.666222,
        'apikey': 'YOUR_APIKEY'
    }
)
result = resp.json()
if result['code'] == 200:
    print('完整地址:', result['data']['data']['formatted_address'])

示例中的 YOUR_APIKEY 请替换为你在轻语API控制台获取的apikey；不要在公开页面或客户端代码中暴露正式API Key。

应用场景

定位信息人类可读化

App获取GPS坐标后实时转为“某某路附近”的地址描述，用于签到打卡和行程记录。

轨迹与围栏管理

车辆/外勤人员轨迹点批量逆编码，把坐标流变成可读的行程报告。

内容地域标注

UGC内容、图片EXIF中的坐标转城市名，自动打地域标签做同城分发。

常见问题

逆地理编码API怎么调用？

GET请求 https://5555api.com/data/api/reverseGeocoder，query参数传longitude（经度）、latitude（纬度）和apikey即可返回结构化地址。约0.035元/次。

经纬度顺序会弄反吗？

注意接口要求先longitude（经度）后latitude（纬度），传反会解析到错误位置或失败。国内经度约73-135，纬度约18-54，可用于自检。

formatted_address包含什么？

按县区、城市、省份、行政区划代码、国家的顺序拼接的完整地址字符串，可直接展示给用户。

为什么street或town有时为空？

取决于坐标点的位置密度：城区坐标通常能解析到街道/乡镇，偏远地区或海上坐标可能只到县市级别。

和地理编码API怎么配合使用？

先用地理编码把用户地址转成坐标存库，展示或核对时再用逆地理编码把坐标还原成地址，两个接口互为逆操作。

支持海外坐标吗？

接口以中国境内行政区划数据为主，海外坐标会返回country=对应国家但省市细节可能缺失。