[Subscribe](https://developers.google.com/static/maps/documentation/javascript/feeds/releases.xml)
to these release notes.
[![Subscribe](https://developers.google.com/static/maps/documentation/images/rss-icon.svg)](https://developers.google.com/static/maps/documentation/javascript/feeds/releases.xml)

The Maps JavaScript API team regularly updates the API with new
features, bug fixes, and performance improvements. You can indicate which
version of the API to load within your application by specifying it in the
`v` parameter of the Maps JavaScript API bootstrap
request. Read more about
[versioning](https://developers.google.com/maps/documentation/javascript/versions.md.txt).

This changelog lists releases by date and version number, along with
associated changes.

This page lists release notes for 2025 and 2026. For earlier releases, see
the
[Maps JavaScript API
release notes archive](https://developers.google.com/maps/documentation/javascript/releases-archive).

To receive updates on new Maps API versions, please subscribe to the
[google-maps-js-api-v3-notify](http://groups.google.com/group/google-maps-js-api-v3-notify) group.

> [!NOTE]
> As of August 26, 2021 starting with the `beta` channel, Maps JavaScript API may make additional calls to report telemetry information for the purpose of calculating the SLO (Service Level Objective) of several features. You may need to update your Content Security Policy to ensure these calls are not blocked at browser-level. For more information, please see the [FAQ](https://developers.google.com/maps/faq.md.txt#uptime_slo).

## 3.66.13d

#### 4 November, 2026

Changes:

- \[alpha channel\] Screen readers now read the `Route.createPopover()` and `Route3DElement` route summary as a single labeled image with the travel mode, duration, and distance.
- `Map3DElement` no longer pans the camera to an open `PopoverElement` when the map's mode changes.
- The place name in Place Details widgets now scales with the widget's `font-size`, like the rest of its text.
- Reviews and features in the Reviews and About tabs of Place Details widgets now have the same side padding as the rest of the widget.
- Added `PlacePopularTimesElement` (`<gmp-place-popular-times>`), which shows how busy a place usually is throughout the day, plus live busyness when available, in `PlaceDetailsElement` and `AdvancedPlaceDetailsElement`. Popular times are also included in the standard and all content presets.

## 3.66.12d

#### 28 October, 2026

Changes:

- Added `MapMode.ROADMAP` (now the default mode when `mode` is omitted), the map mode UI control, `Map3DElement.colorScheme` (for light and dark map styling), `Label3DElement` (`<gmp-label-3d>`), `Map3DElement.maxMemoryMegabytes`, `Map3DElement.qualityMode`, and `QualityMode` to 3D Maps (`Map3DElement`). For more information on `ROADMAP` mode, the map mode control, and custom styling for 3D roadmap maps, see [Change the map mode](https://developers.google.com/maps/documentation/javascript/3d/map-modes.md.txt), [3D map controls and exploration](https://developers.google.com/maps/documentation/javascript/3d/map-controls.md.txt), and [Customize 3D maps](https://developers.google.com/maps/documentation/javascript/3d/customize-maps.md.txt).
- \[beta channel\] Added `contentTokens` and `addContentTokens()` to google.maps.Settings.
- Place Details widgets no longer log a warning about a content config element when content elements are added as direct children.

## 3.66.11a

#### 22 October, 2026

Changes:

- Places UI Kit Pro elements (`AdvancedPlaceDetailsElement`, `AdvancedPlaceDetailsCompactElement`, `AdvancedPlaceSearchElement`, `AdvancedPlaceListElement`) are now generally available in the weekly channel.
- In horizontal compact layouts of `PlaceDetailsCompactElement` (`<gmp-place-details-compact>`) and `PlaceSearchElement` (`<gmp-place-search>`), the Open in Google Maps icon button now renders in the top row alongside the place name and address so the remaining basic info rows span the full width.
- Place Details no longer shows an empty action area when none of the slotted `gmp-place-link` or `gmp-place-button` elements can render for the place.
- Deprecated `PlaceContentConfigElement` (`<gmp-place-content-config>`). Add content elements directly to `PlaceDetailsElement` or `PlaceDetailsCompactElement`, or inside a `<template slot="details-item">` element in `PlaceSearchElement`.
- The KmlLayer functionality in the Maps JavaScript API is no longer available. For more info, see <https://developers.google.com/maps/deprecations>.
- \[alpha channel\] Added `PlacePinElement` (`<gmp-place-pin>`), which shows a map pin for a place using the place's category icon or photo, for use as the content of an `AdvancedMarkerElement`.
- \[alpha channel\] Fixed `Route3DElement` and `Route.createPopover()` popover content being clipped in short maps, for example on phones at 200% page zoom.

## 3.66.9d

#### 14 October, 2026

Changes:

- Fixed an issue where completing a drag on an AdvancedMarkerElement would erroneously trigger a map click event.
- Fixes the POI info window not closing with the Escape key after reopening the same POI.
- \[alpha channel\] `AdvancedPlaceDetailsElement`, `AdvancedPlaceDetailsCompactElement`, and `AdvancedPlaceItemElement`, now support `basic-section-top` and `basic-section-bottom` slots in the alpha channel.
- \[alpha channel\] `PlacePinElement`is now available in the alpha channel to show place information on a map
- Fixes InfoWindow not closing with the Escape key, and focus not returning to the previously focused element, when the map is a gmp-map element.

## 3.66.8b

#### 8 October, 2026

Changes:

- Fixes the POI info window not closing with the Escape key after its POI icon is clicked again.
- Fixes keyboard arrow-key navigation moving focus to AdvancedMarkerElements outside the visible map area.
- \[beta channel\] Added `MapMode.ROADMAP`, the map mode UI control, `Map3DElement.colorScheme` (for light and dark map styling), and `Label3DElement` (`<gmp-label-3d>`) to 3D Maps (`Map3DElement`).

## 3.66.7

#### 1 October, 2026

Changes:

- \[alpha channel\] Fixed transit vehicle icons in the `Route3DElement` popover disappearing in forced colors mode.
- \[alpha channel\] `Route.createWaypointMarkers()` now sets a localized default `title` ("Origin" or "Destination") on the markers it creates.
- \[alpha channel\] Fixed `Route3DElement` popover text being invisible in hybrid and satellite map modes.
- \[alpha channel\] 3D markers created by `Route.createWaypointMarkers()` now keep a constant screen size (`sizePreserved` is `true` by default).
- \[alpha channel\] `Route3DElement` origin and destination markers can now be reached with the keyboard and are announced by screen readers. Hovering a marker shows its title as a tooltip.
- \[beta channel\] Added the Map3DElement.maxMemoryMegabytes and Map3DElement.qualityMode properties, along with the QualityMode enum, to help reduce the 3D map's memory usage.
- Fixed an issue where `PopoverElement` (`<gmp-popover>`) shifted off its anchor when changing page zoom in Safari.
- Added pointer events support via `gmp-pointerover`, `gmp-pointerout`, and `gmp-pointermove` for interactive elements in Maps3D.
- Fixed TypeScript definitions for 3D Maps drawing elements (Marker3DElement, Model3DElement, Polygon3DElement, Polyline3DElement, FlattenerElement, CirclePathElement) and PopoverElement to accept google.maps.LatLng.

## 3.66.6c

#### 22 September, 2026

Changes:

- Fixed an issue where `PlaceAutocompleteElement` did not display its clear button when populated programmatically via constructor options or the value property.
- \[alpha channel\] Removed `colorScheme` from `google.maps.routes.RoutePolyline3DOptions`. Route3DElement now tracks the effective color scheme of the parent Map3D.
- \[beta channel\] Fixed memory leaking in Street View Panorama rendering lifecycle.
- \[beta channel\] `PlaceLinkElement` default icons may be hidden with the `default-icon-hidden` attribute, allowing for text-only place links.

## 3.66.4d

#### 9 September, 2026

Changes:

- \[alpha channel\] AutofitsCamera minimum range changed from 2,000 meters to 80 meters.
- Deprecated `AdvancedMarkerElement.addListener()` and legacy events (`click`, `dragstart`, `drag`, `dragend`). Use standard `addEventListener()` with `gmp-` prefixed events instead.

## 3.66.3d

#### 2 September, 2026

Changes:

- \[alpha channel\] Added the `trafficPolylinesDisabled` field to `RoutePolyline3DOptions`. This allows developers to disable traffic-aware polylines when creating 3D route polylines.
- \[alpha channel\] Optimize Route3DElement to avoid unnecessary backend requests when toggling trafficPolylinesDisabled.

## 3.66.2d

#### 26 August, 2026

Changes:

- \[alpha channel\] Removed Route 3D icons from font loading and moved them into embedded SVG assets to avoid complications when loading the Material Symbols font more than once.
- \[beta channel\] Adds Places UI Kit advanced components: `AdvancedPlaceDetailsElement`, `AdvancedPlaceDetailsCompactElement`, `PlaceLinkElement`, `PlaceButtonElement`, `PlaceNameElement`, `AdvancedPlaceListElement`, `AdvancedPlaceSearchElement`
- Added a tooltip to transit line names in order to see the full name even when it is truncated.
- Added `removeEventListener` typings for custom web components.
- Fixed an issue where VoiceOver displayed a focus outline on visually hidden screen reader elements for route markers

## 3.66.1a

#### 17 August, 2026

Changes:

- Fixed accessibility behavior of static Place card images by adding fallback labels and removing redundant keyboard focus stops.

## 3.65.12f

#### 6 August, 2026

Changes:

- \[alpha channel\] Adds `<gmp-label-3d>` (`google.maps.maps3d.Label3DElement`) to the alpha channel of the 3D Maps JS API. Developers can now use the new element to declare label text and independently configure its collision behavior separately from its linked 3D marker elements (such as `<gmp-marker-3d>` and `<gmp-marker-3d-interactive>`).
- Provide unique accessible names for More Options buttons across Place Details widgets.
- \[alpha channel\] Improved Route 3D travel mode error messages for when `TravelMode.TWO_WHEELER` is used outside of alpha/beta
- \[alpha channel\] The Route3D component now supports the `trafficPolylinesDisabled` property. This allows developers to disable traffic aware polylines when using `TRAFFIC_AWARE` or `TRAFFIC_AWARE_OPTIMAL` routing options.
- \[alpha channel\] AutofitsCamera northern bounds padding increased to prevent default pin cropping.
- Fixed an issue where Street View Pegman could not be dragged onto the map on touch screen devices.

## 3.65.11b

#### 27 July, 2026

Changes:

- \[alpha channel\] Enhanced Route3D popover to show non-transit icons (bicycling, driving, two-wheeler, and walking).
- \[alpha channel\] `Route.createWaypointMarkers` creates markers for the origin and destination, with default styling applied unless a customOverride function is specified. Intermediate waypoints are not currently supported.

## 3.65.10a

#### 22 July, 2026

Changes:

- Fixed an issue where Maps JS loaded the Material Symbols Outlined font in a way that could impact the same font loaded on the base page.
- Fixed an issue where `PlaceAutocompleteElement` submitted an empty value on form POST when initialized with options.value or modified programmatically via the value property.
- Updated 3D map tilt and heading UI controls to re-enable if camera restriction range is increased.

## 3.65.8c (Rolled back)

#### 7 July, 2026

Changes:

- \[alpha channel\] `Route3DElement` renders additional polyline and popover data for transit routes.
- Added support for `internalUsageAttributionIds` to the address validation API. This property allows API call attribution to specific packages or OSS libraries.
- Updated the default info window for POI clicks on 2D Maps to use Place Widgets.
- Improved the reliability of Street View panoramas under high-traffic conditions.

## 3.65.6a

#### 25 June, 2026

Changes:

- \[beta channel\] Updated the default Info Window for POI clicks on 2D maps to use Place Widgets.
- Fixed a bug where the 3D map would occasionally throw an error at extreme `fov` values.
- Updated default Route markers to no longer use the deprecated `glyph` `PinElement` option.

## 3.65.5e

#### 17 June, 2026

Changes:

- Fixed typings for `OverlayView.getMap()`
- Updated typings for `BasicPlaceAutocompleteElement` and `PlaceAutocompleteElement` to indicate that the constructor options parameter is optional

## 3.65.3b

#### 4 June, 2026

Changes:

- The DrawingManager functionality in the Maps JavaScript API is no longer available. For more info, see <https://developers.google.com/maps/deprecations>.
- Improved color contrast for the Map's copyright dialog in dark mode.
- Disable 3D Map rotation controls when heading limits are reached.
- Fixed an issue where the Place Autocomplete mobile input field overlapped the iOS system status bar/safe area. Note: the fix works when viewport-fit=cover is set in the viewport meta tag.
- Added support for internalUsageAttributionIds to the Maps 3D JavaScript API. This property allows developers to attribute API calls to specific packages or OSS libraries.
- Added support for internalUsageAttributionIds to Places (New) API. This property allows developers to attribute API calls to specific packages or OSS libraries.
- \[alpha channel\] Narrowed getter types of Route3DElement properties to match setter normalization.
- \[alpha channel\] Route3DElement exposes routes, fallbackInfo, and geocodingResults properties.

## 3.65.2d

#### 27 May, 2026

Changes:

- Fixed an issue with the zoom button when zooming out on a map with restricted bounds.
- The Places library has introduced `transitStation` to places.
- Added support for `internalUsageAttributionIds` in the Routes library. This property allows developers to attribute API calls to specific packages or OSS libraries.

## 3.65.1c

#### 20 May, 2026

Changes:

- The Google logo will now be dark gray on a white background for Roadmap and Terrain in light mode, regardless of whether a map ID or custom styling is provided.
- \[alpha channel\] Route3DElement dispatches gmp-load and gmp-error events after a successful and erroneous Routes API calls, respectively.
- Fixed incorrect documentation stating that matches are highlighted in the secondary text of autocomplete predictions. Matches are only highlighted in the main text, reflecting Places API Autocomplete behavior.
- Improved color inheritance for Place Autocomplete prediction items so they gracefully inherit the color set on the parent element.
- Added 'input-icon' and 'clear-icon' slots to both PlaceAutocompleteElement and BasicPlaceAutocompleteElement for icon customization.
- Exposed `prediction-item-secondary-text` and `prediction-item-nonmatch` shadow parts for both BasicPlaceAutocomplete and PlaceAutocomplete prediction items, enabling custom styling for unmatched main text and secondary text.
- Add no-clear-button attribute and noClearButton property to both PlaceAutocompleteElement and BasicPlaceAutocompleteElement to allow hiding the clear button
- The Heatmap Layer functionality in the Maps JavaScript API is now decommissioned.
- Improved error handling for map config retrieval.
- 45 degree imagery is now decommissioned for raster maps.
- Added missing classes to the PlacesLibrary documentation. Also documented the `toString()` method on `FormattableText`.
- Improved accessibility of 'Report a map error' links.

## 3.64.12d

#### 6 May, 2026

Changes:

- The `equals()` method of `LatLng` now accepts `LatLngLiteral` objects instead of throwing an error. The documentation for `LatLng` and `LatLngAltitude` `equals()` now also accurately reflects that the existing tolerance level of 1e-9.
- \[alpha channel\] `Map3DElement` with autofits children now initially renders with `RELATIVE_TO_GROUND` altitude mode, which supports showing higher elevation areas on load for cases when the camera properties are pre-defined rather than applied using `flyCameraTo`. Also, on initial load of `Map3DElement`, if the map has children which use the AutofitsCamera API that are still working, the initial map render is deferred until they all finish working, and the camera snaps regardless of the fly-to animation setting; subsequent camera updates respect the fly-to setting.
- \[alpha channel\] `Polygon3DElement` adds the autofitsCamera property to support automatic camera fitting.

## 3.64.11d

#### 29 April, 2026

Changes:

- \[alpha channel\] MarkerElement adds the autofitsCamera property to support automatic camera fitting of the marker.
- Fixed an issue in PlaceAutocompleteElement where the prediction item icon would not render in Safari browser.
- The Places library has introduced `isPureServiceAreaBusiness` to places. It is now possible to request results for pure service area businesses by setting `pureServiceAreaBusinessesIncluded` on Place Autocomplete (data API and widgets) and Text Search requests.
- The Places library has introduced `addressDescriptor`, `containingPlaces`, and `timeZone` to places.
- The Places library has introduced `futureOpeningDate` to places. It is now possible to request results for businesses that have not yet opened by setting `futureOpeningBusinessesIncluded` on Place Autocomplete (data API and widgets), Nearby Search, and Text Search requests.
- The Google logo will now be the same for Roadmap light with or without a map id or custom styling. Previously, we were showing the dark mode Google logo for all Roadmap maps using a map id. To maintain the white Google logo, users should switch to dark mode.
- Added focus-ring as CSS Shadow Part in both PlaceAutocompleteElement and BasicPlaceAutocompleteElement.
- Added new `FuelType` `DIESEL_PLUS` and `E100`. Added new `EVConnectorType` `NACS`.
- Added value, placeholder, disabled, readonly, no-input-icon and maxlength attributes to PlaceAutocompleteElement and BasicPlaceAutocompleteElement.
- Added a 'description' property to both PlaceAutocompleteElement and BasicPlaceAutocompleteElement to provide additional context for screen reader users.
- Narrowed the declared type of LatLngAltitudeLiteral.altitude to not allow null or undefined. Corrected the declared return type of DirectionalLocation.toJSON().

## 3.64.9c

#### 14 April, 2026

Changes:

- TypeScript declarations now correctly differentiate the types of property getters and setters (including readonly properties without setters).

## 3.64.8b

#### 8 April, 2026

Changes:

- \[alpha channel\] Route3DElement, Marker3DElement and Polyline3DElement with autofitsCamera will not cause camera updates when removed from the DOM. For Route3DElement, errors or empty responses have no effect on the camera. Also, changing autofitsCamera from true to false on a given element will not update the camera to exclude that element, but it will opt the element out of future camera updates.
- The `zIndex` of an `AdvancedMarkerElement` is now determined by its explicitly set value or, by default, by its vertical pixel position. Explicit values take precedence over the default. To avoid markers lower on the screen without a `zIndex` unexpectedly overlap those with one, we recommend applying `zIndex` consistently across all markers.
- TypeScript declarations now include an interface mapping HTML tag names to JS classes (`google.maps.HTMLElementTagNameMap` and the global `HTMLElementTagNameMap`), an interface mapping HTML tag names to each JS class's EventMap (`google.maps.HTMLElementEventMapTagNameMap`), an interface of all custom CSS properties (`google.maps.CSSProperties`), and each string-based enum has a string union type defined (as `${EnumName}String`) and that string union is used for that enum throughout the declarations. `addEventListener()` is also overloaded on each custom element with its EventMap types, and `google.maps.importLibrary()` is overloaded to correctly type each returned library for the passed in library name.

## 3.64.7d

#### 1 April, 2026

Changes:

- The `mapId` property can now be updated dynamically after `Map3DElement` initialization, eliminating the need for `Map3DElement` re-instantiation.
- \[alpha channel\] Added a new `Route3DElement` for rendering routes on 3D maps.
- \[alpha channel\] Added a new `Route.create3DPolylines()` and `Route.createPopover()` APIs.
- \[alpha channel\] Added a new `spherical.traversePath()` API.
- \[alpha channel\] Added a new `autofitsCamera` API to `Marker3DElement`, `Polyline3DElement`, and `Route3DElement`, with new `autofitsCameraAnimation` API for `Map3DElement`.
- \[alpha channel\] Added a new `CirclePathElement` for rendering circles with `Polygon3DElement`.
- \[alpha channel\] A new `ROADMAP` map mode is now available on 3D Maps in the `alpha` channel.
- Fixed a bug where StreetView pegman did not work correctly on mobile devices when in a map attached to a DOM element created in a different frame context from the Maps JS library code.

## 3.64.6d

#### 26 March, 2026

Changes:

- Fixed an issue where pressing Enter would not submit a containing form of Place Autocomplete elements if no prediction was highlighted.
- Fixed a race condition causing `FlattenerElement` to fail to draw on 3D Maps.
- Fixed a bug where touch-handling on mobile devices did not work correctly when a map was attached to a DOM element that was created in a different iframe context from the Maps JS library code.

## 3.64.5d

#### 18 March, 2026

Changes:

- The `weekly` channel now features several 3D Maps updates, including the new `MarkerElement` and `FlattenerElement`. Additionally, we've added `cameraPosition` and `fov` properties, plus `altitudeMode` support for the `flyCameraTo` and `flyCameraAround` methods.
- The Places library has introduced `currentOpeningHours`, `regularSecondaryOpeningHours`, and `currentSecondaryOpeningHours` for identified places. The `currentOpeningHours` provide opening hours for the upcoming week including any exceptional hours like holidays. The secondary hours are different from a place's main hours and indicate the hours for things like a place's drive through, pickup, or takeout.
- Fixed an issue in 3D maps where the link to Google Maps was sometimes not updating correctly after the map moved.

## 3.64.4d

#### 12 March, 2026

Changes:

- Sync `InfoWindow` map property on position change to fix the issue that caused unnecessary console warnings.
- Fixes an issue where programmatic `fov` updates to Map3DElement would occasionally be dropped.
- The `flyCameraAround` method on `Map3DElement` now accepts `Number.Infinity` for the `repeatCount` parameter, allowing for endless animation.

## 3.64.3a

#### 2 March, 2026

Changes:

- The Maps Embed API now use Places UI Kit to display place details.
- \[beta channel\] The `cameraPosition` property previously introduced on `Map3DElement` in 3.64.2 is now also supported in the `flyCameraTo` target. Please see [3D Maps in Maps JavaScript](https://developers.google.com/maps/documentation/javascript/3d/overview.md.txt) for more information.

## 3.64.2b

#### 26 February, 2026

Changes:

- `google.maps.DirectionsService`, `google.maps.DirectionsRenderer`, and `google.maps.DistanceMatrixService` are deprecated as of February 25th, 2026. At this time, they are not scheduled to be discontinued and will continue to receive bug fixes for any major regressions. At least 12 months notice will be given before support is discontinued. Please see [legacy](https://developers.google.com/maps/legacy.md.txt) for additional details (including newer, recommended alternatives).
- \[beta channel\] Introduced a new `MarkerElement` allowing you to display custom HTML content within markers on 3D Map. Additionally, a new `FlattenerElement` can now flatten 3D meshes in specific areas.
- \[beta channel\] `Map3DElement` has been updated with `fov` and `cameraPosition` properties, while the `flyCameraTo` and `flyCameraAround` methods now support `altitudeMode`. Please see [3D Maps in Maps JavaScript](https://developers.google.com/maps/documentation/javascript/3d/overview.md.txt) for more information.
- Fixed a bug that caused creating a `PinElement` using `document.createElement('gmp-pin')` to throw a `NotSupportedError`.

## 3.64.1c

#### 19 February, 2026

Changes:

- Update collision when `AdvancedMarkerElement` resizes.

## 3.63.14d

#### 5 February, 2026

Changes:

- The Places library has introduced new options for identifying a place when requesting data. In addition to using `id`, you can now specify a `resourceName` to initialize a `Place` object.
- The Places library has introduced `subDestinations` for identified places. These `subDestinations` provide more specific destinations for users who are searching within a large or complex place like an airport, national park, university, or stadium.
- Fixed an issue where Map3D required an altitude to be specified when setting the center property in JS (now defaults to 0).
- The Place object from `PlaceDetailsElement` and `PlaceDetailsCompactElement` now includes a `googleMapsLinks` property, which provides URLs for deep-linking into Google Maps for a variety of actions. This includes URIs for viewing the place, getting directions, viewing photos, reading existing reviews, and writing a new review.

## 3.63.13

#### 29 January, 2026

Changes:

- The Maps Embed API no longer shows hover cards when placing the mouse cursor over POIs.
- Adds console warnings for misconfigured Places UI Kit (Place Details + Place Search) elements
- PlaceDetailsElement will now show AI generated place summaries when available.
- An AI-generated review summary is now available for the PlaceDetailsElement.

## 3.63.10a

#### 13 January, 2026

Changes:

- Fixed an issue which prevented scroll and click gestures inside popovers.
- `resourceName` and `shortFormattedAddress` fields are now available through the Places API

## 3.63.9d

#### 8 January, 2026

Changes:

- `PlaceSearchElement` shows non-photo content slightly faster while photos are loading. Photo fade-in animations are refined across Places UI Kit.
- Improve the performance when rendering Polylines on a tilted map.
- Fixed a bug where the 3D map camera did not update when set programmatically under certain conditions.
- Small performance improvement loading photos for `PlaceDetailsElement` and `PlaceSearchElement`.
- Clarified the behavior of the `draggable` property in `MapOptions` to better explain user interaction constraints.
- Enforces beta channel access for `possibleNextAction` in the Address Validation library
- Add `placeholder` property and HTML attribute support to `PlaceAutocompleteElement`
- `PlaceAutocompleteElement` now supports customization for more standard CSS font properties, including: font, font-size, font-family, font-weight, line-height, font-style, and color. Default font-size now becomes 16px.
- Add `value` property and HTML attribute support to `PlaceAutocompleteElement`
- Optimize image loading in Places UI Kit.
- Added CSS Part `input` to the `PlaceAutocompleteElement`

## 3.63.5d

#### 11 December, 2025

Changes:

- Launches Address Validation API in Maps JavaScript API
- `mapTypeId` now defaults to `MapTypeId.ROADMAP` when set to null or undefined, fixing an issue that could cause map tiles not to load.
- Hide the review section in `PlaceDetailsElement` if the place is not ratable.
- Improved color contrast for Google logo shown on `google.maps.Map` with custom styling
- Vector maps now use the same satellite imagery as raster maps allowing for a higher visual fidelity.

## 3.63.4a

#### 4 December, 2025

Changes:

- `--gmp-mat-spacing-medium` now applies to the inner container padding for `PlaceDetailsCompactElement` horizontal view.
- Fixed an issue with 3D Map shifting on MacOS Safari when interacting with UI controls.
- `language` and `region` properties can now be dynamically changed on `Map3DElement` without a need to re-create a map.

## 3.63.1b

#### 20 November, 2025

Changes:

- Fixed an issue where the Info Window was incorrectly positioned when attached to an `AdvancedMarkerElement`.
- Made `PlaceAutocompleteElement`'s clear button visible only when input has text.
- Made orientation attribute matching case-insensitive in PlaceDetailsCompactElement styles.
- Added an ability to disable panning the map when `PopoverElement` is open on 3D Maps.
- Fixed a bug that prevents the use of `addEventListener()` on the `PinElement`.
- Modals dialogs (such as the keyboard shortcuts dialog on the map and the disclosures dialog in Places UI Kit) now close with a click outside of the content area.
- Place data now includes informational AI-generated summaries for reviews and nearby amenities. New properties are evChargeAmenitySummary, neighborhoodSummary, generativeSummary and reviewSummary.

## 3.62.13e

#### 6 November, 2025

Changes:

- Fixed a memory leak issue when a `PopoverElement` is dynamically added and removed to/from the DOM.
- Fixed a memory leak issue when a `Map3DElement` is dynamically added and removed to/from the DOM.
- Fixed alignment of rounded image corners with rounded container corners when using a thick border in `PlaceDetailsCompactElement`.

## 3.62.12c

#### 30 October, 2025

Changes:

- \[alpha channel\] Removed the experimental `ElevationElement`.
- Added CSS variables for `background-color`, `border-radius`, `box-shadow`, and `padding` to Map 3D `PopoverElement`.
- Places UI Kit photo lightboxes no longer close when clicking outside the photo.

## 3.62.11d

#### 23 October, 2025

Changes:

- \[alpha channel\] Make dark mode work for highlighting place contextual list items.
- Added `anchorLeft` and `anchorTop` properties to `AdvancedMarkerElementOptions`.
- `<gmp-pin>` web component is now available. Use the new `glyphSrc` property to provide an image URL for the glyph, or the `glyphText` property to display text. The `glyph` property is now deprecated on the `PinElement`.
- Prevents the InfoWindow from unexpectedly showing when an associated AdvancedMarker is created outside the viewport.
- 3D Maps is now available in the weekly channel. This release includes a new compass control and simplified default UI controls; support for Cloud-based map styling, and cooperative gesture handling; improved localization with new `language` and `region` properties on the `Map3DElement`, as well as accessibility improvements for basemap labels. See [3D Maps in Maps JavaScript](https://developers.google.com/maps/documentation/javascript/3d/overview.md.txt) for more information.
- Improved memory management for Map 3D to avoid out of memory issues on iOS devices.
- Launched [Routes JS](https://developers.google.com//maps/documentation/javascript/routes). Allows developers to make Routes API calls and draw routes with Maps JS API.

## 3.62.9c

#### 9 October, 2025

Changes:

- Added `anchorTop` and `anchorLeft` properties to the `AdvancedMarkerElement`. This enables changing a marker's anchor point to something other than the default bottom middle.

## 3.62.8d

#### 2 October, 2025

Changes:

- New camera controls enabled for the Maps Embed API.
- \[beta channel\] `defaultUIDisabled` property in `Map3DElement` class and `Map3DElementOptions` interface has been replaced with `defaultUIHidden`. `defaultUIDisabled` will continue to function in the `beta` channel.
- \[beta channel\] `rounds` property in `FlyAroundAnimationOptions` interface has been replaced with `repeatCount`. `rounds` will continue to function in the `beta` channel.
- `mapMode` property is now deprecated on the `PlaceContextualElement`.

## 3.62.7e

#### 25 September, 2025

Changes:

- Enable highlighting markers for PlaceContextualElement.

## 3.62.6d

#### 18 September, 2025

Changes:

- \[beta channel\] Clarify `Route` error messages.
- \[beta channel\] Support Place resource names in `Route` requests.
- \[beta channel\] Allow creating `Route` polylines from `RouteLeg` paths.

## 3.62.5d

#### 10 September, 2025

Changes:

- \[beta channel\] The `coordinates` property in Polyline3DElement has been replaced with `path`, which is now available as an HTML attribute. The `outerCoordinates` property on Polygon3DElement has been replaced with `path`, which is now available as an HTML attribute. The `innerCoordinates` property on Polygon3DElement has been replaced by `innerPaths`. All "coordinates" properties on these two elements have been deprecated but will continue to function in the beta channel.

## 3.62.3c

#### 3 September, 2025

No public-facing changes.

## 3.62.2c

#### 28 August, 2025

Changes:

- The Drawing Library is deprecated. See <https://developers.google.com/maps/deprecations> for more information.

## 3.62.1

#### 21 August, 2025

Changes:

- \[beta channel\] Added `sessionToken` and `placeAutocompleteElement` as optional options for the Address Validation API for session management in `AddressValidation.fetchAddressValidation()`
- \[beta channel\] Launched [Routes JS](https://developers.google.com//maps/documentation/javascript/routes). Allows developers to make Routes API calls and draw routes with Maps JS API.

## 3.61.14

#### 7 August, 2025

Changes:

- Fixes an issue where the photo lightbox wasn't available in the Place Details Compact element when in horizontal mode.

## 3.61.12c

#### 31 July, 2025

Changes:

- Added documentation for additional fields in PlaceAutocompleteElementOptions and BasicPlaceAutocompleteElementOptions.
- Resolved an issue where Advanced Markers would briefly flash and then disappear when panned offscreen.
- Added googleMapsLinks to the Place class.

## 3.61.11a

#### 24 July, 2025

Changes:

- Add originalText and originalTextLanguageCode to the Place Review class.
- \[alpha channel\] Enable mapMode for PlaceContextual Maps Grounding Widget. Allows users to switch between ROADMAP, HYBRID and NONE.
- \[beta channel\] The Map3DElement now fires an event if the map fails to initialize, e.g. from lack of WebGL support in the user's browser.
- 45° Imagery on Map is now deprecated. See [Deprecations -- 45° Imagery](https://developers.google.com/maps/deprecations.md.txt#45%C2%B0_imagery_deprecated_as_of_may_27_2025) for more information.

## 3.61.10d

#### 17 July, 2025

Changes:

- The Basic Place Autocomplete Widget is now available in the weekly channel.
- \[alpha channel\] Remove experimental PlaceListElement.
- Add PlaceSearchElement and associated config / request elements.
- Additional style tokens for PlaceDetailsElement and PlaceDetailsCompactElement.

## 3.61.9a

#### 10 July, 2025

Changes:

- Updated markers to prevent repeated navigation instructions on each item when using a screen reader. Instruction is now announced only once each time entering the group.
- Fixed a contrast issue for the keyboard shortcut dialog in dark mode.
- Enable border, border radius, widget background color and color scheme customization support for Place Autocomplete Element. The Place Autocomplete Element now automatically respects dark mode - to disable, apply `color-scheme: light` in CSS.
- Added googleMapsURI fields to Place Photo and Review classes.
- \[beta channel\] Add `PossibleNextAction` enum to Address Validation API.

## 3.61.7a

#### 1 July, 2025

Changes:

- The Heatmap Layer functionality in the Maps JavaScript API is no longer supported. This API was deprecated in May 2025 and will be made unavailable in a later version of the Maps JavaScript API, releasing in May 2026. For more info, see <https://developers.google.com/maps/deprecations>).
- Fixes issue in GA preventing processing of clicks on POIs that were hidden by custom styling.
- \[beta channel\] Added extra handling for WebGL context loss in 3D maps. 3D maps will now try to restore themselves when the WebGL context is restored.

## 3.61.6d

#### 26 June, 2025

Changes:

- Add internalUsageAttributionIds to Map3DElement and Map3DElementOptions.

## 3.61.5a

#### 17 June, 2025

Changes:

- Enable support for string "IP_BIAS" for LocationBias for Places Autocomplete.
- Fixed a documentation error for `SearchNearbyRequest`. The default value for `SearchNearbyRequest.RankPreference` is `POPULARITY`, not `DISTANCE`.

## 3.61.4a

#### 12 June, 2025

Changes:

- Added `RPCStatus` enum to describe status codes returned by certain web services.

## 3.61.3b

#### 5 June, 2025

No public-facing changes.

## 3.61.2

#### 29 May, 2025

Changes:

- Added PlaceDetailsElement, PlaceDetailsCompactElement and associated config elements. Removed PlaceDetailsSize.
- Fixed an issue with PlaceAutocompleteElement where selecting an IME entry caused the element to select a prediction item.

## 3.61.1

#### 22 May, 2025

Changes:

- \[beta channel\] Fix missing location/viewport on PlaceDetailsCompactElement place output.
- Street-level details are available in covered cities.

## 3.60.12

#### 8 May, 2025

Changes:

- \[beta channel\] Added support for the Address Validation API in the Maps JavaScript API.
- Fixed an issue with network calls from contexts without Origin headers.

## 3.60.11 (Rolled back)

#### 1 May, 2025

Changes:

- \[beta channel\] Add PlaceDetailsCompactElement and associated config elements.
- Fix StreetViewPanoramaOptions.zoomControl = false not working for Street View maps.

## 3.60.10

#### 24 April, 2025

Changes:

- \[beta channel\] 3D Maps is now available in the beta channel. This release includes accessibility improvements as well as new interactive elements for polylines, polygons and 3D models. Additionally, a new `PopoverElement` is now available for displaying custom HTML content on 3D Maps. Please see [3D Maps in Maps JavaScript](https://developers.google.com/maps/documentation/javascript/3d/overview.md.txt) for more information.

## 3.60.9

#### 17 April, 2025

Changes:

- \[alpha channel\] Launch PlaceContextualElement to unrestricted experimental.
- \[alpha channel\] 3D models are now rendered with an image-based lighting (IBL) by default on 3D Maps.

## 3.60.8

#### 9 April, 2025

Changes:

- \[beta channel\] LocalContext API has now been completely removed. Attempting to instantiate LocalContextMapView now throws an error. See <https://developers.google.com/maps/deprecations#localcontext-deprecation> for more information.
- Fixed a bug that caused weird behavior when dragging Advanced Markers on touch devices.
- Increased the opacity of the Cooperative Gesture Handling overlay so that the text on it meets contrast requirements over all areas of the map.
- Add support for `PostalAddress` in the Places API.
- Ensures that static map overlay at startup is the same colorScheme as the underlying map.

## 3.60.7b

#### 3 April, 2025

Changes:

- The Place Autocomplete Widget is now available in the weekly channel.

## 3.60.6

#### 27 March, 2025

Changes:

- Fixed an issue on Safari where pages using `overscroll-behavior` would not scroll properly.
- Fixed the flickering when adding a lot of Advanced Markers with collision behavior enabled.
- Added support for `PriceRange` in Places.

## 3.60.5 (Rolled back)

#### 20 March, 2025

Changes:

- Fixed a bug that prevented the page from being able to be scrolled when clicking or touching Advanced Markers.
- Fixed a bug that caused the fullscreen mode not to work properly in `<gmp-map>`.
- Fixed a bug where the Info Window of a hidden Advanced Marker was still visible.
- Custom styled maps in Roadmap will not lose their custom styling when the Bicycling layer is added.

## 3.60.4

#### 11 March, 2025

Changes:

- Custom styles and background colors are applied to the specific map type and color scheme for which the style is defined (initially, this will be limited to Roadmap and Roadmap Dark). The Transit layer will maintain any custom styling for the selected map type.

## 3.60.3 (Rolled back)

#### 5 March, 2025

Changes:

- Fixed a bug that caused the directions panel not to show up.

## 3.60.2

#### 27 February, 2025

Changes:

- Places: Added support for EV connector type NACS (SAE J3400).
- Released gmp-map and gmp-advanced-marker HTML elements to GA.

## 3.60.1

#### 20 February, 2025

Changes:

- \[alpha channel\] `altitudeMode` on `Polygon3DElement` and `Polyline3DElement` now defaults to `CLAMP_TO_GROUND`.
- \[alpha channel\] A new `mode` option on `Map3DElement` has now to be set for 3D Map to be rendered (2 new values `HYBRID` and `SATELLITE` are available). The existing `defaultLabelsDisabled` option is removed, please set the `mode` to either `HYBRID` or `SATELLITE`.
- \[beta channel\] Background color will return to default or color set in `MapOptions` if it was not specifically set for a particular map type.
- \[beta channel\] Raster custom styles should apply only to the map type that the style has been assigned to.
- Fixed an issue where Advanced Markers would shift when dragged in fullscreen mode. Also fixed an issue with the StreetView pegman having an offset when dragged in fullscreen mode.
- Replace the default zoom control with the new camera control, which contains both pan and zoom buttons.
- Update the zoom button icons to align with the new pan button icons.

## 3.59.8

#### 6 February, 2025

Changes:

- Customers can now access TransitFare values as text.
- \[alpha channel\] Launched the new AirQualityMeterElement: \<gmp-air-quality-meter\>.
- \[alpha channel\] Using the PlaceAutocompleteElement will now require Places API (New) be enabled on the Google Cloud Project. .
- \[alpha channel\] PlaceAutocompleteElement: The gmp-placeselect event is replaced by gmp-select, and provides a PlacePredictionSelectEvent object instead of a PlaceAutocompletePlaceSelect object.
- \[alpha channel\] PlaceAutocompleteElement: The gmp-requesterror event is replaced by gmp-error, and provides an Event object instead of a PlaceAutocompleteRequestErrorEvent object.
- \[alpha channel\] PlaceAutocompleteElement: componentRestrictions is replaced by includedRegionCodes.
- \[alpha channel\] PlaceAutocompleteElement: types is replaced by includedPrimaryTypes.

## 3.59.7

#### 30 January, 2025

Changes:

- \[beta channel\] Roadmap and dark-mode roadmap background colors set for custom styles should be rendered behind tiles and past map margins.
- \[beta channel\] A custom styled roadmap (or dark-mode roadmap) will maintain its custom styling when a transit layer is added, rather reverting back to the default base map style.
- Maps that are in dark mode will now remain in dark mode when the transit layer is added.

## 3.59.6

#### 23 January, 2025

No public-facing changes.

## 3.59.5

#### 16 January, 2025

Changes:

- Fixed a bug which caused uncaught errors thrown when creating a custom Street View panorama.

## 3.59.4a

#### 9 January, 2025

Changes:

- Fixed a bug which caused uncaught errors thrown when traffic layer is enabled.
- \[beta channel\] Resolves an issue where PlaceAutocompleteElement did not yield focus correctly.
- \[beta channel\] Atomic map features will be shown in supporting cities at z17 and deeper.

## Earlier release notes

For release notes from 2024 and earlier, see the
[Maps JavaScript API
release notes archive](https://developers.google.com/maps/documentation/javascript/releases-archive).