地理编码 - 澄曜API Hub

基本信息

接口调用前需要确认的核心配置。

接口地址/api/geocoder

请求方式GET

返回格式JSON

调用权限需登录

ApiKey不需要

创建时间2026-05-20

脚本路由geocoder

📊 当前您的权限信息

会员等级

免费用户

调用频率限制

100 次/分钟

可访问API类型

仅免费API

💡 注册成为普通会员可免审核即时获得 Key，调用频率提升至 180 次/分钟。升级VIP 可解锁全部API，调用频率提升至 300 次/分钟。

请求参数说明

必填参数必须传入，示例值可直接用于联调。

参数名	必填	类型	说明	示例值
`key`	是	string	需要审核通过的 ApiKey。请注册账号获取API Key。	`YOUR_API_KEY`
`action`	否	string	操作类型：geocode=地址转坐标 regeocode=坐标转地址 ip=IP定位	`geocode`
`address`	否	string	待编码的地址（geocode时必填）	`北京市朝阳区望京SOHO`
`city`	否	string	指定城市（geocode时可选，提高精度）	`北京`
`location`	否	string	经纬度坐标，格式lng,lat（regeocode时必填）	`116.397428,39.90923`
`radius`	否	number	搜索半径（regeocode时），默认1000米，范围1-3000	`1000`
`poitype`	否	string	POI类型（regeocode时可选）	`餐饮服务`
`ip`	否	string	IP地址（ip时可选，默认客户端IP）	`114.247.50.2`

示例代码

优先使用示例地址测试请求参数是否正确。

示例请求

https://api.ruseo.cn/api/geocoder?action=geocode&address=%E5%8C%97%E4%BA%AC%E5%B8%82%E6%9C%9D%E9%98%B3%E5%8C%BA%E6%9C%9B%E4%BA%ACSOHO&city=%E5%8C%97%E4%BA%AC&location=116.397428%2C39.90923&radius=1000&poitype=%E9%A4%90%E9%A5%AE%E6%9C%8D%E5%8A%A1&ip=114.247.50.2

cURL

curl "https://api.ruseo.cn/api/geocoder?action=geocode&address=%E5%8C%97%E4%BA%AC%E5%B8%82%E6%9C%9D%E9%98%B3%E5%8C%BA%E6%9C%9B%E4%BA%ACSOHO&city=%E5%8C%97%E4%BA%AC&location=116.397428%2C39.90923&radius=1000&poitype=%E9%A4%90%E9%A5%AE%E6%9C%8D%E5%8A%A1&ip=114.247.50.2"

PHP

$url = 'https://api.ruseo.cn/api/geocoder?action=geocode&address=%E5%8C%97%E4%BA%AC%E5%B8%82%E6%9C%9D%E9%98%B3%E5%8C%BA%E6%9C%9B%E4%BA%ACSOHO&city=%E5%8C%97%E4%BA%AC&location=116.397428%2C39.90923&radius=1000&poitype=%E9%A4%90%E9%A5%AE%E6%9C%8D%E5%8A%A1&ip=114.247.50.2';
$response = file_get_contents($url);
$data = json_decode($response, true);

JavaScript

fetch('https://api.ruseo.cn/api/geocoder?action=geocode&address=%E5%8C%97%E4%BA%AC%E5%B8%82%E6%9C%9D%E9%98%B3%E5%8C%BA%E6%9C%9B%E4%BA%ACSOHO&city=%E5%8C%97%E4%BA%AC&location=116.397428%2C39.90923&radius=1000&poitype=%E9%A4%90%E9%A5%AE%E6%9C%8D%E5%8A%A1&ip=114.247.50.2')
  .then(res => res.json())
  .then(data => console.log(data));

返回说明

实际返回内容以接口脚本处理结果为准。

返回示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "route": "geocoder",
        "example": true
    }
}

返回参数说明

参数名	类型	说明	示例值
`action`	string	执行的操作类型	`geocode`
`formatted_address`	string	标准地址格式	`北京市朝阳区望京街道望京SOHO`
`province`	string	省份	`北京市`
`city`	string	城市	`北京市`
`district`	string	区县	`朝阳区`
`adcode`	string	区域编码	`110105`
`location`	object	坐标对象{lng,lat,string}
`location.lng`	number	经度	`116.481028`
`location.lat`	number	纬度	`40.011726`
`address_component`	object	地址组件（regeocode时）
`pois`	array	周边POI列表（regeocode时）
`rectangle`	string	IP定位矩形区域	`116.43,39.86;116.45,39.88`
`count`	number	结果数量	`1`

调试参数

请求方式接口地址 key * action address city location radius poitype ip

响应结果

◔ --

点击左侧“发送请求”查看结果...