Skip to content

Commit 5eb9573

Browse files
chore(main): release 1.8.0 (#895)
* chore(main): release 1.8.0 * docs: add what's new for 1.8 version --------- Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> Co-authored-by: Martin Schuhfuss <m.schuhfuss@gmail.com>
1 parent 7dc0cfa commit 5eb9573

4 files changed

Lines changed: 107 additions & 6 deletions

File tree

CHANGELOG.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,26 @@
11
# Changelog
22

3+
## [1.8.0](https://github.com/visgl/react-google-maps/compare/v1.7.1...v1.8.0) (2026-03-26)
4+
5+
6+
### Features
7+
8+
* add 2d geometry components - circle, polyline and polygon ([#917](https://github.com/visgl/react-google-maps/issues/917)) ([54b1d0e](https://github.com/visgl/react-google-maps/commit/54b1d0e338e03d2dc5defb67297d52f034f2bd99))
9+
* add 3D map, marker and popover components ([#898](https://github.com/visgl/react-google-maps/issues/898)) ([2ba09a1](https://github.com/visgl/react-google-maps/commit/2ba09a1c2d4cd9fe3e6d0b6ad1d5047b4cda07f6))
10+
* add fetchAppCheckToken prop to APIProvider ([#913](https://github.com/visgl/react-google-maps/issues/913)) ([992994d](https://github.com/visgl/react-google-maps/commit/992994d7e16373bf74c2e407adc5d77e5a510080))
11+
* **api-loader:** migrate to @googlemaps/js-api-loader ([#885](https://github.com/visgl/react-google-maps/issues/885)) ([4af51dd](https://github.com/visgl/react-google-maps/commit/4af51ddf42953a7b0ca3050be712aed0e8efce32))
12+
* **map3d:** refactor components to use custom elements ([#765](https://github.com/visgl/react-google-maps/issues/765)) ([8b60a78](https://github.com/visgl/react-google-maps/commit/8b60a78115fd6d5f321996f570089223300a736d))
13+
* **pin:** split Pin component into modern and legacy implementations ([#945](https://github.com/visgl/react-google-maps/issues/945)) ([4826836](https://github.com/visgl/react-google-maps/commit/4826836e737ba1664d6fea3cae24e95a2303392e))
14+
15+
16+
### Bug Fixes
17+
18+
* better handling for `clickable` prop in AdvancedMarker ([#906](https://github.com/visgl/react-google-maps/issues/906)) ([c8ff82f](https://github.com/visgl/react-google-maps/commit/c8ff82fd2fc251685782d300260d503f2d44e5a4))
19+
* introduce useEffectEvent to improve stability of event handlers ([#866](https://github.com/visgl/react-google-maps/issues/866)) ([e44933e](https://github.com/visgl/react-google-maps/commit/e44933e7d5f3d79e845081b2cf038f05a0b001f9))
20+
* **map:** improve reuseMaps reliability after remounting ([#920](https://github.com/visgl/react-google-maps/issues/920)) ([e9296de](https://github.com/visgl/react-google-maps/commit/e9296deeb21f127cb0b5cdc7aea7a77749824e74))
21+
* more efficient useMemoized hook and fixed infowindow issues ([#903](https://github.com/visgl/react-google-maps/issues/903)) ([8cb7151](https://github.com/visgl/react-google-maps/commit/8cb7151caf5da2e0b325fcad9ff434913f9f8a33))
22+
* trigger release-please action ([0eaabeb](https://github.com/visgl/react-google-maps/commit/0eaabeba45349fae98118e38929d8111134a5ba5))
23+
324
## [1.7.1](https://github.com/visgl/react-google-maps/compare/v1.7.0...v1.7.1) (2025-11-03)
425

526

docs/whats-new.md

Lines changed: 80 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,86 @@ recent versions of the library. For a complete list of changes, including bug
55
fixes, please refer to
66
the [Changelog](https://github.com/visgl/react-google-maps/blob/main/CHANGELOG.md).
77

8+
## Version 1.8 (March 2026)
9+
10+
### 2D Geometry Components: Circle, Polyline, and Polygon
11+
12+
Three new components make it straightforward to draw geometric shapes directly
13+
on the map without managing the underlying Google Maps API objects manually.
14+
15+
- **`<Circle>`** — renders a circle at a given center and radius
16+
- **`<Polyline>`** — draws a line through a series of coordinates (also accepts
17+
encoded polyline strings)
18+
- **`<Polygon>`** — renders a closed shape, supporting multiple paths for
19+
complex geometries
20+
21+
All three components support controlled and uncontrolled usage, as well as the
22+
full set of event handlers (click, drag, mouse events) and change callbacks.
23+
24+
```tsx
25+
<Circle
26+
center={{lat: 53.55, lng: 10.0}}
27+
radius={1000}
28+
fillColor={'#0088ff'}
29+
fillOpacity={0.3}
30+
strokeColor={'#0088ff'}
31+
strokeWeight={2}
32+
/>
33+
```
34+
35+
See the API reference for
36+
[`<Circle>`](./api-reference/components/circle.md),
37+
[`<Polyline>`](./api-reference/components/polyline.md), and
38+
[`<Polygon>`](./api-reference/components/polygon.md) for the full prop
39+
documentation, and the [geometry example](https://visgl.github.io/react-google-maps/examples/geometry)
40+
for a live demo.
41+
42+
### 3D Map Components: Map3D, Marker3D, and Popover
43+
44+
The library now ships first-class React components for the Google Maps 3D API:
45+
46+
- **`<Map3D>`** — renders a photorealistic 3D map (uses the `gmp-map-3d` custom
47+
element internally) with props for camera position (`center`, `range`,
48+
`heading`, `tilt`, `roll`) and a `useMap3D` hook to access the underlying
49+
element
50+
- **`<Marker3D>`** — places a 3D marker on a `<Map3D>`
51+
- **`<Popover>`** — renders an HTML popover attached to a position on a `<Map3D>`
52+
53+
```tsx
54+
<Map3D
55+
defaultCenter={{lat: 37.7749, lng: -122.4194, altitude: 1000}}
56+
defaultRange={5000}
57+
defaultTilt={45}>
58+
<Marker3D position={{lat: 37.7749, lng: -122.4194, altitude: 0}} />
59+
</Map3D>
60+
```
61+
62+
See the API reference for
63+
[`<Map3D>`](./api-reference/components/map-3d.md),
64+
[`<Marker3D>`](./api-reference/components/marker-3d.md), and
65+
[`<Popover>`](./api-reference/components/popover.md), and the
66+
[map-3d example](https://visgl.github.io/react-google-maps/examples/map-3d) for
67+
a live demo.
68+
69+
### Firebase App Check Support
70+
71+
The `<APIProvider>` component now accepts a `fetchAppCheckToken` prop. When
72+
provided, the token returned by this function is sent along with every Maps
73+
JavaScript API request, enabling
74+
[Firebase App Check](https://firebase.google.com/docs/app-check) protection for
75+
your Maps usage.
76+
77+
```tsx
78+
<APIProvider
79+
apiKey={YOUR_API_KEY}
80+
fetchAppCheckToken={() => getToken(appCheck).then(r => r.token)}>
81+
{/* ... */}
82+
</APIProvider>
83+
```
84+
85+
See the [`<APIProvider>` API reference](./api-reference/components/api-provider.md)
86+
for details.
87+
888
## Version 1.7 (October 2025)
989

1090
### Add support for Custom Elements

package-lock.json

Lines changed: 5 additions & 5 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "@vis.gl/react-google-maps",
3-
"version": "1.7.1",
3+
"version": "1.8.0",
44
"description": "React components and hooks for the Google Maps JavaScript API",
55
"source": "src/index.ts",
66
"main": "dist/index.umd.js",

0 commit comments

Comments
 (0)