简介
腾讯地图WebService API 是基于HTTPS/HTTP协议的数据接口。
开发者可以使用任何客户端、服务器和开发语言,按照腾讯地图WebService API规范,按需构建HTTPS请求,并获取结果数据(目前支持JSON/JSONP方式返回)。
使用限制
针对个人开发者和企业开发者,提供的服务调用量有差别,可参考配额限制说明。
Hello world!
1. 申请开发者密钥(Key):申请密钥(key是调用API的身份标识,作为必填参数之一传递给API接口)
2. 密钥(key)申请成功后,需要给该密钥分配调用额度,才可正常使用。去分配
3. 以下示例为:搜坐标位置周边1000米范围内的"酒店"(点击链接可查看返回结果。注:本示例的Key仅为演示使用,实际开发及上线时,请务必使用您申请的Key。)
微信小程序中使用
微信小程序开发中,提供了发起 HTTPS 网络请求的方法(wx.request),可通过其使用地图WebServiceAPI。
详细请参见:《微信小程序中使用服务API》
启用服务
腾讯位置服务API Key,在调用时用于唯一标识开发者身份,API KEY是各产品通用的,也就是说同一个Key可以用在地图SDK,也可以用在JavascriptAPI,也可以用在WebServiceAPI以及其它各产品中,可针对不同产品可独立启用(开关)。 假设您的某个Key只会调用地图SDK,可在Key配置界面,将其它产品关闭,以降低安全风险。
例如:在Key设置中,勾中WebService复选框,即为启用产品,该Key才可调用WebServiceAPI服务 未启用时请求服务,会返回:
{ "status": 199, "message": "此key未开启webservice功能" }
API Key安全
腾讯位置服务的调用配额是开放到Key上的,为了防止您的Key被盗用,保障调用安全,我们在Key的设置中提供了多种安全策略:
注意:请尽量避免在网页端直接调用WebServiceAPI,因key作为请求参数容易被抓取到,被盗用的风险较高。
详细使用方法请点击了解>>
实时监控配额使用情况
每次请求WebServiceAPI接口,在返回结果的同时,其响应头中(Response Headers)会包含这一时刻的配额使用情况
响应头:X-LIMIT
子变量:
current_qps:当前每秒并发量
limit_qps:每秒并发配额
current_pv:今日调用量
limit_pv:日请求量配额
如图所示: