地图组件 / 开发指南 / 位置展示组件

位置展示组件

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

1.2 调用参数

参数名 必填 参数说明 示例
type 是 0：使用URL传递的数据
1：使用地图检索数据，支持region和nearby检索。参考WebService API - 地点搜索
2：使用自有定制数据[暂未开放，后续会陆续支持]		 type=0
marker 是 marker参数的格式：marker=markerAttributesImarkerAttributes，每个markerAttributes定义了一个标注的全部属性，markerAttributes之间以"I"分隔。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号院Icoord: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=酒店&center=39.908491,116.374328&radius=1000&key=yourkey&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为中心的查询范围半径，单位：米。
注意：
1、只有在指定中心点的检索时，才是必填
2、当限定范围内无数据返回，会自动扩大范围（依次按照按1公里、2公里、5公里，最大到全城市范围搜索）		 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

预览

请在下方输入框填入您的key，点击按钮生成二维码(key可在控制台应用管理中自行创建)

这篇文章对您解决问题是否有帮助？

已解决
未解决