> [!WARNING]
> As of February 21st, 2024 (v3.56), google.maps.Marker is deprecated. We encourage you to
> transition to the new `google.maps.marker.AdvancedMarkerElement` class. Advanced
> markers provide substantial improvements over the legacy `google.maps.Marker` class.
> The minimum version of the Maps JavaScript API with `google.maps.marker.AdvancedMarkerElement`
> is 3.53.2. At this time, google.maps.Marker is not scheduled to be discontinued.
>
> [Learn more](https://developers.google.com/maps/documentation/javascript/advanced-markers/migration.md.txt)

This example uses `window.setTimeout()` to place markers on the map
consecutively rather than all at once when a **Drop Markers** button is
clicked.

Read the [documentation](https://developers.google.com/maps/documentation/javascript/markers.md.txt#animate).
<iframe src="https://geo-devrel-javascript-samples.web.app/samples/marker-animations-iteration/app/dist/" allow="fullscreen; "></iframe>

### TypeScript

```typescript
// If you're adding a number of markers, you may want to drop them on the map
// consecutively rather than all at once. This example shows how to use
// window.setTimeout() to space your markers' animation.

const neighborhoods: google.maps.LatLngLiteral[] = [
  { lat: 52.511, lng: 13.447 },
  { lat: 52.549, lng: 13.422 },
  { lat: 52.497, lng: 13.396 },
  { lat: 52.517, lng: 13.394 },
];

let markers: google.maps.Marker[] = [];
let map: google.maps.Map;

function initMap(): void {
  map = new google.maps.Map(document.getElementById("map") as HTMLElement, {
    zoom: 12,
    center: { lat: 52.52, lng: 13.41 },
  });

  document.getElementById("drop")!.addEventListener("click", drop);
}

function drop(): void {
  clearMarkers();

  for (let i = 0; i < neighborhoods.length; i++) {
    addMarkerWithTimeout(neighborhoods[i], i * 200);
  }
}

function addMarkerWithTimeout(
  position: google.maps.LatLngLiteral,
  timeout: number
): void {
  window.setTimeout(() => {
    markers.push(
      new google.maps.Marker({
        position: position,
        map,
        animation: google.maps.Animation.DROP,
      })
    );
  }, timeout);
}

function clearMarkers(): void {
  for (let i = 0; i < markers.length; i++) {
    markers[i].setMap(null);
  }

  markers = [];
}

declare global {
  interface Window {
    initMap: () => void;
  }
}
window.initMap = initMap;
```

> [!NOTE]
> **Note:** Read the [guide](https://developers.google.com/maps/documentation/javascript/using-typescript.md.txt) on using TypeScript and Google Maps.

### JavaScript

```javascript
// If you're adding a number of markers, you may want to drop them on the map
// consecutively rather than all at once. This example shows how to use
// window.setTimeout() to space your markers' animation.
const neighborhoods = [
  { lat: 52.511, lng: 13.447 },
  { lat: 52.549, lng: 13.422 },
  { lat: 52.497, lng: 13.396 },
  { lat: 52.517, lng: 13.394 },
];
let markers = [];
let map;

function initMap() {
  map = new google.maps.Map(document.getElementById("map"), {
    zoom: 12,
    center: { lat: 52.52, lng: 13.41 },
  });
  document.getElementById("drop").addEventListener("click", drop);
}

function drop() {
  clearMarkers();

  for (let i = 0; i < neighborhoods.length; i++) {
    addMarkerWithTimeout(neighborhoods[i], i * 200);
  }
}

function addMarkerWithTimeout(position, timeout) {
  window.setTimeout(() => {
    markers.push(
      new google.maps.Marker({
        position: position,
        map,
        animation: google.maps.Animation.DROP,
      }),
    );
  }, timeout);
}

function clearMarkers() {
  for (let i = 0; i < markers.length; i++) {
    markers[i].setMap(null);
  }

  markers = [];
}

window.initMap = initMap;
```

> [!NOTE]
> **Note:** The JavaScript is compiled from the TypeScript snippet.

### CSS

```css
/* 
 * Always set the map height explicitly to define the size of the div element
 * that contains the map. 
 */
#map {
  height: 100%;
}

/* 
 * Optional: Makes the sample page fill the window. 
 */
html,
body {
  height: 100%;
  margin: 0;
  padding: 0;
}

#floating-panel {
  position: absolute;
  top: 10px;
  left: 25%;
  z-index: 5;
  background-color: #fff;
  padding: 5px;
  border: 1px solid #999;
  text-align: center;
  font-family: "Roboto", "sans-serif";
  line-height: 30px;
  padding-left: 10px;
}

#floating-panel {
  margin-left: -52px;
}
```

### HTML

```html
<html>
  <head>
    <title>Marker Animations With setTimeout()</title>

    <link rel="stylesheet" type="text/css" href="./style.css" />
    <script type="module" src="./index.js"></script>
  </head>
  <body>
    <div id="floating-panel">
      <button id="drop">Drop Markers</button>
    </div>
    <div id="map"></div>

    <!-- 
      The `defer` attribute causes the script to execute after the full HTML
      document has been parsed. For non-blocking uses, avoiding race conditions,
      and consistent behavior across browsers, consider loading using Promises. See
      https://developers.google.com/maps/documentation/javascript/load-maps-js-api
      for more information.
      -->
    <script
      src="https://maps.googleapis.com/maps/api/js?key=AIzaSyB41DRUbKWJHPxaFjMAwdrzWzbVKartNGg&callback=initMap&v=weekly"
      defer
    ></script>
  </body>
</html>
```

### Clone Sample


Git and Node.js are required to run this sample locally. Follow these [instructions](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) to install Node.js and NPM. The following commands clone, install dependencies and start the sample application.

```javascript
  git clone -b sample-marker-animations-iteration https://github.com/googlemaps/js-samples.git
  cd js-samples
  npm i
  npm start
```


Other samples can be tried by switching to any branch beginning with `sample-SAMPLE_NAME`.

```javascript
  git checkout sample-SAMPLE_NAME
  npm i
  npm start
```