angular-google-maps

用途：在 Angular 应用中集成 Google Maps，实现地图嵌入、标记标注、图形绘制与地址/坐标转换。主要能力：用 GoogleMapsModule 引入组件；<google-map> 通过 [center]、[zoom]、[options] 绑定并处理 mapClick、mapDrag、zoomChanged 事件；<map-marker> 支持 position、label、title、options 及点击、拖拽事件；<map-info-window> 配合 @ViewChild(MapInfoWindow) 调用 open()/close() 显示弹窗；<map-polygon>、<map-polyline>、<map-circle> 绘制图形并配置样式；google.maps.Geocoder 支持地址与坐标互转。使用方式：先安装 npm install @angular/google-maps 与 npm install @types/google.maps，在 index.html 中加载 https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY，需在 Google Cloud Console 启用 Maps JavaScript API 并创建、限制 API Key；地图元素必须设置显式高度；位置使用 google.maps.LatLngLiteral：{ lat: number, lng: number }。适用场景：需在 Angular 中展示交互地图、标注多点、绘制区域或做地理编码的功能。限制与注意：API Key 不得在无限制情况下暴露于客户端，应存入环境配置并按域/IP 限制；地理编码需缓存并防抖（300-500ms），避免每次按键请求；大数据集（超过 100 个标记）应使用标记聚类、按视口过滤，避免一次性加载全部标记；地图脚本可延迟加载。