用途:在 React 应用中实现 Google Maps 地图相关功能,使用官方 React 库 @vis.gl/react-google-maps。该库由 vis.gl 维护,并获得 Google 支持。
主要能力:库导出 APIProvider(包裹应用并加载 Maps JS API)、Map(地图容器)、AdvancedMarker(现代标记,需 mapId)、Pin(标记自定义样式)、InfoWindow(弹窗)、MapControl(地图自定义控件)以及已被弃用的旧版 Marker。Hooks 包括 useMap(访问 google.maps.Map 实例)、useMapsLibrary(加载 places、geocoding、drawing 等附加库)、useAdvancedMarkerRef(关联标记与信息窗口)和 useApiIsLoaded(检查 API 是否加载)。枚举有 ControlPosition 与 CollisionBehavior。
使用方式:安装命令为 npm install @vis.gl/react-google-maps。APIProvider 必须包裹所有地图组件,建议放在应用根或布局层。AdvancedMarker 需要 mapId,在 Google Cloud Console 的 Maps > Map Styles 创建。资料给出的快速示例展示在 Map 内使用 AdvancedMarker 与 Pin。
限制与注意:Circle、Polygon、Polyline 未从该库导出,需参考 references/geometry-components.md 自行实现;places.Autocomplete 已于 2025 年 3 月弃用,应改用 AutocompleteService 配合自定义 UI。Marker 为旧版且已弃用。此外,详细组件、Hooks、几何组件、地点自动补全与拖拽同步等内容需查阅对应参考文件。