Карта не загружается

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

Сначала определите, где именно возникла проблема:

• на опубликованном сайте;
• в предпросмотре виджета;
• при создании или редактировании точки;
• только в одном браузере или на всех устройствах.

При ошибке загрузки виджет показывает сообщение:

«Не удалось загрузить карту»

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

Найдите название домена внутри сообщения об ошибке.

Например:

Именно этот адрес должен быть разрешён в настройках API-ключа Яндекс Карт.

1. Войдите в личный кабинет Mapfolio.
2. Откройте раздел «Настройки».
3. Перейдите на вкладку «API-ключи».
4. Найдите блок «API ключ Яндекс.Карты».
5. Убедитесь, что ключ сохранён.
6. Если поле пустое, вставьте API-ключ.
7. Нажмите «Сохранить».
8. Вернитесь к виджету.

Mapfolio позволяет выбрать API-ключ для конкретного виджета. Если ключ удалили или заменили, виджет может остаться без подходящего подключения.

1. Откройте раздел «Виджеты».
2. Нажмите на карточку проблемного виджета.
3. Найдите поле выбора API-ключа Яндекс Карт.
4. Откройте список.
5. Выберите сохранённый ключ.
6. Сохраните виджет.
7. Откройте опубликованную страницу.
8. Нажмите «Повторить» в сообщении об ошибке или обновите страницу.

Даже правильный API-ключ не заработает, если в его настройках запрещён домен опубликованного сайта.

1. Войдите в кабинет разработчика Яндекса.
2. Откройте используемый API-ключ.
3. Найдите ограничения по доменам или источникам запросов.
4. Сравните их с адресом из сообщения Mapfolio.
5. Добавьте домен опубликованного сайта.
6. Сохраните настройки ключа.
7. Подождите применения изменений.
8. Вернитесь на сайт.
9. Нажмите кнопку «Повторить».
10. Если карта не появилась, обновите страницу без кеша.

Ключ должен разрешать работу JavaScript API Яндекс Карт. Наличие ключа для другого сервиса Яндекса не гарантирует загрузку карты.

Проверьте, что ключ был создан для нужного картографического API, а не для Метрики, Директа или другого продукта.

У виджета и API-ключа могут быть отдельные ограничения по доменам.

Это две независимые проверки:

• ограничения API-ключа контролирует Яндекс;
• разрешённые домены виджета контролирует Mapfolio.

Проверьте список разрешённых доменов виджета.

Домен указывайте без:

• https://;
• пути страницы;
• параметров после ?;
• лишних пробелов.

Например, для страницы https://example.ru/contacts доменом будет example.ru.

Отключённый или удалённый виджет не передаёт данные на сайт.

1. Откройте раздел «Виджеты».
2. Найдите нужную карточку.
3. Проверьте, нет ли отметки «Отключён».
4. Нажмите на карточку.
5. При необходимости включите виджет.
6. Сохраните изменения.
7. Обновите опубликованную страницу.

Если не отображается не только карта, но и весь интерфейс Mapfolio, проверьте установочный код.

Он должен содержать:

• контейнер виджета;
• токен виджета;
• подключение JavaScript Mapfolio.

• Скопированы обе строки.
• Токен не изменён.
• Сохранены кавычки и скобки.
• Адрес файла Mapfolio указан полностью.
• Код вставлен в HTML-блок.
• Страница опубликована.
• Код не преобразовался в обычный текст.
• На странице нет двух повреждённых копий одного виджета.

Если на одной странице установлено несколько виджетов Mapfolio, для них рекомендуется использовать один и тот же API-ключ.

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

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

1. Откройте главную страницу Mapfolio.
2. Проверьте, есть ли опубликованные точки.
3. Убедитесь, что нужные точки не скрыты.
4. Проверьте координаты.
5. Сбросьте поиск.
6. Сбросьте все фильтры.
7. Уменьшите масштаб карты.
8. Сохраните изменённые точки.
9. Обновите страницу с виджетом.

Карту могут блокировать расширения браузера, настройки конфиденциальности или старые сохранённые файлы страницы.

1. Откройте страницу в режиме инкогнито.
2. Проверьте её в другом браузере.
3. Временно отключите блокировщик рекламы для сайта.
4. Разрешите JavaScript.
5. Обновите страницу без кеша.
6. Проверьте сайт на другом устройстве.
7. Попробуйте другое интернет-соединение.

Сторонние плагины и настройки сайта могут запрещать загрузку файлов Яндекс Карт или Mapfolio.

На время проверки обратите внимание на:

• плагины кеширования;
• объединение и отложенную загрузку JavaScript;
• блокировку сторонних скриптов;
• настройки Content Security Policy;
• баннер согласия на cookie;
• защитные плагины WordPress;
• проксирование через CDN;
• ручные правила в шаблоне сайта.

Конструктор может не запускать сторонние скрипты во время редактирования.

Это часто происходит в HTML-блоках Tilda, WordPress и других платформ.

1. Сохраните страницу.
2. Опубликуйте изменения.
3. Откройте страницу по обычному адресу.
4. Проверьте виджет вне редактора.
5. Если опубликованная карта работает, установка выполнена правильно.

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

Если карта не работает только при создании или редактировании точки:

1. Обновите страницу.
2. Проверьте другой браузер.
3. Отключите блокировщик рекламы.
4. Проверьте интернет-соединение.
5. Убедитесь, что другие страницы Mapfolio открываются.
6. Повторите попытку позже.
7. Если проблема сохраняется, обратитесь в поддержку.

После исправления API-ключа или ограничения домена не нужно переустанавливать виджет.

1. Вернитесь на страницу с ошибкой.
2. Нажмите кнопку «Повторить».
3. Дождитесь загрузки.
4. Если сообщение осталось, обновите страницу.
5. Подождите несколько минут после изменения ключа.
6. Повторите проверку в режиме инкогнито.

Если проблема не решилась, подготовьте:

• адрес страницы;
• название виджета;
• домен из сообщения об ошибке;
• снимок экрана;
• название браузера;
• информацию о том, работает ли карта на телефоне;
• описание последних изменений;
• время возникновения ошибки.

1. Опубликуйте страницу.
2. Определите, отсутствует вся карта или только точки.
3. Запишите домен из сообщения об ошибке.
4. Проверьте API-ключ в настройках Mapfolio.
5. Проверьте ключ, выбранный в виджете.
6. Добавьте домен в ограничения ключа Яндекса.
7. Проверьте разрешённые домены виджета.
8. Убедитесь, что виджет включён.
9. Проверьте установочный код.
10. Нажмите «Повторить».
11. Обновите страницу без кеша.
12. Проверьте другой браузер и устройство.
13. Если карта есть, но точек нет, проверьте публикацию точек.
14. Если проблема сохраняется, обратитесь в поддержку.