位置展示组件
位置展示组件，可以在地图上展示一个或多个位置点。数据来源支持三种方式：通过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传递数据 | 地图检索数据 |
|---|---|
 |
 |