@angular/google-maps 19.0.0-next.0 → 19.0.0-next.10

package/index.d.ts

@@ -1,7 +1,6 @@
 /// <reference types="google.maps" />
 
 import { AfterContentInit } from '@angular/core';
-import { ElementRef } from '@angular/core';
 import { EventEmitter } from '@angular/core';
 import * as i0 from '@angular/core';
 import { NgZone } from '@angular/core';
@@ -12,6 +11,49 @@ import { OnInit } from '@angular/core';
 import { QueryList } from '@angular/core';
 import { SimpleChanges } from '@angular/core';
 
+declare interface Algorithm_2 {
+    /**
+     * Calculates an array of {@link Cluster}.
+     */
+    calculate: ({ markers, map }: AlgorithmInput) => AlgorithmOutput;
+}
+export { Algorithm_2 as Algorithm }
+
+export declare interface AlgorithmInput {
+    /**
+     * The map containing the markers and clusters.
+     */
+    map: google.maps.Map;
+    /**
+     * An array of markers to be clustered.
+     *
+     * There are some specific edge cases to be aware of including the following:
+     * * Markers that are not visible.
+     */
+    markers: Marker[];
+    /**
+     * The `mapCanvasProjection` enables easy conversion from lat/lng to pixel.
+     *
+     * @see [MapCanvasProjection](https://developers.google.com/maps/documentation/javascript/reference/overlay-view#MapCanvasProjection)
+     */
+    mapCanvasProjection: google.maps.MapCanvasProjection;
+}
+
+export declare interface AlgorithmOptions {
+    maxZoom?: number;
+}
+
+export declare interface AlgorithmOutput {
+    /**
+     * The clusters returned based upon the {@link AlgorithmInput}.
+     */
+    clusters: Cluster[];
+    /**
+     * A boolean flag indicating that the clusters have not changed.
+     */
+    changed?: boolean;
+}
+
 /**
  * Function type alias for determining the aria label on a Google Maps marker cluster.
  *
@@ -26,13 +68,34 @@ export declare type AriaLabelFn = (text: string) => string;
  */
 export declare type Calculator = (markers: google.maps.Marker[], clusterIconStylesCount: number) => ClusterIconInfo;
 
+export declare class Cluster {
+    marker?: Marker;
+    readonly markers?: Marker[];
+    protected _position: google.maps.LatLng;
+    constructor({ markers, position }: ClusterOptions);
+    get bounds(): google.maps.LatLngBounds | undefined;
+    get position(): google.maps.LatLng;
+    /**
+     * Get the count of **visible** markers.
+     */
+    get count(): number;
+    /**
+     * Add a marker to the cluster.
+     */
+    push(marker: Marker): void;
+    /**
+     * Cleanup references and remove marker from map.
+     */
+    delete(): void;
+}
+
 /**
  * Cluster class from the @google/markerclustererplus library.
  *
  * See googlemaps.github.io/v3-utility-library/classes/_google_markerclustererplus.cluster.html
  */
-declare class Cluster {
-    constructor(markerClusterer: MarkerClusterer);
+declare class Cluster_2 {
+    constructor(markerClusterer: MarkerClusterer_2);
     getCenter(): google.maps.LatLng;
     getMarkers(): google.maps.Marker[];
     getSize(): number;
@@ -76,6 +139,27 @@ export declare interface ClusterIconStyle {
     width: number;
 }
 
+export declare interface ClusterOptions {
+    position?: google.maps.LatLng | google.maps.LatLngLiteral;
+    markers?: Marker[];
+}
+
+export declare class ClusterStats {
+    readonly markers: {
+        sum: number;
+    };
+    readonly clusters: {
+        count: number;
+        markers: {
+            mean: number;
+            sum: number;
+            min: number;
+            max: number;
+        };
+    };
+    constructor(markers: Marker[], clusters: Cluster[]);
+}
+
 /** Arbitrary default height for the map element */
 declare const DEFAULT_HEIGHT = "500px";
 
@@ -107,6 +191,118 @@ declare const DEFAULT_OPTIONS: google.maps.MapOptions;
 /** Arbitrary default width for the map element */
 declare const DEFAULT_WIDTH = "500px";
 
+export declare const defaultOnClusterClickHandler: onClusterClickHandler;
+
+/**
+ * Angular component for implementing a Google Maps Marker Clusterer.
+ * See https://developers.google.com/maps/documentation/javascript/marker-clustering
+ *
+ * @deprecated This component is using a deprecated clustering implementation. Use the
+ *   `map-marker-clusterer` component instead.
+ * @breaking-change 21.0.0
+ *
+ */
+export declare class DeprecatedMapMarkerClusterer implements OnInit, AfterContentInit, OnChanges, OnDestroy {
+    private readonly _googleMap;
+    private readonly _ngZone;
+    private readonly _currentMarkers;
+    private readonly _eventManager;
+    private readonly _destroy;
+    /** Whether the clusterer is allowed to be initialized. */
+    private readonly _canInitialize;
+    ariaLabelFn: AriaLabelFn;
+    set averageCenter(averageCenter: boolean);
+    private _averageCenter;
+    batchSize?: number;
+    set batchSizeIE(batchSizeIE: number);
+    private _batchSizeIE;
+    set calculator(calculator: Calculator);
+    private _calculator;
+    set clusterClass(clusterClass: string);
+    private _clusterClass;
+    set enableRetinaIcons(enableRetinaIcons: boolean);
+    private _enableRetinaIcons;
+    set gridSize(gridSize: number);
+    private _gridSize;
+    set ignoreHidden(ignoreHidden: boolean);
+    private _ignoreHidden;
+    set imageExtension(imageExtension: string);
+    private _imageExtension;
+    set imagePath(imagePath: string);
+    private _imagePath;
+    set imageSizes(imageSizes: number[]);
+    private _imageSizes;
+    set maxZoom(maxZoom: number);
+    private _maxZoom;
+    set minimumClusterSize(minimumClusterSize: number);
+    private _minimumClusterSize;
+    set styles(styles: ClusterIconStyle[]);
+    private _styles;
+    set title(title: string);
+    private _title;
+    set zIndex(zIndex: number);
+    private _zIndex;
+    set zoomOnClick(zoomOnClick: boolean);
+    private _zoomOnClick;
+    set options(options: MarkerClustererOptions);
+    private _options;
+    /**
+     * See
+     * googlemaps.github.io/v3-utility-library/modules/
+     * _google_markerclustererplus.html#clusteringbegin
+     */
+    readonly clusteringbegin: Observable<void>;
+    /**
+     * See
+     * googlemaps.github.io/v3-utility-library/modules/_google_markerclustererplus.html#clusteringend
+     */
+    readonly clusteringend: Observable<void>;
+    /** Emits when a cluster has been clicked. */
+    readonly clusterClick: Observable<Cluster_2>;
+    _markers: QueryList<MapMarker>;
+    /**
+     * The underlying MarkerClusterer object.
+     *
+     * See
+     * googlemaps.github.io/v3-utility-library/classes/
+     * _google_markerclustererplus.markerclusterer.html
+     */
+    markerClusterer?: MarkerClusterer_2;
+    /** Event emitted when the clusterer is initialized. */
+    readonly markerClustererInitialized: EventEmitter<MarkerClusterer_2>;
+    constructor(...args: unknown[]);
+    ngOnInit(): void;
+    ngAfterContentInit(): void;
+    ngOnChanges(changes: SimpleChanges): void;
+    ngOnDestroy(): void;
+    fitMapToMarkers(padding: number | google.maps.Padding): void;
+    getAverageCenter(): boolean;
+    getBatchSizeIE(): number;
+    getCalculator(): Calculator;
+    getClusterClass(): string;
+    getClusters(): Cluster_2[];
+    getEnableRetinaIcons(): boolean;
+    getGridSize(): number;
+    getIgnoreHidden(): boolean;
+    getImageExtension(): string;
+    getImagePath(): string;
+    getImageSizes(): number[];
+    getMaxZoom(): number;
+    getMinimumClusterSize(): number;
+    getStyles(): ClusterIconStyle[];
+    getTitle(): string;
+    getTotalClusters(): number;
+    getTotalMarkers(): number;
+    getZIndex(): number;
+    getZoomOnClick(): boolean;
+    private _combineOptions;
+    private _watchForMarkerChanges;
+    private _getInternalMarkers;
+    private _assertInitialized;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DeprecatedMapMarkerClusterer, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DeprecatedMapMarkerClusterer, "deprecated-map-marker-clusterer", ["mapMarkerClusterer"], { "ariaLabelFn": { "alias": "ariaLabelFn"; "required": false; }; "averageCenter": { "alias": "averageCenter"; "required": false; }; "batchSize": { "alias": "batchSize"; "required": false; }; "batchSizeIE": { "alias": "batchSizeIE"; "required": false; }; "calculator": { "alias": "calculator"; "required": false; }; "clusterClass": { "alias": "clusterClass"; "required": false; }; "enableRetinaIcons": { "alias": "enableRetinaIcons"; "required": false; }; "gridSize": { "alias": "gridSize"; "required": false; }; "ignoreHidden": { "alias": "ignoreHidden"; "required": false; }; "imageExtension": { "alias": "imageExtension"; "required": false; }; "imagePath": { "alias": "imagePath"; "required": false; }; "imageSizes": { "alias": "imageSizes"; "required": false; }; "maxZoom": { "alias": "maxZoom"; "required": false; }; "minimumClusterSize": { "alias": "minimumClusterSize"; "required": false; }; "styles": { "alias": "styles"; "required": false; }; "title": { "alias": "title"; "required": false; }; "zIndex": { "alias": "zIndex"; "required": false; }; "zoomOnClick": { "alias": "zoomOnClick"; "required": false; }; "options": { "alias": "options"; "required": false; }; }, { "clusteringbegin": "clusteringbegin"; "clusteringend": "clusteringend"; "clusterClick": "clusterClick"; "markerClustererInitialized": "markerClustererInitialized"; }, ["_markers"], ["*"], true, never>;
+}
+
 /**
  * Angular component that renders a Google Map via the Google Maps JavaScript
  * API.
@@ -243,7 +439,7 @@ export declare class GoogleMap implements OnChanges, OnInit, OnDestroy {
      * https://developers.google.com/maps/documentation/javascript/reference/map#Map.zoom_changed
      */
     readonly zoomChanged: Observable<void>;
-    constructor(_elementRef: ElementRef, _ngZone: NgZone, platformId: Object);
+    constructor(...args: unknown[]);
     ngOnChanges(changes: SimpleChanges): void;
     ngOnInit(): void;
     private _initialize;
@@ -346,7 +542,7 @@ export declare class GoogleMap implements OnChanges, OnInit, OnDestroy {
 
 export declare class GoogleMapsModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<GoogleMapsModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<GoogleMapsModule, never, [typeof i1.GoogleMap, typeof i2.MapBaseLayer, typeof i3.MapBicyclingLayer, typeof i4.MapCircle, typeof i5.MapDirectionsRenderer, typeof i6.MapGroundOverlay, typeof i7.MapHeatmapLayer, typeof i8.MapInfoWindow, typeof i9.MapKmlLayer, typeof i10.MapMarker, typeof i11.MapAdvancedMarker, typeof i12.MapMarkerClusterer, typeof i13.MapPolygon, typeof i14.MapPolyline, typeof i15.MapRectangle, typeof i16.MapTrafficLayer, typeof i17.MapTransitLayer], [typeof i1.GoogleMap, typeof i2.MapBaseLayer, typeof i3.MapBicyclingLayer, typeof i4.MapCircle, typeof i5.MapDirectionsRenderer, typeof i6.MapGroundOverlay, typeof i7.MapHeatmapLayer, typeof i8.MapInfoWindow, typeof i9.MapKmlLayer, typeof i10.MapMarker, typeof i11.MapAdvancedMarker, typeof i12.MapMarkerClusterer, typeof i13.MapPolygon, typeof i14.MapPolyline, typeof i15.MapRectangle, typeof i16.MapTrafficLayer, typeof i17.MapTransitLayer]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<GoogleMapsModule, never, [typeof i1.GoogleMap, typeof i2.MapBaseLayer, typeof i3.MapBicyclingLayer, typeof i4.MapCircle, typeof i5.MapDirectionsRenderer, typeof i6.MapGroundOverlay, typeof i7.MapHeatmapLayer, typeof i8.MapInfoWindow, typeof i9.MapKmlLayer, typeof i10.MapMarker, typeof i11.MapAdvancedMarker, typeof i12.DeprecatedMapMarkerClusterer, typeof i13.MapPolygon, typeof i14.MapPolyline, typeof i15.MapRectangle, typeof i16.MapTrafficLayer, typeof i17.MapTransitLayer, typeof i18.MapMarkerClusterer], [typeof i1.GoogleMap, typeof i2.MapBaseLayer, typeof i3.MapBicyclingLayer, typeof i4.MapCircle, typeof i5.MapDirectionsRenderer, typeof i6.MapGroundOverlay, typeof i7.MapHeatmapLayer, typeof i8.MapInfoWindow, typeof i9.MapKmlLayer, typeof i10.MapMarker, typeof i11.MapAdvancedMarker, typeof i12.DeprecatedMapMarkerClusterer, typeof i13.MapPolygon, typeof i14.MapPolyline, typeof i15.MapRectangle, typeof i16.MapTrafficLayer, typeof i17.MapTransitLayer, typeof i18.MapMarkerClusterer]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<GoogleMapsModule>;
 }
 
@@ -378,7 +574,7 @@ declare namespace i11 {
 
 declare namespace i12 {
     export {
-        MapMarkerClusterer
+        DeprecatedMapMarkerClusterer
     }
 }
 
@@ -412,6 +608,12 @@ declare namespace i17 {
     }
 }
 
+declare namespace i18 {
+    export {
+        MapMarkerClusterer
+    }
+}
+
 declare namespace i2 {
     export {
         MapBaseLayer
@@ -466,7 +668,7 @@ declare namespace i9 {
  *
  * See developers.google.com/maps/documentation/javascript/reference/marker
  */
-export declare class MapAdvancedMarker implements OnInit, OnChanges, OnDestroy, MapAnchorPoint {
+export declare class MapAdvancedMarker implements OnInit, OnChanges, OnDestroy, MapAnchorPoint, MarkerDirective {
     private readonly _googleMap;
     private _ngZone;
     private _eventManager;
@@ -514,6 +716,26 @@ export declare class MapAdvancedMarker implements OnInit, OnChanges, OnDestroy,
      * https://developers.google.com/maps/documentation/javascript/reference/advanced-markers#AdvancedMarkerElement.click
      */
     readonly mapClick: Observable<google.maps.MapMouseEvent>;
+    /**
+     * This event is fired when the AdvancedMarkerElement is double-clicked.
+     */
+    readonly mapDblclick: Observable<google.maps.MapMouseEvent>;
+    /**
+     * This event is fired when the mouse moves out of the AdvancedMarkerElement.
+     */
+    readonly mapMouseout: Observable<google.maps.MapMouseEvent>;
+    /**
+     * This event is fired when the mouse moves over the AdvancedMarkerElement.
+     */
+    readonly mapMouseover: Observable<google.maps.MapMouseEvent>;
+    /**
+     * This event is fired when the mouse button is released over the AdvancedMarkerElement.
+     */
+    readonly mapMouseup: Observable<google.maps.MapMouseEvent>;
+    /**
+     * This event is fired when the AdvancedMarkerElement is right-clicked.
+     */
+    readonly mapRightclick: Observable<google.maps.MapMouseEvent>;
     /**
      * This event is repeatedly fired while the user drags the AdvancedMarkerElement.
      * https://developers.google.com/maps/documentation/javascript/reference/advanced-markers#AdvancedMarkerElement.drag
@@ -537,18 +759,20 @@ export declare class MapAdvancedMarker implements OnInit, OnChanges, OnDestroy,
      * See developers.google.com/maps/documentation/javascript/reference/advanced-markers#AdvancedMarkerElement
      */
     advancedMarker: google.maps.marker.AdvancedMarkerElement;
-    constructor(_googleMap: GoogleMap, _ngZone: NgZone);
+    constructor(...args: unknown[]);
     ngOnInit(): void;
     private _initialize;
     ngOnChanges(changes: SimpleChanges): void;
     ngOnDestroy(): void;
     getAnchor(): google.maps.marker.AdvancedMarkerElement;
+    /** Returns a promise that resolves when the marker has been initialized. */
+    _resolveMarker(): Promise<google.maps.marker.AdvancedMarkerElement>;
     /** Creates a combined options object using the passed-in options and the individual inputs. */
     private _combineOptions;
     /** Asserts that the map has been initialized. */
     private _assertInitialized;
     static ɵfac: i0.ɵɵFactoryDeclaration<MapAdvancedMarker, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<MapAdvancedMarker, "map-advanced-marker", ["mapAdvancedMarker"], { "title": { "alias": "title"; "required": false; }; "position": { "alias": "position"; "required": false; }; "content": { "alias": "content"; "required": false; }; "gmpDraggable": { "alias": "gmpDraggable"; "required": false; }; "options": { "alias": "options"; "required": false; }; "zIndex": { "alias": "zIndex"; "required": false; }; }, { "mapClick": "mapClick"; "mapDrag": "mapDrag"; "mapDragend": "mapDragend"; "mapDragstart": "mapDragstart"; "markerInitialized": "markerInitialized"; }, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MapAdvancedMarker, "map-advanced-marker", ["mapAdvancedMarker"], { "title": { "alias": "title"; "required": false; }; "position": { "alias": "position"; "required": false; }; "content": { "alias": "content"; "required": false; }; "gmpDraggable": { "alias": "gmpDraggable"; "required": false; }; "options": { "alias": "options"; "required": false; }; "zIndex": { "alias": "zIndex"; "required": false; }; }, { "mapClick": "mapClick"; "mapDblclick": "mapDblclick"; "mapMouseout": "mapMouseout"; "mapMouseover": "mapMouseover"; "mapMouseup": "mapMouseup"; "mapRightclick": "mapRightclick"; "mapDrag": "mapDrag"; "mapDragend": "mapDragend"; "mapDragstart": "mapDragstart"; "markerInitialized": "markerInitialized"; }, never, never, true, never>;
 }
 
 
@@ -560,7 +784,7 @@ export declare interface MapAnchorPoint {
 export declare class MapBaseLayer implements OnInit, OnDestroy {
     protected readonly _map: GoogleMap;
     protected readonly _ngZone: NgZone;
-    constructor(_map: GoogleMap, _ngZone: NgZone);
+    constructor(...args: unknown[]);
     ngOnInit(): void;
     ngOnDestroy(): void;
     private _assertInitialized;
@@ -683,7 +907,7 @@ export declare class MapCircle implements OnInit, OnDestroy {
     readonly circleRightclick: Observable<google.maps.MapMouseEvent>;
     /** Event emitted when the circle is initialized. */
     readonly circleInitialized: EventEmitter<google.maps.Circle>;
-    constructor(_map: GoogleMap, _ngZone: NgZone);
+    constructor(...args: unknown[]);
     ngOnInit(): void;
     private _initialize;
     ngOnDestroy(): void;
@@ -757,7 +981,7 @@ export declare class MapDirectionsRenderer implements OnInit, OnChanges, OnDestr
     readonly directionsRendererInitialized: EventEmitter<google.maps.DirectionsRenderer>;
     /** The underlying google.maps.DirectionsRenderer object. */
     directionsRenderer?: google.maps.DirectionsRenderer;
-    constructor(_googleMap: GoogleMap, _ngZone: NgZone);
+    constructor(...args: unknown[]);
     ngOnInit(): void;
     private _initialize;
     ngOnChanges(changes: SimpleChanges): void;
@@ -797,7 +1021,7 @@ export declare interface MapDirectionsResponse {
 export declare class MapDirectionsService {
     private readonly _ngZone;
     private _directionsService;
-    constructor(_ngZone: NgZone);
+    constructor(...args: unknown[]);
     /**
      * See
      * developers.google.com/maps/documentation/javascript/reference/directions
@@ -838,7 +1062,7 @@ declare type MapEventManagerTarget = {
 export declare class MapGeocoder {
     private readonly _ngZone;
     private _geocoder;
-    constructor(_ngZone: NgZone);
+    constructor(...args: unknown[]);
     /**
      * See developers.google.com/maps/documentation/javascript/reference/geocoder#Geocoder.geocode
      */
@@ -895,7 +1119,7 @@ export declare class MapGroundOverlay implements OnInit, OnDestroy {
     readonly mapDblclick: Observable<google.maps.MapMouseEvent>;
     /** Event emitted when the ground overlay is initialized. */
     readonly groundOverlayInitialized: EventEmitter<google.maps.GroundOverlay>;
-    constructor(_map: GoogleMap, _ngZone: NgZone);
+    constructor(...args: unknown[]);
     ngOnInit(): void;
     private _initialize;
     ngOnDestroy(): void;
@@ -952,7 +1176,7 @@ export declare class MapHeatmapLayer implements OnInit, OnChanges, OnDestroy {
     heatmap?: google.maps.visualization.HeatmapLayer;
     /** Event emitted when the heatmap is initialized. */
     readonly heatmapInitialized: EventEmitter<google.maps.visualization.HeatmapLayer>;
-    constructor(_googleMap: GoogleMap, _ngZone: NgZone);
+    constructor(...args: unknown[]);
     ngOnInit(): void;
     private _initialize;
     ngOnChanges(changes: SimpleChanges): void;
@@ -1030,7 +1254,7 @@ export declare class MapInfoWindow implements OnInit, OnDestroy {
     readonly zindexChanged: Observable<void>;
     /** Event emitted when the info window is initialized. */
     readonly infoWindowInitialized: EventEmitter<google.maps.InfoWindow>;
-    constructor(_googleMap: GoogleMap, _elementRef: ElementRef<HTMLElement>, _ngZone: NgZone);
+    constructor(...args: unknown[]);
     ngOnInit(): void;
     private _initialize;
     ngOnDestroy(): void;
@@ -1109,7 +1333,7 @@ export declare class MapKmlLayer implements OnInit, OnDestroy {
     readonly statusChanged: Observable<void>;
     /** Event emitted when the KML layer is initialized. */
     readonly kmlLayerInitialized: EventEmitter<google.maps.KmlLayer>;
-    constructor(_map: GoogleMap, _ngZone: NgZone);
+    constructor(...args: unknown[]);
     ngOnInit(): void;
     private _initialize;
     ngOnDestroy(): void;
@@ -1147,7 +1371,7 @@ export declare class MapKmlLayer implements OnInit, OnDestroy {
  *
  * See developers.google.com/maps/documentation/javascript/reference/marker
  */
-export declare class MapMarker implements OnInit, OnChanges, OnDestroy, MapAnchorPoint {
+export declare class MapMarker implements OnInit, OnChanges, OnDestroy, MapAnchorPoint, MarkerDirective {
     private readonly _googleMap;
     private _ngZone;
     private _eventManager;
@@ -1306,7 +1530,7 @@ export declare class MapMarker implements OnInit, OnChanges, OnDestroy, MapAncho
      * See developers.google.com/maps/documentation/javascript/reference/marker#Marker
      */
     marker?: google.maps.Marker;
-    constructor(_googleMap: GoogleMap, _ngZone: NgZone);
+    constructor(...args: unknown[]);
     ngOnInit(): void;
     private _initialize;
     ngOnChanges(changes: SimpleChanges): void;
@@ -1387,105 +1611,45 @@ export declare class MapMarker implements OnInit, OnChanges, OnDestroy, MapAncho
  *
  * See https://developers.google.com/maps/documentation/javascript/marker-clustering
  */
-export declare class MapMarkerClusterer implements OnInit, AfterContentInit, OnChanges, OnDestroy {
+export declare class MapMarkerClusterer implements OnInit, OnChanges, OnDestroy {
     private readonly _googleMap;
     private readonly _ngZone;
     private readonly _currentMarkers;
-    private readonly _eventManager;
-    private readonly _destroy;
+    private readonly _closestMapEventManager;
+    private _markersSubscription;
     /** Whether the clusterer is allowed to be initialized. */
     private readonly _canInitialize;
-    ariaLabelFn: AriaLabelFn;
-    set averageCenter(averageCenter: boolean);
-    private _averageCenter;
-    batchSize?: number;
-    set batchSizeIE(batchSizeIE: number);
-    private _batchSizeIE;
-    set calculator(calculator: Calculator);
-    private _calculator;
-    set clusterClass(clusterClass: string);
-    private _clusterClass;
-    set enableRetinaIcons(enableRetinaIcons: boolean);
-    private _enableRetinaIcons;
-    set gridSize(gridSize: number);
-    private _gridSize;
-    set ignoreHidden(ignoreHidden: boolean);
-    private _ignoreHidden;
-    set imageExtension(imageExtension: string);
-    private _imageExtension;
-    set imagePath(imagePath: string);
-    private _imagePath;
-    set imageSizes(imageSizes: number[]);
-    private _imageSizes;
-    set maxZoom(maxZoom: number);
-    private _maxZoom;
-    set minimumClusterSize(minimumClusterSize: number);
-    private _minimumClusterSize;
-    set styles(styles: ClusterIconStyle[]);
-    private _styles;
-    set title(title: string);
-    private _title;
-    set zIndex(zIndex: number);
-    private _zIndex;
-    set zoomOnClick(zoomOnClick: boolean);
-    private _zoomOnClick;
-    set options(options: MarkerClustererOptions);
-    private _options;
     /**
-     * See
-     * googlemaps.github.io/v3-utility-library/modules/
-     * _google_markerclustererplus.html#clusteringbegin
+     * Used to customize how the marker cluster is rendered.
+     * See https://googlemaps.github.io/js-markerclusterer/interfaces/Renderer.html.
      */
-    readonly clusteringbegin: Observable<void>;
+    renderer: Renderer;
     /**
-     * See
-     * googlemaps.github.io/v3-utility-library/modules/_google_markerclustererplus.html#clusteringend
+     * Algorithm used to cluster the markers.
+     * See https://googlemaps.github.io/js-markerclusterer/interfaces/Algorithm.html.
      */
+    algorithm: Algorithm_2;
+    /** Emits when clustering has started. */
+    readonly clusteringbegin: Observable<void>;
+    /** Emits when clustering is done. */
     readonly clusteringend: Observable<void>;
     /** Emits when a cluster has been clicked. */
-    readonly clusterClick: Observable<Cluster>;
-    _markers: QueryList<MapMarker>;
-    /**
-     * The underlying MarkerClusterer object.
-     *
-     * See
-     * googlemaps.github.io/v3-utility-library/classes/
-     * _google_markerclustererplus.markerclusterer.html
-     */
-    markerClusterer?: MarkerClusterer;
-    /** Event emitted when the clusterer is initialized. */
+    readonly clusterClick: EventEmitter<Cluster>;
+    /** Event emitted when the marker clusterer is initialized. */
     readonly markerClustererInitialized: EventEmitter<MarkerClusterer>;
-    constructor(_googleMap: GoogleMap, _ngZone: NgZone);
-    ngOnInit(): void;
-    ngAfterContentInit(): void;
-    ngOnChanges(changes: SimpleChanges): void;
+    _markers: QueryList<MarkerDirective>;
+    /** Underlying MarkerClusterer object used to interact with Google Maps. */
+    markerClusterer?: MarkerClusterer;
+    ngOnInit(): Promise<void>;
+    ngOnChanges(changes: SimpleChanges): Promise<void>;
     ngOnDestroy(): void;
-    fitMapToMarkers(padding: number | google.maps.Padding): void;
-    getAverageCenter(): boolean;
-    getBatchSizeIE(): number;
-    getCalculator(): Calculator;
-    getClusterClass(): string;
-    getClusters(): Cluster[];
-    getEnableRetinaIcons(): boolean;
-    getGridSize(): number;
-    getIgnoreHidden(): boolean;
-    getImageExtension(): string;
-    getImagePath(): string;
-    getImageSizes(): number[];
-    getMaxZoom(): number;
-    getMinimumClusterSize(): number;
-    getStyles(): ClusterIconStyle[];
-    getTitle(): string;
-    getTotalClusters(): number;
-    getTotalMarkers(): number;
-    getZIndex(): number;
-    getZoomOnClick(): boolean;
-    private _combineOptions;
+    private _createCluster;
     private _watchForMarkerChanges;
+    private _destroyCluster;
     private _getInternalMarkers;
     private _assertInitialized;
     static ɵfac: i0.ɵɵFactoryDeclaration<MapMarkerClusterer, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<MapMarkerClusterer, "map-marker-clusterer", ["mapMarkerClusterer"], { "ariaLabelFn": { "alias": "ariaLabelFn"; "required": false; }; "averageCenter": { "alias": "averageCenter"; "required": false; }; "batchSize": { "alias": "batchSize"; "required": false; }; "batchSizeIE": { "alias": "batchSizeIE"; "required": false; }; "calculator": { "alias": "calculator"; "required": false; }; "clusterClass": { "alias": "clusterClass"; "required": false; }; "enableRetinaIcons": { "alias": "enableRetinaIcons"; "required": false; }; "gridSize": { "alias": "gridSize"; "required": false; }; "ignoreHidden": { "alias": "ignoreHidden"; "required": false; }; "imageExtension": { "alias": "imageExtension"; "required": false; }; "imagePath": { "alias": "imagePath"; "required": false; }; "imageSizes": { "alias": "imageSizes"; "required": false; }; "maxZoom": { "alias": "maxZoom"; "required": false; }; "minimumClusterSize": { "alias": "minimumClusterSize"; "required": false; }; "styles": { "alias": "styles"; "required": false; }; "title": { "alias": "title"; "required": false; }; "zIndex": { "alias": "zIndex"; "required": false; }; "zoomOnClick": { "alias": "zoomOnClick"; "required": false; }; "options": { "alias": "options"; "required": false; }; }, { "clusteringbegin": "clusteringbegin"; "clusteringend": "clusteringend"; "clusterClick": "clusterClick"; "markerClustererInitialized": "markerClustererInitialized"; }, ["_markers"], ["*"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MapMarkerClusterer, "map-marker-clusterer", ["mapMarkerClusterer"], { "renderer": { "alias": "renderer"; "required": false; }; "algorithm": { "alias": "algorithm"; "required": false; }; }, { "clusteringbegin": "clusteringbegin"; "clusteringend": "clusteringend"; "clusterClick": "clusterClick"; "markerClustererInitialized": "markerClustererInitialized"; }, ["_markers"], ["*"], true, never>;
 }
 
 /**
@@ -1554,7 +1718,7 @@ export declare class MapPolygon implements OnInit, OnDestroy {
     readonly polygonRightclick: Observable<google.maps.PolyMouseEvent>;
     /** Event emitted when the polygon is initialized. */
     readonly polygonInitialized: EventEmitter<google.maps.Polygon>;
-    constructor(_map: GoogleMap, _ngZone: NgZone);
+    constructor(...args: unknown[]);
     ngOnInit(): void;
     private _initialize;
     ngOnDestroy(): void;
@@ -1653,7 +1817,7 @@ export declare class MapPolyline implements OnInit, OnDestroy {
     readonly polylineRightclick: Observable<google.maps.PolyMouseEvent>;
     /** Event emitted when the polyline is initialized. */
     readonly polylineInitialized: EventEmitter<google.maps.Polyline>;
-    constructor(_map: GoogleMap, _ngZone: NgZone);
+    constructor(...args: unknown[]);
     ngOnInit(): void;
     private _initialize;
     ngOnDestroy(): void;
@@ -1763,7 +1927,7 @@ export declare class MapRectangle implements OnInit, OnDestroy {
     readonly rectangleRightclick: Observable<google.maps.MapMouseEvent>;
     /** Event emitted when the rectangle is initialized. */
     readonly rectangleInitialized: EventEmitter<google.maps.Rectangle>;
-    constructor(_map: GoogleMap, _ngZone: NgZone);
+    constructor(...args: unknown[]);
     ngOnInit(): void;
     private _initialize;
     ngOnDestroy(): void;
@@ -1817,7 +1981,7 @@ export declare class MapTrafficLayer implements OnInit, OnDestroy {
     set autoRefresh(autoRefresh: boolean);
     /** Event emitted when the traffic layer is initialized. */
     readonly trafficLayerInitialized: EventEmitter<google.maps.TrafficLayer>;
-    constructor(_map: GoogleMap, _ngZone: NgZone);
+    constructor(...args: unknown[]);
     ngOnInit(): void;
     private _initialize;
     ngOnDestroy(): void;
@@ -1852,6 +2016,30 @@ export declare class MapTransitLayer implements OnInit, OnDestroy {
     static ɵdir: i0.ɵɵDirectiveDeclaration<MapTransitLayer, "map-transit-layer", ["mapTransitLayer"], {}, { "transitLayerInitialized": "transitLayerInitialized"; }, never, never, true, never>;
 }
 
+/** Marker types from the Google Maps API. */
+declare type Marker = google.maps.Marker | google.maps.marker.AdvancedMarkerElement;
+
+export declare class MarkerClusterer extends google.maps.OverlayView {
+    onClusterClick: onClusterClickHandler;
+    protected algorithm: Algorithm_2;
+    protected clusters: Cluster[];
+    protected markers: Marker[];
+    protected renderer: Renderer;
+    protected map: google.maps.Map | null;
+    protected idleListener: google.maps.MapsEventListener;
+    constructor({ map, markers, algorithmOptions, algorithm, renderer, onClusterClick, }: MarkerClustererOptions_2);
+    addMarker(marker: Marker, noDraw?: boolean): void;
+    addMarkers(markers: Marker[], noDraw?: boolean): void;
+    removeMarker(marker: Marker, noDraw?: boolean): boolean;
+    removeMarkers(markers: Marker[], noDraw?: boolean): boolean;
+    clearMarkers(noDraw?: boolean): void;
+    render(): void;
+    onAdd(): void;
+    onRemove(): void;
+    protected reset(): void;
+    protected renderClusters(): void;
+}
+
 
 /// <reference types="google.maps" preserve="true" />
 /**
@@ -1860,7 +2048,7 @@ export declare class MapTransitLayer implements OnInit, OnDestroy {
  * See
  * googlemaps.github.io/v3-utility-library/classes/_google_markerclustererplus.markerclusterer.html
  */
-declare class MarkerClusterer {
+declare class MarkerClusterer_2 {
     constructor(map: google.maps.Map, markers?: google.maps.Marker[], options?: MarkerClustererOptions);
     ariaLabelFn: AriaLabelFn;
     static BATCH_SIZE: number;
@@ -1869,7 +2057,7 @@ declare class MarkerClusterer {
     static IMAGE_PATH: string;
     static IMAGE_SIZES: number[];
     addListener(eventName: string, handler: Function): google.maps.MapsEventListener;
-    addMarker(marker: MarkerClusterer, nodraw: boolean): void;
+    addMarker(marker: MarkerClusterer_2, nodraw: boolean): void;
     addMarkers(markers: google.maps.Marker[], nodraw?: boolean): void;
     bindTo(key: string, target: google.maps.MVCObject, targetKey: string, noNotify: boolean): void;
     changed(key: string): void;
@@ -1880,7 +2068,7 @@ declare class MarkerClusterer {
     getBatchSizeIE(): number;
     getCalculator(): Calculator;
     getClusterClass(): string;
-    getClusters(): Cluster[];
+    getClusters(): Cluster_2[];
     getEnableRetinaIcons(): boolean;
     getGridSize(): number;
     getIgnoreHidden(): boolean;
@@ -1929,6 +2117,12 @@ declare class MarkerClusterer {
     static withDefaultStyle(overrides: ClusterIconStyle): ClusterIconStyle;
 }
 
+export declare enum MarkerClustererEvents {
+    CLUSTERING_BEGIN = "clusteringbegin",
+    CLUSTERING_END = "clusteringend",
+    CLUSTER_CLICK = "click"
+}
+
 /**
  * Options for constructing a MarkerClusterer from the @google/markerclustererplus library.
  *
@@ -1957,4 +2151,45 @@ export declare interface MarkerClustererOptions {
     zoomOnClick?: boolean;
 }
 
+declare interface MarkerClustererOptions_2 {
+    markers?: Marker[];
+    /**
+     * An algorithm to cluster markers. Default is {@link SuperClusterAlgorithm}. Must
+     * provide a `calculate` method accepting {@link AlgorithmInput} and returning
+     * an array of {@link Cluster}.
+     */
+    algorithm?: Algorithm_2;
+    algorithmOptions?: AlgorithmOptions;
+    map?: google.maps.Map | null;
+    /**
+     * An object that converts a {@link Cluster} into a `google.maps.Marker`.
+     * Default is {@link DefaultRenderer}.
+     */
+    renderer?: Renderer;
+    onClusterClick?: onClusterClickHandler;
+}
+
+/** Interface that should be implemented by directives that wrap marker APIs. */
+declare interface MarkerDirective {
+    _resolveMarker(): Promise<Marker>;
+}
+
+export declare type onClusterClickHandler = (event: google.maps.MapMouseEvent, cluster: Cluster, map: google.maps.Map) => void;
+
+export declare interface Renderer {
+    /**
+     * Turn a {@link Cluster} into a `Marker`.
+     *
+     * Below is a simple example to create a marker with the number of markers in the cluster as a label.
+     *
+     * ```typescript
+     * return new google.maps.Marker({
+     *   position,
+     *   label: String(markers.length),
+     * });
+     * ```
+     */
+    render(cluster: Cluster, stats: ClusterStats, map: google.maps.Map): Marker;
+}
+
 export { }