地圖選點組件,類似微信中的“發送位置”功能,該組件可以讓用戶快速、準確地選擇並確認自己的當前位置,並將相關位置信息回傳給開發者。
調用示例
調用方式一
通過iframe內嵌調用,地圖選點組件的頁面會根據開發者設置的iframe寬高自適應。注:1、使用iframe調用時,爲防止在大屏手機上字體過小,需在源碼中加入meta信息,<meta name="viewport" content="width=device-width, initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no">
2、開發者可以在自己的頁面裏通過iframe內嵌的方式調用該組件的時候,由於存在跨域的問題,需要通過html5 postMessage的方式回傳用戶選擇的位置信息,開發者需要在自己的頁面中實現一個監聽函數,例如:
1 2 3 4 5 6 7 8 9 10 11 12 13 | <iframe id= "mapPage" width= "100%" height= "100%" frameborder=0 </iframe> <script> window.addEventListener( 'message' , function (event) { // 接收位置信息,用戶選擇確認位置點後選點組件會觸發該事件,回傳用戶的位置信息 var loc = event.data; if (loc && loc.module == 'locationPicker' ) { //防止其他應用也會向該頁面post信息,需判斷module是否爲'locationPicker' console.log( 'location' , loc); } }, false ); </script> |
返回的位置信息格式
1 2 3 4 5 6 7 8 9 10 | { module: 'locationPicker' , latlng: { lat: 39.998766, lng: 116.273938 }, poiaddress: "北京市海淀區新建宮門路19號" , poiname: "頤和園" , cityname: "北京市" } |
調用方式二
例如:http://apis.map.qq.com/tools/locpicker?search=1&type=0&backurl=http://3gimg.qq.com/lightmap/components/locationPicker2/back.html&key=OB4BZ-D4W3U-B7VVO-4PJWW-6TKDJ-WPB77&referer=myapp
調用參數
參數名 | 必填 | 參數說明 | 示例 |
---|---|---|---|
type | 是 | 該參數代表該組件的兩種不同的調用方法。 0:表示該組件是以頁面跳轉的方式調用的,此時需要加上backurl參數,backurl參數表示用戶點擊選擇的位置點後的回跳地址。 1:表示該組件是以iframe內嵌頁面的形式調用的。 | 示例1,type=0&backurl=XXX 示例2,type=1 |
search | 否 | 0:不顯示搜索區域 1:顯示搜索區域(缺省值) | search=1 |
policy | 否 | 該參數代表關鍵詞輸入提示的策略。 0:默認,常規策略(缺省值)。 1:本策略主要用於收貨地址、上門服務地址的填寫,提高了小區類、商務樓宇、大學等分類的排序,過濾行政區、道路等分類(如海淀大街、朝陽區等),排序策略引入真實用戶對輸入提示的點擊熱度,使之更爲符合此類應用場景,體驗更爲舒適。 | policy=1 |
mapdraggable | 否 | 0:地圖區域不可拖動 1:地圖區域可拖動(缺省值) | mapdraggable=0 |
zoom | 否 | 地圖區域的縮放級別,取值範圍是1-18,默認值是15 | zoom=13 |
coord | 否 | 在指定位置附近進行位置選擇,coord用英文逗號分隔,緯度在前,經度在後 | coord=40.022964,116.319723 |
coordtype | 否 | 輸入的coord座標類型 可選值爲[1,6]之間的整數,每個數字代表的類型說明: 1. GPS座標 2. sogou經緯度 3. baidu經緯度 4. mapbar經緯度 5. [默認]騰訊、google、高德座標 6. sogou墨卡託 | coordtype=5 |
radius | 否 | 周邊檢索的半徑,默認值是在1000米範圍內檢索,取值範圍是1000-5000 | radius=2000 |
total | 否 | 顯示周邊檢索的結果數 | total=10 |
key | 是 | 開發密鑰(key) | key=OB4BZ-D4W3U-B7VVO-4PJWW-6TKDJ-WPB77 |
referer | 是 | 調用來源,一般爲您的應用名稱,爲了保障對您的服務,請務必填寫! | referer=myapp |
預覽
demo1: 單獨體驗 | demo2: iframe調用 | demo3: backurl調用 |
---|---|---|
本文轉自騰訊位置服務http://lbs.qq.com/tool/component-picker.html