API-ключ
Сверяем продукт, статус ключа, ограничения по домену и HTTP Referer, протокол и активированный пакет.
География и API
Не работает карта на сайте
Проверяем API-ключ, доменные ограничения, загрузку скрипта, контейнер и данные точек. Возвращаем карту, маркеры и понятный переход к маршруту.
Диагностика
От подключения API
до точки на карте
Карта зависит от внешнего сервиса и кода страницы. Мы проверяем загрузку библиотеки, право домена использовать ключ, создание контейнера и данные каждого объекта.
Скрипт
Проверяем адрес API, версию, параметры языка, порядок загрузки, CSP и ошибки в консоли.
Контейнер
Ищем нулевую высоту, скрытую вкладку, повторный id и инициализацию до появления блока в DOM.
Координаты
Сверяем широту и долготу, порядок значений, результат геокодирования и актуальность адреса.
Метки и события
Проверяем данные объектов, балуны, кластеризацию, клики, ссылки и повторную отрисовку после фильтра.
Мобильное управление
Тестируем касания, масштаб, прокрутку страницы, высоту блока и кнопку открытия маршрута в приложении.
Поиск причины
Разбираем отказ карты по шагам
Сохраните адрес страницы и текст ошибки из консоли браузера. Уточните, видят ли проблему другие посетители и появилась ли она после переноса сайта, изменения шаблона или подключения защиты. Проверяем тот же сценарий на рабочем домене.
Вкладка или окно
Если карта появляется внутри закрытой вкладки, проверяем размер блока после открытия. Для JavaScript API 2.1 при необходимости вызываем fitToViewport(). Способ исправления выбираем по версии библиотеки, а затем проверяем повторное открытие окна.
Сбой загрузки
В панели сети смотрим, какой запрос завершился ошибкой: библиотека, тайлы или данные объектов. Сверяем сообщения консоли. Блокировщик браузера, политика CSP и отказ сервиса требуют разных исправлений; замена ключа без диагностики может ничего не изменить.
Несколько филиалов
Владелец подтверждает адрес и координаты каждого офиса. Сверяем подпись, вход в здание и ссылку на маршрут. После фильтра проверяем набор маркеров и выбранную точку, чтобы посетитель не поехал к другому филиалу.
Безопасная проверка
Не публикуем ключи кабинета в переписке и не снимаем доменные ограничения ради теста. Согласуем разрешённые адреса и доступы. При внешнем отказе оставляем посетителю текстовый адрес и ссылку, по которой он сможет открыть маршрут.
Приёмка исправления
Проверка карты после выпуска
Для ошибок управления на телефоне проверьте мобильную версию. Обмен списком филиалов относится к API-интеграциям.
Какие страницы нужно проверить?
Контакты, карточку филиала и страницы с отдельным экземпляром карты. Открываем их после очистки кеша, переключаем вкладки и меняем ширину окна. Проверяем отсутствие новых ошибок в консоли.
Как проверить карту на телефоне?
Прокручиваем страницу через область карты, выбираем маркер и открываем маршрут. Проверяем закрытие балуна и возврат на сайт. Посетитель должен прочитать адрес даже при недоступности интерактивного блока.
Что подтверждает завершение задачи?
Исходный сбой не воспроизводится в согласованных браузерах, точки совпадают с подтверждёнными адресами, ссылки ведут к нужному месту. Передаём перечень изменений и отдельно отмечаем ограничения внешнего сервиса.
Результат
Карта показывает проверенные точки и не мешает странице
API загружается
Ключ и доменные ограничения соответствуют рабочему адресу, а библиотека запускается без ошибок.
Точки совпадают
Маркеры используют проверенные координаты и содержат актуальные подписи и ссылки.
Телефон управляется
Пользователь может прокрутить страницу, выбрать точку и открыть маршрут без ловушки жестов.
Порядок работ
Проверяем карту на рабочем домене
Нужен URL страницы и пример точки. Если ошибка связана с ключом, потребуется доступ к кабинету с минимальными правами или совместная проверка настроек.
Фиксируем ошибку
Смотрим консоль, запросы к API, размер контейнера и состояние ключа на боевом домене.
Проверяем данные
Сверяем адреса, координаты, маркеры, фильтры и параметры инициализации.
Исправляем подключение
Меняем ограничения ключа, порядок загрузки, контейнер или код создания объектов.
Тестируем отказ
Проверяем компьютер, телефон, несколько точек и резервную ссылку, если API недоступен.
Быстрый старт Яндекс Maps JavaScript API указывает на API-ключ, подключение скрипта, видимый контейнер ненулевого размера и инициализацию карты. Эти элементы проверяем в первую очередь.
Границы работ
Лимиты и условия задаёт картографический сервис
Мы исправляем подключение и код сайта, но не можем отменить тариф, квоту, модерацию или ограничение стороннего провайдера. Изменение ключа и его разрешённых доменов согласуем с владельцем кабинета. Если точный адрес не распознаётся, используем подтверждённые координаты. Для посетителя сохраняем текстовый адрес и обычную ссылку на маршрут, чтобы контактная информация оставалась доступной при сбое интерактивной карты.
Вопросы
Перед исправлением
Почему карта показывает пустой блок?
Проверяем ключ, загрузку API, ошибки JavaScript, CSP и ненулевой размер контейнера.
Почему карта работает локально, но не на сайте?
Частая причина связана с ограничением ключа по HTTP Referer или отличием протокола и домена.
Почему метка стоит не там?
Сверяем порядок координат, геокодирование адреса и сохранённые данные точки.
Как проверить результат?
Тестируем загрузку, метки, клики, масштаб, телефон, несколько страниц и резервную ссылку на маршрут.
Первый шаг
Пришлите страницу и пример точки
Укажите картографический сервис, домен и текст ошибки. Ключ API в заявку вставлять не нужно.