Gathering detailed insights and metrics for @react-google-maps/api
Gathering detailed insights and metrics for @react-google-maps/api
Installations
npm install @react-google-maps/apiDeveloper Guide
BETA
Typescript
Yes
Module System
CommonJS
Node Version
20.11.0
NPM Version
10.2.4
Score
94.4
Supply Chain
95.5
Quality
84.9
Maintenance
100
Vulnerability
99.3
License
Releases
Unable to fetch releases
Contributors
94
Unable to fetch Contributors
Languages
3
TypeScript
JavaScript
CSS
TypeScript (95.96%)
JavaScript (3.76%)
CSS (0.28%)
Developer
JustFly1984
Download Statistics
Total Downloads
76,142,504
Last Day
138,855
Last Week
748,528
Last Month
3,227,842
Last Year
29,963,195
GitHub Statistics
MIT License
1,882 Stars
1,982 Commits
461 Forks
24 Watchers
99 Branches
94 Contributors
Updated on Mar 20, 2025
Bundle Size
160.19 kB
Minified
33.73 kB
Minified + Gzipped
Maintainers
2
Package Meta Information
Latest Version
2.20.6
Package Id
@react-google-maps/api@2.20.6
Unpacked Size
5.73 MB
Size
1.06 MB
File Count
147
NPM Version
10.2.4
Node Version
20.11.0
Published on
Feb 11, 2025
Total Downloads
Cumulative downloads
Total Downloads
76,142,504
Last Day
-3.7%
138,855
Compared to previous day
Last Week
-0.3%
748,528
Compared to previous week
Last Month
7.8%
3,227,842
Compared to previous month
Last Year
35.2%
29,963,195
Compared to previous year
Daily Downloads
Weekly Downloads
Monthly Downloads
Yearly Downloads
Dependencies
6
Dev Dependencies
33
@babel/core@babel/runtime@babel/plugin-transform-class-properties@babel/plugin-proposal-decorators@babel/plugin-proposal-export-default-from@babel/plugin-syntax-dynamic-import@babel/plugin-syntax-jsx@babel/plugin-syntax-typescript@babel/plugin-transform-arrow-functions@babel/plugin-transform-classes@babel/plugin-transform-destructuring@babel/plugin-transform-for-of@babel/plugin-transform-parameters@babel/plugin-transform-react-jsx@babel/plugin-transform-spread@babel/plugin-transform-typescript@babel/preset-env@babel/preset-react@babel/preset-typescript@babel/plugin-transform-runtime@rollup/plugin-commonjs@rollup/plugin-node-resolve@rollup/plugin-typescript@testing-library/react@rollup/plugin-terser@rollup/plugin-babeljestjest-clirimrafrolluprollup-plugin-dtsts-loadertslib
@react-google-maps/api
@react-google-maps/api
You can donate or became a sponsor of the project here: https://opencollective.com/react-google-maps-api#category-CONTRIBUTE
This library requires React v16.6 or later. To use the latest features (including hooks) requires React v16.8+. If you need support for earlier versions of React, you should check out react-google-maps Versions starting 12.20.0 should support React@19.
This is complete re-write of the (sadly unmaintained) react-google-maps library. We thank tomchentw for his great work that made possible.
@react-google-maps/api provides very simple bindings to the google maps api and lets you use it in your app as React components.
Here are the main additions to react-google-maps that were the motivation behind this re-write
Install @react-google-maps/api
with PNPM
1pnpm install @react-google-maps/api
with NPM
1npm i -S @react-google-maps/api
1import React from 'react' 2import { GoogleMap, useJsApiLoader } from '@react-google-maps/api' 3 4const containerStyle = { 5 width: '400px', 6 height: '400px', 7} 8 9const center = { 10 lat: -3.745, 11 lng: -38.523, 12} 13 14function MyComponent() { 15 const { isLoaded } = useJsApiLoader({ 16 id: 'google-map-script', 17 googleMapsApiKey: 'YOUR_API_KEY', 18 }) 19 20 const [map, setMap] = React.useState(null) 21 22 const onLoad = React.useCallback(function callback(map) { 23 // This is just an example of getting and using the map instance!!! don't just blindly copy! 24 const bounds = new window.google.maps.LatLngBounds(center) 25 map.fitBounds(bounds) 26 27 setMap(map) 28 }, []) 29 30 const onUnmount = React.useCallback(function callback(map) { 31 setMap(null) 32 }, []) 33 34 return isLoaded ? ( 35 <GoogleMap 36 mapContainerStyle={containerStyle} 37 center={center} 38 zoom={10} 39 onLoad={onLoad} 40 onUnmount={onUnmount} 41 > 42 {/* Child components, such as markers, info windows, etc. */} 43 <></> 44 </GoogleMap> 45 ) : ( 46 <></> 47 ) 48} 49 50export default React.memo(MyComponent)
Migration from react-google-maps@9.4.5
if you need an access to map object, instead of ref prop, you need to use onLoad callback on <GoogleMap /> component.
Before:
1// before - don't do this! 2<GoogleMap 3 ref={(map) => { 4 const bounds = new window.google.maps.LatLngBounds() 5 6 map.fitBounds(bounds) 7 }} 8/>
After:
1<GoogleMap 2 onLoad={(map) => { 3 const bounds = new window.google.maps.LatLngBounds() 4 map.fitBounds(bounds) 5 }} 6 onUnmount={(map) => { 7 // do your stuff before map is unmounted 8 }} 9/>
If you want to use window.google object, you need to extract GoogleMap in separate module, so it is lazy executed then google-maps-api script is loaded and executed by <LoadScript />. If you try to use window.google before it is loaded it will be undefined and you'll get a TypeError.
Main features
- Simplified API
- Uses the new Context API
- Supports async React (StrictMode compliant)
- Removes lodash dependency =>
smaller bundle size
12.4kbgzip, tree-shakeable https://bundlephobia.com/result?p=@react-google-maps/api - forbids loading of Roboto fonts, if you set property preventGoogleFonts on
<LoadScript preventGoogleFonts />component
Examples
Examples can be found in two places:
- Official docs (powered by react-styleguidist.
- A Gatsby app including some examples. See the examples folder
Advice
Using the examples requires you to generate a google maps api key. For instructions on how to do that please see the following guide
Community Help Resource
You can join our Slack channel
Contribute
Maintainers and contributors are very welcome! See this issue to get started.
How to test changes locally
When working on a feature/fix, you're probably gonna want to test your changes. This workflow is a work in progress. Please feel free to improve it!
- In the file
packages/react-google-maps-api/package.jsonchangemainto"src/index.ts" - In the same file, delete the
modulefield - You can now use the package
react-google-maps-api-gatsby-exampleto test your changes. Just make sure you change the import from@react-google-maps/apito../../../react-google-maps-api
Since 1.2.0 you can use onLoad and onMount props for each @react-google-maps/api component, ref does not contain API methods anymore.
Since version 1.2.2 We added useGoogleMap hook, which is working only with React@16.8.1 and later versions.
No vulnerabilities found.
Reason
security policy file detected
Details
- Info: security policy file detected: SECURITY.md:1
- Info: Found linked content: SECURITY.md:1
- Info: Found disclosure, vulnerability, and/or timelines in security policy: SECURITY.md:1
- Info: Found text in security policy: SECURITY.md:1
Reason
no binaries found in the repo
Reason
license file detected
Details
- Info: project has a license file: LICENSE:0
- Info: FSF or OSI recognized license: MIT License: LICENSE:0
Reason
Found 10/14 approved changesets -- score normalized to 7
Reason
0 commit(s) and 4 issue activity found in the last 90 days -- score normalized to 3
Reason
no effort to earn an OpenSSF best practices badge detected
Reason
project is not fuzzed
Details
- Warn: no fuzzer integrations found
Reason
SAST tool is not run on all commits -- score normalized to 0
Details
- Warn: 0 commits out of 27 are checked with a SAST tool
Reason
66 existing vulnerabilities detected
Details
- Warn: Project is vulnerable to: GHSA-968p-4wvh-cqc8
- Warn: Project is vulnerable to: GHSA-67hx-6x53-jw92
- Warn: Project is vulnerable to: GHSA-593m-55hh-j8gv
- Warn: Project is vulnerable to: GHSA-wf5p-g6vw-rhxx
- Warn: Project is vulnerable to: GHSA-jr5f-v2jv-69x6
- Warn: Project is vulnerable to: GHSA-qwcr-r2fm-qrc7
- Warn: Project is vulnerable to: GHSA-grv7-fg5c-xmjg
- Warn: Project is vulnerable to: GHSA-pxg6-pf52-xh8x
- Warn: Project is vulnerable to: GHSA-3xgq-45jj-v275
- Warn: Project is vulnerable to: GHSA-w573-4hg7-7wgq
- Warn: Project is vulnerable to: GHSA-4gmj-3p3h-gm8h
- Warn: Project is vulnerable to: GHSA-rv95-896h-c2vc
- Warn: Project is vulnerable to: GHSA-qw6h-vgh9-j6wx
- Warn: Project is vulnerable to: GHSA-jchw-25xp-jwwc
- Warn: Project is vulnerable to: GHSA-cxjh-pqwp-8mfp
- Warn: Project is vulnerable to: GHSA-rc47-6667-2j5j
- Warn: Project is vulnerable to: GHSA-9c47-m6qq-7p4h
- Warn: Project is vulnerable to: GHSA-3rfm-jhwj-7488
- Warn: Project is vulnerable to: GHSA-hhq3-ff78-jv3g
- Warn: Project is vulnerable to: GHSA-952p-6rrq-rcjv
- Warn: Project is vulnerable to: GHSA-f8q6-p94x-37v3
- Warn: Project is vulnerable to: GHSA-7hpj-7hhx-2fgx
- Warn: Project is vulnerable to: GHSA-mwcw-c2x4-8c55
- Warn: Project is vulnerable to: GHSA-9wv6-86v2-598j
- Warn: Project is vulnerable to: GHSA-rhx6-c78j-4q9w
- Warn: Project is vulnerable to: GHSA-7fh5-64p2-3v2j
- Warn: Project is vulnerable to: GHSA-c2qf-rxjj-qqgw
- Warn: Project is vulnerable to: GHSA-m6fv-jmcg-4jfg
- Warn: Project is vulnerable to: GHSA-76p7-773f-r4q5
- Warn: Project is vulnerable to: GHSA-cm22-4g7w-348p
- Warn: Project is vulnerable to: GHSA-fhg7-m89q-25r3
- Warn: Project is vulnerable to: GHSA-4vvj-4cpr-p986
- Warn: Project is vulnerable to: GHSA-wr3j-pwj9-hqq6
- Warn: Project is vulnerable to: GHSA-j8xg-fqg3-53r7
- Warn: Project is vulnerable to: GHSA-3h5v-q93c-6h6q
- Warn: Project is vulnerable to: GHSA-f9xv-q969-pqx4
- Warn: Project is vulnerable to: GHSA-gcx4-mw62-g8wm
- Warn: Project is vulnerable to: GHSA-74fj-2j2h-c42q
- Warn: Project is vulnerable to: GHSA-pw2r-vq6v-hr8c
- Warn: Project is vulnerable to: GHSA-c7qv-q95q-8v27
- Warn: Project is vulnerable to: GHSA-4wx3-54gh-9fr9
- Warn: Project is vulnerable to: GHSA-xvch-5gv4-984h
- Warn: Project is vulnerable to: GHSA-3949-f494-cm99
- Warn: Project is vulnerable to: GHSA-x7hr-w5r2-h6wg
- Warn: Project is vulnerable to: GHSA-4wf5-vphf-c2xc
- Warn: Project is vulnerable to: GHSA-h5c3-5r3r-rr8q
- Warn: Project is vulnerable to: GHSA-rmvr-2pp2-xj38
- Warn: Project is vulnerable to: GHSA-xx4v-prfh-6cgc
- Warn: Project is vulnerable to: GHSA-8hc4-vh64-cxmj
- Warn: Project is vulnerable to: GHSA-x9w5-v3q2-3rhw
- Warn: Project is vulnerable to: GHSA-ghr5-ch3p-vcr6
- Warn: Project is vulnerable to: GHSA-434g-2637-qmqr
- Warn: Project is vulnerable to: GHSA-49q7-c7j4-3p7m
- Warn: Project is vulnerable to: GHSA-977x-g7h5-7qgw
- Warn: Project is vulnerable to: GHSA-f7q4-pwc6-w24p
- Warn: Project is vulnerable to: GHSA-fc9h-whq2-v747
- Warn: Project is vulnerable to: GHSA-vjh7-7g9h-fjfh
- Warn: Project is vulnerable to: GHSA-67mh-4wv8-2f99
- Warn: Project is vulnerable to: GHSA-78xj-cgh5-2h22
- Warn: Project is vulnerable to: GHSA-2p57-rm9w-gvfp
- Warn: Project is vulnerable to: GHSA-76p3-8jx3-jpfq
- Warn: Project is vulnerable to: GHSA-w5hq-hm5m-4548
- Warn: Project is vulnerable to: GHSA-f5x3-32g6-xq36
- Warn: Project is vulnerable to: GHSA-72xf-g2v4-qvf3
- Warn: Project is vulnerable to: GHSA-w5p7-h5w8-2hfq
- Warn: Project is vulnerable to: GHSA-hc6q-2mpp-qw7j
Score
4.5
/10
Last Scanned on 2025-03-17
The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.
Learn More