Если вместо карты появилось пустое место или сообщение «Не удалось загрузить карту», не нужно сразу создавать новый виджет или заново добавлять точки.
Чаще всего проблема связана с одной из следующих причин:
- API-ключ не добавлен в Mapfolio;
- в виджете не выбран сохранённый ключ;
- ключ создан не для JavaScript API;
- домен сайта отсутствует в ограничениях ключа;
- новый ключ ещё не активировался;
- загрузке мешает интернет, VPN или блокировщик рекламы;
- ключ заблокирован на стороне Яндекса.
Ниже разберём проверки по порядку — от самых простых к более сложным.
Сначала определите, что именно не работает
Посмотрите, что отображается на странице с виджетом.
| Что вы видите | Что это означает | Что проверять |
|---|---|---|
| Карта не появилась, показана ошибка | Не загрузился сервис Яндекс Карт | API-ключ, домен и соединение |
| Карта появилась, но на ней нет точек | API-ключ работает | Публикацию точек, фильтры и координаты |
| Виджет вообще не появился | Не загрузился сам Mapfolio | Код установки и доступ к виджету |
| Список точек работает, а карта нет | Данные Mapfolio доступны, но карта Яндекса не загрузилась | Ключ и ограничение по домену |
| Карта работает на одном сайте, но не работает на другом | Второй домен не разрешён | HTTP Referer |
| Карта работает на компьютере, но не на телефоне | Проблема может быть в сети или браузере устройства | Интернет, VPN и блокировщики |
Шаг 1. Обновите страницу
Сначала попробуйте повторить загрузку.
- Проверьте подключение к интернету.
- Обновите страницу сайта.
- Если отображается сообщение «Не удалось загрузить карту», нажмите кнопку «Повторить».
- Подождите несколько секунд.
На мобильном устройстве вместо обычной кнопки может появиться надпись «Ошибка. Повторить». Нажмите на неё ещё раз после проверки соединения.
Шаг 2. Проверьте, сохранён ли ключ в Mapfolio
- Войдите в личный кабинет Mapfolio.
- Откройте раздел «Настройки».
- Перейдите во вкладку «API ключи».
- Найдите блок «API ключ Яндекс.Карты».
Если рядом с заполненным полем находится кнопка «Изменить», ключ сохранён.
Если поле пустое и отображается кнопка «Сохранить», ключ необходимо добавить.
Если Mapfolio не принимает ключ
Если появляется сообщение «Введите корректный API ключ Яндекс.Карт»:
- Не вводите ключ вручную.
- Откройте Кабинет разработчика Яндекса.
- Скопируйте полное значение ключа.
- Вернитесь в Mapfolio.
- Нажмите «Изменить».
- Вставьте скопированный ключ.
- Нажмите «Сохранить».
Убедитесь, что вместо ключа не вставлено его название.
Шаг 3. Проверьте выбор ключа в виджете
Сохранённый ключ должен быть связан с виджетом.
- Откройте раздел «Виджеты».
- Выберите нужный виджет.
- Перейдите к разделу «2. API карты».
- Откройте список подключённых API.
- Выберите «Яндекс карты #1».
- Сохраните настройки виджета.
- Обновите страницу сайта.
Шаг 4. Проверьте ключ в Кабинете разработчика Яндекса
- Откройте Кабинет разработчика Яндекса.
- Войдите в учётную запись, на которой создавался ключ.
- Найдите подключённый продукт JavaScript API.
- Откройте список ключей.
- Найдите ключ, добавленный в Mapfolio.
- Убедитесь, что ключ не удалён и не заблокирован.
- Проверьте, что он привязан именно к JavaScript API.
Mapfolio загружает JavaScript API 3.0. Для него нужен ключ от соответствующего продукта Яндекс Карт.
Как проверить, что сравниваются одинаковые ключи
- В Кабинете разработчика скопируйте значение нужного ключа.
- В Mapfolio откройте «Настройки» → «API ключи».
- Нажмите «Изменить».
- Сравните сохранённое значение со скопированным ключом.
- Если значения отличаются, вставьте правильный ключ.
- Нажмите «Сохранить».
Шаг 5. Проверьте домен в HTTP Referer
Для JavaScript API 3.0 в настройках ключа должно быть заполнено ограничение по HTTP Referer.
- Откройте ключ в Кабинете разработчика.
- Нажмите «Изменить».
- Найдите ограничения ключа.
- Выберите ограничение по домену или HTTP Referer.
- Проверьте список разрешённых доменов.
- Добавьте домен страницы с виджетом.
- Сохраните изменения.
Яндекс требует заполнить HTTP Referer для ключей JavaScript API 3.0: подключение JavaScript API.
Какой домен нужно проверить
При ошибке Mapfolio показывает домен, с которого пытается загрузиться карта.
Например:
«Возможно, домен example.ru не добавлен в ограничения API-ключа Яндекс Карт».
В этом случае откройте ограничения ключа и убедитесь, что там есть:
example.ru
Если в сообщении указан lk.mapfolio.ru, добавьте его для работы предварительного просмотра в личном кабинете.
Проверьте формат домена
Домен вводится без протокола и адреса отдельной страницы.
Правильно:
example.ru
Неправильно:
- https://example.ru;
- example.ru/catalog;
- example.ru:443;
- example.ru/?map=1.
Домены указываются по одному в строке. Подробные правила приведены в официальной инструкции Яндекса.
| Где открывается карта | Что добавить в HTTP Referer |
|---|---|
| https://example.ru/map | example.ru |
| https://www.example.ru/catalog | example.ru |
| https://project.tilda.ws | project.tilda.ws |
| Предпросмотр сообщает об ошибке для lk.mapfolio.ru | lk.mapfolio.ru |
| Карта используется на двух разных сайтах | Оба домена, каждый с новой строки |
Шаг 6. Подождите применения настроек
Новый ключ и изменения ограничений начинают работать не мгновенно.
После создания ключа или добавления домена:
- Подождите до 15 минут.
- Откройте страницу с картой.
- Нажмите Ctrl + F5.
- Если ошибка осталась, нажмите «Повторить».
Яндекс указывает, что активация ключа и применение ограничений могут занимать до 15 минут.
Шаг 7. Проверьте браузер и интернет
Если настройки выглядят правильно, проверьте загрузку в другом окружении.
- Откройте страницу в другом браузере.
- Попробуйте открыть её в режиме инкогнито.
- Временно отключите VPN.
- Временно отключите блокировщик рекламы.
- Проверьте карту через другую сеть, например мобильный интернет.
- Откройте страницу на другом устройстве.
Некоторые расширения браузера, антивирусы и сетевые фильтры могут блокировать загрузку файлов с адреса Яндекс Карт.
Карта работает в Mapfolio, но не работает на сайте
Если предварительный просмотр работает, а опубликованная карта не загружается:
- Откройте страницу сайта с виджетом.
- Посмотрите, какой домен указан в ошибке.
- Добавьте этот домен в HTTP Referer ключа.
- Проверьте, что домен введён без https:// и пути.
- Подождите до 15 минут.
- Обновите страницу сайта.
Обычно это означает, что для ключа разрешён домен Mapfolio, но не разрешён домен вашего сайта.
Карта работает на сайте, но не работает в предпросмотре
Если карта работает у посетителей сайта, но не отображается в личном кабинете:
- Посмотрите домен в сообщении об ошибке.
- Если указан lk.mapfolio.ru, добавьте его в HTTP Referer.
- Не удаляйте из ограничений домен своего сайта.
- Сохраните изменения.
- Подождите до 15 минут.
- Обновите предварительный просмотр.
Карта загружается, но точки не видны
Если картографическая основа появилась, API-ключ работает. Проверьте сами точки:
- Убедитесь, что точки опубликованы.
- Проверьте, не скрыты ли они.
- Сбросьте фильтры виджета.
- Очистите строку поиска.
- Проверьте адрес и положение точки.
- Убедитесь, что маркер находится в видимой области карты.
- Проверьте лимит опубликованных точек.
На мобильном устройстве появилась надпись «Ошибка. Повторить»
На телефоне карта может загружаться только после нажатия кнопки открытия.
Если появилась надпись «Ошибка. Повторить»:
- Проверьте мобильный интернет или Wi-Fi.
- Отключите VPN.
- Закройте полноэкранный режим карты.
- Откройте карту повторно.
- Если появилась подробная ошибка, запишите указанный домен.
- Проверьте этот домен в HTTP Referer.
При этом список точек и карточки могут продолжать работать.
Быстрая последовательность проверки
Проверяйте настройки именно в таком порядке:
- Обновите страницу и нажмите «Повторить».
- Убедитесь, что ключ сохранён в Mapfolio.
- Проверьте выбор ключа в разделе «2. API карты».
- Убедитесь, что ключ создан для JavaScript API.
- Проверьте, что ключ не заблокирован.
- Добавьте домен из сообщения об ошибке в HTTP Referer.
- Подождите до 15 минут.
- Откройте страницу в другом браузере.
- Отключите VPN и блокировщик рекламы.
- Проверьте карту на другом устройстве.
Частые проблемы и решения
| Проблема | Возможная причина | Решение |
|---|---|---|
| «Не удалось загрузить карту» | Домен отсутствует в HTTP Referer | Добавьте домен из сообщения |
| «Введите корректный API ключ» | Неправильный формат ключа | Скопируйте ключ заново |
| Ключ сохранён, но карта не работает | Ключ создан не для JavaScript API | Проверьте подключённый продукт |
| Карта перестала работать после замены ключа | Новый ключ не настроен или не активирован | Проверьте ключ и подождите 15 минут |
| Карта работает только на одном сайте | Разрешён только один домен | Добавьте остальные домены |
| Карта работает только в одном браузере | Расширение блокирует Яндекс Карты | Отключите блокировщик или проверьте инкогнито |
| Карта есть, маркеров нет | Проблема не связана с ключом | Проверьте точки и фильтры |
| Виджет полностью отсутствует | Не загружается Mapfolio | Проверьте код установки виджета |
| На телефоне «Ошибка. Повторить» | Не загрузился API Яндекса | Проверьте сеть, ключ и домен |
| Настройки только что изменены | Они ещё не применились | Подождите до 15 минут |
Если ничего не помогло
Если все проверки выполнены, обратитесь в поддержку Mapfolio по адресу support@mapfolio.ru.
В сообщении укажите:
- адрес страницы с виджетом;
- точное время появления ошибки;
- текст сообщения;
- домен, показанный в ошибке;
- модель устройства;
- название браузера;
- работает ли карта в другом браузере;
- работает ли список точек;
- скриншот ошибки;
- какие проверки уже выполнены.
Итоговая проверка
Карта должна загрузиться, если:
- API-ключ сохранён в Mapfolio;
- ключ выбран для нужного виджета;
- он создан для JavaScript API;
- ключ активен и не заблокирован;
- в HTTP Referer указан правильный домен;
- после настройки прошло до 15 минут;
- браузер не блокирует Яндекс Карты;
- устройство подключено к интернету.
После исправления причины обновите страницу и нажмите кнопку «Повторить».