|
位置展示组件
位置展示组件，可以在地图上展示一个或多个位置点。数据来源支持三种方式：通过URL传递数据、地图检索数据和自有定制数据。
可以展示每个位置点的名称、地址等详细信息，也可查看该位置点的街景信息或发起到该位置的路线规划。
调用示例
下面按照数据来源的三种方式，分别介绍调用的地址及参数说明。
1. 使用URL传递数据
1.1 调用地址
https://apis.map.qq.com/tools/poimarker?type=0&marker=coord:39.96554,116.26719;title:成都;addr:北京市海淀区复兴路32号院|coord:39.87803,116.19025;title:成都园;addr:北京市丰台区射击场路15号北京园博园|coord:39.88129,116.27062;title:老成都;addr:北京市丰台区岳各庄梅市口路西府景园六号楼底商|coord:39.9982,116.19015;title:北京园博园成都园;addr:北京市丰台区园博园内&key=your key&referer=myapp
1.2 调用参数
参数名
必填
参数说明
示例
type
是
0：使用URL传递的数据
1：使用地图检索数据，支持region和nearby检索。参考 WebService API - 地点搜索
2：使用自有定制数据[暂未开放，后续会陆续支持]
type=0
marker
是
marker参数的格式：marker=markerAttributes|markerAttributes，每个markerAttributes定义了一个标注的全部属性，markerAttributes之间以"|"分隔。markerAttributes格式：coord:lat,lng;title:标注点名称;addr:标注点地址。不同属性之间用英文分号隔开，属性名称和属性值之间用英文冒号隔开。特别提醒，URL中最多传递4个marker信息，且每个marker中title和addr的长度不能超过10个汉字。
单点标注：marker=coord:39.892326,116.342763;title:超好吃冰激凌;addr:手帕口桥北铁路道口多点标注：marker=coord:39.96554,116.26719;title:成都;addr:复兴路32号院|coord:39.87803,116.19025;title:成都园;addr:北京园博园
marker属性集
coord
是
位置点的坐标：lat,lng（英文逗号隔开）
这里的坐标是火星坐标，可用坐标拾取器获取
coord:39.892326,116.342763
coordtype
否
输入的coord坐标类型可选值为[1,6]之间的整数，每个数字代表的类型说明：
1. GPS坐标
2. sogou经纬度
3. baidu经纬度
4. mapbar经纬度
5. [默认]腾讯、google、高德坐标
6. sogou墨卡托
coordtype:5
title
是
位置点名称
title:超好吃冰激凌
addr
是
位置点地址
addr:北京市手帕口桥北铁路道口
init_view
否
初始化显示视图，默认：显示地图 2：显示列表，此参数只在多点标注下生效
init_view=2
key
是
开发密钥(key)
key=your key特别说明：若您的key已设置webservice域名白名单，请在白名单 中增加本组件域名
referer
是
调用来源，一般为您的应用名称，为了保障对您的服务，请务必填写！
referer=myapp
2. 使用地图检索数据
2.1 调用地址
https://apis.map.qq.com/tools/poimarker?type=1&keyword=酒店¢er=39.908491,116.374328&radius=1000&key=your key&referer=myapp
2.2 调用参数
参数名
必填
参数说明
示例
type
是
0：使用URL传递的数据
1：使用地图检索数据，支持region和nearby检索。参考 WebService API - 地点搜索
2：使用自有定制数据[暂未开放，后续会陆续支持]
type=1
keyword
是
检索的关键字
keyword=酒店
region
三选一
城市名称，指定城市的地点搜索
region=北京
bound
矩形范围区域，参数需给定矩形 左下(西南) 和 右上(东北) 位置坐标lat,lng ,lat,lng
bound=39.907293,116.368935,39.914996,116.379321
center
中心点坐标，指定中心点的周边地点搜索,center=lat,lng,注意center=CurrentLocation时表示自动获取设备当前位置作为中心点
center=39.908491,116.374328或center=CurrentLocation
radius
是
以center为中心的查询范围半径，单位：米。注意，只有在指定中心点的检索时，才是必填
radius=1000
georetry
否
center=CurrentLocation条件下，当定位失败时是否显示定位重试按钮。0：不显示重试按钮，使用城市级别的检索结果1：显示重试按钮(缺省值)
georetry=0
tonav
否
0：不显示去这里按钮1：显示去这里按钮(缺省值)
tonav=0
init_view
否
初始化显示视图，默认：显示地图 2：显示列表
init_view=2
key
是
开发密钥(key)
key=your key
referer
是
调用来源，一般为您的应用名称，为了保障对您的服务，请务必填写！
referer=myapp
预览
URL传递数据
地图检索数据
|