Обзор
В целях повышения безопасности и надежности аутентификации, идентификаторы клиентов Maps Platform устарели с 26 мая 2025 года и не могут быть использованы после 31 мая 2026 года.
Вместо идентификатора клиента для аутентификации трафика сервиса Google Maps API необходимо использовать учетные данные API-ключа. В этом руководстве показано, как перейти от использования идентификаторов клиента к использованию API-ключей.
Для начала выполните следующие шаги:
- Проверьте текущее использование идентификаторов клиентов.
- Подготовка API-ключей
- Проверка настроек квоты
- Обновите свой код
- Отслеживайте трафик по идентификаторам клиентов.
- Приостановите работу вашего идентификатора клиента.
Проверить текущее использование идентификаторов клиентов
Перед началом процесса миграции составьте список следующих пунктов:
- Сервисы картографической платформы, которые вы используете со своим идентификатором клиента.
- Приложения, сайты или системы, в которых вы используете свой идентификатор клиента.
Компания Google разослала уведомление по электронной почте затронутым клиентам о прекращении поддержки идентификаторов клиентов в мае 2025 года. Вы также можете найти эту информацию в уведомлении по электронной почте.
В консоли Cloud Console вы можете проверить актуальное состояние использования вашего идентификатора клиента на странице метрик Google Maps.
Список сервисов картографической платформы можно найти здесь :
- Откройте страницу «Метрики» в консоли Cloud.
- Отфильтруйте использование, используя следующие настройки:
- Учетные данные: Выберите только "номер_проекта:<числовой идентификатор>".
- Установите следующий фильтр.
- Сгруппировано по: API
Подсказки о приложениях, сайтах или системах :
В консоли Cloud Console не отображаются подробные сведения о ваших приложениях, сайтах или системах. Однако вы можете найти некоторые подсказки об источниках трафика с вашими идентификаторами клиентов. Выполните следующие шаги:
- Откройте страницу «Метрики» в консоли Cloud.
- Выберите сервис картографической платформы из выпадающего списка.
- Отфильтруйте использование, используя следующие настройки:
- Учетные данные: Выберите только "номер_проекта:<числовой идентификатор>".
- Установите следующий фильтр.
- Группировка по: платформе или домену
- Повторите шаги, начиная с шага 2, для каждого сервиса платформы карт, для которого необходимо проверить дорожную ситуацию.
Подготовка ключей API
Все идентификаторы клиентов связаны с проектом Google Cloud, и использование ключа API из этого проекта предоставит вам доступ к тем же функциям, к которым вы ранее имели доступ с помощью своего идентификатора клиента. Мы рекомендуем перейти на связанный проект, чтобы избежать проблем с квотами или отсутствием функций.
- Найдите облачный проект, к которому привязан ваш идентификатор клиента:
- Убедитесь, что ваш облачный проект связан с открытым платежным аккаунтом .
- Создайте новый ключ API для миграции идентификаторов клиентов.
- В облачном проекте можно повторно использовать любые существующие ключи API.
- Вы можете использовать несколько ключей API из одного и того же облачного проекта, например, для разделения трафика для каждой службы картографической платформы или для разделения трафика с разных платформ (браузер, мобильное приложение и т. д.). Рекомендации по управлению ключами API см. в руководстве по безопасности .
Защитите свой API-ключ
Обязательно защитите свой API-ключ, чтобы предотвратить несанкционированный доступ.
- Установите ограничения для вашего API-ключа (например, веб-сайты, IP-адреса, приложения для Android или iOS).
- Установите ограничения API для вашего ключа API.
Более подробную информацию можно найти в руководстве по безопасности платформы Google Maps .
Для API карт JavaScript, статического API карт и статического API просмотра улиц вы можете перенести доверенные источники переходов, указанные в вашем клиентском идентификаторе, на ограничения, связанные с ключом API. Список доверенных источников переходов можно найти в консоли Cloud.
Проверка настроек квоты
Убедитесь, что в вашем облачном проекте установлены необходимые параметры квотирования. Это необходимо сделать только в том случае, если вы вызываете клиентские сервисы Maps JavaScript API с определенного идентификатора клиента. Проверить и изменить настройки квот можно на странице квот Google Maps .
Узнайте больше об отчетах по квотам.
Увеличение квоты на клиентские сервисы Maps JavaScript API
Если вы используете следующие сервисы в Maps JavaScript API, после миграции ключа API вы заметите увеличение использования квоты.
Проверьте текущие настройки квот, текущий объем использования и скорректируйте лимиты квот соответствующим образом .
- Проверьте, используете ли вы клиентские сервисы Maps JavaScript API с идентификатором клиента.
- Откройте страницу «Метрики» в консоли Cloud.
- Отфильтруйте использование, используя следующие настройки:
- Сгруппировано по: методу API
- Учетные данные: Выберите только "номер_проекта:<числовой идентификатор>".
- Затем вы увидите список названий методов и объем трафика, передаваемого по API, на диаграмме "Трафик по методам API".
Метод API | Сервис на стороне клиента | Услуга по корректировке квоты |
google.routes.Directions.Javascript | Служба навигации | API для построения маршрутов |
google.routes.DistanceMatrix.Javascript | Служба матрицы расстояний | API матрицы расстояний |
google.maps.Elevation.Javascript | Служба лифтов | API для определения высоты |
google.places.Geocoding.Javascript | Сервис геокодирования | API геокодирования |
google.places.*.Javascript, кроме google.places.Geocoding.Javascript | Библиотека "Места" | API мест |
- Если вы не используете эти методы API, вам не нужно беспокоиться о настройках квот, поскольку трафик с вашими идентификаторами клиентов уже израсходован на квоту вашего проекта.
- Оцените использование квоты на идентификаторы клиентов.
- Для каждой из служб проверьте детализацию как посекундно, так и посуточно.
- График в секунду: умножьте пиковый трафик на 60, чтобы определить дополнительные потребности в квоте в минуту.
- График за день: пиковый трафик должен соответствовать дополнительной суточной потребности в квотах.
- Настройте свою квоту в соответствующих сервисах картографической платформы.
- Исходя из названия метода, найденного на шаге 1, отрегулируйте квоту для соответствующих сервисов.
Обновите свой код
Замените параметр клиента на ключевой параметр.
В исходящих вызовах API GMP обновите учетные данные аутентификации с URL&client={value} на URL&key={value} . Если ваши приложения используют HTTP для доступа к сервисам GMP, обновите их до HTTPS.
Обновите параметр канала для формирования отчетов.
Вы можете отслеживать использование каналов, указывая параметр `channel` в своих API-запросах. API-ключи поддерживают только числовые значения для параметра `channel`. Если вы используете свой Client ID с нечисловыми значениями для параметра `channel`, обновите его до числового значения, которое поддерживается.
Дополнительную информацию см. в разделе «Отчетность по платформе Google Maps» .
Удалите параметр подписи для веб-сервисов.
Для следующих API веб-сервисов параметр подписи не требуется при обращении к ним с помощью ключа API. Удаляйте параметр подписи только из ваших запросов к API.
- API для построения маршрутов (устаревшая версия)
- API матрицы расстояний (устаревшая версия)
- API геокодирования
- API для определения высоты
- API часовых поясов
Для получения более подробной информации см. Обзор тарифного плана Premium .
Секретный ключ для подписи API обработки изображений
Статический API карт и статический API просмотра улиц по-прежнему требуют параметра подписи. В целях тестирования они принимают небольшое количество запросов без подписи, но в рабочей среде начинают выдавать ошибки, как только их количество достигает порогового значения. Замените секретный ключ подписи, используемый для идентификатора клиента, на секретный ключ для ключа API. Вы можете использовать тот же алгоритм подписи, но вам потребуется использовать другой секретный ключ подписи. Для получения дополнительной информации см. раздел «Использование цифровой подписи» .
Отслеживайте трафик по идентификаторам клиентов.
После развертывания подтвердите успешную миграцию трафика с помощью панелей мониторинга Cloud Console . Вы заметите снижение трафика по идентификаторам клиентов, которое отображается в формате "project_number:123456" на панели мониторинга при группировке по учетным данным.
Приостановите работу вашего идентификатора клиента.
Мы настоятельно рекомендуем разработчикам приостановить использование клиентских идентификаторов после миграции. Это необходимо для защиты ваших учетных данных от непреднамеренного трафика и для подтверждения того, что оставшееся использование вашего клиентского идентификатора не является критически важным (например, тестирование, кэширование, боты и т. д.) и может приводить к ошибкам без ущерба для бизнеса. Вы можете приостановить использование своего клиентского идентификатора в консоли Cloud. Дополнительные сведения см. в разделе «Обзор аутентификации в тарифном плане Premium» .
Поиск неисправностей
Как мы можем узнать, успешно ли выполняется наш запрос или нет?
Статистику ошибок можно посмотреть на графиках кодов ответов.
Ошибка ApiNotActivatedMapError или REQUEST_DENIED
Если вы не включили службу в своем облачном проекте, вы увидите ошибку ApiNotActivatedMapError или REQUEST_DENIED . Следуйте инструкциям, чтобы включить службу .
Ошибка RefererNotAllowedMapError
Если ваш исходный домен не добавлен в ваш API-ключ, вы увидите ошибку RefererNotAllowedMapError. Проверьте раздел «Защитите свой API-ключ» и добавьте свой домен в API-ключ.
Ошибка OverQuotaMapError или OVER_QUERY_LIMIT
Если установленной вами квоты недостаточно для покрытия трафика, вы увидите ошибку OverQuotaMapError или OVER_QUERY_LIMIT . Проверьте раздел «Проверка настроек квоты» и скорректируйте квоту соответствующим образом.
Ошибка "Запросы к этому API должны обрабатываться по протоколу SSL"
Если вы получили следующее сообщение об ошибке, обновите ваши API-запросы с "http://" на "https://".
{
"error_message" : "Requests to this API must be over SSL. Load the API with
\"https://\" instead of \"http://\".",
"results" : [],
"status" : "REQUEST_DENIED"
}