騰訊位置服務API接入教程詳解

1 地圖調起(URI API)

:URI API是一組用於打開騰訊地圖網站或者打開用戶手機上安裝的騰訊地圖產品的協議接口，一般在第三方網站或應用中需要用到地圖相關的功能時，可以通過這套接口啓動騰訊地圖產品的不同功能模塊，爲用戶提供地圖及導航服務。

2 功能

：周邊地點搜索、公交搜索、路線導航、逆地址解析、地點標註、街景展示
適用開發平臺：
面向瀏覽器：WebPC版騰訊地圖、移動端瀏覽器H5版騰訊地圖
面向移動端APP：Android版騰訊地圖、iOS版騰訊地圖

3調用

3.1Web端調用

3.1.1接口調用說明

一次完整的URI調用需要包含兩部分信息：引用地址、方法及參數
指定啓用的騰訊地圖產品類型
Web/Wap版地圖：https://apis.map.qq.com/uri/v1/

3.1.2方法及參數

指定啓用的功能及該功能需要設定的參數。格式：method?param=value[&param=value&…]

其中method是方法名，具體支持的方法有：search，地點/公交搜索，周邊搜索；routeplan，路線規劃，包括公交、駕車；geocoder，逆地址解析；marker，地點標註；streetview，街景展示。

3.1.3樣例分析

https://apis.map.qq.com/uri/v1/search?keyword=酒店&region=滄州&referer=OB4BZ-D4W3U-B7VVO-4PJWW-6TKDJ-WPB77

說明：https://apis.map.qq.com/uri/v1/
是引用地址，search是方法名，keyword、region、referer是參數名。

Web瀏覽器打開效果

在手機瀏覽器打開示例效果

3.2 Android/iOS調用

1. 接口調用說明
   適用於在手機端APP 和 手機瀏覽器中，調起騰訊地圖APP。
   iOS通過scheme調用，Android使用Intent調用，統一協議爲：qqmap://map/ 、直接調用系統的canOpenURL進行判斷
   
   

2. APP判斷手機中是否安裝騰訊地圖
   Android系統：請檢測包名 com.tencent.map
   iOS系統：騰訊地圖的URLSheme 是qqmap:// ，直接調用系統的canOpenURL進行判斷
   
   

3. 手機中未安裝騰訊地圖APP的處理方式
   打開騰訊地圖下載頁
   當用戶手機中未安裝騰訊地圖APP時，可通過瀏覽器調起騰訊地圖下載頁，爲用戶提供下載，實現體驗閉環。
   下載頁鏈接：
   https://pr.map.qq.com/j/tmap/download?key=YourKey
   a. 該頁面會自動區分Android 與 iOS ，並下載相應APP包；
   
   
   
   
   
   
   

   b. YourKey：開發者Key，選填（點此申請，Key類型選擇“瀏覽器”），用於標識開發者身份
   
   

調用結果

4 路線規劃

4.1導航和路線規劃

根據指定起點、終點以及出行方式，調起騰訊地圖APP的路線規劃功能，查詢出行路線，並在地圖中展示。
Android 和 iOS 調用地址qqmap://map/routeplan

4.2 功能參數表

4.2.1Android/iOS調用

參數名	必填	說明	示例
type	是	路線規劃方式參數：公交：bus駕車drive步行：walk騎行：bike	type=bus 或 type=drive 或 type=walk 或 type=bike
from	否	起點名稱	from=鼓樓
fromcoord	是	起點座標，格式：lat,lng （緯度在前，經度在後，逗號分隔）功能參數值：CurrentLocation ：使用定位點作爲起點座標	fromcoord=39.907380,116.388501fromcoord=CurrentLocation
to	否	終點名稱	to=奧林匹克森林公園
tocoord	是	終點座標	tocoord=40.010024,116.392239
referer	是	請填寫開發者key	referer=OB4BZ-D4W3U-B7VVO-4PJWW-6TKDJ-WPB77調用示例

測試樣例
調起騰訊地圖APP，顯示由中國石油大學到天安門的駕車路線
qqmap://map/routeplan?type=drive&from=中國石油大學&fromcoord=39.994745,116.247282&to=天安門&tocoord=39.867192,116.493187&referer=OB4BZ-D4W3U-B7VVO-4PJWW-6TKDJ-WPB77

4.2.2Web端(PC/H5)調用調用

根據指定的搜索詞，及搜索範圍等參數，調起騰訊地圖產品的搜索功能，發起地點、地址、公交搜索，並直接在地圖上展示搜索結果。

注意：這裏的公交搜索是指公交線搜索。例如搜索110路的信息。如果要進行公交換乘方案搜索，請使用路線規劃接口。 方法名：search

參數名	必填	說明	示例
region	否	限定搜索城市	region=北京
bound	否	限定搜索座標範圍：矩形範圍區域，參數需給定矩形 左下(西南) 和 右上(東北) 位置座標lat,lng <左下角>,lat,lng <右上角>	bound=39.907293,116.368935,39.914996,116.372
coord_type	否	座標類型，取值如下： 1. GPS 2. 騰訊座標（默認）如果用戶指定該參數爲非騰訊地圖座標系，則URI API自動進行座標處理，以便準確對應到騰訊地圖底圖上。	coord_type=1