Обратное геокодирование (адрес по координатам)
Находит ближайшие адреса (дома, улицы, города) по географическим координатам. Только для России.
Как вызвать
Чтобы вызвать метод, зарегистрируйтесь и подтвердите почту.
Параметры запроса
| Название | Тип | Обяз.? | По умолч. | Описание |
|---|---|---|---|---|
| lat | number | ✓ | Географическая широта | |
| lon | number | ✓ | Географическая долгота | |
| count | number | 10 | Количество результатов (максимум — 20) | |
| radius_meters | number | 100 | Радиус поиска в метрах (максимум – 1000) | |
| language | string | ru | На каком языке вернуть результат (ru / en) |
Пример запроса с ограничением по радиусу в 50 м:
Что в ответе
Адреса в ответе идут в порядке удаления от заданных координат.
У адреса обычный набор полей, но некоторые из них не заполняются:
Покрытие координат
«Дадата» берет координаты домов и улиц из OpenStreetMap.
Примеры вызова
Ограничения
Длина запроса (параметр query ) — не более 300 символов.
Количество запросов в день — в соответствии с тарифным планом.
Максимальная частота запросов — 20 в секунду с одного IP-адреса.
Максимальная частота создания новых соединений — 60 в минуту с одного IP-адреса.
Стоимость
Метод бесплатный до 10 000 запросов в день. Больше — в составе годовой подписки.
Хелпер для работы с DaData на PHP CURL
Сегодня поговорим о достаточно распространенной задаче: получение адреса, банковских данных и так далее.
Рассмотрим реальную задачу, требования: необходимо получать полную информацию о банке по введенному БИК номеру. Для реализации задачи отлично подойдет сервис DaData. Для реализации вывода подсказок в форме достаточно скопировать код с сайта DaData, поэтому на этом останавливаться не будем, а рассмотрим работу именно на бэкенде.
Для работы с DaData мы будем использовать библиотеку CURL и собственно язык программирования PHP 🙂 Сразу приведем код хэлпера для работы с сервисом:
Использовать хэлпер предельно просто:
Наша команда разрабатывает портал BXCert, а также занимается разработкой сайтов на CMS 1С-Битрикс. Все участники являются сертифицированными специалистами Bitrix.
Возможно Вам будет интересно
Комментарии
О проекте
По всем вопросам Вы можете писать на почту:
Актуальные вакансии
Мы собираем и храним информацию по всем вакансия web разработчиков и программистов PHP, Python и многих других специалистов.
Компании СТС Медиа требуется Javascript Developer в Москве
16 сентября 2021
Главный инженер по разработке требуется в Зеленограде
16 сентября 2021
API подсказок по адресам
Ищет адреса по любой части адреса от региона до дома («тверская нижний 12» → «Нижегородская обл, г Нижний Новгород, ул Тверская, д 12»). Также ищет по почтовому индексу («105568» → «г Москва, ул Магнитогорская»).
Что умеет и не умеет
✔️ Работает по всем странам мира (по России до квартиры, по Белоруссии до дома, по остальным странам — до города). Ищет и показывает результаты как на русском языке («Самара, пр-кт Металлургов»), так и на английском («Russia, gorod Samara, prospekt Metallurgov»).
✔️ Находит актуальные адреса по историческим названиям (Свердловск → Екатеринбург) и синонимам (Питер → Санкт-Петербург).
✔️ Ищет по частичному совпадению («москва болот» → «г Москва, Болотная наб»), но только в последнем слове запроса («мос болот» не найдет).
✔️ Исправляет опечатки («самара авиционная») и запросы в неправильной раскладке («vjcrdf» → «москва»).
✔️ Раскладывает выбранный адрес на гранулярные части (от региона до квартиры).
✔️ Поддерживает гранулярные подсказки по отдельным частям адреса (регионы, города, улицы, дома).
✔️ Подсказывает адреса в конкретных регионах, районах, городах и населенных пунктах. Понимает названия («Петергоф»), коды КЛАДР («7800000800000») и ФИАС («8f238984-812b-4bb1-850b-49749fb5c56d»).
✔️ Учитывает, где вы находитесь (в связке с методом город по IP-адресу).
❌ Автоматически (без участия человека) обработать адреса из базы или файла.
❌ Транслитерировать (moskva suhonskaja 11 → 127642, г Москва, ул Сухонская, д 11).
Подсказки не подходят для автоматической обработки адресов. Они предлагают варианты, но не гарантируют, что угадали правильно. Поэтому окончательное решение всегда должен принимать человек.
Для автоматической обработки и транслитерации используйте API Стандартизации
Как вызвать
Чтобы вызвать метод, зарегистрируйтесь и подтвердите почту.
Укажите при вызове:
Параметры запроса
| Название | Тип | Обяз.? | По умолч. | Описание |
|---|---|---|---|---|
| query | string | ✓ | Текст запроса | |
| count | number | 10 | Количество результатов (максимум — 20) | |
| language | string | ru | На каком языке вернуть результат (ru / en) | |
| locations | array [object] | Ограничение по родителю (страна, регион, район, город, улица) | ||
| locations_geo | array [object] | Ограничение по радиусу окружности | ||
| locations_boost | array [object] | Приоритет города при ранжировании | ||
| from_bound to_bound | object | Гранулярные подсказки по адресу |
Что в ответе
Объект с массивом подсказок в поле suggestions :
Идентификатор OpenStreetMap для Белоруссии.
Для остальных стран — не заполняется.
Если подсказка до улицы — это прошлые названия этой улицы, если до города — города.
Заполняются при выборе конкретной подсказки. До этого они пустые.
Координаты есть у 97% домов в Москве, 91% в Санкт-Петербурге, 69% в других городах-миллиониках и 47% по остальной России.
Площадь и стоимость есть у 70% квартир в России.
Коды ответа на запрос
| HTTP-код ответа | Описание |
|---|---|
| 200 | Запрос успешно обработан |
| 400 | Некорректный запрос (невалидный JSON или XML) |
| 401 | В запросе отсутствует API-ключ |
| 403 | В запросе указан несуществующий API-ключ Или не подтверждена почта Или исчерпан дневной лимит по количеству запросов |
| 405 | Запрос сделан с методом, отличным от POST |
| 413 | Слишком большая длина запроса или слишком много условий |
| 429 | Слишком много запросов в секунду или новых соединений в минуту |
| 5xx | Произошла внутренняя ошибка сервиса |
Примеры вызова
Гранулярные подсказки (отдельно регион, отдельно город, отдельно улица)
Ограничения
Для иностранных адресов заполнен ограниченный набор полей, вне зависимости от тарифного плана: почтовый индекс, страна, регион, населенный пункт, часовой пояс и геокоординаты. Прочие поля — пустые.
Количество условий в параметрах locations и locations_boost — не более 10.
Длина запроса (параметр query ) — не более 300 символов.
Количество запросов в день — в соответствии с тарифным планом.
Максимальная частота запросов — 20 в секунду с одного IP-адреса.
Максимальная частота создания новых соединений — 60 в минуту с одного IP-адреса.
Частые вопросы
По адресам
Да, есть подсказки по всем городам мира. Чтобы их включить, передайте параметр country = «*» :
Как включить подсказки на английском языке (транслитом)?
Передайте параметр language = «en» :
Как часто обновляется справочник адресов (ФИАС)?
Один раз в неделю, на выходных.
Почему индекс неправильный — не такой, как у Почты России?
Дадата работает по объединенному справочнику налоговой службы (ФИАС) и Почты России. В нем исправлены более 7 000 некорректных и отсутствующих индексов.
К сожалению, справочник индексов Почты детализирован только до населенных пунктов. Привязки к улицам и домам нет. Поэтому все-все индексы исправить не удалось.
Если получили от Дадаты неправильный индекс — отправьте адрес через специальную форму. Мы исправляем ошибки ежемесячно.
Почему подсказки не возвращают геокоординаты и район города?
Подсказки возвращают геокоординаты и район после того, как человек выбрал конкретный адрес из списка.
Почему подсказки не возвращают площадь квартиры, ближайшее метро и часовой пояс?
Эти поля возвращаются только для тарифа «Максимальный».
Почему подсказки не возвращают коды качества?
Подсказки в принципе не возвращают коды качества, потому что не занимаются разбором адресов. Для этого есть стандартизация.
Почему на картах дом есть, а в подсказках — нет?
Подсказки используют справочник адресов налоговой службы (ФИАС). В нем нет некоторых реально существующих домов и строений. К сожалению, более полной базы, чем ФИАС, просто не существует.
Чтобы добавить дом в подсказки, отправьте его через специальную форму. Мы пополняем справочник ежемесячно.
Общие
Подсказки перестанут подсказывать ツ До начала нового дня, затем снова заработают.
10 000 запросов считаются суммарно по всем видам подсказок: адреса, ФИО, организации, банки, емейлы.
Стоимость
Бесплатно до 10 тысяч запросов в день. Больше — в составе годовой подписки.
Dadata геокодирование php curl
Data cleansing, enrichment and suggestions via Dadata API
Thin PHP wrapper over Dadata API.
Create API client instance:
Then call API methods as specified below.
Same API method as «validate and cleanse»:
Show suggestions in English:
Constrain by city (Yuzhno-Sakhalinsk):
Constrain by specific geo point and radius (in Vologda city):
Boost city to top (Toliatti):
Suggest postal office by address or code:
Find postal office by code:
Find nearest postal office:
Company or individual enterpreneur
Find by INN and KPP:
Constrain by specific regions (Saint Petersburg and Leningradskaya oblast):
Constrain by active companies:
Constrain by individual entrepreneurs:
Constrain by head companies, no branches:
Search only by manager INN:
Find by SWIFT code:
Find by INN and KPP:
Find by registration number:
Suggest female first name:
Constrain by city (Saint Petersburg):
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
Make sure to add or update tests as appropriate.
Use Conventional Commits for commit messages.
API сервиса
Максимум информации по клиентам и контрагентам
Адреса
API работы с почтовыми адресами и геокоординатами.
Разбор адреса из строки («стандартизация»)
Разбивает адрес из строки по отдельным полям (регион, город, улица, дом, квартира) согласно КЛАДР/ФИАС. Определяет почтовый индекс, часовой пояс, ближайшее метро, координаты, стоимость квартиры и другую информацию об адресе.
Автодополнение при вводе («подсказки»)
Помогает человеку быстро ввести корректный адрес на веб-форме или в приложении. Для России и всего мира.
Геокодирование
Определяет координаты по адресу из строки. Заодно возвращает почтовый индекс и вообще все данные по адресу.
Обратное геокодирование
Возвращает всю информацию об адресе по координатам. Работает для домов, улиц и городов.
Город по IP-адресу
Определяет город по IP-адресу в России.
Адрес по ФИАС-коду
Возвращает всю информацию об адресе по ФИАС-коду или КЛАДР-коду.
Кадастровый номер
Находит кадастровый номер дома или квартиры по ФИАС-коду.
Ближайшее почтовое отделение
Находит точное отделение по индексу или ближайшее — по координатам.
Город в службе доставки
Определяет идентификатор города в СДЭК, Boxberry и DPD на основании КЛАДР-кода города.
Находит адрес в справочнике ФИАС по коду КЛАДР или ФИАС.
Страны
Справочник стран мира по стандарту ISO 3166.
Компании
API работы с ЕГРЮЛ и реестрами налоговой.
Организация по ИНН
Находит компанию или индивидуального предпринимателя по ИНН, КПП, ОГРН. Возвращает реквизиты компании, учредителей, руководителей, сведения о налоговой, ПФР и ФСС, финансы, лицензии, реестр МСП и другую информацию о компании.
Автодополнение при вводе («подсказки»)
Помогает человеку быстро ввести реквизиты организации на веб-форме или в приложении.
Поиск аффилированных компаний
Находит организации по ИНН учредителей и руководителей. Работает для физлиц и юрлиц.
Через API налоговой. Не гарантируем его доступность и быстродействие.
Банки
API работы со справочниками Банка России.
Банк по БИК, SWIFT, ИНН, рег. номеру
Находит банк по любому из идентификаторов: БИК, SWIFT, ИНН, ИНН + КПП (для филиалов), рег. номеру, присвоенному Банком России. Возвращает реквизиты банка, корр. счёт, адрес и статус (действующий / на ликвидации).
Автодополнение при вводе («подсказки»)
Помогает человеку быстро ввести реквизиты банка на веб-форме или в приложении.
Разбор ФИО из строки («стандартизация»)
Разбивает ФИО из строки по отдельным полям (фамилия, имя, отчество). Определяет пол и склоняет по падежам.
Автодополнение при вводе («подсказки»)
Помогает человеку быстро ввести ФИО на веб-форме или в приложении.
Телефоны
Проверить телефон
Проверяет телефон по справочнику Россвязи, определяет оператора с учётом переноса номеров, заполняет страну, город и часовой пояс.
Паспорта
API работы с паспортными данными.
Проверка по реестру МВД
Кем выдан паспорт
Через API налоговой. Не гарантируем его доступность и быстродействие.
API работы с адресами эл. почты.
Проверить email
Исправляет опечатки и проверяет на одноразовый адрес. Классифицирует адреса на личные, корпоративные и «ролевые».
Автодополнение при вводе («подсказки»)
Помогает человеку быстро ввести адрес эл. почты на веб-форме или в приложении.
Прочие справочники
Налоговые инспекции, мировые суды, марки автомобилей и другое.
Налоговые инспекции
Справочник инспекций Налоговой службы.
Таможни
Справочник таможенных органов и постов.
Мировые суды
Справочник мировых судов России.
Станции метро
Справочник станций метро в Москве, Санкт-Петербурге и других городах России.
Марки автомобилей
Справочник марок автомобилей на английском и русском языках.
Товары и услуги
Международный классификатор товаров и услуг.
ОКВЭД 2
Общероссийский классификатор видов экономической деятельности.
ОКПД 2
Общероссийский классификатор продукции по видам экономической деятельности.
ОКТМО
Общероссийский классификатор территорий муниципальных образований.
Валюты
Справочник валют по стандарту ISO 4217.
Вы можете подключить к «Дадате» собственный справочник. На бесплатном тарифе, а также тарифах «Лёгкий» и «Расширенный» он будет доступен всем остальным пользователям. На тарифе «Максимальный» можно загружать приватные справочники, скрытые от остальных.
Чтобы подключить новый справочник, напишите в службу поддержки и приложите справочник в формате CSV. Заявки проходят модерацию.
Если у вас коробочная версия — подключайте государственные, отраслевые и корпоративные справочники без модерации! Прочитайте в документации, как это сделать.
Личный кабинет
API информации из личного кабинета.
Версии справочников
Узнать, когда какой справочник обновлялся в последний раз.
Статистика использования
Проверить, не исчерпан ли лимит запросов на день.
Баланс пользователя
Не пропустить момент, когда пора пополнять.