騰訊地圖WebService API 是基于HTTPS/HTTP協(xié)議的數(shù)據(jù)接口。
開發(fā)者可以使用任何客戶端、服務(wù)器和開發(fā)語言,按照騰訊地圖WebService API規(guī)范,按需構(gòu)建HTTPS請求,并獲取結(jié)果數(shù)據(jù)(目前支持JSON/JSONP方式返回)。
針對個人開發(fā)者和企業(yè)開發(fā)者,提供的服務(wù)調(diào)用量有差別,可參考配額限制說明。
1. 申請開發(fā)者密鑰(Key):申請密鑰(key是調(diào)用API的身份標識,作為必填參數(shù)之一傳遞給API接口)
2. 以下示例為:搜坐標位置周邊1000米范圍內(nèi)的"酒店"(點擊鏈接可查看返回結(jié)果。注:本示例的Key僅為演示使用,實際開發(fā)及上線時,請務(wù)必使用您申請的Key。)
微信小程序開發(fā)中,提供了發(fā)起 HTTPS 網(wǎng)絡(luò)請求的方法(wx.request),可通過其使用地圖WebServiceAPI。
詳細請參見:《微信小程序中使用服務(wù)API》
騰訊位置服務(wù)API Key,在調(diào)用時用于唯一標識開發(fā)者身份,API KEY是各產(chǎn)品通用的,也就是說同一個Key可以用在地圖SDK,也可以用在JavascriptAPI,也可以用在WebServiceAPI以及其它各產(chǎn)品中,可針對不同產(chǎn)品可獨立啟用(開關(guān))。
假設(shè)您的某個Key只會調(diào)用地圖SDK,可在Key配置界面,將其它產(chǎn)品關(guān)閉,以降低安全風(fēng)險。
例如:在Key設(shè)置中,勾中WebService復(fù)選框,即為啟用產(chǎn)品,該Key才可調(diào)用WebServiceAPI服務(wù) 未啟用時請求服務(wù),會返回:
{ "status": 199, "message": "此key未開啟webservice功能" }
關(guān)于API Key安全:
騰訊位置服務(wù)的調(diào)用配額是開放到Key上的,為了防止您的Key被盜用,保障調(diào)用安全,我們在Key的設(shè)置中提供了多種安全策略:
注意:請盡量避免在網(wǎng)頁端直接調(diào)用WebServiceAPI,因key作為請求參數(shù)容易被抓取到,被盜用的風(fēng)險較高。
詳細使用方法請點擊了解>>
每次請求WebServiceAPI接口,在返回結(jié)果的同時,其響應(yīng)頭中(Response Headers)會包含這一時刻的配額使用情況
響應(yīng)頭:X-LIMIT
子變量:
current_qps:當(dāng)前每秒并發(fā)量
limit_qps:每秒并發(fā)配額
current_pv:今日調(diào)用量
limit_pv:日請求量配額
如圖所示: