Get a Maps Demo Key: Try out select Maps JavaScript API and Places UI Kit features at no cost with a Maps Demo Key—no billing information required.

Open source libraries

Spark icon

Page Summary

The Google Maps Platform offers numerous open-source libraries hosted on GitHub and npm to enhance the functionality of the Maps JavaScript API.
These libraries cater to various needs, including web components, API loading, TypeScript integration, React integration, marker and overlay extensions, testing, linting, and Node.js environments.
Developers can leverage libraries such as the Extended Component Library for streamlined UI development and the JS API Loader for dynamic API loading.
Dedicated libraries are available for specific frameworks like React and TypeScript, along with tools for testing, linting, and extending map functionalities with markers, clusters, and overlays.
Google Maps Platform provides Node.js libraries for server-side operations, such as making API calls and URL signing.

Many open source libraries are available to provide additional capabilities for Maps JavaScript API. These libraries are versioned on GitHub and published to npm.

Web Components

Use Maps JavaScript API Web Components to quickly add maps functionality to your websites. Web Components encapsulate boilerplate code, best practices, and responsive design, reducing complex map UIs into what is effectively a single HTML element.

Extended Component Library (Beta)

Google Maps Platform Extended Component Library is a set of Web Components that helps developers build better maps faster, and with less effort.

npm i @googlemaps/extended-component-library

NPM version for @googlemaps/extended-component-library NPM downloads for @googlemaps/extended-component-library GitHub Repo stars GitHub commit activity (branch) GitHub forks Discord server badge

Loading the API

Modern web applications may benefit from using the following libraries to load the Maps JavaScript API.

JS API loader

Dynamically load the Maps JavaScript API with Promises.

npm i @googlemaps/js-api-loader

NPM version for @googlemaps/js-api-loader NPM downloads for @googlemaps/js-api-loader GitHub Repo stars GitHub commit activity (branch) GitHub forks Discord server badge

Using TypeScript

TypeScript users can get started with the following packages. Check out the using TypeScript guide for additional information.

TypeScript types

TypeScript types for Maps JavaScript API

npm i -D @types/google.maps

NPM version for @types/google.maps NPM downloads for @types/google.maps GitHub Repo stars GitHub commit activity (branch) GitHub forks Discord server badge

TypeScript guards

TypeScript guards to narrow union types.

npm i -D @googlemaps/typescript-guards

NPM version for @googlemaps/typescript-guards NPM downloads for @googlemaps/typescript-guards GitHub Repo stars GitHub commit activity (branch) GitHub forks Discord server badge

Using React

React users can get started with the following packages.

React Google Maps Library

Components and hooks to integrate the Maps JavaScript API into React applications.

npm i -D @vis.gl/react-google-maps

NPM version for @vis.gl/react-google-maps NPM downloads for @vis.gl/react-google-maps GitHub Repo stars GitHub commit activity (branch) GitHub forks Discord server badge

React wrapper

A wrapper component to declaratively load the Maps JavaScript API.

npm i @googlemaps/react-wrapper

NPM version for @googlemaps/react-wrapper NPM downloads for @googlemaps/react-wrapper GitHub Repo stars GitHub commit activity (branch) GitHub forks Discord server badge

Extending markers and overlays

The following libraries extend classes such as Marker and OverlayView.

Marker clusterer

Creates and manages per-zoom-level clusters for large amounts of markers.

npm i @googlemaps/markerclusterer

NPM version for @googlemaps/markerclusterer NPM downloads for @googlemaps/markerclusterer GitHub Repo stars GitHub commit activity (branch) GitHub forks Discord server badge

Marker manager

Adds and removes markers based upon map viewport changes.

npm i @googlemaps/markermanager

NPM version for @googlemaps/markermanager NPM downloads for @googlemaps/markermanager GitHub Repo stars GitHub commit activity (branch) GitHub forks Discord server badge

Web map service (WMS)

Add Open Geospatial Consortium (OGC) layers such as a Web Map Service (WMS) to a map.

npm i @googlemaps/ogc

NPM version for @googlemaps/ogc NPM downloads for @googlemaps/ogc GitHub Repo stars GitHub commit activity (branch) GitHub forks Discord server badge

Marker labels

Add custom HTML labels to markers.

npm i @googlemaps/markerwithlabel

NPM version for @googlemaps/markerwithlabel NPM downloads for @googlemaps/markerwithlabel GitHub Repo stars GitHub commit activity (branch) GitHub forks Discord server badge

Three.js overlays

Use WebGL and ThreeJS for high performance visualizations.

npm i @googlemaps/three

NPM version for @googlemaps/three NPM downloads for @googlemaps/three GitHub Repo stars GitHub commit activity (branch) GitHub forks Discord server badge

Deck.gl overlays

Use Deck.gl as a custom Google Maps overlay.

npm i @deck.gl/google-maps

NPM version for @deck.gl/google-maps NPM downloads for @deck.gl/google-maps GitHub Repo stars GitHub commit activity (branch) GitHub forks Discord server badge

Testing and linting

Use these libraries to ensure best practices and make testing easier for the Maps JavaScript API.

ESLint plugin

Use custom ESLint rules to lint your code.

npm i -D eslint-plugin-googlemaps

NPM version for eslint-plugin-googlemaps NPM downloads for eslint-plugin-googlemaps GitHub Repo stars GitHub commit activity (branch) GitHub forks Discord server badge

Jest mocks

Mocks to use with the Jest testing library.

npm i -D @googlemaps/jest-mocks

NPM version for @googlemaps/jest-mocks NPM downloads for @googlemaps/jest-mocks GitHub Repo stars GitHub commit activity (branch) GitHub forks Discord server badge

Node.js Libraries

Node.js client library

Node.js client library for making calls from cloud functions or serverside code.

npm i @googlemaps/google-maps-services-js

NPM version for @googlemaps/google-maps-services-js NPM downloads for @googlemaps/google-maps-services-js GitHub Repo stars GitHub commit activity (branch) GitHub forks Discord server badge

Polyline encoding

Encode and decode polylines in Node.js.

npm i @googlemaps/polyline-codec

NPM version for @googlemaps/polyline-codec NPM downloads for @googlemaps/polyline-codec GitHub Repo stars GitHub commit activity (branch) GitHub forks Discord server badge

URL signing

Sign URLs in Node.js for additional security.

npm i @googlemaps/url-signature

NPM version for @googlemaps/url-signature NPM downloads for @googlemaps/url-signature GitHub Repo stars GitHub commit activity (branch) GitHub forks Discord server badge