После смены API-ключа карта может исчезнуть, показать серый блок или перестать искать адреса. При этом сам сайт открывается нормально.

Нужно проверить, какой картографический сервис используется, какие API включены, какие домены разрешены, есть ли лимиты и что пишет консоль браузера.

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

Почему возникает проблема

Проблема появляется при смене владельца проекта, домена, кабинета карт, тарифного плана или после ограничения ключа по HTTP referrer.

Что проверить в первую очередь

  • правильный API-ключ
  • разрешенные домены
  • включенные сервисы карты и геокодинга
  • лимиты и billing
  • ошибки JavaScript в консоли

Как я решаю такую задачу

Я проверяю карту от загрузки скрипта до выбора адреса или точки на карте.

  • смотрю ошибку в браузере
  • проверяю настройки ключа
  • сверяю домены и протокол HTTPS
  • исправляю код подключения карты
  • тестирую поиск адреса и отображение точек

Что подготовить

  • адрес страницы с картой
  • какой сервис используется
  • доступ к кабинету API
  • новый и старый ключ при наличии
  • описание, что именно не работает

Сроки и риски

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

Чего лучше не делать

Не вставляйте API-ключ из чужого проекта. Он может перестать работать, попасть под лимиты или нарушать настройки безопасности.

FAQ

Почему карта работает локально, но не на сайте?

Обычно из-за ограничений домена или разных ключей для окружений.

Нужно включать billing?

Для некоторых сервисов и лимитов это требуется.

Можно скрыть ключ?

Ключ frontend-карт обычно виден в браузере, поэтому его ограничивают доменом.

Что делать с адресными подсказками?

Нужно проверить отдельный API подсказок или геокодинга, а не только карту.

Нужна похожая задача?

Напишите в Telegram @rabotator_support или оставьте заявку на сайте. Пришлите ссылку на проект, коротко опишите проблему и укажите, какие доступы уже есть. Я посмотрю задачу, предложу безопасный план и скажу, с чего лучше начать.

Итог

Рабочая карта должна загружаться на нужном домене, использовать корректный ключ и стабильно выполнять свои функции: точки, адреса, геокодинг или доставку.