Mapfolio показывает ваши точки на интерактивной карте. Саму карту — улицы, дома, дороги и названия населённых пунктов — предоставляет сервис Яндекс Карты.
Чтобы Яндекс разрешил загрузить карту на вашем сайте, используется специальный API-ключ.
Что такое API-ключ простыми словами
API-ключ — это специальный набор символов, который позволяет Mapfolio обращаться к Яндекс Картам.
Его можно сравнить с пропуском:
- Посетитель открывает страницу вашего сайта.
- На странице запускается виджет Mapfolio.
- Mapfolio передаёт API-ключ сервису Яндекс Карт.
- Яндекс проверяет ключ.
- Если всё настроено правильно, посетитель видит карту и размещённые на ней точки.
За что отвечает Mapfolio, а за что — Яндекс Карты
Mapfolio и Яндекс Карты выполняют разные задачи.
| Mapfolio | Яндекс Карты |
|---|---|
| Хранит созданные вами точки | Показывает карту местности |
| Показывает карточки объектов | Показывает улицы, дома и дороги |
| Отображает фотографии и видео | Позволяет перемещать и масштабировать карту |
| Применяет поиск и фильтры | Загружает картографическую основу |
| Формирует виджет для установки на сайт | Проверяет API-ключ при загрузке карты |
Например, вы создали в Mapfolio точку магазина, добавили его название, адрес, фотографии и время работы.
Mapfolio отвечает за информацию о магазине. Яндекс Карты отвечают за карту, на которой будет расположен маркер этого магазина.
Что происходит без собственного API-ключа
Пока API-ключ не подключён, карта в личном кабинете может работать в демонстрационном режиме. В верхней части страницы при этом отображается сообщение:
«Карта работает в демо режиме, для установки на сайт подключите свое API Яндекс Карт».
Демонстрационный режим позволяет познакомиться с Mapfolio, создать точки и подготовить виджет.
Когда понадобится API-ключ
Собственный API-ключ понадобится перед установкой виджета Mapfolio на сайт.
Общий порядок работы выглядит так:
- Вы получаете ключ для Яндекс Карт.
- Добавляете его в Mapfolio.
- Создаёте или редактируете виджет.
- Выбираете подключённый ключ в разделе «API ключи».
- Устанавливаете код виджета на свой сайт.
- Посетители открывают сайт и видят карту с вашими точками.
Где API-ключ добавляется в Mapfolio
Для добавления ключа откройте в личном кабинете раздел «Настройки», а затем вкладку «API ключи».
На странице находится блок «API ключ Яндекс.Карты». В нём можно ввести полученный ключ и нажать кнопку «Сохранить».
Если ключ уже сохранён, рядом с ним будет доступна кнопка «Изменить».
Почему одного ключа недостаточно
При создании API-ключа на стороне Яндекса обычно указываются сайты, на которых разрешено его использовать. Такие адреса называются разрешёнными доменами.
Например, если ваш сайт открывается по адресу example.ru, этот домен должен быть разрешён в настройках ключа.
Если сайт не добавлен в ограничения ключа, виджет Mapfolio загрузится, но вместо карты может появиться сообщение «Не удалось загрузить карту».
Что API-ключ не делает
API-ключ не содержит созданные вами точки, фотографии или описания. Он также не заменяет учётную запись Mapfolio.
Ключ только разрешает загрузку карты Яндекса. Все точки и их содержимое вы продолжаете создавать и редактировать в личном кабинете Mapfolio.
Коротко о главном
API-ключ нужен, чтобы карта Яндекса могла загружаться внутри виджета Mapfolio на вашем сайте.
Запомните три основных момента:
- ключ получают для использования Яндекс Карт;
- ключ добавляют во вкладке «Настройки» → «API ключи»;
- при создании виджета ключ выбирают в разделе «API карты».
После правильного подключения посетители сайта смогут видеть карту, открывать точки и пользоваться возможностями виджета Mapfolio.