天地图

连接器

需两次购买：①订购原厂商接口 ②订购易源会员包代理转发；天地图地图服务支持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

请求方式POST/GET

请求参数

Header 参数

参数名称	类型	示例值	必须	描述
content-type	String	application/x-www-form-urlencoded	否

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'。

返回参数

该接口返回经 showapi_res_body 系统封装，业务数据均位于该对象内；系统级字段见。

返回体

请求示例

查看我的 appKey 查看使用向导

Python / Java 等多语言示例

cURL

curl -X POST "https://connector.showapi.com/3021-1?appKey=YOUR_APPKEY" \
  -H "content-type: application/x-www-form-urlencoded"

返回示例

JSON

{
  "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": "超市"
  }
}

MCP 服务集成接口级

在 Cherry Studio、ChatBox 等支持 MCP 的客户端中配置，将 {your_appKey} 替换为真实 AppKey（AppKey 管理）。该服务覆盖本接口全部接入点。

MCP JSON

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

OpenAPI 文档接口级

标准 OpenAPI 3.0 文档，覆盖本接口全部接入点，可导入 Apifox / Postman / Swagger UI，或供 AI Agent 直接消费。

在线查看 YAML

下载 YAML

查看 JSON