天地图

连接器

需两次购买：①订购原厂商接口 ②订购易源会员包代理转发；天地图地图服务支持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-7?appKey={your_appKey}查看密钥调用帮助

返回格式JSON

请求方式POST/GET

请求参数

Header 参数

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

URI 参数

参数名称	类型	示例值	必须	描述
searchWord	String	北京	否	查询关键字。
searchType	String	1	否	查询类型(0：根据code查询，1：根据名称。)。
needSubInfo	String	false	否	是否需要下一级信息。
needAll	String	false	否	是否需要所有子节点。
needPolygon	String	true	否	是否需要行政区划范围。
needPre	String	true	否	是否需要上一级所有信息。
tk	String	-	是	您的服务器端密钥

返回参数

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

返回体

请求示例

查看我的 appKey 查看使用向导

Python / Java 等多语言示例

cURL

curl -X POST "https://connector.showapi.com/3021-7?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": "64116e150de376de4e656d33",
  "showapi_res_body": {
    "ret_code": 0,
    "remark": "请求成功",
    "returncode": "100",
    "data": [
      {
        "parents": {
          "country": {
            "name": "中华人民共和国",
            "cityCode": "156000000",
            "adminType": "country"
          }
        },
        "level": 11,
        "nameabbrevation": "北京",
        "name": "北京市",
        "cityCode": "156110000",
        "adminType": "province",
        "englishabbrevation": "BeiJing",
        "lnt": 116.71847,
        "english": "BeiJing Shi",
        "bound": "115.422051,40.978643,117.383319,39.455766",
        "lat": 39.903883
      }
    ],
    "msg": "ok"
  }
}

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