SkillFoxx
Telegram

Скилл по Яндекс Картам JS API v3

yandex-maps-v3

Справочник и рецепты для Яндекс Карт JS API v3: маркеры, кластеризация, поиск, геокодер и React/Next.js паттерн без ошибок с порядком координат

  • 1 ★ репозитория
  • Последний коммит
Скилл

Минимальный доступ

Почему такой уровень

  • Только справочный материал, не выполняет запросы и не меняет данные
Все причины и проверки
Российский стек

ulugbekeshnazarov409/yandex-maps-v3Автор:ulugbekeshnazarov409

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/yandex-maps-v3

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Минимальный доступИнструмент ничего не запускает и не ходит в сеть.

  • Только справочный материал, не выполняет запросы и не меняет данные

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Скилл собирает справочник по Яндекс Картам JavaScript API v3 (ymaps3): загрузка скрипта и ключ, порядок координат долгота-широта, который отличается от Leaflet и Google, классы YMap, слои и источники данных, маркеры, контролы, события YMapListener, подсказки и попапы, кластеризатор @yandex/ymaps3-clusterer, темы и геолокация, а также React и Next.js паттерн reactify с безопасным для SSR динамическим импортом. Отдельный файл покрывает смежные HTTP API: Geosuggest для автодополнения адреса, Геокодер в обе стороны, поиск мест и построение маршрутов, у каждого свой ключ. Есть материалы про полигоны и линии маршрутов, перетаскиваемые маркеры, подгрузку маркеров по видимой области и миграцию с v2 на v3.

Для кого. Для фронтенд-разработчиков, которые встраивают Яндекс Карты в веб, React или Next.js приложение.

Подходит, если

  • Нужно быстро подключить карту с маркерами, попапами или кластеризацией
  • Карта показывает не то место: скорее всего перепутан порядок координат
  • Нужен рецепт для React или Next.js App Router с корректным SSR-безопасным импортом

Не подходит, если

  • Проект использует Яндекс Карты API v2: справочник целиком про v3 и ymaps3
  • Нужна помощь не с картами, а с другими продуктами Яндекса: скилл узко про JS API карт и смежные HTTP API поиска и маршрутов

Пример запроса к агенту

Добавь на карту Next.js приложения маркеры с попапом и кластеризацией для списка точек

Ограничения

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

Как отключить. Удалите папку скилла из .claude/skills или аналогичного каталога агента.

Частые вопросы

Почему карта показывает неправильное место?

Скорее всего перепутан порядок координат, v3 использует [долгота, широта] везде, в отличие от Leaflet и Google с [широта, долгота].

Нужен ли один ключ на все возможности?

Нет, у HTTP API поиска, геокодера и маршрутов свои отдельные ключи, помимо ключа JS API карты.

Обсуждение

Вопросов и отзывов пока нет.

Яндекс Карты — все инструменты
Российский стек

Скилл аудита локального SEO для рынка СНГ: карточки в Google Business Profile, Яндекс Бизнесе, Яндекс Картах, 2ГИС и их согласованность

СкиллРасширенный доступ3
Российский стек

MCP-сервер для Яндекс Карт: прямое и обратное геокодирование и отрисовка статической карты с метками

MCP-серверРасширенный доступ17
Российский стек

Монорепозиторий MCP-серверов для Яндекса: Директ, Метрика, Вебмастер, Wordstat, Трекер, 360, Карты, SpeechKit, YandexGPT и AppMetrica

MCP-серверШирокий доступ14
Российский стек

MCP-сервер для предпроектного анализа участков: границы Росреестра, геокодирование и карты Яндекса, инфраструктура и геометрия

MCP-серверРасширенный доступ4
Российский стек

MCP-сервер сводит воедино три источника транспорта: Мосгортранс, РНИС Подмосковья и Яндекс Транспорт, со сверкой прогнозов прибытия

MCP-серверРасширенный доступ

Коротко о README

Короткий README описывает скилл как полный справочник и руководство по интеграции Яндекс Карт JS API v3 для веб, React и Next.js. Перечислены темы покрытия: загрузчик и ключ, порядок координат, YMap и слои, маркеры, контролы, события, подсказки, кластеризатор, темы, геолокация и паттерн reactify. Дана структура файлов: SKILL.md как точка входа и папка reference с api.md, packages.md, recipes.md и search-geocode-routing.md. Установка одной командой npx skills add.

Бейдж для README

Исходный SKILL.md

---
name: yandex-maps-v3
description: >-
  Complete reference and integration guide for the Yandex Maps JavaScript API
  v3 (ymaps3), script loader and API key, the [longitude, latitude] coordinate
  order, YMap / layers / data sources, markers (custom DOM + YMapDefaultMarker),
  controls (zoom, geolocation, buttons, YMapOpenMapsButton), YMapListener events,
  hints and popups, the @yandex/ymaps3-clusterer marker clusterer, themes
  (dark/light), geolocation, behaviors, and the React/Next.js reactify pattern
  (App Router, SSR-safe dynamic import). Also covers the separate HTTP API
  products, Geosuggest (address autocomplete), Geocoder (forward and reverse),
  Places/POI search, and Routing (build and draw routes), plus YMapFeature
  polygons/polylines, draggable markers, viewport-based marker loading at scale,
  satellite/raster layers, scheme customization, and v2 to v3 migration.
---

# Yandex Maps JavaScript API v3 (ymaps3)

The modern (v3) Yandex Maps web SDK. Vector-first, promise-based, modular
(extra features loaded via ymaps3.import('@yandex/...')), with a first-class
React wrapper (reactify).

THE #1 GOTCHA: Yandex v3 uses [longitude, latitude] order
everywhere (center, coordinates, bounds). This is the OPPOSITE of
Leaflet/Google ([lat, lng]). Mixing them puts Tashkent in the ocean.
Toshkent center = [69.2797, 41.3111].

For exhaustive detail load the bundled references:
- reference/api.md, every class/type with props.
- reference/recipes.md, copy-paste Next.js App Router patterns.
- reference/packages.md, importable @yandex/* modules.
- reference/search-geocode-routing.md, the separate HTTP APIs.

## 1. API key

Get a "JavaScript API and Geocoder" key at
https://developer.tech.yandex.com/ (or developer.tech.yandex.ru).

Activation takes up to 15 minutes.

Сообщить о проблеме