Yandex.Maps Geocoder — веб-служба, предоставляемая компанией Яндекс для преобразования адресных описаний в географические координаты и обратного геокодирования, то есть сопоставления координат с текстовыми адресами. Сервис предназначен для интеграции в картографические и навигационные приложения, веб-сайты и серверные решения, где требуется автоматизированное преобразование местоположений. В основе работы лежит обработка запросов в формате HTTP с поддержкой нескольких форматов ответа и набором параметров, позволяющих уточнять область и типы возвращаемых объектов.
Исторически Geocoder развивался как часть экосистемы картографических сервисов Яндекса и предназначался для работы совместно с набором API для отображения карт, маршрутизации и поиска POI. Документация сервиса описывает синтаксис запросов, параметры фильтрации, форматы ответа (JSON и XML) и правила использования, включая ограничения по объёму запросов и условия лицензионного применения в коммерческих и некоммерческих проектах. В тексте ниже даны ключевые функциональные возможности и типичные параметры, характерные для геокодеров этого класса.
- Преобразование адрес→координаты: поддержка прямого геокодирования по адресным строкам различной степени детализации — от страны и города до улицы и дома.
- Обратное геокодирование: получение человекочитаемого адреса или набора атрибутов объекта по заданным широте и долготе.
- Форматы ответа: экспорт результатов в JSON и XML, что облегчает интеграцию с веб- и серверными приложениями.
- Фильтрация по типам объектов: возможность ограничивать выдачу по категориям (например, транспортные объекты, административные единицы, населённые пункты, предприятия и т. д.).
- Ограничение области поиска: параметризация запроса для сужения области интереса (bounding box или радиус), повышающая релевантность результатов.
- Параметр языка: управление языком ответов и транслитерацией названий, полезно для мультиязычных интерфейсов.
- Дополнительные метаданные: возврат информации о границах административных единиц, идентификаторах объектов, почтовых индексах и других атрибутах, когда они доступны.
- Результаты с ранжированием: выдача множества кандидатов с оценкой релевантности и возможностью выбора наиболее подходящего варианта.
- Совместимость с другими API Яндекса: использование геокодированных данных совместно с картографическими и маршрутизирующими сервисами для визуализации и построения маршрутов.
- Ограничения и политика использования: приложение квот и правил доступа для предотвращения злоупотреблений; детали зависят от текущей документации и условий предоставления API.