5 км к северо-востоку от Казанского КремляДокументация
Как писать запросы и как сервис их обрабатывает
Краткий справочник по пространственным операциям, маршрутам, областям неопределенности, экспорту, API и ограничениям системы.
Запросы
Пишите так, как описали бы место человеку
Лучшие запросы содержат опорный объект, расстояние, направление или отношение между объектами. Если топоним неоднозначен, добавляйте город, район или соседний ориентир.
Середина между Осиново и ЮдиноТочка в трети пути от Зеленодольска до Казани15 км по направлению к Иннополису от центра КазаниФункции
Поддерживаемые пространственные операции
LLM-парсер превращает текст в цепочку функций, а геодвижок выполняет их детерминированно.
Список функций адаптируется под ширину экрана; на широких экранах он показан таблицей.
| Функция | Назначение | Пример |
|---|---|---|
| Locate | Найти объект по названию | Казанский Кремль |
| Relative | Смещение от точки по направлению и расстоянию | 5 км на северо-восток |
| Azimuth | Смещение по углу в градусах | 10 км по азимуту 45 |
| Between | Точка между двумя объектами | между Осиново и Юдино |
| Fraction | Доля пути между объектами | треть пути от А до Б |
| Toward | Движение от объекта в сторону цели | к Иннополису от Казани |
| Along | Точка вдоль маршрута или линии | по дороге от А до Б |
| Near / Inside | Окрестность или попадание внутрь области | рядом с озером, внутри района |
| Intersection | Пересечение улиц или геометрий | перекресток улиц |
| StreetTurn | Поворот или движение по улицам | от улицы направо через 500 м |
Примеры
Готовые формулировки по Казани и рядом
Эти запросы можно вставлять в демо без изменений. Они покрывают основные типы операций и неоднозначные топонимы.
Как строятся дороги
Если включено построение маршрута по дорогам, сервис запрашивает картографические данные. Если маршрут недоступен, будет показано предупреждение и прямая линия между точками.
Что значит круг
Область неопределенности показывает предполагаемую ошибку. Она зависит от типа операции, качества геокодинга и точности входной фразы.
Источник карты
Базовая подложка берется из OpenStreetMap. Геокодинг, маршруты и доп. данные могут использовать внешние сервисы.
Экспорт
GeoJSON удобен для веб-карт, KML для Google Earth и части GIS, GPX для треков и навигационных инструментов.
API
Интеграция с внутренними системами
Сайт использует внутренний программный интерфейс для расчета, истории и сохранений. Внешний API-доступ для интеграций предоставляется по отдельному запросу.
Внешний API пока не опубликован.
Для интеграции нужно согласовать сценарий,
формат входных данных, требования к доступу
и способ передачи результата.Ограничения
Что важно проверять вручную
Геоконтекст помогает ускорять разбор текстовых описаний, но результат зависит от внешних данных и качества исходной фразы.
Неоднозначные названия могут иметь несколько вариантов в разных регионах.
Внешние сервисы геокодинга и маршрутизации могут не отвечать или отдавать неполные данные.
Сервис не предназначен для критической навигации без проверки специалистом.
Для публичной эксплуатации нужны актуальные юридические документы и процедуры обработки данных.