Примечания к выпуску Maps JavaScript API

Подпишитесь на примечания к выпуску. Подписаться

Команда разработчиков Maps JavaScript API постоянно совершенствует этот программный продукт, в том числе исправляет ошибки и добавляет новые функции. Вы можете выбрать в своем приложении версию API с помощью параметра v в запросе начальной загрузки к Maps JavaScript API. Подробнее об управлении версиями…

В этом журнале изменений выпуски перечислены по дате и номеру версии, а также указаны связанные с ними изменения.

На этой странице приведены примечания к выпускам за 2025 и 2026 годы. Сведения о более ранних выпусках можно найти в архиве примечаний к выпускам Maps JavaScript API.

Чтобы получать уведомления о новых версиях Maps API, подпишитесь на группу google-maps-js-api-v3-notify.

3.66.11a

22 октября 2026 г.

Изменения:

  • Элементы Places UI Kit Pro (AdvancedPlaceDetailsElement, AdvancedPlaceDetailsCompactElement, AdvancedPlaceSearchElement, AdvancedPlaceListElement) теперь общедоступны в еженедельном канале.
  • В горизонтальных компактных макетах PlaceDetailsCompactElement (<gmp-place-details-compact>) и PlaceSearchElement (<gmp-place-search>) кнопка "Открыть в Google Картах" теперь отображается в верхней строке рядом с названием и адресом места, поэтому остальные строки с основной информацией занимают всю ширину.
  • В информации о местах больше не показывается пустая область действий, если ни один из элементов gmp-place-link или gmp-place-button не может быть отрисован для места.
  • Элемент PlaceContentConfigElement (<gmp-place-content-config>) устарел. Добавляйте элементы контента непосредственно в PlaceDetailsElement или PlaceDetailsCompactElement или внутрь элемента <template slot="details-item"> в PlaceSearchElement.
  • Функция KmlLayer в Maps JavaScript API больше не доступна. Подробную информацию можно найти на странице https://developers.google.com/maps/deprecations.
  • [Альфа-канал] Добавлен класс PlacePinElement (<gmp-place-pin>), который показывает маркер места на карте, используя значок категории или фото места. Используется как контент для AdvancedMarkerElement.
  • [Альфа-канал] Исправлена ошибка, из-за которой контент всплывающих окон Route3DElement и Route.createPopover() обрезался на картах небольшой высоты, например на телефонах при масштабе страницы 200 %.

3.66.9d

14 октября 2026 г.

Изменения:

  • Исправлена ошибка, из-за которой при завершении перетаскивания элемента AdvancedMarkerElement ошибочно запускалось событие клика по карте.
  • Исправлена ошибка, из-за которой информационное окно объекта инфраструктуры не закрывалось при нажатии клавиши Esc после повторного открытия того же объекта.
  • [Альфа-канал] AdvancedPlaceDetailsElement, AdvancedPlaceDetailsCompactElement и AdvancedPlaceItemElement теперь поддерживают слоты basic-section-top и basic-section-bottom в альфа-канале.
  • [Альфа-канал] PlacePinElement теперь доступен в альфа-канале для показа информации о месте на карте.
  • Исправлена ошибка, из-за которой информационное окно не закрывалось при нажатии клавиши Esc, а фокус не возвращался к предыдущему элементу, если карта была элементом gmp-map.

3.66.8b

8 октября 2026 г.

Изменения:

  • Исправлена ошибка, из-за которой информационное окно объекта инфраструктуры не закрывалось при нажатии клавиши Esc после повторного нажатия на значок объекта.
  • Исправлена ошибка, из-за которой при навигации с помощью клавиш со стрелками фокус перемещался на элементы AdvancedMarkerElement за пределами видимой области карты.
  • [Бета-канал] В 3D-карты (Map3DElement) добавлены MapMode.ROADMAP, элемент управления пользовательского интерфейса для режима карты, Map3DElement.colorScheme (для светлого и темного стилей карты) и Label3DElement (<gmp-label-3d>).

3.66.7

1 октября 2026 г.

Изменения:

  • [Альфа-канал] Исправлена ошибка, из-за которой значки транспортных средств во всплывающем окне Route3DElement исчезали в режиме принудительного использования цветов.
  • [Альфа-канал] Теперь Route.createWaypointMarkers() устанавливает локализованное значение по умолчанию title ("Origin" или "Destination") для создаваемых маркеров.
  • [Альфа-канал] Исправлена ошибка, из-за которой текст всплывающего окна Route3DElement не отображался в гибридном и спутниковом режимах карты.
  • [Альфа-канал] 3D-маркеры, созданные с помощью Route.createWaypointMarkers(), теперь сохраняют постоянный размер экрана (sizePreserved по умолчанию имеет значение true).
  • [Альфа-канал] Маркеры начала и конца маршрута Route3DElement теперь можно выбирать с помощью клавиатуры. Они озвучиваются программами чтения с экрана. При наведении указателя мыши на маркер показывается его название.
  • [Бета-канал] Добавлены свойства Map3DElement.maxMemoryMegabytes и Map3DElement.qualityMode, а также перечисление QualityMode, чтобы снизить использование памяти 3D-картой.
  • Исправлена ошибка, из-за которой PopoverElement (<gmp-popover>) смещался относительно своей привязки при изменении масштаба страницы в Safari.
  • Добавлена поддержка событий указателя через gmp-pointerover, gmp-pointerout и gmp-pointermove для интерактивных элементов в Maps3D.
  • Исправлены определения TypeScript для элементов рисования 3D-карт (Marker3DElement, Model3DElement, Polygon3DElement, Polyline3DElement, FlattenerElement, CirclePathElement) и PopoverElement, чтобы они принимали google.maps.LatLng.

3.66.6c

22 сентября 2026 г.

Изменения:

  • Исправлена ошибка, из-за которой в PlaceAutocompleteElement не показывалась кнопка очистки, если элемент был заполнен программно с помощью параметров конструктора или свойства value.
  • [альфа-канал] Пользователь colorScheme удален из группы google.maps.routes.RoutePolyline3DOptions. Route3DElement теперь отслеживает эффективную цветовую схему родительского элемента Map3D.
  • [Бета-канал] Исправлена утечка памяти в жизненном цикле рендеринга панорамы в Просмотре улиц.
  • [Бета-канал] Значки по умолчанию для PlaceLinkElement можно скрыть с помощью атрибута default-icon-hidden, чтобы ссылки на места содержали только текст.

3.66.4d

9 сентября 2026 г.

Изменения:

  • [Альфа-канал] Минимальный диапазон AutofitsCamera изменен с 2000 метров на 80 метров.
  • Устаревшие события AdvancedMarkerElement.addListener() и устаревшие события (click, dragstart, drag, dragend). Вместо них используйте стандартные события addEventListener() с префиксом gmp-.

3.66.3d

2 сентября 2026 г.

Изменения:

  • [Альфа-канал] В RoutePolyline3DOptions добавлено поле trafficPolylinesDisabled. Это позволяет разработчикам отключать ломаные линии с учетом трафика при создании трехмерных ломаных линий маршрута.
  • [Альфа-канал] Оптимизирован элемент Route3DElement, чтобы избежать ненужных запросов к серверу при переключении trafficPolylinesDisabled.

3.66.2d

26 августа 2026 г.

Изменения:

  • [Альфа-канал] Значки маршрутов в 3D удалены из загрузки шрифтов и перемещены во встроенные объекты SVG, чтобы избежать проблем при многократной загрузке шрифта Material Symbols.
  • [Бета-канал] Добавлены расширенные компоненты Places UI Kit: AdvancedPlaceDetailsElement, AdvancedPlaceDetailsCompactElement, PlaceLinkElement, PlaceButtonElement, PlaceNameElement, AdvancedPlaceListElement, AdvancedPlaceSearchElement.
  • Добавлена подсказка к названиям маршрутов общественного транспорта, чтобы можно было увидеть полное название, даже если оно усечено.
  • Добавлены типы removeEventListener для пользовательских веб-компонентов.
  • Исправлена ошибка, из-за которой VoiceOver показывал контур фокуса на скрытых элементах программы чтения с экрана для маркеров маршрута.

3.66.1a

17 августа 2026 г.

Изменения:

  • Исправлены специальные возможности для статических изображений на карточке места: добавлены резервные ярлыки и удалены лишние остановки фокуса клавиатуры.

3.65.12f

6 августа 2026 г.

Изменения:

  • [альфа-канал] Добавляет <gmp-label-3d> (google.maps.maps3d.Label3DElement) в альфа-канал 3D Maps JS API. Теперь разработчики могут использовать новый элемент, чтобы объявлять текст ярлыка и настраивать его поведение при наложении отдельно от связанных с ним элементов 3D-маркера, таких как <gmp-marker-3d> и <gmp-marker-3d-interactive>.
  • Добавьте уникальные доступные названия для кнопок "Ещё" в виджетах с информацией о местах.
  • [Альфа-канал] Улучшены сообщения об ошибках, связанных с режимом путешествия Route 3D, когда TravelMode.TWO_WHEELER используется за пределами альфа- и бета-версий.
  • [Альфа-канал] Компонент Route3D теперь поддерживает свойство trafficPolylinesDisabled. Это позволяет разработчикам отключать ломаные линии с учетом загруженности дорог при использовании вариантов маршрутизации TRAFFIC_AWARE или TRAFFIC_AWARE_OPTIMAL.
  • [Альфа-канал] Увеличено поле северной границы AutofitsCamera, чтобы предотвратить обрезку маркера по умолчанию.
  • Исправлена ошибка, из-за которой на устройствах с сенсорным экраном не удавалось перетащить человечка Просмотра улиц на карту.

3.65.11b

27 июля 2026 г.

Изменения:

  • [Альфа-канал] Улучшено всплывающее окно Route3D: теперь в нем показываются значки, не связанные с общественным транспортом (велосипед, автомобиль, двухколесное транспортное средство и пешеход).
  • [Альфа-канал] Route.createWaypointMarkers создает маркеры для пунктов отправления и назначения, применяя стиль по умолчанию, если не указана функция customOverride. Промежуточные путевые точки пока не поддерживаются.

3.65.10a

22 июля 2026 г.

Изменения:

  • Исправлена ошибка, из-за которой Maps JS загружал шрифт Material Symbols Outlined таким образом, что это могло повлиять на тот же шрифт, загруженный на базовой странице.
  • Исправлена ошибка, из-за которой элемент PlaceAutocompleteElement отправлял пустое значение в POST-запросе формы, если он был инициализирован с помощью options.value или изменен программно через свойство value.
  • Обновлены элементы управления пользовательского интерфейса наклоном и направлением 3D-карты, чтобы их можно было снова включить, если диапазон ограничений камеры увеличен.

3.65.8c (откат)

7 июля 2026 г.

Изменения:

  • [Альфа-канал] Route3DElement показывает дополнительные данные о ломаных линиях и всплывающих окнах для маршрутов общественного транспорта.
  • В Address Validation API добавлена поддержка internalUsageAttributionIds. Это свойство позволяет атрибутировать вызовы API определенным пакетам или библиотекам OSS.
  • Обновлено информационное окно по умолчанию, которое появляется при нажатии на объект инфраструктуры на 2D-карте. Теперь в нем используются виджеты мест.
  • Повышена надежность панорам Просмотра улиц в условиях высокой загруженности.

3.65.6a

25 июня 2026 г.

Изменения:

  • [Бета-канал] Обновлено информационное окно по умолчанию, которое появляется при нажатии на объект инфраструктуры на 2D-карте. Теперь в нем используются виджеты мест.
  • Исправлена ошибка, из-за которой на 3D-карте иногда возникала ошибка при экстремальных значениях fov.
  • Обновлены маркеры маршрутов по умолчанию, чтобы больше не использовать устаревший параметр glyph PinElement.

3.65.5e

17 июня 2026 г.

Изменения:

  • Исправлены типы для OverlayView.getMap().
  • Обновлены типы для BasicPlaceAutocompleteElement и PlaceAutocompleteElement, чтобы указать, что параметр options конструктора является необязательным.

3.65.3b

4 июня 2026 г.

Изменения:

  • Функция DrawingManager в Maps JavaScript API больше не доступна. Подробную информацию можно найти на странице https://developers.google.com/maps/deprecations.
  • Улучшен цветовой контраст для диалогового окна с информацией об авторских правах на карту в темном режиме.
  • Отключать элементы управления поворотом 3D-карты, когда достигнуты пределы направления.
  • Исправлена ошибка, из-за которой поле ввода автозаполнения мест на мобильных устройствах перекрывало строку состояния или безопасную область iOS. Примечание. Исправление работает, если в метатеге viewport задано значение viewport-fit=cover.
  • В Maps 3D JavaScript API добавлена поддержка internalUsageAttributionIds. Это свойство позволяет разработчикам связывать вызовы API с определенными пакетами или библиотеками ПО с открытым исходным кодом.
  • В Places (New) API добавлена поддержка internalUsageAttributionIds. Это свойство позволяет разработчикам связывать вызовы API с определенными пакетами или библиотеками ПО с открытым исходным кодом.
  • [Альфа-канал] Сужены типы геттеров свойств Route3DElement, чтобы они соответствовали нормализации сеттеров.
  • [Альфа-канал] Route3DElement предоставляет свойства routes, fallbackInfo и geocodingResults.

3.65.2d

27 мая 2026 г.

Изменения:

  • Исправлена ошибка, из-за которой кнопка уменьшения масштаба не работала на карте с ограниченными границами.
  • В библиотеке Places появилось transitStation для мест.
  • Добавлена поддержка internalUsageAttributionIds в библиотеке Routes. Это свойство позволяет разработчикам связывать вызовы API с определенными пакетами или библиотеками ПО с открытым исходным кодом.

3.65.1c

20 мая 2026 г.

Изменения:

  • Теперь логотип Google будет темно-серым на белом фоне для схемы и рельефа в светлом режиме, независимо от того, указан ли идентификатор карты или собственный стиль.
  • [Альфа-канал] Route3DElement отправляет события gmp-load и gmp-error после успешных и ошибочных вызовов Routes API соответственно.
  • Исправлена ошибка в документации, где говорилось, что совпадения выделяются в дополнительном тексте подсказок автозаполнения. Совпадения выделяются только в основном тексте, как и при автозаполнении в Places API.
  • Улучшено наследование цветов для элементов подсказок автозаполнения мест, чтобы они корректно наследовали цвет, заданный для родительского элемента.
  • В PlaceAutocompleteElement и BasicPlaceAutocompleteElement добавлены слоты input-icon и clear-icon для настройки значков.
  • Добавлены теневые части prediction-item-secondary-text и prediction-item-nonmatch для элементов подсказок BasicPlaceAutocomplete и PlaceAutocomplete, что позволяет настраивать собственный стиль для несовпадающего основного и дополнительного текста.
  • Добавьте атрибут no-clear-button и свойство noClearButton в PlaceAutocompleteElement и BasicPlaceAutocompleteElement, чтобы можно было скрывать кнопку очистки.
  • Поддержка слоя тепловой карты в Maps JavaScript API прекращена.
  • Улучшена обработка ошибок при получении конфигурации карты.
  • Аэрофотоснимки больше не поддерживаются на растровых картах.
  • В документацию по PlacesLibrary добавлены отсутствующие классы. Также добавлена документация по методу toString() в FormattableText.
  • Улучшены специальные возможности для ссылок "Сообщить об ошибке на карте".

3.64.12d

6 мая 2026 г.

Изменения:

  • Метод equals() объекта LatLng теперь принимает объекты LatLngLiteral вместо того, чтобы выдавать ошибку. В документации по LatLng и LatLngAltitude equals() теперь также точно отражен существующий уровень допуска 1e-9.
  • Map3DElement [альфа-канал] с дочерними элементами autofits теперь изначально отображается в режиме высоты RELATIVE_TO_GROUND, который поддерживает показ областей с большей высотой при загрузке в случаях, когда свойства камеры предопределены, а не применяются с помощью flyCameraTo. Кроме того, при начальной загрузке Map3DElement, если у карты есть дочерние элементы, которые используют API AutofitsCamera и все ещё работают, начальный рендеринг карты откладывается до тех пор, пока они не закончат работу, а камера привязывается независимо от настройки анимации перехода. Последующие обновления камеры учитывают настройку перехода.
  • [Альфа-канал] Polygon3DElement Добавлено свойство autofitsCamera для поддержки автоматической настройки камеры.

3.64.11d

29 апреля 2026 г.

Изменения:

  • [Альфа-канал] В MarkerElement добавлено свойство autofitsCamera, которое позволяет автоматически подгонять маркер под камеру.
  • Исправлена ошибка в PlaceAutocompleteElement, из-за которой значок подсказки не отображался в браузере Safari.
  • В библиотеке Places появилось isPureServiceAreaBusiness для мест. Теперь можно запрашивать результаты для компаний, обслуживающих определенную территорию, задав pureServiceAreaBusinessesIncluded в запросах автозаполнения мест (виджеты и Data API) и текстового поиска.
  • В библиотеку Places добавлены поля addressDescriptor, containingPlaces и timeZone.
  • В библиотеке Places появилось futureOpeningDate для мест. Теперь можно запрашивать результаты для компаний, которые ещё не открылись, установив futureOpeningBusinessesIncluded в запросах автозаполнения мест (Data API и виджеты), поиска поблизости и текстового поиска.
  • Теперь логотип Google будет одинаковым для светлой схемы дорог с идентификатором карты или собственным стилем и без них. Ранее мы показывали логотип Google в темной теме для всех карт Roadmap, использующих идентификатор карты. Чтобы логотип Google оставался белым, пользователям нужно переключиться на тёмную тему.
  • Добавлен focus-ring как CSS Shadow Part в PlaceAutocompleteElement и BasicPlaceAutocompleteElement.
  • Добавлены новые FuelType DIESEL_PLUS и E100. Добавлен новый EVConnectorType NACS.
  • В PlaceAutocompleteElement и BasicPlaceAutocompleteElement добавлены атрибуты value, placeholder, disabled, readonly, no-input-icon и maxlength.
  • В PlaceAutocompleteElement и BasicPlaceAutocompleteElement добавлено свойство description, чтобы предоставить дополнительный контекст пользователям программ чтения с экрана.
  • Сужен объявленный тип LatLngAltitudeLiteral.altitude, чтобы запретить null или undefined. Исправлен объявленный тип возвращаемого значения DirectionalLocation.toJSON().

3.64.9c

14 апреля 2026 г.

Изменения:

  • В объявлениях TypeScript теперь правильно различаются типы геттеров и сеттеров свойств (в том числе свойства только для чтения без сеттеров).

3.64.8b

8 апреля 2026 г.

Изменения:

  • [Альфа-канал] Route3DElement, Marker3DElement и Polyline3DElement с autofitsCamera не будут вызывать обновления камеры при удалении из DOM. Для Route3DElement ошибки или пустые ответы не влияют на камеру. Кроме того, если изменить значение autofitsCamera с true на false для определенного элемента, камера не будет обновлена, чтобы исключить этот элемент, но он будет исключен из будущих обновлений камеры.
  • Теперь zIndex элемента AdvancedMarkerElement определяется его явно заданным значением или, по умолчанию, его вертикальным положением в пикселях. Явные значения имеют приоритет над значениями по умолчанию. Чтобы маркеры, расположенные ниже на экране и не имеющие значения zIndex, не перекрывали маркеры с таким значением, рекомендуем задать zIndex для всех маркеров.
  • Декларации TypeScript теперь включают интерфейс, сопоставляющий имена HTML-тегов с классами JS (google.maps.HTMLElementTagNameMap и глобальный HTMLElementTagNameMap), интерфейс, сопоставляющий имена HTML-тегов с EventMap каждого класса JS (google.maps.HTMLElementEventMapTagNameMap), интерфейс всех пользовательских свойств CSS (google.maps.CSSProperties). Для каждого перечисления на основе строк определен тип объединения строк (как ${EnumName}String), и это объединение строк используется для этого перечисления во всех декларациях. addEventListener() также перегружен для каждого пользовательского элемента с его типами EventMap, а google.maps.importLibrary() перегружен для правильного ввода каждой возвращенной библиотеки для переданного имени библиотеки.

3.64.7d

1 апреля 2026 г.

Изменения:

  • Свойство mapId теперь можно динамически обновлять после инициализации Map3DElement, поэтому повторно создавать экземпляр Map3DElement не нужно.
  • [Альфа-канал] Добавлен новый класс Route3DElement для отрисовки маршрутов на 3D-картах.
  • [Альфа-канал] Добавлены новые API Route.create3DPolylines() и Route.createPopover().
  • [Альфа-канал] Добавлен новый API spherical.traversePath().
  • [Альфа-канал] В Marker3DElement, Polyline3DElement и Route3DElement добавлен новый API autofitsCamera, а в Map3DElement – новый API autofitsCameraAnimation.
  • [Альфа-канал] Добавлен новый класс CirclePathElement для отрисовки кругов с помощью Polygon3DElement.
  • [Альфа-канал] В 3D-картах на канале alpha теперь доступен новый режим карты ROADMAP.
  • Исправлена ошибка, из-за которой человечек Просмотра улиц работал некорректно на мобильных устройствах, если он находился на карте, прикрепленной к элементу DOM, созданному в контексте фрейма, отличном от кода Maps JS API.

3.64.6d

26 марта 2026 г.

Изменения:

  • Исправлена ошибка, из-за которой при нажатии клавиши Ввод не отправлялась форма, содержащая элементы автозаполнения мест, если не была выделена ни одна подсказка.
  • Исправлено состояние гонки, из-за которого FlattenerElement не отображался на 3D-картах.
  • Исправлена ошибка, из-за которой обработка касаний на мобильных устройствах работала некорректно, если карта была прикреплена к элементу DOM, созданному в контексте iframe, отличном от кода библиотеки Maps JS.

3.64.5d

18 марта 2026 г.

Изменения:

  • На канале weekly появилось несколько обновлений 3D-карт, в том числе новые MarkerElement и FlattenerElement. Кроме того, мы добавили свойства cameraPosition и fov, а также поддержку altitudeMode для методов flyCameraTo и flyCameraAround.
  • В библиотеке Places появились поля currentOpeningHours, regularSecondaryOpeningHours и currentSecondaryOpeningHours для идентифицированных мест. currentOpeningHours содержит часы работы на предстоящую неделю, включая особые дни, например праздники. Дополнительные часы работы отличаются от основных и указывают на время работы таких услуг, как обслуживание в автомобиле, самовывоз или еда навынос.
  • Исправлена ошибка, из-за которой ссылка на Google Карты в 3D-картах иногда не обновлялась корректно после перемещения карты.

3.64.4d

12 марта 2026 г.

Изменения:

  • Синхронизация свойства карты InfoWindow при изменении положения, чтобы устранить проблему, которая приводила к ненужным предупреждениям в консоли.
  • Исправлена ошибка, из-за которой программные обновления fov для Map3DElement иногда не выполнялись.
  • Метод flyCameraAround в Map3DElement теперь принимает Number.Infinity для параметра repeatCount, что позволяет создавать бесконечную анимацию.

3.64.3a

2 марта 2026 г.

Изменения:

  • Maps Embed API теперь использует Places UI Kit для показа информации о местах.
  • [Бета-канал] Свойство cameraPosition, ранее представленное в Map3DElement в версии 3.64.2, теперь также поддерживается в целевом объекте flyCameraTo. Подробную информацию вы найдете в статье 3D-карты в Maps JavaScript API.

3.64.2b

26 февраля 2026 г.

Изменения:

  • google.maps.DirectionsService, google.maps.DirectionsRenderer и google.maps.DistanceMatrixService будут упразднены 25 февраля 2026 г. В настоящее время мы не планируем прекращать их поддержку и будем выпускать исправления ошибок для любых серьезных регрессий. Об их отключении мы предупредим за 12 месяцев. Дополнительную информацию, в том числе о новых рекомендуемых альтернативах, можно найти в разделе Устаревшие функции.
  • [Бета-канал] Добавлен новый элемент MarkerElement, позволяющий показывать собственный HTML-контент в маркерах на 3D-карте. Кроме того, новый FlattenerElement теперь может сглаживать 3D-сетки в определенных областях.
  • [Бета-канал] В Map3DElement добавлены свойства fov и cameraPosition, а методы flyCameraTo и flyCameraAround теперь поддерживают altitudeMode. Подробную информацию вы найдете в статье 3D-карты в Maps JavaScript API.
  • Исправлена ошибка, из-за которой при создании PinElement с помощью document.createElement('gmp-pin') возникала ошибка NotSupportedError.

3.64.1c

19 февраля 2026 г.

Изменения:

  • Обновление коллизии при изменении размера AdvancedMarkerElement.

3.63.14d

5 февраля 2026 г.

Изменения:

  • В библиотеке Places появились новые возможности для идентификации места при запросе данных. Теперь для инициализации объекта Place можно использовать не только id, но и resourceName.
  • В библиотеке Places появился параметр subDestinations для идентифицированных мест. Эти subDestinations помогают пользователям находить конкретные места в крупных или сложных объектах, таких как аэропорты, национальные парки, университеты или стадионы.
  • Исправлена ошибка, из-за которой для Map3D требовалось указывать высоту при настройке свойства center в JS (теперь по умолчанию используется значение 0).
  • Объект Place из PlaceDetailsElement и PlaceDetailsCompactElement теперь включает свойство googleMapsLinks, которое предоставляет URL для ссылок на контент в Google Картах для различных действий. В частности, это URI для просмотра места, получения маршрута, просмотра фотографий, чтения существующих отзывов и написания нового отзыва.

3.63.13

29 января 2026 г.

Изменения:

  • Maps Embed API больше не показывает всплывающие карточки при наведении указателя мыши на объекты инфраструктуры.
  • Добавлены предупреждения консоли о неправильно настроенных элементах Places UI Kit (информация о местах и поиск мест).
  • Теперь PlaceDetailsElement будет показывать созданные ИИ сводки о местах, если они доступны.
  • Для PlaceDetailsElement теперь доступна сводка отзывов, созданная ИИ.

3.63.10a

13 января 2026 г.

Изменения:

  • Исправлена ошибка, из-за которой не работали жесты прокрутки и нажатия во всплывающих окнах.
  • Поля resourceName и shortFormattedAddress теперь доступны в Places API

3.63.9d

8 января 2026 г.

Изменения:

  • PlaceSearchElement показывает контент без фотографий немного быстрее, пока загружаются фотографии. Улучшена анимация появления фотографий в Places UI Kit.
  • Повышена производительность при отрисовке ломаных линий на наклонной карте.
  • Исправлена ошибка, из-за которой камера 3D-карты не обновлялась, если была настроена программно при определенных условиях.
  • Небольшое улучшение производительности при загрузке фотографий для PlaceDetailsElement и PlaceSearchElement.
  • Уточнено поведение свойства draggable в MapOptions, чтобы лучше объяснить ограничения на взаимодействие с пользователем.
  • Принудительно включает доступ к бета-каналу для possibleNextAction в библиотеке Address Validation.
  • Добавьте поддержку свойства placeholder и HTML-атрибута в PlaceAutocompleteElement
  • Теперь PlaceAutocompleteElement поддерживает настройку дополнительных стандартных свойств шрифтов CSS, включая font, font-size, font-family, font-weight, line-height, font-style и color. Размер шрифта по умолчанию теперь составляет 16 пкс.
  • Добавьте поддержку свойства value и HTML-атрибута в PlaceAutocompleteElement
  • Оптимизация загрузки изображений в Places UI Kit.
  • Часть CSS input добавлена в PlaceAutocompleteElement.

3.63.5d

11 декабря 2025 г.

Изменения:

  • Запуск Address Validation API в Maps JavaScript API
  • Теперь для mapTypeId по умолчанию используется значение MapTypeId.ROADMAP, если задано значение null или undefined. Это устраняет проблему, из-за которой могли не загружаться фрагменты карты.
  • Скрыть раздел отзывов в PlaceDetailsElement, если место нельзя оценить.
  • Улучшен цветовой контраст логотипа Google, который показывается на google.maps.Map с собственным стилем.
  • На векторных картах теперь используются те же спутниковые снимки, что и на растровых картах, что позволяет повысить точность визуализации.

3.63.4a

4 декабря 2025 г.

Изменения:

  • --gmp-mat-spacing-medium теперь применяется к внутреннему отступу контейнера для горизонтального представления PlaceDetailsCompactElement.
  • Исправлена ошибка, из-за которой 3D-карта сдвигалась в Safari на macOS при взаимодействии с элементами управления пользовательского интерфейса.
  • Свойства language и region теперь можно динамически изменять в Map3DElement без необходимости повторно создавать карту.

3.63.1b

20 ноября 2025 г.

Изменения:

  • Исправлена ошибка, из-за которой информационное окно неправильно размещалось при прикреплении к AdvancedMarkerElement.
  • Кнопка очистки PlaceAutocompleteElement теперь видна, только когда в поле ввода есть текст.
  • В стилях PlaceDetailsCompactElement сопоставление атрибута ориентации теперь выполняется без учета регистра.
  • Добавлена возможность отключить панорамирование карты, когда на 3D-картах открыт элемент PopoverElement.
  • Исправлена ошибка, из-за которой нельзя было использовать addEventListener() на PinElement.
  • Модальные диалоговые окна (например, окно с быстрыми клавишами на карте и окно с информацией в Places UI Kit) теперь закрываются при нажатии за пределами области контента.
  • Данные о местах теперь включают информативные сводки, созданные искусственным интеллектом, для отзывов и близлежащих удобств. Новые свойства: evChargeAmenitySummary, neighborhoodSummary, generativeSummary и reviewSummary.

3.62.13e

6 ноября 2025 г.

Изменения:

  • Исправлена утечка памяти, возникавшая при динамическом добавлении и удалении PopoverElement в DOM.
  • Исправлена утечка памяти, возникавшая при динамическом добавлении и удалении Map3DElement в DOM.
  • Исправлено выравнивание закругленных углов изображения с закругленными углами контейнера при использовании толстой границы в PlaceDetailsCompactElement.

3.62.12c

30 октября 2025 г.

Изменения:

  • [Альфа-канал] Удален экспериментальный метод ElevationElement.
  • Добавлены переменные CSS для background-color, border-radius, box-shadow и padding в Map 3D PopoverElement.
  • Окна с фотографиями Places UI Kit больше не закрываются при нажатии за пределами фотографии.

3.62.11d

23 октября 2025 г.

Изменения:

  • [Альфа-канал] Обеспечьте работу тёмной темы для выделения элементов контекстного списка мест.
  • В AdvancedMarkerElementOptions добавлены свойства anchorLeft и anchorTop.
  • Веб-компонент <gmp-pin> теперь доступен. Используйте новое свойство glyphSrc, чтобы указать URL изображения для глифа, или свойство glyphText, чтобы показать текст. Свойство glyph больше не поддерживается в PinElement.
  • Предотвращает неожиданный показ InfoWindow, когда связанный AdvancedMarker создается за пределами области просмотра.
  • 3D-карты теперь доступны в еженедельном канале. В этом выпуске добавлен новый элемент управления компасом и упрощены элементы управления пользовательского интерфейса по умолчанию. Также добавлена поддержка облачных стилей карт и совместной обработки жестов. Улучшена локализация благодаря новым свойствам language и region в Map3DElement, а также улучшены специальные возможности для меток базовой карты. Подробнее о 3D-картах в Maps JavaScript…
  • Улучшено управление памятью для Map 3D, чтобы избежать проблем с нехваткой памяти на устройствах iOS.
  • Запущен Routes JS. Позволяет разработчикам выполнять вызовы Routes API и рисовать маршруты с помощью Maps JS API.

3.62.9c

9 октября 2025 г.

Изменения:

  • В AdvancedMarkerElement добавлены свойства anchorTop и anchorLeft. Это позволяет изменить точку привязки маркера, которая по умолчанию находится внизу по центру.

3.62.8d

2 октября 2025 г.

Изменения:

  • В Maps Embed API добавлены новые элементы управления камерой.
  • [Бета-канал] Свойство defaultUIDisabled в классе Map3DElement и интерфейсе Map3DElementOptions заменено на defaultUIHidden. defaultUIDisabled продолжит работать в канале beta.
  • [Бета-канал] Свойство rounds в интерфейсе FlyAroundAnimationOptions заменено на repeatCount. rounds продолжит работать в канале beta.
  • Свойство mapMode больше не поддерживается в PlaceContextualElement.

3.62.7e

25 сентября 2025 г.

Изменения:

  • Включить маркеры выделения для PlaceContextualElement.

3.62.6d

18 сентября 2025 г.

Изменения:

  • [Бета-канал] Уточнены сообщения об ошибках в Route.
  • [Бета-канал] Поддержка названий ресурсов Place в запросах Route.
  • [Бета-канал] Разрешить создание ломаных линий Route из путей RouteLeg.

3.62.5d

10 сентября 2025 г.

Изменения:

  • [Бета-канал] Свойство coordinates в Polyline3DElement заменено на path, которое теперь доступно как HTML-атрибут. Свойство outerCoordinates в Polygon3DElement заменено на path, которое теперь доступно как HTML-атрибут. Свойство innerCoordinates в Polygon3DElement заменено на innerPaths. Все свойства coordinates в этих двух элементах устарели, но продолжат работать в бета-канале.

3.62.3c

3 сентября 2025 г.

Изменений, видимых пользователям, нет.

3.62.2c

28 августа 2025 г.

Изменения:

3.62.1

21 августа 2025 г.

Изменения:

  • [Бета-канал] В Address Validation API добавлены необязательные параметры sessionToken и placeAutocompleteElement для управления сеансами в AddressValidation.fetchAddressValidation().
  • [Бета-канал] Запущен Routes JS. Позволяет разработчикам выполнять вызовы Routes API и рисовать маршруты с помощью Maps JS API.

3.61.14

7 августа 2025 г.

Изменения:

  • Исправлена ошибка, из-за которой лайтбокс с фотографиями был недоступен в компактном элементе с информацией о месте в горизонтальном режиме.

3.61.12c

31 июля 2025 г.

Изменения:

  • Добавлена документация по дополнительным полям в PlaceAutocompleteElementOptions и BasicPlaceAutocompleteElementOptions.
  • Устранена проблема, из-за которой расширенные маркеры ненадолго мигали, а затем исчезали при панорамировании за пределы экрана.
  • В класс Place добавлено свойство googleMapsLinks.

3.61.11a

24 июля 2025 г.

Изменения:

  • Добавьте originalText и originalTextLanguageCode в класс Place Review.
  • [Альфа-канал] Включите mapMode для виджета заземления PlaceContextual Maps. Позволяет пользователям переключаться между режимами ROADMAP, HYBRID и NONE.
  • [Бета-канал] Теперь Map3DElement запускает событие, если не удается инициализировать карту, например из-за отсутствия поддержки WebGL в браузере пользователя.
  • Поддержка снимков под углом 45° на карте прекращена. Подробнее о прекращении поддержки изображений под углом 45°…

3.61.10d

17 июля 2025 г.

Изменения:

  • Базовый виджет автозаполнения мест теперь доступен в еженедельном канале.
  • [Альфа-версия] Удален экспериментальный элемент PlaceListElement.
  • Добавьте PlaceSearchElement и связанные элементы конфигурации и запроса.
  • Дополнительные токены стилей для PlaceDetailsElement и PlaceDetailsCompactElement.

3.61.9a

10 июля 2025 г.

Изменения:

  • Обновлены маркеры, чтобы программа чтения с экрана не повторяла инструкции по навигации для каждого элемента. Теперь инструкция озвучивается только один раз при входе в группу.
  • Исправлена проблема с контрастностью в диалоговом окне быстрых клавиш в тёмной теме.
  • Включите поддержку настройки границы, радиуса границы, цвета фона виджета и цветовой схемы для элемента Place Autocomplete. Элемент автозаполнения мест теперь автоматически поддерживает тёмную тему. Чтобы отключить ее, примените color-scheme: light в CSS.
  • В классы Place Photo и Review добавлены поля googleMapsURI.
  • [Бета-канал] В Address Validation API добавлено перечисление PossibleNextAction.

3.61.7a

1 июля 2025 г.

Изменения:

  • Функция слоя тепловой карты в Maps JavaScript API больше не поддерживается. Поддержка этого API прекращена в мае 2025 года. Он будет удален из Maps JavaScript API в мае 2026 года. Подробную информацию можно найти на странице https://developers.google.com/maps/deprecations.
  • Исправлена ошибка в GA, из-за которой не обрабатывались клики по POI, скрытым с помощью собственных стилей.
  • [Бета-канал] Добавлена дополнительная обработка потери контекста WebGL на 3D-картах. Теперь 3D-карты будут пытаться восстановиться при восстановлении контекста WebGL.

3.61.6d

26 июня 2025 г.

Изменения:

  • Добавьте internalUsageAttributionIds в Map3DElement и Map3DElementOptions.

3.61.5a

17 июня 2025 г.

Изменения:

  • Включена поддержка строки IP_BIAS для LocationBias в автозаполнении мест.
  • Исправлена ошибка в документации для SearchNearbyRequest. Значение по умолчанию для SearchNearbyRequest.RankPreference – POPULARITY, а не DISTANCE.

3.61.4a

12 июня 2025 г.

Изменения:

  • Добавлено перечисление RPCStatus для описания кодов статуса, возвращаемых определенными веб-сервисами.

3.61.3b

5 июня 2025 г.

Изменений, видимых пользователям, нет.

3.61.2

29 мая 2025 г.

Изменения:

  • Добавлены элементы PlaceDetailsElement, PlaceDetailsCompactElement и связанные элементы конфигурации. Удален PlaceDetailsSize.
  • Исправлена ошибка в PlaceAutocompleteElement, из-за которой при выборе записи IME элемент выбирал подсказку.

3.61.1

22 мая 2025 г.

Изменения:

  • [Бета-канал] Исправлена ошибка, из-за которой в выходных данных PlaceDetailsCompactElement не указывалось местоположение или область просмотра.
  • Подробные снимки улиц доступны в некоторых городах.

3.60.12

8 мая 2025 г.

Изменения:

  • [Бета-канал] Добавлена поддержка Address Validation API в Maps JavaScript API.
  • Исправлена ошибка, связанная с сетевыми вызовами из контекстов без заголовков Origin.

3.60.11 (откат)

1 мая 2025 г.

Изменения:

  • [Бета-канал] Добавлен элемент PlaceDetailsCompactElement и связанные элементы конфигурации.
  • Исправлена ошибка, из-за которой параметр StreetViewPanoramaOptions.zoomControl = false не работал для карт Просмотра улиц.

3.60.10

24 апреля 2025 г.

Изменения:

  • [Бета-канал] 3D-карты теперь доступны в бета-канале. В этом выпуске улучшены специальные возможности и добавлены новые интерактивные элементы для ломаных линий, многоугольников и 3D-моделей. Кроме того, теперь доступен новый PopoverElement для показа пользовательского HTML-контента на 3D-картах. Подробную информацию вы найдете в статье о 3D-картах в Maps JavaScript API.

3.60.9

17 апреля 2025 г.

Изменения:

  • [Альфа-версия] Запуск PlaceContextualElement в неограниченном экспериментальном режиме.
  • [Альфа-канал] Теперь 3D-модели по умолчанию отображаются на 3D-картах с освещением на основе изображения (IBL).

3.60.8

9 апреля 2025 г.

Изменения:

  • [Бета-канал] LocalContext API полностью удален. При попытке создать экземпляр LocalContextMapView теперь возникает ошибка. Подробную информацию можно найти на странице https://developers.google.com/maps/deprecations#localcontext-deprecation.
  • Исправлена ошибка, из-за которой расширенные маркеры вели себя странно при перетаскивании на сенсорных устройствах.
  • Увеличена прозрачность наложения совместной обработки жестов, чтобы текст на нем соответствовал требованиям к контрастности во всех областях карты.
  • Добавить поддержку PostalAddress в Places API.
  • Обеспечивает, чтобы при запуске статическое наложение данных на карту имело ту же цветовую схему, что и базовая карта.

3.60.7b

3 апреля 2025 г.

Изменения:

  • Виджет автозаполнения мест теперь доступен в еженедельном канале.

3.60.6

27 марта 2025 г.

Изменения:

  • Исправлена ошибка в Safari, из-за которой страницы с overscroll-behavior прокручивались неправильно.
  • Исправлено мерцание при добавлении большого количества расширенных маркеров с включенным поведением при наложении.
  • Добавлена поддержка PriceRange в Places.

3.60.5 (откат)

20 марта 2025 г.

Изменения:

  • Исправлена ошибка, из-за которой не работала прокрутка страницы при нажатии на расширенные маркеры.
  • Исправлена ошибка, из-за которой полноэкранный режим в <gmp-map> работал неправильно.
  • Исправлена ошибка, из-за которой информационное окно скрытого расширенного маркера оставалось видимым.
  • Стилизованные карты в режиме Roadmap не теряют свой собственный стиль при добавлении слоя велосипедных дорожек.

3.60.4

11 марта 2025 г.

Изменения:

  • Собственные стили и цвета фона применяются к определенному типу карты и цветовой схеме, для которых задан стиль (изначально это будут только Roadmap и Roadmap Dark). Слой Transit сохраняет все собственные стили для выбранного типа карты.

3.60.3 (откат)

5 марта 2025 г.

Изменения:

  • Исправлена ошибка, из-за которой не показывалась панель маршрутов.

3.60.2

27 февраля 2025 г.

Изменения:

  • Places API: добавлена поддержка коннектора NACS (SAE J3400) для электромобилей.
  • Элементы HTML gmp-map и gmp-advanced-marker стали общедоступными.

3.60.1

20 февраля 2025 г.

Изменения:

  • [Альфа-канал] altitudeMode на Polygon3DElement и Polyline3DElement теперь по умолчанию имеет значение CLAMP_TO_GROUND.
  • [Альфа-канал] Для отрисовки 3D-карты теперь нужно задать новый параметр mode в Map3DElement (доступны два новых значения: HYBRID и SATELLITE). Существующий вариант defaultLabelsDisabled удален. Установите для параметра mode значение HYBRID или SATELLITE.
  • [Бета-канал] Цвет фона вернется к значению по умолчанию или к цвету, заданному в MapOptions, если он не был задан для определенного типа карты.
  • [Бета-канал] Собственные стили растровых карт должны применяться только к тому типу карты, которому они назначены.
  • Исправлена ошибка, из-за которой расширенные маркеры смещались при перетаскивании в полноэкранном режиме. Также исправлена ошибка, из-за которой человечек Просмотра улиц смещался при перетаскивании в полноэкранном режиме.
  • Замените стандартный элемент управления масштабом на новый элемент управления камерой, который содержит кнопки панорамирования и масштабирования.
  • Обновите значки кнопок масштабирования, чтобы они соответствовали новым значкам кнопок панорамирования.

3.59.8

6 февраля 2025 г.

Изменения:

  • Теперь клиенты могут получать доступ к значениям TransitFare в виде текста.
  • [Альфа-канал] Запущен новый элемент AirQualityMeterElement: <gmp-air-quality-meter>.
  • [Альфа-канал] Для использования PlaceAutocompleteElement теперь требуется включить Places API (New) в облачном проекте Google Cloud. .
  • [Альфа-канал] PlaceAutocompleteElement: событие gmp-placeselect заменено на gmp-select и предоставляет объект PlacePredictionSelectEvent вместо PlaceAutocompletePlaceSelect.
  • [Альфа-канал] PlaceAutocompleteElement: событие gmp-requesterror заменено на gmp-error и предоставляет объект Event вместо объекта PlaceAutocompleteRequestErrorEvent.
  • [Альфа-версия] PlaceAutocompleteElement: componentRestrictions заменено на includedRegionCodes.
  • [Альфа-версия] PlaceAutocompleteElement: types заменено на includedPrimaryTypes.

3.59.7

30 января 2025 г.

Изменения:

  • [Бета-канал] Цвета фона для дорожной карты и дорожной карты в темном режиме, заданные для собственных стилей, должны отображаться за тайлами и за пределами карты.
  • [Бета-канал] Схема дорог с собственным стилем (или в ночном режиме) сохраняет свой стиль при добавлении слоя общественного транспорта, а не возвращается к стилю базовой карты по умолчанию.
  • Теперь, если на карту с темной темой добавить слой общественного транспорта, она останется темной.

3.59.6

23 января 2025 г.

Изменений, видимых пользователям, нет.

3.59.5

16 января 2025 г.

Изменения:

  • Исправлена ошибка, из-за которой при создании пользовательской панорамы в Просмотре улиц возникали неперехваченные ошибки.

3.59.4a

9 января 2025 г.

Изменения:

  • Исправлена ошибка, из-за которой при включении слоя трафика возникали неперехваченные ошибки.
  • [Бета-канал] Устранена проблема, из-за которой PlaceAutocompleteElement неверно передавал фокус.
  • [Бета-канал] Атомарные объекты карты будут показываться в поддерживаемых городах на уровне масштабирования 17 и выше.

Примечания к более ранним выпускам

Примечания к выпускам за 2024 г. и более ранние годы можно найти в архиве примечаний к выпускам Maps JavaScript API.