Прекращение поддержки

На этой странице перечислены все продукты и функции платформы Google Карт, для которых прекращена поддержка, в частности для сервисов Maps, Routes и Places.

Этапы прекращения поддержки

Период прекращения поддержки начинается с даты объявления об этом. Доступ к продукту, версии или функции сохраняется в течение всего периода (обычно на протяжении 12 месяцев). По его истечении продукт, функция или версия прекращают работу и становятся недоступными.

Владельцы проектов заблаговременно получают по электронной почте уведомления об изменениях по каждому из своих проектов. Узнавайте о крупных обновлениях, прекращении поддержки и других изменениях.

Прекращение поддержки в версиях SDK

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

Планы по прекращению поддержки и информацию о доступных версиях Maps JavaScript API, которые выходят раз в квартал, вы найдете в статье об управлении версиями.

Ознакомьтесь с рекомендациями по управлению зависимостями версий через Maps SDK для Android, Maps SDK для iOS, Places SDK для Android и Places SDK для iOS.

Продукты и функции, которые скоро не будут поддерживаться

Ниже перечислены все продукты и функции, поддержка которых скоро прекратится.

Библиотека локального контекста, Maps JavaScript API (с версии v3.51.2)

Поскольку бета-функция библиотеки локального контекста была не очень популярна, она перестанет поддерживаться в Maps JavaScript API, начиная с версии 3.51.2. Библиотека локального контекста будет работать до отдельного уведомления, но мы не рекомендуем добавлять ее в новые проекты.

Если вы хотите сами создать что-то похожее на библиотеку локального контекста, рекомендуем попробовать решение Neighborhood Discovery в инструменте Quick Builder или использовать библиотеку Places с Maps JavaScript API. При этом вам могут быть полезны примеры кода и практические работы для библиотеки Places.

Библиотека совместимости с Places для Places SDK для Android (с 31 марта 2022 г.)

Поддержка всех версий библиотеки совместимости с Places для Places SDK для Android прекращена с 31 марта 2022 года. Мы приостанавливаем разработку библиотеки совместимости с Places для Places SDK для Android версии 2.6.0 (указывается в зависимостях как com.google.android.libraries.places:places-compat:2.6.0).

После этой даты мы не будем выпускать новые версии этой библиотеки. Получить доступ к функциям и исправлениям ошибок в Places SDK для Android версии выше 2.6.0 можно будет, только используя Places SDK для Android.

Библиотека совместимости с Places была представлена в январе 2019 года, чтобы упростить переход с устаревших SDK (доступных в сервисах Google Play) на отдельный пакет Places SDK для Android.

Следуйте указаниям в руководстве по переходу, чтобы использовать Places SDK для Android напрямую. В библиотеке совместимости с Places и в самом пакете Places SDK для Android некоторые коды статусов, а также названия методов и классов автозаполнения различаются. Сведения о том, как указать и поддерживать зависимости от версий Places SDK для Android, можно найти в документации о версиях.

В настоящий момент мы не планируем полностью прекращать поддержку библиотеки совместимости с Places. Однако, если вы решите и дальше использовать ее доступные версии, обратите внимание на ограничения, связанные с поддержкой старых версий SDK.

Неподдерживаемые запросы Place Search в Places API и библиотеке Places в Maps JavaScript API (31 марта 2022 г. – 31 марта 2023 г.)

Неподдерживаемые запросы Place Search для Text Search, Nearby Search и Find Place в Places API и библиотеке Places в Maps JavaScript API не используются с 31 марта 2022 г. С 31 марта 2023 г. они будут вызывать ошибку INVALID_REQUEST.

Places API и библиотека Places в Maps JavaScript API поддерживают три метода поиска мест: Text Search, Nearby Search и Find Place. Каждый метод принимает запросы с комбинацией поддерживаемых параметров и отклоняет большинство запросов, комбинация параметров в которых не поддерживается.

На данный момент некоторые комбинации неподдерживаемых параметров не отклоняются:

  • запросы Text Search с пустым или отсутствующим параметром query и без поддерживаемого параметра type;
  • запросы Text Search с query=*;
  • запросы Nearby Search с keyword=*;
  • запросы Nearby Search с name=*;
  • запросы Find Place с input=*.

Неподдерживаемые запросы Place Search необходимо заменять одним из следующих запросов:

  • Для поиска организаций поблизости можно использовать запросы Nearby Search без параметра keyword (или name). Также рекомендуем использовать параметр type с одним из поддерживаемых типов (см. таблицу 1 Типы мест). Эта комбинация обеспечивает результат, максимально близкий к текущему поведению запросов Text Search с пустым или отсутствующим параметром query.

  • Для поиска ближайшего адреса можно использовать запросы Geocoding API с параметром latlng. Эта комбинация обеспечивает результат, максимально близкий к текущему поведению:

    • запросов Text Search с query=*;
    • запросы Nearby Search с keyword=*;
    • запросы Nearby Search с name=*;
    • запросов Find Place с input=*.

Обновление Content Security Policy (21 марта 2022 г. – май 2023 г.)

Поддержка сайтов с Content Security Policy (CSP), для которых в Maps JavaScript API не указан узел googleapis.com, прекращена в версии 3.49. Они не будут поддерживаться начиная с версии 3.50. Последняя версия 3.49, в которой поддерживаются такие сайты, будет выведена из эксплуатации во втором квартале 2023 г. После этого Maps JavaScript API будет отклонять все запросы с директивами CSP, если в них не указан узел googleapis.com.

Чтобы избежать сбоев в работе сайта, укажите googleapis.com в CSP. Все доступные на текущий момент версии Maps JavaScript API поддерживают CSP.

Игровые сервисы платформы Google Карт (18 октября 2021 г. – 31 декабря 2022 г.)

18 октября 2021 г. начался период прекращения поддержки игровых сервисов платформы Google Карт. 31 декабря 2022 г. эти сервисы будут окончательно выведены из эксплуатации. В течение указанного периода Google будет продолжать оказывать поддержку, устранять серьезные ошибки и сбои. В нашем руководстве по переходу вы найдете ресурсы, которые помогут при планировании дальнейшей разработки ваших проектов.

Устаревшие идентификаторы мест (16 марта 2021 г. – 30 марта 2022 г.)

30 марта 2022 г. все API платформы Google Карт перестанут поддерживать определенные идентификаторы мест. Начиная с 30 марта 2022 г. любые запросы с устаревшими идентификаторами мест будут отклоняться. В ответ придет код ошибки INVALID_REQUEST. Чтобы обеспечить удобство для пользователей, обновите все идентификаторы мест, которые старше 12 месяцев. Это необходимо сделать до 30 марта 2022 г.

Модуль Maps в google.load (13 октября 2020 г. –13 октября 2021 г.)

Поддержка сервиса, который обеспечивает работу модуля Maps для google.load, прекращена 13 октября 2020 года. Он будет отключен 13 октября 2021 года. Теперь запросы на загрузку модуля Maps в google.load приводят к ошибке и карта не загружается. Более подробные сведения вы найдете в руководстве по переносу.

Тип GMSPlaceField в Places SDK для iOS теперь использует макрос NS_OPTIONS (начиная с версии 4.0.0)

Тип GMSPlaceField в Places SDK для iOS,начиная с версии 4.0.0 использует макрос NS_OPTIONS вместо NS_ENUM, чтобы улучшить поддержку языка Swift. Подробнее об использовании NS_OPTIONS в GMSPlaceField…

Чтобы по-прежнему использовать GMSPlaceField как NS_ENUM, оставайтесь на версии 3.10.0 или более ранней, указав ее в своих зависимостях.

Методы Places SDK для iOS: setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner, initWithBounds:filter (начиная с версий 3.10.0 – 4.0.0)

Вспомогательный метод setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner не поддерживается, начиная с версии 3.10.0 и отключен в версии 4.0.0 и более поздних. Вместо нее необходимо использовать locationBias или locationRestriction.

Метод initWithBounds:filter не поддерживается, начиная с версии 3.10.0 и отключен в версии 4.0.0 и более поздних. Вместо нее необходимо использовать initWithFilter: в GMSAutocompleteFetcher.

Максимальная поддерживаемая версия для этих устаревших методов – v3.10.0.

Подробную информацию об используемых вместо них методах можно найти в Приложении 1.

GMSCoordinateBounds в сервисе автозаполнения местоположения (версии 3.9.0 –4.0.0)

Некоторые свойства и параметры, использующие GMSCoordinateBounds в сервисе автозаполнения Places SDK для iOS, не поддерживаются, начиная с версии 3.9.0, то есть в версии 4.0.0 и более поздних. Максимальная поддерживаемая версия для этих устаревших свойств и параметров – 3.10.0.

Границы в GMSAutocompleteViewController

Указанные ниже свойства GMSAutocompleteViewController не поддерживаются:

В качестве равноценной замены используйте GMSAutocompleteViewController.autocompleteFilter с GMSAutocompleteFilter.locationBias или GMSAutocompleteFilter.locationRestriction. Для этого требуется Places SDK для iOS не ниже версии 3.8.0.

Границы в findAutocompletePredictionsFromQuery и autocompleteQuery

В качестве равноценной замены используйте findAutocompletePredictionsFromQuery:filter:sessionToken:callback с GMSAutocompleteFilter.locationBias или GMSAutocompleteFilter.locationRestriction. Для этого требуется Places SDK для iOS не ниже версии 3.8.0.

Подробную информацию об используемых вместо них методах можно найти в Приложении 1.

Используемое в Places поле GMSPlace.openNowStatus (версии 3.0.0 – 4.0.0)

Поле/свойство GMSPlace.openNowStatus в Places SDK для iOS не поддерживается, начиная с версии 3.0.0 и отключено в версии 4.0.0 и более поздних. Максимальная поддерживаемая версия для этого устаревшего поля – 3.10.0.

Вместо него используйте функции GMSPlace.isOpen или GMSPlace.isOpenAtDate. Для этого требуется Places SDK для iOS не ниже версии 3.3.0.

Используемое в Places поле permanently_closed (поддержка прекращена 26 мая 2020 г.)

Поле permanently_closed в Places API, библиотеке Places и Maps JavaScript API не поддерживается. Вместо него используйте business_status (в Places API) или business_status (в библиотеке Places, JavaScript API), чтобы получать данные о статусе компаний. Для этого требуется версия не ниже 3.40 библиотеки Places и Maps JavaScript API с business_status.

Используемые в Places поля open_now и utc_offset (поддержка прекращена 20 ноября 2019 г.)

Поля open_now и utc_offset в библиотеке Places и Maps JavaScript API не поддерживаются с 20 ноября 2019 года, их не следует использовать.

Эти поля будут недоступны только в библиотеке Places и Maps JavaScript API.

  • В запросах дополнительных данных о месте необходимо заменить поле open_now на PlaceResult.opening_hours.isOpen(). В запросах, связанных с поиском мест поблизости и текстовым поиском, используйте параметр openNow:true, чтобы находить места, которые сейчас открыты. Эквивалента для запросов поиска мест нет. Чтобы получить это значение, требуется отправить запрос дополнительных данных о месте.
  • В запросах дополнительных данных о месте необходимо заменить поле utc_offset на PlaceResult.utc_offset_minutes.

Подробнее об обновлении полей Places…

Maps JavaScript API: google.maps.event.addDomListener() и google.maps.event.addDomListenerOnce() (поддержка прекращена 7 апреля 2022 г.)

Поддержка функций [google.maps.event.addDomListener()](/maps/documentation/javascript/reference/event#event.addDomListener) и [google.maps.event.addDomListenerOnce()](/maps/documentation/javascript/reference/event#event.addDomListenerOnce) в Maps JavaScript API прекращена. Используйте вместо них стандартный метод addEventListener().

Эти методы будут работать и дальше. Планов по их отключению в настоящий момент нет.

Продукты и функции, которые уже не поддерживаются

Ниже перечислены все продукты и функции, которые были выведены из эксплуатации. Они больше недоступны.

Maps JavaScript API версии 2 (19 мая 2010 г. – 26 мая 2021 г.)

Maps JavaScript API версии 2 не используется с 26 мая 2021 года. Если на вашем сайте есть карты, которые используют эту версию, они перестанут работать и будут возвращать ошибки JavaScript. Чтобы продолжить пользоваться этими картами, перейдите на Maps JavaScript API версии 3. Подробнее об обновлении приложения с Maps JavaScript API с версии 2 до версии 3…

Используемые в Places поля reference, id, alt_id и scope (3 сентября 2019 г. – 10 августа 2020 г.)

Поля id, alt_id и scope в Places были выключены 10 августа 2020 года. Поле reference больше не поддерживается и его нельзя использовать.

  • Вместо поля ответа id теперь применяется place_id.
  • Вместо поля ответа reference, которое стало недоступным, теперь следует применять поле place_id.
  • У полей alt_id и scope нет эквивалентов, так они нужны были только для работы сервиса добавления места, который был выключен в июле 2018 года.

Подробнее об обновлении полей Places…

iOS версии 10, ARMv7 32-разрядная архитектура в Maps SDK для iOS 5.0

Начиная с версии 5.0 Maps SDK для iOS, прекращена поддержка iOS 10 и 32-разрядной архитектуры ARMv7.

Places SDK для iOS

После выпуска версии 5.0 Places SDK для iOS функция GMSCoordinateBounds была выведена из эксплуатации и заменена на GMSPlacesViewportInfo.

Слой Сводных таблиц, экспериментальная функция (3 декабря 2018 г. – 3 декабря 2019 г.)

Слой Сводных таблиц в Maps JavaScript API был выключен 3 декабря 2019 года и больше недоступен начиная с версии 3.38. Последняя версия, в которой поддерживаются Сводные таблицы, – 3.37. Подробнее…

Пакеты средств разработки Places SDK для Android и iOS (29 января 2019 г. – 29 июля 2019 г.)

С 29 января 2019 года вместо предыдущих версий используются обновленные пакеты средств разработки Places SDK для Android и iOS. Предыдущие версии Places SDK для iOS и Places SDK для Android, а также виджет выбора мест не поддерживаются с 29 января 2019 года и были выключены 29 июля 2019 года.

Функции добавления и удаления места (30 июня 2017 г. – 30 июня 2018 г.)

Функции добавления и удаления места были выключены и больше недоступны с 30 июня 2018 года.

Приложение 1. Список API, доступных в Places SDK для iOS, для замены тех, которые больше не поддерживаются

В таблице ниже указаны методы и свойства, которые необходимо использовать вместо устаревших.

Устаревший метод или свойство Вместо него используйте
setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner
(в GMSAutocompleteViewController)		 locationRestriction и locationBias
setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner
(в GMSAutocompleteResultsViewController)		 locationRestriction и locationBias
setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner
(в GMSAutocompleteTableDataSource)		 locationRestriction и locationBias
initWithBounds:filter
(в GMSAutocompleteFetcher)		 initWithFilter:
autocompleteBounds и autocompleteBoundsMode
(в GMSAutocompleteViewController)		 GMSAutocompleteViewController.autocompleteFilter с locationBias или locationRestriction
findAutocompletePredictionsFromQuery:bounds:boundsMode:filter:SessionToken:callback, autocompleteQuery:bounds:filter:callback и autocompleteQuery:bounds:boundsMode:filter:callback
(в GMSPlacesClient)		 findAutocompletePredictionsFromQuery:filter:sessionToken:callback с locationBias или locationRestriction

Для этого требуется Places SDK для iOS не ниже версии 3.8.0.