地图 JS API 2.0
开发 地图 JS API 2.0 进阶教程 控件和弹窗 信息窗体

信息窗体 最后更新时间: 2024年02月04日

信息窗体在地图应用中是重要的信息展示工具,适用于地点信息展示等场景。本文介绍AMap.InfoWindow信息窗体,包括信息窗体的创建和使用。

默认样式信息窗体示例

[フレーム]

1、准备

成为开发者并创建 key

为了正常调用 API ,请先注册成为高德开放平台开发者,并申请 web 平台(JS API)的 key 和安全密钥,点击 具体操作

提示

你在2021年12月02日以后申请的 key 需要配合你的安全密钥一起使用。

2、信息窗体 InfoWindow

注意

一个地图实例每次只能打开一个信息窗体。

2.1 默认信息窗体的创建

默认信息窗体已有关闭按钮,只需要设定InfoWindowcontent属性。content是字符串拼接的 DOM 元素,content的样式可以自定义。

//信息窗体的内容
var content = [
 "<div><b>高德软件有限公司</b>",
 "电话 : 010-84107000 邮编 : 100102",
 "地址 : 北京市望京阜通东大街方恒国际中心A座16层</div>",
];
//创建 infoWindow 实例
var infoWindow = new AMap.InfoWindow({
 content: content.join("<br>"), //传入字符串拼接的 DOM 元素
 anchor: "top-left",
});
//打开信息窗体
infoWindow.open(map, map.getCenter()); //map 为当前地图的实例,map.getCenter() 用于获取地图中心点坐标。

2.2 信息窗体锚点的设置(anchor)(自 v1.4.13 新增属性)

可以通过anchor设置锚点方位。anchor可选值有'top-left''top-center''top-right''middle-left''center''middle-right''bottom-left''bottom-center''bottom-right' , 分别代表了信息窗体在地图上展示位置的不同方位。

var infoWindow = new AMap.InfoWindow({
 anchor: "top-left",
 content: "这是信息窗体!",
});
infoWindow.open(map, [116.401337, 39.907886]);

2.3 自定义信息窗体

如果要自定义信息窗体,只需把 InfoWindowisCustom 属性设置为 true ,信息窗体就会变成自定义信息窗体。与默认信息窗体的不同在于,自定义信息窗体需要自己通过 content 来实现关闭按钮以及全部外观样式,同时需要通过 offset 指定锚点位置,offset 为相对于 content 下边缘中间点的位移:

//实例化信息窗体
var content = [
 "<div class='info'>这是一个自定义窗体",
 "所以内容和样式你都可以自定义",
 "<img src='https://webapi.amap.com/images/sharp.png'></div>",
];
var infoWindow = new AMap.InfoWindow({
 isCustom: true, //使用自定义窗体
 content: content.join("<br>"),
 offset: new AMap.Pixel(16, -45),
});
infoWindow.open(map, map.getCenter());
提示

如果你想关闭信息窗体,可以使用infoWindow.close()

设置样式:

.info {
 background-color: #fff;
 text-align: center;
 padding: 10px;
 position: relative;
 border: 1px solid #b9b9b9;
}
.info img {
 width: 30px;
 height: 23px;
 position: absolute;
 left: calc(50% - 15px);
 bottom: -23px;
}
提示

自定义信息窗体的偏移量(offset)

如果用户自定义信息窗体内容,可以为定义的内容添加偏移量(offset)。当偏移量为 (0, 0) 时,自定义内容默认以底部中部为基准点(若设置了 anchor,基准点位置则为 anchor 设置的位置)与经纬度坐标对齐;设置 offset 为其他值则对齐位置相应改变。具体偏移规则如下:

2.4 信息窗体的事件

信息窗体支持多种事件,包括:open 事件(信息窗体打开之后触发)、close 事件(信息窗体关闭之后触发)。

示例中心 常见问题

AltStyle によって変換されたページ (->オリジナル) /