地图选点组件

地图选点组件,类似微信中的“发送位置”功能,该组件可以让用户快速、准确地选择并确认自己的当前位置,并将相关位置信息回传给开发者。

调用示例

调用方式一

通过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的方式回传用户选择的位置信息,开发者需要在自己的页面中实现一个监听函数,例如:

返回的位置信息格式

调用方式二

通过页面跳转的方式调用该组件的时候,开发者需要设置backurl参数,用户点击选中的位置点后,页面跳转至开发者指定的返回地址(backurl),并将位置信息添加到回跳地址(backurl)上。

例如:https://apis.map.qq.com/tools/locpicker?search=1&type=0&backurl=http://3gimg.qq.com/lightmap/components/locationPicker2/back.html&key=your key&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=your key
特别说明:若您的key已设置webservice域名白名单,请在白名单 中增加本组件域名
referer 调用来源,一般为您的应用名称,为了保障对您的服务,请务必填写! referer=myapp

预览

demo1: 单独体验 demo2: iframe调用 demo3: backurl调用