快速开始

# 最小示例：地址编码
curl "https://stmappro.cn/access/v3/geocode/geo?key=你的ClientKey&address=上海市浦东新区陆家嘴"

# 返回
{
  "status": "1",
  "geocodes": [ { "formatted_address": "上海市浦东新区陆家嘴", "location": "121.506674,31.241581" } ]
}

高德 Web 服务 API

Web 服务 API 为服务端 HTTP 接口，适用于后端直接调用。接口路径与官方 API 完全一致，使用 Web 服务 Key鉴权。

接口总览（25 个）

地址编码

将详细的结构化地址转换为经纬度坐标。支持对地标性名胜景区、建筑物名称解析为经纬度坐标。

https://stmappro.cn/access/v3/geocode/geo?key=你的ClientKey&address=地址&city=城市

https://stmappro.cn/access/v3/geocode/geo?key=你的ClientKey&address=上海市浦东新区陆家嘴

{
  "status": "1",
  "info": "OK",
  "infocode": "10000",
  "count": "1",
  "geocodes": [
    {
      "formatted_address": "上海市浦东新区陆家嘴",
      "country": "中国",
      "province": "上海市",
      "city": "上海市",
      "district": "浦东新区",
      "location": "121.506674,31.241581",
      "level": "兴趣点"
    }
  ]
}

逆地址编码

将经纬度坐标转化为结构化地址。

https://stmappro.cn/access/v3/geocode/regeo?key=你的ClientKey&location=经度,纬度

https://stmappro.cn/access/v3/geocode/regeo?key=你的ClientKey&location=121.506674,31.241581

{
  "status": "1",
  "info": "OK",
  "regeocode": {
    "formatted_address": "上海市浦东新区陆家嘴",
    "addressComponent": {
      "province": "上海市",
      "city": "上海市",
      "district": "浦东新区",
      "adcode": "310115"
    }
  }
}

关键词查询

用关键词搜索 POI（兴趣点）信息。

https://stmappro.cn/access/v3/place/text?key=你的ClientKey&keywords=星巴克&city=上海&offset=10

周边查询

在指定坐标周围搜索 POI。

https://stmappro.cn/access/v3/place/around?key=你的ClientKey&location=121.506674,31.241581&keywords=餐厅&radius=1000

多边形搜索

在多边形区域内搜索 POI，适用于电子围栏、区域统计等场景。

https://stmappro.cn/access/v3/place/polygon?key=你的ClientKey&polygon=121.47,31.23|121.51,31.23|121.51,31.25|121.47,31.25&keywords=餐厅

ID查询

通过 POI ID 查询兴趣点详细信息。

https://stmappro.cn/access/v3/place/detail?key=你的ClientKey&id=B0FFFAGXSV&extensions=all

输入提示

提供输入提示建议，用于搜索框自动补全。

https://stmappro.cn/access/v3/assistant/inputtips?key=你的ClientKey&keywords=星巴克&city=上海

驾车路线

规划驾车出行路线，支持多途经点、避开拥堵等策略。

https://stmappro.cn/access/v3/direction/driving?key=你的ClientKey&origin=121.4737,31.2304&destination=121.5067,31.2416&strategy=0&extensions=all

步行路线

规划步行出行路线，支持步行导航。

https://stmappro.cn/access/v3/direction/walking?key=你的ClientKey&origin=121.4737,31.2304&destination=121.5067,31.2416

公交路线

规划公交、地铁等公共交通出行路线。

https://stmappro.cn/access/v3/direction/transit/integrated?key=你的ClientKey&origin=121.4737,31.2304&destination=121.5067,31.2416&city=上海

高德路线规划（v5 / 路径规划2.0）

路径规划 2.0（对应官方 /v5/direction/{mode}），与上文的经典版 /v3/direction/*并存；v5 是新一代接口，支持多备选路线、途经点等更丰富能力。本节覆盖系统新增的 骑行 / 电动车 / 货车三种模式（驾车/步行/公交仍使用 v3，见上文各小节）。

https://stmappro.cn/access/v5/direction/bicycling?key=你的ClientKey&origin=116.434307,39.90909&destination=116.434446,39.90816

https://stmappro.cn/access/v5/direction/electrobike?key=你的ClientKey&origin=116.434307,39.90909&destination=116.434446,39.90816

https://stmappro.cn/access/v5/direction/truck?key=你的ClientKey&origin=116.434307,39.90909&destination=116.434446,39.90816&size=2

JS API（浏览器端·Plan Y 浏览器直联）

百度浏览器端 AK 通过 /access/baidu/jsapi/load加载 SDK 后，路线规划等能力由浏览器直联百度官方完成，系统不提供独立的 /access/baidu/jsapi/direction/...端点。请在加载 SDK 后使用官方 BMap对象（如 BMap.DrivingRoute、BMap.WalkingRoute等）调用，或改用「Plan X 服务端代理」方案走 /access/baidu/directionlite/v1/... REST 接口。

// 参考（Plan X 服务端代理 REST 端点，使用服务端 AK 客户 Key）
// /access/baidu/directionlite/v1/riding?key=你的服务端客户Key&origin=116.434307,39.90909&destination=116.434446,39.90816
// /access/baidu/directionlite/v1/electrobike?key=你的服务端客户Key&origin=116.434307,39.90909&destination=116.434446,39.90816
// /access/baidu/directionlite/v1/truck?key=你的服务端客户Key&origin=116.434307,39.90909&destination=116.434446,39.90816&size=2

距离测算

测量两点之间的行驶距离，支持驾车、步行、骑行。

https://stmappro.cn/access/v3/distance?key=你的ClientKey&origins=121.4737,31.2304&destination=121.5067,31.2416&type=1

行政区域搜索

查询行政区划信息，支持省市区三级数据。

https://stmappro.cn/access/v3/config/district?key=你的ClientKey&keywords=上海&subdistrict=2

天气

查询指定城市的天气，包括实况和未来预报。

https://stmappro.cn/access/v3/weather/weatherInfo?key=你的ClientKey&city=310115&extensions=all

ip定位

根据 IP 地址返回定位信息。

https://stmappro.cn/access/v3/ip?key=你的ClientKey&ip=114.114.114.114

坐标转化

将 GPS/百度/Mapbar 坐标转化为官方坐标（GCJ02）。

https://stmappro.cn/access/v3/assistant/coordinate/convert?key=你的ClientKey&locations=116.481499,39.990475&coordsys=gps

静态图

生成静态地图图片，可直接作为 img 标签的 src。

<img src="https://stmappro.cn/access/v3/staticmap?key=你的ClientKey&location=121.5067,31.2416&zoom=15&size=600*400" />

交通态势

查询指定区域的交通拥堵情况，支持圆形区域、矩形区域和指定道路三种查询方式。

https://stmappro.cn/access/v3/traffic/status/circle?key=你的ClientKey&location=121.4737,31.2304&radius=1000

https://stmappro.cn/access/v3/traffic/status/rectangle?key=你的ClientKey&rectangle=121.47,31.23,121.51,31.25

https://stmappro.cn/access/v3/traffic/status/road?key=你的ClientKey&name=世纪大道&city=上海

智能硬件定位（高德）

基于基站、WiFi 等环境信息为智能硬件设备（无 GPS 或弱 GPS 信号）估算地理位置，对应官方 v5/position/IoT。需 Web 服务 Key鉴权，资源池 Key 需在高德开放平台开通「智能硬件定位（IoT）」服务。

curl -X POST "https://stmappro.cn/access/v5/position/IoT?key=你的ClientKey" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "accesstype=1&cdma=0&bts=460,0,9362,4593,20"

智能硬件定位 1.0（高德）

高德智能硬件定位 1.0 版本（旧版），对应官方 apilocate.amap.com/position。与 2.0（/v5/position/IoT）相比：使用 GET请求、基站字段为五元组（无 cage）、对 LTE/广电等基站制式的覆盖通常更广。当 2.0 因 network枚举不含 LTE 等原因无法定位时，可改用本接口。需 Web 服务 Key鉴权，资源池 Key 需在高德开放平台开通「智能硬件定位（geolocation）」服务。

curl -G "https://stmappro.cn/access/v1/position?key=你的ClientKey" \
  --data-urlencode "accesstype=0" \
  --data-urlencode "cdma=0" \
  --data-urlencode "bts=460,0,31056,25896412,-78" \
  --data-urlencode "imei=869115123456789"

curl -G "https://stmappro.cn/access/v1/position?key=你的ClientKey" \
  --data-urlencode "accesstype=1" \
  --data-urlencode "imei=869115123456789" \
  --data-urlencode "macs=4c:48:da:25:0b:11,-59,MyWiFi|4c:48:da:25:1a:11,-77,MyWiFi"

高德 JS API 接口

JS API 接口适用于浏览器端通过官方 JS SDK 调用，统一入口为 /access/jsapi/load（加载后会注入 serviceHost 代理），使用 JS API Key鉴权。

接口总览（23 个）

JS SDK 加载

如果你的项目需要在浏览器中使用高德 JS SDK（如地图渲染、覆盖物、交互等），可以通过以下方式加载：

<script src="https://stmappro.cn/access/jsapi/load?key=你的JSAPI_Key&plugins=AMap.Geocoder,AMap.Scale"></script>
<script>
  var map = new AMap.Map('container', { zoom: 12, center: [116.397, 39.909], touchZoom: true, doubleClickZoom: true });
  // Geocoder 等插件的请求自动经系统代理转发，无需任何额外配置
  var geocoder = new AMap.Geocoder();
  geocoder.getLocation('北京市朝阳区阜通东大街6号', function(status, result) {
    console.log(result.geocodes[0].location);
  });
</script>

GET https://stmappro.cn/access/_AMapService/你的JSAPI_Key/v3/geocode/geo?address=北京市朝阳区
# 系统自动注入官方 JS Key + 安全密钥(jscode) 后转发 restapi.amap.com

JS API 接入方式

方式一：加载 SDK 后调用（推荐）

JS API 能力需在浏览器中加载系统代理的 JS SDK（/access/jsapi/load），然后像官方高德 JS API 一样使用 AMap对象。SDK 内部的数据请求会自动经 serviceHost 代理转发，无需手动拼接 REST URL。

// 1. 先加载 SDK（在 HTML 中引入，注意用 /access/jsapi/load 而非官方地址）
// <script src="https://stmappro.cn/access/jsapi/load?key=你的JSAPI_Key&plugins=AMap.Geocoder,AMap.PlaceSearch"></script>

// 2. 像官方一样使用 AMap 对象
const geocoder = new AMap.Geocoder();
geocoder.getLocation('上海市浦东新区', (status, result) => {
  console.log(result.geocodes[0].location);   // 经纬度
});

const placeSearch = new AMap.PlaceSearch({ city: '上海' });
placeSearch.search('星巴克', (status, result) => {
  console.log(result.poiList.pois);
});

方式二：通过 SDK 调用

加载 JS SDK 后，SDK 内部会自动通过系统代理调用 REST API，调用方无需手动拼接 URL。

// 1. 加载 SDK（将官方地址替换为系统代理）
<script src="https://stmappro.cn/access/jsapi/load?key=你的JSAPI_Key"></script>

// 2. 使用 SDK
<script>
  AMap.plugin('AMap.Geocoder', function() {
    var geocoder = new AMap.Geocoder();
    geocoder.getLocation('上海市浦东新区', function(status, result) {
      console.log(result);
    });
  });
</script>

JS API 接口详情

JS API 能力对应下方的官方 Web 服务接口，参数说明请点击链接查看。实际调用由浏览器通过加载的 JS SDK（/access/jsapi/load）发起，数据请求自动经 /access/_AMapService/你的JSAPI_Key/...代理转发，无需手动拼 REST URL。

以下是每个 JS API 接口对应的 Web 服务接口文档，参数说明请点击链接查看：

调用示例

// 以下均在已加载 /access/jsapi/load 的页面中，用官方 AMap 对象调用
// 地址编码
const geocoder = new AMap.Geocoder();
geocoder.getLocation('上海市浦东新区', (status, result) => {
  console.log(result.geocodes[0].location);
});

// 周边搜索
const placeSearch = new AMap.PlaceSearch();
placeSearch.searchNearBy('餐厅', [121.5067, 31.2416], 1000, (status, result) => {
  console.log(result.poiList.pois);
});

// 驾车路线
const driving = new AMap.Driving();
driving.search(new AMap.LngLat(121.4737, 31.2304), new AMap.LngLat(121.5067, 31.2416), (status, result) => {
  console.log(result.routes[0]);
});

百度地图 Web 服务 API

百度地图 Web 服务 API 为服务端 HTTP 接口，使用 服务端 AK（Web 服务 Key）鉴权。调用方式与高德一致：只需把路径前缀从 /access/v3/...换成 /access/baidu/...，其余（Client Key 鉴权、参数、返回格式）完全一致。

接口总览（22 个）

百度地理编码

将详细的结构化地址转换为百度坐标（BD-09）。

https://stmappro.cn/access/baidu/geocoding/v3?key=你的ClientKey&address=北京市海淀区中关村&city=北京&output=json

https://stmappro.cn/access/baidu/geocoding/v3?key=你的ClientKey&address=北京市海淀区中关村&city=北京

{
  "status": 0,
  "result": {
    "location": { "lng": 116.310924, "lat": 39.98313 },
    "precise": 1,
    "confidence": 80,
    "comprehension": 100,
    "level": "商务大厦"
  }
}

百度逆地理编码

将百度坐标（BD-09）转化为结构化地址。

https://stmappro.cn/access/baidu/reverse_geocoding/v3?key=你的ClientKey&location=39.98313,116.310924&output=json

https://stmappro.cn/access/baidu/reverse_geocoding/v3?key=你的ClientKey&location=39.98313,116.310924

{
  "status": 0,
  "result": {
    "location": { "lng": 116.310924, "lat": 39.98313 },
    "formatted_address": "北京市海淀区中关村",
    "addressComponent": {
      "country": "中国", "province": "北京市", "city": "北京市",
      "district": "海淀区", "street": "中关村大街"
    },
    "pois": [ { "name": "中关村鼎好大厦", "point": { "x": 116.31, "y": 39.98 } } ]
  }
}

百度地点搜索

POI 搜索：支持关键词搜索、周边搜索、区域搜索（对应官方 place/v2/search）。

https://stmappro.cn/access/baidu/place/v2/search?key=你的ClientKey&query=星巴克®ion=北京&city_limit=true&output=json

# 关键词搜索
https://stmappro.cn/access/baidu/place/v2/search?key=你的ClientKey&query=星巴克®ion=北京

# 周边搜索（纬度,经度）
https://stmappro.cn/access/baidu/place/v2/search?key=你的ClientKey&query=餐厅&location=39.98313,116.310924&radius=1000

{
  "status": 0,
  "message": "ok",
  "results": [
    {
      "name": "星巴克(中关村店)",
      "location": { "lng": 116.316, "lat": 39.984 },
      "address": "北京市海淀区中关村大街",
      "uid": "xxxxx"
    }
  ]
}

百度路线规划

轻量路线规划（对应官方 directionlite/v1/{mode}），支持驾车 / 公交 / 步行 / 骑行四种模式。

https://stmappro.cn/access/baidu/directionlite/v1/driving?key=你的ClientKey&origin=39.98313,116.310924&destination=39.915,116.404&output=json

# 驾车
https://stmappro.cn/access/baidu/directionlite/v1/driving?key=你的ClientKey&origin=39.98313,116.310924&destination=39.915,116.404
# 公交
https://stmappro.cn/access/baidu/directionlite/v1/transit?key=你的ClientKey&origin=39.98313,116.310924&destination=39.915,116.404&city=北京
# 步行 / 骑行：把路径改为 /directionlite/v1/walking 或 /directionlite/v1/riding

{
  "status": 0,
  "result": {
    "routes": [
      { "distance": 12345, "duration": 1800, "steps": [ { "instruction": "向西出发", "distance": 200 } ] }
    ]
  }
}

百度路线规划（完整版 v2）

完整版路线规划（对应官方 direction/v2/{mode}），与上文的轻量版 directionlite/v1/{mode}并存；完整版支持更多参数（如途经点、偏好、货车参数等），返回结构也更丰富。支持 驾车 / 公交 / 步行 / 骑行 / 货车 五种模式。

https://stmappro.cn/access/baidu/direction/v2/driving?key=你的ClientKey&origin=39.98313,116.310924&destination=39.915,116.404&output=json

# 驾车（完整版 v2）
https://stmappro.cn/access/baidu/direction/v2/driving?key=你的ClientKey&origin=39.98313,116.310924&destination=39.915,116.404
# 公交
https://stmappro.cn/access/baidu/direction/v2/transit?key=你的ClientKey&origin=39.98313,116.310924&destination=39.915,116.404&city=北京
# 步行 / 骑行 / 货车：把路径改为 /direction/v2/walking、/direction/v2/riding、/direction/v2/truck

百度坐标转换

在不同坐标系之间互转（对应官方 geoconv/v1）。

https://stmappro.cn/access/baidu/geoconv/v1?key=你的ClientKey&coords=116.404,39.915&from=3&to=5&output=json

# 高德(GCJ02)  百度(BD09ll)
https://stmappro.cn/access/baidu/geoconv/v1?key=你的ClientKey&coords=116.404,39.915&from=3&to=5

{ "status": 0, "result": [ { "x": 116.410, "y": 39.921 } ] }

百度天气查询

查询指定区县的实况或预报天气（对应官方 weather/v1）。

https://stmappro.cn/access/baidu/weather/v1?key=你的ClientKey&district_id=110101&data_type=now&output=json

https://stmappro.cn/access/baidu/weather/v1?key=你的ClientKey&district_id=110101&data_type=now

{
  "status": 0,
  "result": {
    "location": { "id": "110101", "name": "东城区" },
    "now": { "text": "晴", "temp": 25, "feels_like": 24, "rh": 40, "wind_dir": "北风", "wind_class": "2级" }
  }
}

百度静态图

生成静态地图图片，可直接作为 <img>的 src（对应官方 staticimage/v2）。

https://stmappro.cn/access/baidu/staticimage/v2?key=你的ClientKey¢er=116.404,39.915&zoom=15&width=400&height=300&markers=116.404,39.915&output=json

https://stmappro.cn/access/baidu/staticimage/v2?key=你的ClientKey¢er=116.404,39.915&zoom=15&width=400&height=300

百度交通态势

查询指定道路的实时交通态势（对应官方 traffic/v1/road）。

https://stmappro.cn/access/baidu/traffic/v1/road?key=你的ClientKey&road_name=中关村大街&city=北京&output=json

https://stmappro.cn/access/baidu/traffic/v1/road?key=你的ClientKey&road_name=中关村大街&city=北京

{
  "status": 0,
  "description": "拥堵",
  "evaluation": { "status": 2, "expedite": 0.1, "congested": 0.6, "blocked": 0.3 },
  "road_traffic": [ { "road_name": "中关村大街", "status": 2 } ]
}

百度 IP 定位

根据 IP 地址定位到所属区域（对应官方 location/ip）。

https://stmappro.cn/access/baidu/location/ip?key=你的ClientKey&ip=114.114.114.114&output=json

https://stmappro.cn/access/baidu/location/ip?key=你的ClientKey&ip=114.114.114.114

{
  "status": 0,
  "content": {
    "address": "北京市",
    "point": { "x": 116.40, "y": 39.90 },
    "address_detail": { "province": "北京市", "city": "北京市", "district": "海淀区" }
  }
}

智能硬件定位（百度）

基于基站、WiFi 为智能硬件设备定位，对应官方 locapi/v2。需 Web 服务 Key鉴权，资源池 Key 需在百度开发平台开通「智能硬件定位（loc）」服务。

curl -X POST "https://stmappro.cn/access/baidu/locapi/v2?key=你的ClientKey" \
  -H "Content-Type: application/json" \
  -d '{"cellinfo":[{"cid":"4593","lac":"9362","mnc":"0","sid":"460"}],"wifiinfo":[{"mac":"aa:bb:cc:dd:ee:ff","rssi":"-50"}]}'

百度地图 JS API

百度地图 JavaScript API（GL 版）用于浏览器端加载地图、渲染覆盖物与交互，使用 浏览器端 AK（JS API Key）鉴权。调用路径前缀为 /access/baidu/jsapi/。

接口总览（20 个）

<script>
  window.onBMapReady = function() {
    var map = new BMap.Map('container');
    map.centerAndZoom(new BMap.Point(116.404, 39.915), 15);
    map.enableScrollWheelZoom(true);
  };
</script>
<script src="https://stmappro.cn/access/baidu/jsapi/load?key=你的PlanY客户Key&callback=onBMapReady"></script>

腾讯地图 WebService API

腾讯地图 WebService API 为服务端 HTTP 接口，使用 服务端 Key（Web 服务 Key）鉴权。调用方式与高德一致：只需把路径前缀从 /access/v3/...换成 /access/tencent/ws/...，其余（Client Key 鉴权、参数、返回格式）完全一致。

接口总览（23 个）

腾讯地址解析

https://stmappro.cn/access/tencent/ws/geocoder/v1?key=你的ClientKey&address=北京市海淀区中关村

https://stmappro.cn/access/tencent/ws/geocoder/v1/?key=你的ClientKey&location=39.984154,116.307490

{
  "status": 0,
  "message": "query ok",
  "result": {
    "title": "海淀区",
    "location": { "lng": 116.307490, "lat": 39.984154 },
    "address_components": {
      "province": "北京市",
      "city": "北京市",
      "district": "海淀区",
      "street": "中关村",
      "street_number": ""
    }
  }
}

腾讯地点搜索

https://stmappro.cn/access/tencent/ws/place/v1/search?key=你的ClientKey&keyword=星巴克&boundary=nearby(39.984154,116.307490,1000)

腾讯路线规划

https://stmappro.cn/access/tencent/ws/direction/v1/driving/?key=你的ClientKey&from=39.984154,116.307490&to=39.915,116.404

腾讯坐标转换

https://stmappro.cn/access/tencent/ws/coord/v1/translate?key=你的ClientKey&locations=39.915,116.404&type=1

腾讯IP 定位

https://stmappro.cn/access/tencent/ws/location/v1/ip?key=你的ClientKey&ip=114.114.114.114

智能硬件定位（腾讯）

基于 GPS、WiFi、基站、蓝牙等环境信息为智能硬件设备估算位置，对应官方 ws/location/v1/network。需 Web 服务 Key鉴权，资源池 Key 需开通「智能硬件定位」配额。

curl -X POST "https://stmappro.cn/access/tencent/ws/location/v1/network?key=你的ClientKey" \
  -H "Content-Type: application/json" \
  -d '{"device_id":"device_001","gpsinfo":{"lat":39.92,"lon":116.44},"wifiinfo":[{"mac":"aa:bb:cc:dd:ee:ff","rssi":-50}]}'

多边形范围搜索

在指定的多边形区域内搜索 POI，适用于电子围栏、区域统计等场景，对应官方 ws/place/v1/search_by_polygon。

https://stmappro.cn/access/tencent/ws/place/v1/search_by_polygon?key=你的ClientKey&polygon=39.98,116.30|39.99,116.31|39.97,116.32

沿途搜索

沿指定路线（道路）搜索附近的 POI，适用于沿途加油站、服务区推荐等，对应官方 ws/place/v1/alongby。

https://stmappro.cn/access/tencent/ws/place/v1/alongby?key=你的ClientKey&location=39.984154,116.307490&keyword=加油站

周边推荐

根据定位智能推荐周边兴趣点（如附近美食、景点），对应官方 ws/place/v1/explore。

https://stmappro.cn/access/tencent/ws/place/v1/explore?key=你的ClientKey&location=39.984154,116.307490

行政区划-搜索

按关键字搜索行政区划（省/市/区），与「行政区划-列表」「行政区划-下级」并列，对应官方 ws/district/v1/search。

https://stmappro.cn/access/tencent/ws/district/v1/search?key=你的ClientKey&keyword=海淀

货车路线规划

为货车规划路径，支持载重、限高、禁行等约束，对应官方 ws/direction/v1/trucking/。

https://stmappro.cn/access/tencent/ws/direction/v1/trucking/?key=你的ClientKey&from=39.984154,116.307490&to=39.915,116.404&truck_weight=5

天气查询

查询指定城市的实况天气与未来预报，对应官方 ws/weather/v1/。

https://stmappro.cn/access/tencent/ws/weather/v1/?key=你的ClientKey&location=北京&type=forecast

腾讯 JS API 与双端（both）模式

JS SDK 加载

<script>
  fetch('https://stmappro.cn/access/tencent/jsapi/load?key=你的双端ClientKey')
    .then(r => r.text())
    .then(js => { var s = document.createElement('script'); s.textContent = js; document.head.appendChild(s); });
  // 或直接 <script src="https://stmappro.cn/access/tencent/jsapi/load?key=你的双端ClientKey"></script>
</script>

加载完成后使用 TMap对象初始化地图：

var map = new TMap.Map('container', {
  center: new TMap.LatLng(39.984, 116.307),
  zoom: 13,
  gesture: 'two_finger'  // 移动端双指缩放
});

数据服务调用（同一把 Key）

// 地理编码（服务端代理，腾讯只见系统 IP）
fetch('https://stmappro.cn/access/tencent/ws/geocoder/v1?key=你的双端ClientKey&address=北京市海淀区')
  .then(r => r.json()).then(d => console.log(d.result.location));

错误码说明

HTTP 状态码

错误响应示例

// 403 - 无权限
{
  "error": "该 Key 未开通此接口权限",
  "endpoint": "/v3/geocode/geo"
}

// 403 - Key 类型不匹配
{
  "error": "Key 平台类型与接口不匹配",
  "detail": "该接口需要 web_service 类型 Key"
}

// 429 - 限流
{
  "error": "该接口今日调用量已达上限",
  "endpoint": "/v3/geocode/geo",
  "limit": 1000
}

// 429 - QPS 超限
{
  "error": "该接口并发 QPS 超限",
  "endpoint": "/v3/geocode/geo",
  "limit": 50
}

官方业务错误码

当 HTTP 状态码为 200 时，响应体中的 status和 infocode字段表示业务结果：

腾讯地图错误码

腾讯 WebService API 响应中 status为数字，0 表示成功，非 0 为错误：

代码示例

Web 服务 Key 调用示例

cURL

# 地址编码
curl "https://stmappro.cn/access/v3/geocode/geo?key=你的WebKey&address=上海市浦东新区"

# 驾车路线
curl "https://stmappro.cn/access/v3/direction/driving?key=你的WebKey&origin=121.4737,31.2304&destination=121.5067,31.2416&extensions=all"

JavaScript (fetch)

const BASE = 'https://stmappro.cn/access';
const KEY = '你的WebKey';

// 地址编码
const res = await fetch(`${BASE}/v3/geocode/geo?key=${KEY}&address=上海市浦东新区`);
const data = await res.json();
console.log(data.geocodes[0].location); // "121.506674,31.241581"

// 驾车路线
const res2 = await fetch(`${BASE}/v3/direction/driving?key=${KEY}&origin=121.4737,31.2304&destination=121.5067,31.2416&extensions=all`);
const route = await res2.json();
console.log(route.route.paths[0].distance); // 距离（米）

JavaScript (axios)

import axios from 'axios';

const api = axios.create({
  baseURL: 'https://stmappro.cn/access',
  params: { key: '你的WebKey' },
  timeout: 10000,
});

// 地址编码
const { data } = await api.get('/v3/geocode/geo', {
  params: { address: '上海市浦东新区' }
});

// 搜索 POI
const { data: pois } = await api.get('/v3/place/text', {
  params: { keywords: '星巴克', city: '上海', offset: 10 }
});

Python

import requests

BASE = 'https://stmappro.cn/access'
KEY = '你的WebKey'

# 地址编码
resp = requests.get(f'{BASE}/v3/geocode/geo', params={
    'key': KEY,
    'address': '上海市浦东新区'
})
data = resp.json()
print(data['geocodes'][0]['location'])

# 驾车路线
resp = requests.get(f'{BASE}/v3/direction/driving', params={
    'key': KEY,
    'origin': '121.4737,31.2304',
    'destination': '121.5067,31.2416',
    'extensions': 'all'
})
route = resp.json()
print(route['route']['paths'][0]['distance'])

Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
String BASE = "https://stmappro.cn/access";
String KEY = "你的WebKey";

// 地址编码
String url = BASE + "/v3/geocode/geo?key=" + KEY + "&address=上海市浦东新区";
HttpRequest request = HttpRequest.newBuilder().uri(URI.create(url)).build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

Node.js

const BASE = 'https://stmappro.cn/access';
const KEY = '你的WebKey';

// 地址编码
const url = `${BASE}/v3/geocode/geo?key=${KEY}&address=上海市浦东新区`;
fetch(url)
  .then(res => res.json())
  .then(data => console.log(data.geocodes[0].location));

JS API Key 调用示例

① 加载 SDK（唯一入口）

<!-- 加载 JS SDK，注意用 /access/jsapi/load 而非官方地址 -->
<script src="https://stmappro.cn/access/jsapi/load?key=你的JSAPI_Key&plugins=AMap.Geocoder,AMap.PlaceSearch"></script>

② 用官方 AMap 对象调用（数据请求自动经 serviceHost 代理）

<script>
  // 初始化地图
  var map = new AMap.Map('container', {
    zoom: 11,
    center: [121.4737, 31.2304],
    touchZoom: true,       // 移动端双指缩放
    doubleClickZoom: true  // 双击放大
  });

  // 地址编码
  var geocoder = new AMap.Geocoder();
  geocoder.getLocation('上海市浦东新区', function(status, result) {
    console.log(result.geocodes[0].location);
  });

  // 周边搜索
  AMap.plugin('AMap.PlaceSearch', function() {
    var placeSearch = new AMap.PlaceSearch({ city: '上海', pageSize: 10 });
    placeSearch.search('星巴克', function(status, result) {
      console.log(result);
    });
  });
</script>

Go

package main

import (
    "encoding/json"
    "fmt"
    "net/http"
    "net/url"
)

func main() {
    base := "https://stmappro.cn/access"
    key := "你的WebKey"

    params := url.Values{}
    params.Set("key", key)
    params.Set("address", "上海市浦东新区")

    resp, _ := http.Get(base + "/v3/geocode/geo?" + params.Encode())
    defer resp.Body.Close()

    var result map[string]interface{}
    json.NewDecoder(resp.Body).Decode(&result)
    fmt.Println(result)
}

微信小程序 SDK 接入

架构与链路

三个 SDK 文件与下载

也可在「创建小程序 Key」弹窗中直接复制下载地址。所有 SDK 默认 host 为 https://stmappro.cn/access/{厂商}，无需手动设置。

小程序后台配置（三家通用）

https://stmappro.cn

腾讯小程序 SDK（xtmap-wx-jssdk.js）

与腾讯官方 qqmap-wx-jssdk方法级兼容。把官方 var QQMapWX = require('qqmap-wx-jssdk.js')换成我们的文件，key换成服务系统客户 Key（需勾选「小程序 SDK」，见下文）即可。

引入与初始化

// 把官方 qqmap-wx-jssdk.js 换成我们提供的文件
var XTMapWX = require('./xtmap-wx-jssdk.js');
var sdk = new XTMapWX({ key: '你的服务系统客户Key' });

方法列表

调用示例

// 逆地理编码（缺省 location 自动用 wx.getLocation）
sdk.reverseGeocoder({
  success: function (res) { console.log(res.result.address); },
  fail: function (err) { console.log(err); }
});

// POI 搜索
sdk.search({
  keyword: '咖啡',
  success: function (res) { console.log(res.data); }
});

// 路线规划（驾车）
sdk.direction({
  mode: 'driving',
  to: { latitude: 39.984, longitude: 116.307 },
  success: function (res) { console.log(res.result.routes); }
});

高德小程序 SDK（xtmap-amap-wx.js）

与高德官方 amap-wx.js (AMapWX)方法级兼容。客户 Key 需选择「小程序 SDK」平台（独立平台类型，等同服务端链路）。

引入与初始化

var amapFile = require('./xtmap-amap-wx.js');
var amap = new amapFile.AMapWX({ key: '你的服务系统客户Key' });

方法列表

调用示例

// 逆地理编码（缺省 location 自动用 wx.getLocation）
amap.getRegeo({
  success: function (data) {
    var r = data[0];
    console.log(r.desc, r.longitude, r.latitude);
  },
  fail: function (info) { console.log(info); }
});

// 周边咖啡店
amap.getPoiAround({
  querykeywords: '咖啡',
  success: function (data) { console.log(data.markers); }
});

// 驾车路线
amap.getDrivingRoute({
  origin: '116.397,39.908',
  destination: '116.480,39.990',
  success: function (data) { console.log(data.paths); }
});

百度小程序 SDK（xtmap-bmap-wx.js）

与百度官方 bmap-wx.js (BMapWX)方法级兼容。客户 Key 需选择「小程序 SDK」平台。系统自动走服务端 AK（Plan X），因此不会出现官方浏览器端 AK 服务端代发的 240 限制。

引入与初始化

var bmap = require('./xtmap-bmap-wx.js');
var BMap = new bmap.BMapWX({ ak: '你的服务系统客户Key' });

方法列表

坐标系默认 gcj02（百度链路下系统负责与官方坐标系对齐），无需在客户端做坐标转换。

调用示例

// 逆地理编码（缺省 location 自动用 wx.getLocation）
BMap.regeocoding({
  success: function (data) { console.log(data.result.addressComponent); },
  fail: function (info) { console.log(info); }
});

// POI 检索
BMap.search({
  query: '咖啡',
  region: '北京',
  success: function (data) { console.log(data.results); }
});

// 驾车路线（增强方法）
BMap.direction({
  mode: 'driving',
  origin: '39.915,116.404',
  destination: '39.975,116.480',
  success: function (data) { console.log(data.result.routes); }
});

创建小程序客户 Key

在管理后台「客户 Key 管理」中创建或编辑 Key 时，按厂商选择对应平台即可开通小程序调用权限。

地图显示：微信 <map> 组件

<!-- wxml 中直接使用，无需引入任何 SDK 或 Key -->
<map
  longitude="116.397"
  latitude="39.908"
  scale="14"
  markers="{{markers}}"
  style="width: 100%; height: 300px;">
</map>

把上面各 SDK 返回的 longitude / latitude / markers绑定到 <map>即可实现「数据来自我们的代理、地图由微信原生渲染」的完整小程序地图能力。

常见问题