1. Tiles API
  2. Routing API
  3. TSP API
  4. DistanceMatrix API
  5. Isochrones API
  6. LBS API
  7. GeoSuggest API
  8. JS API

API Геосаджеста

Сервис GeoSuggest API позволяет быстро вводить и проверять адреса и названия организаций, «подсказывает» названия городов, улиц и номера домов, чтобы уменьшить количество ошибок пользователей в этих сведениях.
  • Авторизация
  • Ограничения
  • Запрос GET /geocode – геокодирование
  • Параметры запроса (GeocodeRequest)
  • Ответы (GeocodeResponse)
  • Запрос GET /textSearch – текстовый поиск
  • Параметры запроса (TextSearchRequest)
  • Ответы (TextSearchResponse)
  • Запрос GET/addressSearch – адресный поиск
  • Параметры запроса (AddressSearchRequest)
  • Ответы (AddressSearchResponse)
  • Запрос GET/findNearest – поиск ближайших объектов
  • Ответы (FindNearestResponse)
  • Типы данных для API Геосаджеста
  • Примеры использования
 НАЗАД

Возможны два варианта авторизации:

  1. ключ API указывается в качестве значения параметра t в строке запроса
  2. ключ API указывается в качестве значения параметра Api-Key заголовка запроса.

Ограничения устанавливаются для ключа: максимальное количество запросов в минуту, в день.

Позволяет узнать координаты объекта по его адресу (прямое геокодирование) либо в обратную сторону — узнать адрес объекта по его кординатам (обратное геокодирование). Для геокодирования нужно отправить GET-запрос /geocode

URL: https://webmapapi.navitel.ru/api/v1/geocode?q={q}&l={l}&lon={lon}&lat={lat}&ofs={ofs}&lim={lim}&sco={sco}
Параметр Описание Обязательно/
Опционально		 Тип
данных		 Формат
данных
q Строка для поиска — адрес либо координаты, не менее 3-х символов required string
l Код языка, например: ru_RU required string
lon Координаты точки в пространстве, относительно близости к которой будут выдаваться наиболее релевантные результаты поиска, долгота optional number double
lat Координаты точки в пространстве, относительно близости к которой будут выдаваться наиболее релевантные результаты поиска, широта optional number double
ofs Порядковый номер элемента, с которого требуется начать выдавать результат поиска.
Значение по умолчанию: 0		 optional integer
lim Максимальное количество элементов в выданном результате поиска.
Значение по умолчанию: 100		 optional integer
sco Порядок координат для обратного геокодирования:
longlat – сначала долгота;
latlong – сначала широта.
Значение по умолчанию: longlat		 optional string
enum:
[longlat, latlong]
Код
ответа		 Параметр Тип
данных		 Описание
200 map_object array [MapObject] – см. Типы данных для API Геосаджеста Ответ на верный запрос геокодирования: список объектов
400 Недопустимый аргумент
401 Ключ API отсутствует или недействителен
403 Истёк срок действия ключа API, превышены пределы поиска
500 Внутренняя ошибка сервера

Для текстового поиска нужно отправить GET-запрос /textSearch.

URL: https://webmapapi.navitel.ru/api/v1/textSearch?s={s}&l={l}&lon={lon}&lat={lat}&ofs={ofs}&lim={lim}
Параметр Описание Обязательно/
Опционально		 Тип
данных		 Формат
данных
s Поисковый запрос, не менее 3-х символов required string  
l Код языка, например: ru_RU required string  
lon Координаты точки в пространстве, относительно близости к которой будут выдаваться наиболее релевантные результаты поиска, долгота required number double
lat Координаты точки в пространстве, относительно близости к которой будут выдаваться наиболее релевантные результаты поиска, широта required number double
ofs Порядковый номер элемента, с которого требуется начать выдавать результат поиска.
Значение по умолчанию: 0		 optional integer  
lim Максимальное количество элементов в выданном результате поиска.
Значение по умолчанию : 100		 optional integer  
Код
ответа		 Параметр Тип
данных		 Описание
200 mapObjects array [MapObject] – см. Типы данных для API Геосаджеста Ответ на верный запрос в текстовом поиске: список объектов
400     Недопустимый аргумент
401     Ключ API отсутствует или недействителен
403     Истёк срок действия ключа API, превышены пределы поиска
404     Объект не найден

Для адресного поиска нужно отправить GET-запрос/addressSearch.

URL: https://webmapapi.navitel.ru/api/v1/addressSearch?label={label}&country={country}&region={region}&parish={parish}&city={city}&district={district}&street={street}&number={number}&zip={zip}&l={l}&lon={lon}&lat={lat}&ofs={ofs}&lim={lim}
Параметр Описание Обязательно/
Опционально		 Тип данных Формат
данных
label Подпись к объекту на карте – поисковый запрос optional string  
country Страна – поисковый запрос optional string  
region Субъект федерации (например, область, край и пр.) – поисковый запрос optional string  
parish Район (республики, автономного округа, области, края и пр.) – поисковый запрос optional string  
city Город – поисковый запрос optional string  
district Район (городской), населённый пункт, входящий в агломерацию – поисковый запрос optional string  
street Улица – поисковый запрос optional string  
number Номер здания, дома и пр. – поисковый запрос optional string  
zip Почтовый индекс optional string  
l Код языка, например: ru_RU required string  
lon Координаты точки в пространстве, относительно близости к которой будут выдаваться наиболее релевантные результаты поиска, долгота required number double
lat Координаты точки в пространстве, относительно близости к которой будут выдаваться наиболее релевантные результаты поиска, широта required number double
ofs Порядковый номер элемента, с которого требуется начать выдавать результат поиска.
Значение по умолчанию: 0		 optional integer  
lim Максимальное количество элементов в выданном результате поиска.
Значение по умолчанию : 100		 optional integer  
Код
ответа		 Параметр Тип
данных		 Описание
200 mapObjects array [MapObject] – см. Типы данных для API Геосаджеста Ответ на верный запрос в текстовом поиске: список объектов
400     Недопустимый аргумент
401     Ключ API отсутствует или недействителен
403     Истёк срок действия ключа API, превышены пределы поиска
404     Объект не найден

Для поиска ближайших объектов нужно отправить GET-запрос/findNearest.

URL: https://webmapapi.navitel.ru/api/v1/findNearest?lon={lon}&lat={lat}&l={l}

Параметры запроса (FindNearestRequest)

Параметр Описание Обязательно/
Опционально		 Тип
данных		 Формат
данных
lon Координаты точки в пространстве, относительно которой происходит поиск ближайших объектов, долгота required number double
lat Координаты точки в пространстве, относительно которой происходит поиск ближайших объектов, широта required number double
l Код языка, например: ru_RU required string  
Код
ответа		 Параметр Тип
данных		 Описание
200 mapObjects array [MapObject] – см. Типы данных для API Геосаджеста Ответ на верный запрос в текстовом поиске: ближайший объект
400     Недопустимый аргумент
401     Ключ API отсутствует или недействителен
403     Истёк срок действия ключа API, превышены пределы поиска
404     Объект не найден

MapObject – объект на карте

Параметр Описание Обязательно/
Опционально		 Тип
данных		 Формат
данных
coordinates Объект на карте optional array [Coordinates]  
address Адреса объектов на карте optional array [Address]  
label Подпись объекта на карте optional string  

Сoordinates – координаты точки

Параметр Описание Обязательно/
Опционально		 Тип
данных		 Формат
данных
longitude Долгота required number double
latitude Широта required number double

Address – адреса

Параметр Описание Обязательно/
Опционально		 Тип
данных		 Формат
данных
country Страна optional string  
region Субъект федерации (например, область, край и пр.) optional string  
parish Район (республики, автономного округа, области, края и пр.) optional string  
city Город optional string  
district Район (городской), населённый пункт, входящий в агломерацию optional string  
street Улица optional string  
building Здание, дом optional string  

Запрос GET/geocode прямое геокодирование

https://webmapapi.navitel.ru/api/v1/geocode?q= Кузнецкий Мост улица, 17с2 Москва,1&l=ru_RU&ofs=0&lim=100&t=YOUR_API_KEY

Ответ на запрос GET/geocode

Запрос GET/geocode обратное геокодирование

https://webmapapi.navitel.ru/api/v1/geocode?q=55.810395%2C%2037.593668&l=ru_RU&ofs=0&lim=100&sco=latlong&t=YOUR_API_KEY

Ответ на запрос GET/geocode

Запрос GET/textSearch

https://webmapapi.navitel.ru/api/v1/textSearch?s=Театр&l=ru_RU&lon=37.607465&lat=55.752532&ofs=0&lim=3&t=YOUR_API_KEY

Ответ на запрос GET/textSearch

Запрос GET/addressSearch

https://webmapapi.navitel.ru/api/v1/addressSearch?label=гостиница&street=Поварская&l=ru_RU&lon=37.622413&lat=55.772318&ofs=3&lim=2&t=YOUR_API_KEY

Ответ на запрос GET/addressSearch

Запрос GET /findNearest

https://webmapapi.navitel.ru/api/v1/findNearest?lon=37.464038&lat=55.808733&l=ru_RU&t=YOUR_API_KEY

Ответ на запрос GET /findNearest
  1. Tiles API
  2. Routing API
  3. TSP API
  4. DistanceMatrix API
  5. Isochrones API
  6. LBS API
  7. GeoSuggest API
  8. JS API

GeoSuggest API

The service allows you to quickly enter and check addresses and names of organizations, and “suggests” the names of cities, streets and house numbers in order to reduce the number of user errors in this information.
  • Authorization
  • Limits
  • Request GET /geocode – geocode
  • Request parameters (GeocodeRequest)
  • Responses (GeocodeResponse)
  • Request GET /textSearch – text search
  • Request body parameters (TextSearchRequest)
  • Responses (TextSearchResponse)
  • Request GET /addressSearch – address search
  • Request parameters (AddressSearchRequest)
  • Responses (AddressSearchResponse)
  • Request GET /findNearest — search for nearby objects
  • Request Parameters (FindNearestRequest)
  • Responses (FindNearestResponse)
  • Data types for GeoSuggest API
  • Examples
 BACK

There are two possible authorization options:

  1. the API key is specified as the value of the t parameter in the query string;
  2. the API key is specified as the value of the Api-Key parameter of the request header.

Limits are set for the key: the maximum number of requests per minute, per day.

Allows you to find the coordinates of an object by its address (forward geocoding) or, conversely, find the address of an object by its coordinates (reverse geocoding). To perform geocoding, you need to send a GET request to /geocode.

URL: https://webmapapi.navitel.ru/api/v1/geocode?q={q}&l={l}&lon={lon}&lat={lat}&ofs={ofs}&lim={lim}&sco={sco}
Parameter Description Required/
Optional		 Data
type		 Data
Format
q A search string — an address or coordinates — at least 3 characters long required string
l Language code, for example: ru_RU required string
lon Coordinates of the point in space, relative to the proximity to which the most relevant search results will be displayed, longitude optional number double
lat Coordinates of the point in space, relative to the proximity to which the most relevant search results will be displayed, latitude optional number double
ofs The ordinal number of the element from which you want to start producing the search result.
Default value: 0		 optional integer
lim The maximum number of items in the returned search result.
Default value: 100		 optional integer
sco Coordinate order for reverse geocoding:
longlat – longitude first;
latlong – latitude first.
Default value: longlat		 optional string
enum:
[longlat, latlong]
Response
Code		 Parameter Data
type		 Description
200 map_object Array [MapObject] — See Data types for Geosuggest API Answer to the correct geocoding query: list of objects
400 Invalid argument
401 The API key is missing or invalid
403 API key has expired, search limits exceeded
500 Internal server error

For text search, you need to send a GET request /textSearch.

URL: https://webmapapi.navitel.ru/api/v1/textSearch?s={s}&l={l}&lon={lon}&lat={lat}&ofs={ofs}&lim={lim}

Parameter Description Required/
Optional		 Data
type		 Data
Format
s Search pattern – a search query of at least 3 characters required string  
l Language code, for example: ru_RU required string  
lon Coordinates of the point in space, relative to the proximity to which the most relevant search results will be displayed, longitude required number double
lat Coordinates of the point in space, relative to the proximity to which the most relevant search results will be displayed, latitude required number double
ofs The ordinal number of the element from which you want to start producing the search result.
Default value: 0		 optional integer  
lim The maximum number of items in the returned search result.
Default value: 100		 optional integer  
Response
Code		 Parameter Data
type		 Description
200 mapObjects Array [MapObject] — please refer to the Data Types below Answer to the correct text search query: list of objects
400     Invalid argument
401     The API key is missing or invalid
403     API key has expired, search limits exceeded
404     Object not found

To perform an address search, you need to send a GET request /addressSearch.

URL: https://webmapapi.navitel.ru/api/v1/addressSearch?label={label}&country={country}®ion={region}&parish={parish}&city={city}&district={district}&street={street}&number={number}&zip={zip}&l={l}&lon={lon}&lat={lat}&ofs={ofs}&lim={lim}
Parameter Description Required/
Optional		 Data
type		 Data
Format
label The caption for the object on the map – request pattern (search request) optional string  
country Country – request pattern (search request) optional string  
region A federal subject (for example, a region, a region, etc.) – request pattern (search request) optional string  
parish District (republic, autonomous okrug, region, territory, etc.) – request pattern (search request) optional string  
city City – request pattern (search request) optional string  
district District (urban), settlement included in the agglomeration - request pattern (search request) optional string  
street Street – request pattern (search request) optional string  
number Number of the building, house, etc. – request pattern (search request) optional string  
zip Postcode optional string  
l Language code, for example: ru_RU required string  
lon Coordinates of the point in space, relative to the proximity to which the most relevant search results will be displayed, longitude required number double
lat Coordinates of the point in space, relative to the proximity to which the most relevant search results will be displayed, latitude required number double
ofs The ordinal number of the element from which you want to start producing the search result.
Default value: 0		 optional integer  
lim The maximum number of items in the returned search result.
Default value: 100		 optional integer  
Response
Code		 Parameter Data
type		 Description
200 mapObjects Array [MapObject] — please refer to Data types for GeoSuggest API Answer to the correct text search query: list of objects
400     Invalid argument
401     The API key is missing or invalid
403     API key has expired, search limits exceeded
404     Object not found

To search for nearby objects, you need to send a GET request /findNearest.

URL: https://webmapapi.navitel.ru/api/v1/findNearest?lon={lon}&lat={lat}&l={l}
Parameter Description Required/
Optional		 Data
type		 Data
Format
lon Coordinates of the point in space, relative to the proximity to which the most relevant search results will be displayed, longitude required number double
lat Coordinates of the point in space, relative to the proximity to which the most relevant search results will be displayed, latitude required number double
l Language code, such as: ru_RU required string  
Response
Code		 Parameter Data
type		 Description
200 mapObjects object {MapObject} – please refer to the Data Types below The response to the correct request in a text search is: the nearest object
400     Invalid argument
401     The API key is either missing or not valid
403     The API key has expired; the search limits have been exceeded
404     Object not found

MapObject – object on the map

Parameter Description Required/
Optional		 Data
type		 Data
Format
coordinates Object on the map optional array [Coordinates]  
address Addresses of objects on the map optional array [Address]  
label Caption of the object on the map optional string  

Сoordinates – point coordinates

Parameter Description Required/
Optional		 Data
type		 Data
Format
longitude Longitude required number double
latitude Latitude required number double

Address – address of the object on the map

Parameter Description Required/
Optional		 Data
type		 Data
Format
country Country optional string  
region Subject of the Federation (e.g., region, province, etc.) optional string  
parish District (of a Republic, Autonomous District, Region, Territory, etc.) optional string  
city City optional string  
district Urban District or Settlement within an Agglomeration optional string  
street Street optional string  
building Building, house optional string  

Request GET /textSearch

https://webmapapi.navitel.ru/api/v1/textSearch?s=Teatr&l=en_US&lon=37.607465&lat=55.752532&ofs=0&lim=2&t= YOUR_API_KEY

Response to the request GET /textSearch

Request GET /addressSearch

https://webmapapi.navitel.ru/api/v1/addressSearch?label=hotel&street=Povarskaya&l=en_EN&lon=37.622413&lat=55.772318&ofs=1&lim=2&t=YOUR_API_KEY

Response to the request GET /addressSearch

Request GET /findNearest

https://webmapapi.navitel.ru/api/v1/findNearest?lon=37.464038&lat=55.808733&l=en_EN&t=YOUR_API_KEY

Response to the request GET /findNearest

Search & sitemap

Privacy policy

© JSC “CNT” 2026