天地图API

地理编码接口

简介

天地图地理编码API是一类简单的HTTP/HTTPS接口，是指由结构化地址数据（如：北京市海淀区莲花池西路28号）转换为对应坐标点（经纬度）功能，地址解析仅限于国内。

使用地理编码服务前您需要申请Key。

请求接口

参数值	参数说明	参数类型	是否必备	备注（值域）
keyWord	请求关键字	string	是	无

地理编码响应示例：

请求： http://api.tianditu.gov.cn/geocoder?ds={"keyWord":"北京市海淀区莲花池西路28号"}&tk=您的密钥

xxxxxxxxxx
 
{
    "msg": "ok",
    "location": {
        "score": 100,
        "level": "门址",
        "lon": "116.290158",
        "lat": "39.894696",
        "keyWord": "北京市海淀区莲花池西路28号"
    },
    "searchVersion": "6.4.9V",
    "status": "0"
}
​

响应接口

参数值	参数说明	参数类型	备注（值域）
status	返回状态	string	0：正常返回，101：结果为空，404：出错。
msg	返回信息	string	OK：正常，其他异常。
location	地址信息	json	地址信息

location:

参数值	参数说明	参数类型	备注（值域）
lon	坐标点显示经度	Double	必须返回。
lat	坐标点显示纬度	Double	必须返回。
level	类别名称	string	非必须返回。
typeRound	附近相似点	Array	开启周边查询必需返回。