AIYA — Яндекс Карты на вашем сайте

AIYA Free размещает Яндекс Карты в магазине OpenCart для филиалов, контактов, пунктов выдачи и сервисных точек. Создавайте карты и объекты в админке, затем публикуйте модулем AIYA в макетах или тегом `{aiya_map id=N}` в HTML-контенте.

AIYA работает на вашем ключе Яндекс Maps JavaScript API. В Free нет ИИ-сервисов, ИИ-ключей и ИИ-трафика. AI Assist (BYOK + свой endpoint) доступен в отдельном пакете AIYA Pro.

Возможности (Free 0.3.21)

✅ Ключ JavaScript API Яндекс Карт и язык карты по умолчанию 
✅ Карты и объекты (метки) с координатами, балуном, телефоном, часами работы и категориями 
✅ Локатор на JS API v3 со списком объектов и поиском 
✅ Фильтры по категориям и кластеризация меток 
✅ Загрузка своей иконки метки 
✅ Экземпляры модуля в макетах (Design → Layouts) 
✅ Вставка `{aiya_map id=N}` / `{aiya_map id=N height=500px}` 
✅ Опциональная уличная панорама (по умолчанию выкл.): в балуне «Улица» / Street view открывает веб-панорамы Яндекса (deep-link; не встроенный плеер на карте) 
✅ Режимы «Конструктор» и Static API 
✅ Импорт CSV (координаты) 
✅ Меню AIYA в админке через OCMOD (Maps / Objects)
✅ Опционально «Сейчас открыто» (по умолчанию выкл.): по часам объекта; без часов или с нераспознанным расписанием точка остаётся видимой
✅ Опционально «Страна» и «Город» (по умолчанию выкл.): два списка из полей объекта; карта подстраивает обзор

Требования

[li]OpenCart 3.0+ (Twig admin) — или OpenCart 4.x для листинга OC4  [/li]
[li]PHP 7.3+ (8.x, если ваша сборка OC поддерживает)  [/li]
[li]Ключ Яндекс Maps JavaScript API с разрешённым хостом витрины в Referer

AIYA Pro (отдельное дополнение)

AIYA Pro — платное дополнение к Free. Он открывает зоны доставки, nearby, маршруты на карте, геокодер, GeoJSON/KML/KMZ и AI Assist (BYOK). Free полностью работает для базовых карт и локатора без Pro.

Установка

1. Скачайте пакет Free и загрузите через Extensions → Installer. 
2. Откройте Extensions → Modifications и нажмите Refresh. 
3. Перейдите в Extensions → Extensions → Modules, найдите AIYA — Yandex Maps on your website, нажмите Install, затем Edit. 
4. В Global settings сохраните ключ JavaScript API и включите карты на витрине. 
5. Создайте Objects и Map в меню AIYA; привяжите объекты к карте. 
6. Добавьте экземпляр модуля, выберите карту, назначьте его в Design → Layouts (или вставьте `{aiya_map id=N}` на информационную страницу).

Часто задаваемые вопросы

Использует ли Free ИИ? 
Нет. Free — только карты и локатор филиалов.

Есть ли платная версия? 
Да. AIYA Pro — отдельное платное дополнение. Free работает без него.

Нужен ли свой ключ Яндекс? 
Да. Создайте ключ в кабинете разработчика и разрешите точный хост витрины (например `https://your-shop/*`).

Внешние сервисы

При просмотре карты витрина загружает JavaScript API Яндекс Карт с серверов Яндекса. Free не обращается к ИИ-провайдерам.[/li]

Теги: Opencart, Yandex Maps, Яндекс Карты