As a frontend project, googlemaps/google-maps-services-js has picked up 3.1k stars on GitHub (TypeScript). Node.js client library for Google Maps API Web Services
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
[!IMPORTANT]
Legacy APIs End of Sale & Newer Client Libraries
Several APIs supported by this library are in Legacy status:
Places API (Legacy): This product is in Legacy status. As of October 2026, Places API (Legacy) can no longer be enabled for new Google Cloud projects. Existing projects remain fully supported. For new features and improved performance, migrate to Places API (New).
Directions API (Legacy): This product is in Legacy status. As of October 2026, Directions API (Legacy) can no longer be enabled for new Google Cloud projects. Existing projects remain fully supported. For new features and improved performance, migrate to the Routes API.
Distance Matrix API (Legacy): This product is in Legacy status. As of October 2026, Distance Matrix API (Legacy) can no longer be enabled for new Google Cloud projects. Existing projects remain fully supported. For new features and improved performance, migrate to the Routes API.
For our newer APIs, see the Google Maps Platform APIs in the Cloud Client Libraries for Node.js (overview):
Places API (New) (@googlemaps/places)
Routes API (@googlemaps/routing)
Address Validation API (@googlemaps/addressvalidation)
Datasets API (@googlemaps/maps-platform-datasets)
The new APIs will not be added to this client library.
Description
This client library brings the following [Google Maps Web Services APIs] to your server-side Node.js applications:
Maps Static API
Elevation API
Geocoding API
Roads API
Time Zone API
As well as the following legacy APIs:
Directions API (Legacy)
Places API (Legacy)
Distance Matrix API (Legacy)
Requirements
Sign up with Google Maps Platform
A Google Maps Platform project with the desired API(s) from the above list enabled
An API key associated with the project above
API Key Security
This client library is designed for use in server-side applications.
In either case, it is important to add API key restrictions to improve its security. Additional security measures, such as hiding your key
from version control, should also be put in place to further improve the security of your API key.
Check out the API Security Best Practices guide to learn more.
[!NOTE] This library for server-side only
Attempting to use it client-side, in either the browser or any other environment like React Native, may in some cases work, but mostly will not. Please refrain from reporting issues with these environments when attempting to use them, since server-side Node.js applications is the only supported environment for this library.
For other environments, try the Maps JavaScript API, which contains a comparable feature set, and is explicitly intended for use with client-side JavaScript.
Usage
npm install @googlemaps/google-maps-services-js
Below is a simple example calling the elevation method on the client class.
Import the Google Maps Client using TypeScript and ES6 module:
import {Client} from "@googlemaps/google-maps-services-js";
Alternatively using JavaScript without ES6 module support:
For more information, see the reference documentation. The TypeScript types are the authoritative documentation for this library and may differ slightly from the descriptions.
Developing
In order to run the end-to-end tests, you'll need to supply your API key via an
environment variable.
$ export MAPS_API_KEY=YOUR_API_KEY
$ npm test
Migration
This section discusses the migration from @google/maps to @googlemaps/google-maps-services-js and the differences between the two.
Note: The two libraries do not share any methods or interfaces.
The primary difference is @google/maps exposes a public method that takes individual parameters as arguments while @googlemaps/google-maps-services-js exposes methods that take params, headers, body, instance(see Axios). This allows direct access to the transport layer without the complexity that was inherent in the old library. Below are two examples.
The primary differences are in the following table.
Old
New
Can provide params
Can provide params, headers, instance, timeout (see Axios Request Config)
API key configured at Client
API key configured per method in params object
Retry is supported
Retry is configurable via axios-retry or retry-axios
Does not use promises by default
Promises are default
Typings are in @types/googlemaps
Typings are included
Does not support keep alive
Supports keep alive
Does not support interceptors
Supports interceptors
Does not support cancelalation
Supports cancellation
Premium Plan Authentication
Authentication via client ID and URL signing secret is provided to support legacy applications that use the Google Maps Platform Premium Plan. The Google Maps Platform Premium Plan is no longer available for sign up or new customers. All new applications must use API keys.
Contributions are welcome and encouraged! If you'd like to contribute, send us a pull request and refer to our code of conduct and contributing guide.
Terms of Service
This library uses Google Maps Platform services. Use of Google Maps Platform services through this library is subject to the Google Maps Platform Terms of Service.
This library is not a Google Maps Platform Core Service. Therefore, the Google Maps Platform Terms of Service (e.g. Technical Support Services, Service Level Agreements, and Deprecation Policy) do not apply to the code in this library.
European Economic Area (EEA) developers
If your billing address is in the European Economic Area, effective on 8 July 2025, the Google Maps Platform EEA Terms of Service will apply to your use of the Services. Functionality varies by region. Learn more.
Support
This library is offered via an open source license. It is not governed by the Google Maps Platform Support [Technical Support Services Guidelines, the SLA, or the Deprecation Policy. However, any Google Maps Platform services used by the library remain subject to the Google Maps Platform Terms of Service.
This library adheres to semantic versioning to indicate when backwards-incompatible changes are introduced. Accordingly, while the library is in version 0.x, backwards-incompatible changes may be introduced at any time.
If you find a bug, or have a feature request, please file an issue on GitHub. If you would like to get answers to technical questions from other Google Maps Platform developers, ask through one of our developer community channels. If you'd like to contribute, please check the contributing guide.
You can also discuss this library on our Discord server.
How active is development on googlemaps/google-maps-services-js?
The most recent commit recorded on googlemaps/google-maps-services-js was 28 days ago, based on the GitHub push timestamp. The repository has 659 forks — one of the better signals of community interest.
How many stars does googlemaps/google-maps-services-js have?
googlemaps/google-maps-services-js has 3.1k GitHub stars — refresh the page for the live number, or check github.com/googlemaps/google-maps-services-js. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
Is googlemaps/google-maps-services-js open source?
Yes — googlemaps/google-maps-services-js ships under the Apache-2.0 license, which makes its source code freely readable (and, depending on license terms, forkable and reusable). Source: github.com/googlemaps/google-maps-services-js.
What else is in the Frontend space?
googlemaps/google-maps-services-js is tracked by TopGit under the Frontend category, alongside 10 GitHub-tagged topics. Trending and Topics pages list peer repositories of comparable stars and language.
What is googlemaps/google-maps-services-js?
googlemaps/google-maps-services-js (googlemaps/google-maps-services-js) is a TypeScript project on GitHub. From the project's own README: Node.js client library for Google Maps API Web Services
What language is googlemaps/google-maps-services-js written in?
googlemaps/google-maps-services-js is written primarily in TypeScript. GitHub's language field is based on the largest share of bytes in the default branch.
What license does googlemaps/google-maps-services-js use?
googlemaps/google-maps-services-js is released under the Apache-2.0 license. Always verify the LICENSE file directly on GitHub for the authoritative terms — license strings can be edited out of sync with a project's actual stance.
Where do I read more about googlemaps/google-maps-services-js?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/googlemaps/google-maps-services-js is the definitive source.
Read full README in the tab above.
Is google-maps-services-js worth your time?
ChatGPT, Claude and Perplexity can all read this page. Ask one of them what it makes of google-maps-services-js.