天地图
连接器

天地图

连接器

需两次购买:①订购原厂商接口 ②订购易源会员包代理转发;天地图地图服务支持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-3?appKey={your_appKey}查看密钥调用帮助
返回格式JSON
请求方式POST/GET
请求参数
Header 参数
参数名称类型示例值必须描述
content-typeString
application/x-www-form-urlencoded
URI 参数
参数名称类型示例值必须描述
origString
116.35506,39.92277
起点经纬度
注:-180,-90,180,90。
destString
116.39751,39.90854
终点经纬度
注:-180,-90,180,90。
midString
-
途径点经纬度字符串
注:途径点字符串格式:116.35506,39.92277;116.35506,39.92277两个坐标之间以分号隔开,坐标xy之间用逗号隔开(都是半角)。
styleString
0
导航路线类型:	默认0 (0:最快路线,1:最短路线,2:避开高速,3:步行)
tkString
-
您的服务器端密钥
返回参数
该接口返回经 showapi_res_body 系统封装,业务数据均位于该对象内;系统级字段见
返回体
cURL
curl -X POST "https://connector.showapi.com/3021-3?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": "641165650de376e14ee958d3",
  "showapi_res_body": {
    "result": {
      "mapinfo": {
        "center": "116.375,39.91463",
        "scale": "10"
      },
      "duration": "542.0",
      "distance": "7.5",
      "dest": "116.39751,39.90854",
      "routes": {
        "time": "0.0",
        "count": "11",
        "item": [
          {
            "id": "10",
            "strguide": "沿南池子大街走200米到达目的地。",
            "turnlatlon": "116.3971,39.90649",
            "tollStatus": "0",
            "nextStreetName": "",
            "signage": "",
            "streetName": "南池子大街"
          }
        ]
      },
      "simple": {
        "item": [
          {
            "id": "0",
            "strguide": "从阜成门内大街出发,行驶到阜成门桥,进入西长安街。",
            "streetNames": "阜成门内大街",
            "turnlatlon": "116.35506,39.92249",
            "linkStreetName": "西长安街",
            "tollStatus": "0",
            "signage": "西二环/月坛北桥",
            "streetLatLon": "116.35506,39.92249;116.35092,39.92239;",
            "streetDistance": "353.0",
            "segmentNumber": "0",
            "lastStreetName": "阜成门桥"
          }
        ]
      },
      "routelatlon": "116.35506,39.92277;116.39751,39.90854;",
      "orig": "116.35506,39.92277",
      "parameters": {
        "height": "400",
        "sort": "",
        "dest": "116.39751,39.90854",
        "style": "0",
        "width": "600",
        "orig": "116.35506,39.92277",
        "mid": "",
        "key": "",
        "version": ""
      },
      "mid": ""
    },
    "ret_code": 0,
    "remark": "请求成功"
  }
}
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 直接消费。