# google-map-react/google-map-react

Google map library for react that allows rendering components as markers :tada:

Repository: https://github.com/google-map-react/google-map-react
Canonical: https://ross.abutalabs.com/products/google-map-react
Homepage: http://google-map-react.github.io/google-map-react/map/main/
Language: JavaScript
License: MIT
License Family: permissive
Topics: react, map, google, component, maps
Last push: 2026-02-17T16:42:57+00:00

## Health v2 (maintenance only)
Score: 60/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 68, release rhythm 28, longevity 100
- inputs: {"age_days": 4102, "days_push": 197, "days_rel": 467, "gap_med": 72, "n_releases_24m": 2}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 6477, forks 852 (observed 2026-08-28T04:09:43.733477+00:00)

## What it is
A React component library wrapping a subset of the Google Maps API that lets you render arbitrary React components as map markers. It supports isomorphic (server-side) rendering and can position components even before the Google Maps API loads.

## Use cases
- render react components as google map markers
- add a google map to a react app
- build interactive map with hoverable custom markers
- server-side render a google map in react
- show list of locations synced with map markers
- display custom tooltips and balloons on map pins

## When to choose
- you use React and want custom animated components as markers instead of default Google markers
- you need isomorphic/SSR rendering of maps
- you want hover interactions on every map object with a tweakable hover algorithm
- you need markers positioned before the Google Maps API finishes loading

## When to avoid
- you use Vue, Svelte, or another non-React framework
- you need map providers other than Google Maps
- you want a fully managed high-level mapping solution with built-in clustering and routing
- your project cannot use the Google Maps API or its billing/key requirements

## Facets
- artifact type: library
- maturity: stable
- function: ui-components, frontend-framework
- domain: web-development, frontend
- platform: browser
- tags: google-maps, react-component, isomorphic, markers, geolocation, maps, nodejs, javascript

## Member repositories
- google-map-react/google-map-react (main) score 60

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:43.733477+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:44:34.383821+00:00, confidence not recorded.
  - readme: https://github.com/google-map-react/google-map-react (fetched 2026-08-28T04:09:43.733477+00:00, sha 3994cc8244b6)
  - homepage: http://google-map-react.github.io/google-map-react/map/main/ (fetched 2026-08-29T08:41:23.438569+00:00, sha 282c9985ecab)
  - registry_npm: https://registry.npmjs.org/google-map-react (fetched 2026-08-29T08:41:23.441267+00:00, sha 553426c4a8d2)
- Data as of 2026-08-30T08:39:29.467469+00:00.