天地图

连接器

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

地图地址转经纬度地址经纬度互转

会员资源包统一计费，无需单独购买，开通会员包后可直接调用。

地名搜索V2

接入点说明

地名搜索服务V2.0是一类简单的HTTP/HTTPS接口，包括普通搜索、视野内搜索、周边搜索、多边形搜索、行政区域搜索、分类搜索、统计搜索。
使用搜索服务V2.0前您需要申请Key，并在控制台中配置权限。本接口需到天地图官网购买：http://lbs.tianditu.gov.cn/server/search.html

接口地址

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

返回格式JSON

请求方式POST/GET

请求参数

Header 参数

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

URI 参数

参数名称	类型	示例值	必须	描述
tk	String	-	是	您的服务器端密钥
keyWord	String	北京大学	否	搜索的关键字
mapBound	String	116.02524,39.83833,116.65592,39.99185	否	查询的地图范围(“minx,miny,maxx,maxy”) 注： -180,-90至180,90。
level	String	12	否	目前查询的级别注：1-18级
specify	String	-	否	指定行政区的国标码（行政区划编码表）严格按照行政区划编码表中的（名称，gb码）。如指定的行政区划编码是省以上级别则返回是统计数据（不包括直辖市）
queryType	String	1	否	搜索类型 1:普通搜索（含地铁公交）; 2:视野内搜索; 3:周边搜索服务; 7:地名搜索; 10:多边形搜索服务; 12:行政区划区域搜索服务; 13:分类搜索服务; 14:统计搜索服务;
start	String	0	否	返回结果起始位（用于分页和缓存）注：0-300，表示返回结果的起始位置。
count	String	10	否	返回的结果数量（用于分页和缓存）注：1-300，返回结果的条数。
dataTypes	String	-	否	数据分类
show	String	-	否	返回poi结果信息类别注：取值为1，则返回基本poi信息；取值为2，则返回详细poi信息
queryRadius	String	-	否	查询半径注：单位:米（10公里内）
pointLonlat	String	-	否	点坐标注：中心点，经纬度坐标
polygon	String	-	否	多边形范围数据(经纬度坐标对) 注：经度和纬度用","分割，首尾坐标对需相同。实例(x1,y1,x2,y2,x3,y3,x4,y4,x5,y5,x1,y1)

返回参数

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

返回体

请求示例

查看我的 appKey 查看使用向导

Python / Java 等多语言示例

cURL

curl -X POST "https://connector.showapi.com/3021-2?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": "641161900de376e04ecbc9a1",
  "showapi_res_body": {
    "ret_code": 0,
    "count": "4539",
    "status": {
      "infocode": 1000,
      "cndesc": "服务正常"
    },
    "remark": "请求成功",
    "resultType": 1,
    "pois": [
      {
        "phone": "010-62752114",
        "poiType": "101",
        "lonlat": "116.303550,39.990460",
        "source": "0",
        "address": "颐和园路5号",
        "hotPointID": "C0744404D108E731",
        "name": "北京大学"
      }
    ],
    "prompt": [
      {
        "type": 4,
        "admins": [
          {
            "adminName": "海淀区",
            "adminCode": 156110108
          }
        ]
      }
    ],
    "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