Возвращает подсказки населённых пунктов России из собственного справочника ГАР/ФИАС в Meilisearch и признаки наличия метро и районов в справочниках поиска.
Правила:
queryобязателен как параметр- пустой
queryвозвращает пустой список queryпосле удаления пробелов по краям должен быть не длиннее 300 символовlimitнеобязателен, значение по умолчанию5, диапазон от1до20- сначала ищутся совпадения по названиям населённых пунктов: город, ПГТ, деревня, село, прочие
- только при нехватке совпадений по имени остаток лимита заполняется населёнными пунктами совпавшего региона с тем же порядком типов
- все совпадения по имени предшествуют региональному добору; дубликаты исключаются по
fias_id - для всех типов, кроме настоящих городов, оба признака всегда равны
false - ошибка поиска по имени возвращает
422 address_suggestions_failed; при сбое регионального добора сохраняется успешный результат по имени, в том числе пустой - публичный
type=city|settlementзадаёт адресный уровень для/api/search/addresses, а не один из пяти типов населённых пунктов
Security
bearerAuth or jwtCookie
- https://felmee.comhttps://felmee.com/api/search/places
- http://localhost:8080http://localhost:8080/api/search/places
curl -i -X GET \
'https://felmee.com/api/search/places?query=%D0%BC%D0%BE%D1%81%D0%BA&limit=5' \
-H 'Authorization: Bearer <YOUR_JWT_HERE>'Найденные населённые пункты
Устаревший camelCase-alias поля error_code; при ошибке оба поля содержат одинаковое значение.
Код ошибки. Для успешных ответов всегда null.
Enum:"INVALID_BODY""INVALID_DATE""invalid_body""unauthorized""not_found""slot_unavailable""conflict""BUSINESS_INACTIVE""INSUFFICIENT_FUNDS""REQUISITES_REQUIRED"
Response
{ "success": true, "message": "Place search completed successfully", "codeError": null, "error_code": null, "data": [ { … }, { … } ] }