騰訊地圖選點組件

地圖選點組件,類似微信中的“發送位置”功能,該組件可以讓用戶快速、準確地選擇並確認自己的當前位置,並將相關位置信息回傳給開發者。

調用示例

調用方式一




通過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: "北京市"
}

調用方式二

通過頁面跳轉的方式調用該組件的時候,開發者需要設置backurl參數,用戶點擊選中的位置點後,頁面跳轉至開發者指定的返回地址(backurl),並將位置信息添加到回跳地址(backurl)上。

例如: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
search0:不顯示搜索區域
1:顯示搜索區域(缺省值)
search=1
policy該參數代表關鍵詞輸入提示的策略。
0:默認,常規策略(缺省值)。
1:本策略主要用於收貨地址、上門服務地址的填寫,提高了小區類、商務樓宇、大學等分類的排序,過濾行政區、道路等分類(如海淀大街、朝陽區等),排序策略引入真實用戶對輸入提示的點擊熱度,使之更爲符合此類應用場景,體驗更爲舒適。
policy=1
mapdraggable0:地圖區域不可拖動
1:地圖區域可拖動(缺省值)
mapdraggable=0
zoom地圖區域的縮放級別,取值範圍是1-18,默認值是15zoom=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-5000radius=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


發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章