【连接器】天地图

需要两次购买：1.订购原厂商接口；2.订购易源会员包才可代理转发；天地图地图服务支持HTTP和HTTPS协议。服务采用OGC WMTS标准，具体使用方法请参考OGC WMTS标准中GetCapabilities 和GetTile。天地图地图服务对所有用户开放。使用本组服务之前，需要申请Key。

地址经纬度互转

地图

地址转经纬度

会员资源包统一计费

在线调试使用帮助立即购买

原厂商: 天地图

转发服务商: 昆明秀派科技有限公司

电话: 400-998-8033

QQ: 4009988033

邮箱: @

[TOC] 该接口为半连接口，用户需到天地图官网：[http://lbs.tianditu.gov.cn/server/MapService.html](http://lbs.tianditu.gov.cn/server/MapService.html "http://lbs.tianditu.gov.cn/server/MapService.html") 购买后在来易源平台接入使用。易源平台提供数据监控及管理，实时掌握数据消耗及剩余量，是数据存放管理首选之地。天地图地图服务支持HTTP和HTTPS协议。服务采用OGC WMTS标准，具体使用方法请参考OGC WMTS标准中GetCapabilities 和GetTile。天地图地图服务对所有用户开放。使用本组服务之前，需要申请Key。

地名搜索

接入点说明:

地名搜索服务API是一类简单的HTTP/HTTPS接口，包括普通搜索、视野内搜索、周边搜索、拉框搜索、普通建议词搜索等。使用搜索服务前您需要申请Key。使用本接口需到天地图官网购买：http://lbs.tianditu.gov.cn/server/search.html

接口地址:

https://connector.showapi.com/3021-1?appKey={your_appKey} 查看密钥调用帮助

返回格式:

json

功能体验

请求参数

URI参数

参数名称	类型	示例值	必须	描述
tk	String		是	您的服务器端密钥
keyWord	String	超市	否	搜索的关键字注：不支持’与&符号。
mapBound	String	116.04577,39.70307,116.77361,40.09583	否	查询的地图范围("-x,-y,x,y") 注：-180,-90至180,90。
level	String	11	否	目前查询的级别注：1-20。
specifyAdminCode	String		否	指定行政区的国标码注： 9位国标码，如：北京：156110000，优先级高于视野内。
queryRadius	String		否	查询半径（周边搜索时）
pointLonlat	String		否	点坐标（周边搜索）
queryType	String	1	否	搜索类型 1：普通搜索， 2：视野内搜索， 3：周边搜索， 4：普通建议词搜索， 5：公交规划建议词搜索， 6：公交规划起止点搜索（只搜索公交站），7：纯地名搜索（不搜公交线）， 10：拉框搜索注：传递参数为1-10，分别对应不同的搜索类型。暂无8和9。
start	String	0	否	返回结果起始位（用于分页和缓存）默认0 注：0-300，表示返回结果的起始位置。
count	String	20	否	返回的结果数量（用于分页和缓存）注：1-300，标书返回结果的条数。
lonlat	String		否	查询城市中心点坐标（经纬度坐标）例如：北京坐标点是'lonlat':'116.38094,39.92362'。
bound	String		否	查询城市矩形范围例如：北京矩形范围是'bound':'116.18198,39.84396,116.5799,40.00327'。
zoom	String		否	查询城市缩放级别（1—18级）例如：北京的是'zoom':'12'。
layers	String		否	查询城市图层（vec：表示矢量、Cva：表示注记）例如：'layers':'vec,cva'。
projection	String		否	查询城市投影（c:平面坐标投影、w:墨卡托投影）例如：'projection':'c'。

返回参数

查看公共返回参数

返回体

参数名称	类型	示例值	描述
ret_code	Number	0	0：调用成功 -1：调用失败
count	String	13040	搜索总条数
remark	String	请求成功	调用说明
resultType	Number	1	显示类型，1（普通POI），2（统计），3（行政区)，4（普通建议词搜索），5（线路结果）
pois	Object[]		针对点（类型1）集合返回
- phone	String		电话
- lonlat	String	116.420888 39.609496	坐标
- address	String	北京市大兴区	地址
- hotPointID	String	40CA44852D3D2993
- name	String	绿茵超市	Poi点名称
- ename	String	Lvyin Supermarket	poi点英文名称
- eaddress	String		英文地址
- poiType	Number		resultType=5返回，poi点的poi类型（102 公交站，普通poi 该参数可以不返回）
- stationData	Object[]		resultType=3返回，车站信息结构体数据
- lineName	String		线路名称
- uuid	String		线路的id
- stationUuid	String		resultType=3返回，公交站uuid
- distance	Number		resultType=3返回，距离（周边时有）
landmarkcount	Number	0
dataversion	String	2022-11-14 17:08:54
prompt	Object[]		提示信息，如“您是否在XXX，搜索XXX”，其中包含提示文字及对应的行政区码
- type	Number	4	提示类型： 1：是否在where搜what，2：在where无搜索what的结果，3：多个可跳转的行政区提示，4：城市
- admins	Object[]
- name	String	北京市	行政区名称
- adminCode	Number	156110000	行政区码
mclayer	String
searchversion	String	4.3.0
engineversion	String	20180412
keyWord	String	超市	关键字
statistics	Object[]		针对统计（类型2）集合返回
- count	Number		本次统计POI总数量
- citysCount	Number		城市数量
- countryCount	Number		国家数量
- priorityCitys	Object[]		推荐显示城市
- name	String		城市名称
- count	Number		城市数量
- gbCode	Number		城市国标码
- allAdmins	Object[]		各省包含信息集合
- name	String		省名称
- count	Number		包含数量
- adminCode	String		省国标码
- childAdmins	Object[]		包括各市级集合
- provinceCount	Number		省份数量
area	Object[]		针对行政区省（类型3）集合点
- name	String		名称
- bound	String		定位范围（矩形）
- Points	Object[]		点集合{121.3333 39.222,121.4444 39.223,121.5555 39.265,......}(省级才有)
- lonlat	String		{121.111,43.111}(定位点)
- level	Number		3（显示级别,判断是否存在）
- type	Number		1：正常区域，2：特殊区域
- info	String		type=2返回，区域信息简介
- Address	String		type=2返回，特殊区域的地址信息。
suggests	Object[]		针对建议词（类型4）搜索
- name	String		名称
- address	String		地区地址
- gbCode	String		国标码
lineData	Object[]		针对线路（类型5）结果
- name	String		线路名称
- uuid	String		线路的id
- stationNum	String		站数

请求示例

AI生成调用代码

查看我的appKey

查看使用向导

{{curl_string}}

返回示例

{
  "showapi_res_error": "",
  "showapi_fee_num": 1,
  "showapi_res_code": 0,
  "showapi_res_id": "64115d370de376df4ec6268b",
  "showapi_res_body": {
    "ret_code": 0,
    "count": "13040",
    "remark": "请求成功",
    "resultType": 1,
    "pois": [
      {
        "phone": "",
        "lonlat": "116.420888 39.609496",
        "address": "北京市大兴区",
        "hotPointID": "40CA44852D3D2993",
        "name": "绿茵超市",
        "ename": "Lvyin Supermarket",
        "eaddress": ""
      }
    ],
    "landmarkcount": 0,
    "dataversion": "2022-11-14 17:08:54",
    "prompt": [
      {
        "type": 4,
        "admins": [
          {
            "name": "北京市",
            "adminCode": 156110000
          }
        ]
      }
    ],
    "mclayer": "",
    "searchversion": "4.3.0",
    "engineversion": "20180412",
    "keyWord": "超市"
  }
}

1、系统级返回

参数名称	类型	示例值	描述
showapi_res_body	String	{"city":"昆明","prov":"云南"}	消息体的JSON封装，所有应用级的返回参数将嵌入此对象。
showapi_res_code	int	0	查看错误码
showapi_fee_num	int	1	计费次数标识。为0时表示不计费。大于0时代表计费几次。比如发送长短信时可能会多次计费。通常此字段值为1，代表计费1次。
showapi_res_error	String	用户输入有误!	错误信息的展示
showapi_res_id	String	ce135f6739294c63be0c021b76b6fbff	本次请求id

2、错误码 (showapi_res_code)

状态码	描述
0	成功
-1	系统调用错误
-2	可调用次数或金额为0
-3	读取超时
-4	服务端返回数据解析错误
-5	后端服务器DNS解析错误
-6	服务不存在或未上线
-7	API创建者的网关资源不足
-1000	系统维护
-1004	appKey验证有误
-1006	app无权限调用接口
-1007	没有订购套餐
-1008	服务商关闭对您的调用权限
-1009	调用频率受限
-1010	找不到您的应用
-1011	子授权app_child_id无效
-1012	子授权已过期或失效
-1013	子授权ip受限
-1014	token权限无效

1、获取MCP 配置

MCP JSON

{
    "mcpServers": {
        "showapi-mcp-3021": {
            "url": "http://www.showapi.com.cn/mcp/3021/{your_appKey}"
        }
    }
}

使用时需要替换 {your_appKey} 部分为真实的AppKey，您可以在用户控制台的AppKey管理处查看；订购接口后 MCP 服务提供免费试用，每个用户限定调用5000次/日；

2、配置工具

您可在chatbox、Cherry Studio等工作台中配置调用MCP，以下步骤是在Cherry Studio中使用的配置过程，您可以参考以下步骤进行设置 1、首先，点击界面左下角的设置图标（对应图中步骤 1）。
2、接着，在设置页面中找到 “MCP 设置” 选项并点击。
3、然后，在右侧的 “MCP 服务器” 区域，点击 “添加服务器” 按钮，在弹出的选项中选择 “快速创建”（对应图中步骤 2），即可完成 MCP 服务的配置。

4、依次填写名称、描述、类型、URL等参数信息，其他参数请根据实际需要进行填写，依次点击右上角的保存按钮及启用开关。当只做修改的时候，可以用“保存”按钮来保存修改好的信息。

3、使用MCP服务

1. 首先，点击聊天输入框上方的 “MCP 设置” 按钮（如第一张图箭头所指）。
2. 然后，在弹出的 MCP 选项列表里，选择需要使用的 MCP，比如示例中的 “油价查询”（如第二张图所示）。
3. 选择好后，就可以在输入框中输入相关指令，来利用该 MCP 的功能，比如查询油价等信息，之后按 Enter 发送即可。