星图云开放平台
逆地理编码
更新时间:2026-02-04 11:14:00
接口说明

逆地理编码 API 是通过 HTTP/HTTPS 协议访问远程服务的接口,提供结构化地址与经纬度之间的相互转化的能力。
适用场景:将经纬度转换为详细结构化的地址,且返回附近周边的 POI 信息。 例如:116.480881,39.989410 转换地址描述后:荣事达大道 550 号 正北多少米

坐标系:WGS84坐标

调用方式

使用 API 前,需要先注册账号并完成用户认证,查看 开发指南

服务地址https://api.open.geovisearth.com/pj/geo/v2/geocode/regeo
请求方式GET 方法
接口鉴权服务密钥授权,您需要 申请 token将 token 作为必填参数拼接在服务地址中一起请求
调用限制服务调用量的限制请点击 这里 查阅
请求参数
名称含义是否必填规则说明
location经纬度坐标规则:经度和纬度用","分割,经度在前,纬度在后
radius搜索半径radius 取值范围:0~3000,默认值:1000。单位:米
poiType返回附近 POI 类型地点文本搜索接口支持按照设定的 POI 类型限定地点搜索结果。poiType下载
pageNum请求第几分页page_num 默认为 1,请求第几分页
pageSize当前分页展示的数据条数page_size 默认为 10,page_size 的取值 1-25
返回参数
字段路径类型是否必填中文名说明
codeinteger状态码0 表示成功,其它为错误
dataobject[]返回数据POI 完整集合
infoString返回信息请求结果的文字描述

data对象字段说明:

字段名是否必选中文名说明
addressComponent地址元素列表地址元素
poisPOI 集合POI 集合列表
poiCountPOI 数量POI 集合数量

addressComponent 对象字段说明

字段名是否必选中文名说明
province坐标点所在省名称例如:北京市
city坐标点所在城市名称例如:北京市
citycode城市编码例如:010
district坐标点所在区例如:海淀区
adcode行政区编码例如:110108
township坐标点所在乡镇例如:苏家坨镇
towncode乡镇街道编码例如:110108104

pois 对象字段说明

字段名是否必选中文名说明
idPOI 唯一标识唯一标识
namePOI 名称POI 名称
poiTypePOI 类型POI 分类编码
location经纬度经度在前,纬度在后
address详细地址POI 详细地址
direction方向POI 方向信息
distance距离与查询点的距离(单位:米)
调用示例

请求示例

https://api.open.geovisearth.com/pj/geo/v2/geocode/regeo?location=116.656144,41.035728&token=您的token

返回示例

{
    "code": 0,
    "data": {
        "addressComponent": {
            "citycode": "010",
            "province": "北京市",
            "city": "北京市",
            "district": "海淀区",
            "adCode": "110108",
            "township": "苏家坨镇",
            "towncode": "110108104"
        },
        "pois": [
            {
                "id": "BJ6Q3V74ISN8",
                "name": "肯德基",
                "poiType": "110201",
                "location": "116.173059,40.06561",
                "address": "中关村环保科技示范园正南方向5米",
                "direction": "正北",
                "distance": "0.0000"
            },
            {
                "id": "BJW5Z7HND4Z0",
                "name": "库迪咖啡(万科翠湖国际北区店)",
                "poiType": "110303",
                "location": "116.173046,40.065657",
                "address": "中关村环保科技示范园",
                "direction": "正北",
                "distance": "5.3420"
            }
        ],
        "poiCount": 2
    },
    "info": "操作成功"
}