Устаревшие

На этой странице перечислены все продукты и функции платформы Google Карт, которые в настоящее время не поддерживаются. Сюда входят продукты в разделе «Карты», «Маршруты» и «Места».

Как работает устаревание

Период устаревания продукта, функции или версии начинается с даты объявления об устаревании. Продукт, функция или версия будут по-прежнему доступны в течение всего периода устаревания (обычно 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 (устарело с версии 3.52.2)

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

Если вы заинтересованы в самостоятельном создании библиотеки локального контекста, мы предлагаем вам ознакомиться с решением «Обнаружение соседства» в 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 ). com.google.android.libraries.places:places-compat:2.6.0 ).

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

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

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

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

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

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

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

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

  • Запросы текстового поиска с пустым или отсутствующим параметром query и без параметра поддерживаемого type .
  • Запросы текстового поиска с query=* .
  • Поисковые запросы поблизости с keyword=* .
  • Поисковые запросы поблизости с name=* .
  • Найдите запросы Place с помощью input=* .

Эти неподдерживаемые запросы на поиск мест должны быть заменены одним из следующих:

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

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

    • Запросы текстового поиска с query=* .
    • Поисковые запросы поблизости с keyword=* .
    • Поисковые запросы поблизости с name=* .
    • Найдите запросы Place с помощью input=* .

Обновление политики безопасности контента (21 марта 2022 г. — май 2023 г.)

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

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

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

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

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

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

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

Служба, которая предоставляет модуль «Карты» для google.load , устарела с 13 октября 2020 г. и будет отключена 13 октября 2021 г. Последующие запросы на загрузку модуля «Карты» в google.load приведут к ошибка, и карта не загружается. Дополнительные сведения см. в Руководстве по миграции .

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

Начиная с Places SDK для iOS v4.0.0 , GMSPlaceField теперь использует макрос NS_OPTIONS вместо NS_ENUM для лучшей поддержки Swift. Подробнее о переходе на GMSPlaceField как NS_OPTIONS .

Чтобы продолжить использование GMSPlaceField как NS_ENUM , укажите v3.10.0 или более раннюю версию в ваших зависимостях .

Методы Places SDK для iOS: setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner, initWithBounds:filter (v3.10.0–v4.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 в автозаполнении места (v3.9.0 - v4.0.0)

Некоторые свойства/параметры, использующие GMSCoordinateBounds в Places SDK для службы автозаполнения iOS, устарели с версии 3.9.0 и не поддерживаются в версии 4.0.0 и выше. Максимальная поддерживаемая версия для устаревших свойств/параметров — v3.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 с этими свойствами замены — v3.8.0 .

Подробнее о методах замены см. Приложение 1 .

Поле мест GMSPlace.openNowStatus (v3.0.0 - v4.0.0)

Поле/свойство GMSPlace.openNowStatus в Places SDK для iOS устарело, начиная с версии 3.0.0 , и не поддерживается в версии 4.0.0 и выше. Максимальная поддерживаемая версия для устаревшего поля — v3.10.0 .

Вместо этого используйте функции GMSPlace.isOpen или GMSPlace.isOpenAtDate . Минимальная версия Places SDK для iOS с этими функциями замены — v3.3.0 .

Поле Places: permanently_closed (устарело 26 мая 2020 г.)

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

Поля Places open_now , utc_offset (устарело 20 ноября 2019 г.)

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

Эти поля устарели только в библиотеке Places, Maps JavaScript API.

  • Поле open_now было заменено на PlaceResult.opening_hours.isOpen() в сведениях о месте. Для поиска поблизости и текстового поиска используйте параметр запроса openNow:true для фильтрации мест, открытых в данный момент. Эквивалент для Find Place не предусмотрен . Чтобы получить это значение, вы должны сделать запрос сведений о месте.
  • Поле 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 v2 (19 мая 2010 г. – 26 мая 2021 г.)

С 26 мая 2021 г. версия 2 Maps JavaScript API более недоступна. В результате карты v2 вашего сайта перестанут работать и будут возвращать ошибки JavaScript. Чтобы продолжить использовать карты на своем сайте, перейдите на Maps JavaScript API v3. Узнайте больше об обновлении вашего приложения Maps JavaScript API с версии 2 до версии 3 .

Поля Places: reference , id , alt_id , scope (3 сентября 2019 г. – 10 августа 2020 г.)

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

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

Дополнительные сведения см. в разделе Миграция полей места .

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

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

Places SDK для iOS

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

Слой Fusion Tables (экспериментальный) (3 декабря 2018 г. – 3 декабря 2019 г.)

Слой Fusion Tables в Maps JavaScript API был отключен 3 декабря 2019 г. и больше не доступен с версии 3.38 (3.37 — последняя версия, поддерживающая Fusion Tables). Узнать больше .

Places SDK для Android и iOS (29 января 2019 г. – 29 июля 2019 г.)

С 29 января 2019 года обновленные Places SDK для Android и iOS заменили существующие версии Places SDK. Текущие версии Places SDK для iOS, Places SDK для Android и Place Picker устарели с 29 января 2019 г. и были отключены 29 июля 2019 г.

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

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

Приложение 1. Сводка Places SDK для замены устаревшего API 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 с заменяемыми свойствами — v3.8.0 .