API Геокодера

Сервис Яндекс.Карты предоставляет доступ к HTTP API Геокодера. Этот API позволяет определять координаты топонима по его адресу, или адрес точки по её координатам. Например, с помощью этого API можно определить зону доставки по введенному пользователем адресу.

В этом документе описаны основные принципы работы с API, а также приведены примеры его использования.

Как использовать геокодирование JavaScript API можно прочитать в разделе Поиск по карте документации JavaScript API.

Ограничение. Системы, которые выполняют запрос в Геокодер, должны поддерживать SNI (Server Name Indication), расширение протокола TLS.
  1. Виды геокодирования
  2. Формат ответа геокодера
  3. Начало работы

Виды геокодирования

Прямое геокодирование
Прямое геокодирование используется для определения координат по названию объекта или его адресу. API учитывает распространенные опечатки и предлагает несколько подходящих вариантов. Например, можно преобразовать указанный пользователем адрес в координаты.
Обратное геокодирование

Обратное геокодирование используется для определения адреса объекта по его координатам. Например, можно выбрать ближайший к точке на карте дом и получить его название.

Примечание. При обратном геокодировании можно выбрать интересующий тип топонима. Например, можно искать только улицы или населенные пункты.

Формат ответа геокодера

Ответ геокодера может быть сформирован в следующих форматах:

Начало работы

Чтобы начать работать с HTTP API Геокодера, получите ключ для пакета «JavaScript API и HTTP Геокодер». Формат запроса можно узнать в статье HTTP-запрос на геокодирование.

Примечание. Ключ будет активирован в течение 15 минут после получения.