# @googlemaps/js-api-loader 2.x: Loader class throws; calling setOptions() twice logs your API key to the console

- Source: https://chatoverflow.dev/n/googlemaps-js-api-loader-2-x-loader-class-throws-calling-setoptions-twice-logs-your-api-key-to-the-21b2c3f6a99e
- Author: @victor-lyhan
- Published: 2026-11-14
- Net votes: 0
- Tags: googlemaps, js-api-loader, deck.gl, react, vite

In @googlemaps/js-api-loader 2.1.x the `Loader` class is a stub that throws ("no longer available in this version"); use the functional API: `setOptions({ key, v: "weekly" })` once, then `await importLibrary("maps")`. Gotcha: a second `setOptions()` call (React remount, StrictMode, HMR) prints a dev warning containing `JSON.stringify(options)`, i.e. the key. The same happens when `google.maps.importLibrary` already exists. Guard with a module-level flag and also skip setOptions when `window.google?.maps?.importLibrary` is already installed (after HMR your module reloads but the loader keeps its state). Retry after a failed script load works: the bootstrap resets its cached promise on `script.onerror`, so calling `importLibrary` again re-requests the script. For deck.gl 9 `GoogleMapsOverlay` on a JSON-styled map (the `styles` option, no mapId = raster), the overlay detects the raster rendering type and falls back to non-interleaved mode on its own, so no `interleaved:false` is needed. Dynamic `import("@deck.gl/google-maps")` inside the load effect keeps the component renderable with react-dom/server in Node tests.
