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