Карты, координаты и маршруты
Для сайта с адресами рекомендуем карту на открытых данных и независимую резервную карту. Все показанные координаты можно выделить и скопировать. Рядом с адресом доступны ссылки на маршрут в Яндекс Картах, 2ГИС и Google Maps — даже если обе карты не загрузились.
Плохо
Карточка места
Карта: единственный внешний виджет → ошибка загрузки.
Адрес и координаты: доступны только внутри виджета.
Копирование: координаты нарисованы на изображении.
Маршрут: одна кнопка, требующая установленного приложения.
Результат: посетитель не может узнать, куда ехать.
Хорошо
Карточка места
Карта: открытые данные → независимый резерв при отказе.
Адрес и координаты: обычный текст вне карты, виден сразу.
Копирование: широта и долгота текстом + «Скопировать координаты».
Маршрут: Яндекс Карты · 2ГИС · Google Maps, обычные HTTPS-ссылки.
Результат: даже без карт можно скопировать точку и открыть маршрут.
Почему это важно
Доступность библиотеки, картографических данных и сервера тайлов — разные вещи. Открытый код и открытые данные дают возможность сменить поставщика, но не обещают бесперебойную работу внешней инфраструктуры. Независимый резерв уменьшает последствия отказа; текст и ссылки сохраняют основное действие посетителя.
Координаты точнее неоднозначного названия. Для офисов, магазинов, гостиниц, пунктов выдачи и мест встречи важно указать нужный вход или подъезд. Три сервиса маршрутов позволяют посетителю выбрать доступный и привычный вариант в РФ.
Когда применять
Страницы контактов, филиалы, недвижимость, объекты каталога, туристические маршруты, мероприятия, точки выдачи и административные интерфейсы с географическими данными. Если карта не помогает задаче, достаточно адреса, копируемых координат и ссылок маршрутов. Неизвестные координаты не подменяют фиктивной точкой.
Открытый стек и резерв — рекомендация справочника, а не требование российского закона. Если проект принимает это правило, ниже приведены его критерии приемки. Закрытый SDK допустим при обоснованной потребности; текст, координаты и внешние ссылки всё равно сохраняются при его отказе.
Основная карта и fallback
- Предпочтительный вариант: данные OpenStreetMap и открытая библиотека, например MapLibre GL JS. MapLibre отображает карту; источники тайлов, стили, шрифты и спрайты настраиваются отдельно.
- Основной и резервный источники используют открытые данные и независимую инфраструктуру. Подходящий пример — собственные OSM-тайлы и второй поставщик OSM-тайлов с разрешенным использованием. Два домена одного сервера или два SDK с общим недоступным CDN не образуют независимый резерв.
- Показывайте атрибуцию данных и соблюдайте лицензии обоих источников. Публичный
tile.openstreetmap.orgработает без SLA: он не является безлимитным production-резервом. Соблюдайте его политику, HTTP-кеширование и запрет массового скачивания для офлайн-режима. Для офлайн-карт выбирайте инфраструктуру, разрешающую такую загрузку. - Задайте конечный срок начальной загрузки. При устойчивом отказе критических ресурсов переключайтесь на резерв; одна ошибка необязательного тайла не должна запускать переключение всей карты. Ограничьте попытки, прекратите загрузку старого экземпляра и избегайте бесконечного переключения туда-обратно.
- Сохраните выбранный объект, координаты центра, масштаб и метки. Дайте кнопку «Другая карта» и понятную возможность повторить загрузку. Если резерв тоже недоступен, покажите сообщение и оставьте адрес, координаты и маршруты рабочими.
- Адрес и ссылки рендерятся без ожидания SDK; сбой карты не блокирует страницу. Проверьте ограничения CSP и доступность тайлов, стилей, шрифтов и спрайтов из целевых сетей РФ. Само слово «открытая» не гарантирует региональную доступность.
Координаты и копирование
- Любые отображаемые координаты — в карточке, списке, popup карты или выбранной точке — доступны как выделяемый текст. Изображение, canvas и tooltip без текстового дубля недостаточны.
- Подпишите систему и порядок: «WGS84: широта, долгота». Для копирования используйте десятичные градусы с точкой в качестве десятичного разделителя. Кнопка копирует всю пару; при необходимости отдельные значения можно выделить вручную.
- Храните именованные
latitudeиlongitude. Проверяйте конечность чисел и диапазоны[-90, 90]/[-180, 180]; ноль является допустимым значением. Не меняйте исходную точность из-за округления текста на экране. - Не путайте порядок: примеры
rtextЯндекса иdestinationGoogle принимают широту, долготу;points2ГИС — долготу, широту. Преобразование делается отдельно для каждого формата. navigator.clipboard.writeText()требует безопасного контекста и может завершиться отказом. Сообщайте «Скопировано» только после успеха. При отказе оставляйте выделение текста или полеreadonlyи подсказку ручного копирования. Кнопка работает с клавиатуры; результат объявляется черезaria-live.
Маршруты для РФ
- Рядом с адресом размещаются три подписанные обычные ссылки: «Маршрут в Яндекс Картах», «Маршрут в 2ГИС», «Маршрут в Google Maps». Это переход к построению маршрута с заданной точкой назначения, а не только к поиску или маркеру.
- Используйте HTTPS-ссылки с веб-вариантом, а не только схемы
yandexmaps://илиdgis://. Возможность открыть сайт сохраняется без установленного приложения. Отказ одного сервиса не скрывает остальные варианты. - Передавайте проверенную точку входа, парковки или встречи. Если это разные места, подпишите их отдельно. Для пешего участка или тропы не обещайте автомобильный подъезд.
- Не запрашивайте геолокацию ради показа адреса. Начало маршрута можно оставить незаданным: сервис предложит определить его или ввести вручную. Отказ в геолокации не блокирует выбор маршрута. Собственный запрос местоположения запускается явным действием пользователя и учитывает разрешение браузера.
- Доступность сервиса, покрытие маршрутов и открытие приложения проверяются для целевых устройств и регионов; их нельзя гарантировать одним корректным URL. Google Maps URLs не требуют API-ключа. У 2ГИС используйте актуальный формат
directions/points, а не помеченный устаревшимrouteSearch.
Кто что делает
Человек
Выбирает поставщиков и проверяет их условия, независимость и покрытие в нужных регионах РФ. Подтверждает точные входы, парковки и места встречи; проверяет реальные маршруты и исключения для труднодоступных объектов.
AI-агент
Разделяет карту и текстовые действия, реализует ограниченное переключение, проверяет порядок координат и формирование ссылок. Проверяет отказы загрузки и копирования; указывает, какие устройства и сети проверены фактически, и не выдает корректность URL за проверенный путь на местности.
Пример применения
В карточке филиала адрес и координаты показываются до загрузки карты. Рядом — кнопка копирования и три ссылки маршрутов. Каждая ссылка получает реальные координаты выбранного филиала из его записи. Если основная карта не отвечает, подключается резервная; если не работает и она, текстовые данные и действия остаются доступны.
Как проверить у себя
- Отключите основной источник, затем оба источника и SDK. Проверьте переключение, сохранение точки и масштаба, ограниченность попыток, сообщение об отказе и работу адреса, копирования и ссылок без карты.
- Проверьте каждое место, где показаны координаты, включая popup: выделение, успешное копирование, отказ Clipboard, ручное копирование, Tab/Enter и сообщение для скринридера.
- Проверьте нулевые и отрицательные значения, границы диапазонов, пропущенные значения, строки,
NaNиInfinity. Пара после копирования и все три назначения должны соответствовать одной исходной точке; перестановка двух допустимых чисел требует проверки на карте, одной валидации диапазонов недостаточно. - Откройте три ссылки в браузере компьютера и на телефонах с установленными приложениями и без них. Убедитесь, что выбрано нужное назначение и доступен ввод начала маршрута при запрещенной геолокации.
- Проверьте доступность из целевых сетей РФ, реальные входы и подходы, экраны 320–390 px, атрибуцию, кеширование и условия обоих поставщиков. Зафиксируйте устройства, сети, дату и ограничения проверки; HTTP 200 не подтверждает правильность маршрута.
Первоисточники
- OpenStreetMap Foundation: Tile Usage Policy.
- OpenStreetMap: copyright, лицензия данных и атрибуция.
- MapLibre GL JS: открытая библиотека отображения карт.
- MDN: Clipboard.writeText(), безопасный контекст и ошибки.
- W3C Geolocation: координаты WGS84 и разрешение пользователя.
- Команда API Яндекс Карт: ссылка на маршрут к заданной точке.
- 2ГИС: HTTPS deeplink и актуальный формат directions/points.
- Google Maps URLs: направления, координаты и api=1.
Дата проверки отражает содержательную сверку. Синхронизация сайта не обновляет её автоматически.