@agm/markerclusterer

中文文档
3.0.0-beta.0发布于 2020/07/20MITTypeScriptESM + CJS近 30 天下载 1689

Angular Google Maps (AGM) extension for markerclusterer support

原始使用文档

Marker Clusterer for AGM


this package levereges the markerclustererplus to add clustering support to AGM.

Installation

@agm/js-marker-clusterer has a peer depedency on markerclustererplus

npm install @google/markerclustererplus @agm/js-marker-clusterer --save
# or
yarn add @google/markerclustererplus @agm/js-marker-clusterer

Usage

  1. Add assets command to your angular.json In your angular.json file, go to projects/<yourproject>/architect/build/options/assets and add the following line:

    {"input": "./node_modules/@google/markerclustererplus/images", "glob": "*", "output": "/images"}
    
  2. Import the module

    import { BrowserModule } from '@angular/platform-browser';
    import { NgModule } from '@angular/core';
    import { AppComponent } from './app.component';
    
    // add these imports
    import { AgmCoreModule } from '@agm/core';
    import { AgmJsMarkerClustererModule } from '@agm/js-marker-clusterer';
    
    @NgModule({
      declarations: [
        AppComponent
      ],
      imports: [
        BrowserModule,
        AgmCoreModule.forRoot({
          apiKey: ['YOUR_API_KEY_HERE']
        }),
        AgmJsMarkerClustererModule
      ],
      providers: [],
      bootstrap: [AppComponent]
    })
    export class AppModule { }
    
  3. use it in your template

    <agm-map style="height: 300px" [latitude]="51.673858" [longitude]="7.815982">
      <agm-marker-cluster imagePath="https://raw.githubusercontent.com/googlemaps/v3-utility-library/master/markerclustererplus/images/m">
        <agm-marker [latitude]="51.673858" [longitude]="7.815982">
        </agm-marker><!-- multiple markers -->
      </agm-marker-cluster>
    </agm-map>
    

版本与发布记录

@agm/markerclusterer 共发布 1 个版本,首次发布于 2020/07/20;过去 12 个月发布了 0 个版本。

版本发布日期距今
3.0.0-beta.0latest2020/07/206 年前

关于 @agm/markerclusterer 的常见问题

@agm/markerclusterer 是什么?

Angular Google Maps (AGM) extension for markerclusterer support

如何安装 @agm/markerclusterer?

在项目目录运行 npm install @agm/markerclusterer,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@agm/core(3.0.0-beta.0)、@angular/common(^9.1.0 || ^10.0.0)、@angular/core(^9.1.0 || ^10.0.0)、@google/markerclustererplus(^5.0.4)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@agm/markerclusterer 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@agm/markerclusterer 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@agm/markerclusterer 可以商用吗?

@agm/markerclusterer 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@agm/markerclusterer 的下载量有多少?

根据 npm 官方下载统计,@agm/markerclusterer 在 2026/10/05 – 2026/11/03 这 30 天内被下载 1,689 次,日均约 56 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@agm/markerclusterer 还在维护吗?

最新版本 3.0.0-beta.0 发布于 2020/07/20(6 年前);至今共发布 1 个版本,其中过去 12 个月发布了 0 个;首次发布于 2020/07/20。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。