騰訊地圖WebService API 是基于HTTPS/HTTP協議的數據接口。
開發者可以使用任何客戶端、服務器和開發語言,按照騰訊地圖WebService API規范,按需構建HTTPS請求,并獲取結果數據(目前支持JSON/JSONP方式返回)。
針對個人開發者和企業開發者,提供的服務調用量有差別,可參考配額限制說明。
1. 申請開發者密鑰(Key):申請密鑰(key是調用API的身份標識,作為必填參數之一傳遞給API接口)
2. 以下示例為:搜坐標位置周邊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:日請求量配額
如圖所示: