{"id":20163933,"url":"https://github.com/movemoveapp/laravel-dadata","last_synced_at":"2025-07-14T06:08:37.305Z","repository":{"id":41851172,"uuid":"300023319","full_name":"movemoveapp/laravel-dadata","owner":"movemoveapp","description":"PHP SDK Laravel пакет работы с сервисом DaData.ru, для исправления синтаксических ошибок в информации контактных данных клиентов сайта и вывода подсказок поля форм.","archived":false,"fork":false,"pushed_at":"2023-10-24T15:33:01.000Z","size":149,"stargazers_count":45,"open_issues_count":16,"forks_count":31,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-07-09T17:12:49.210Z","etag":null,"topics":["dadata","laravel","laravel-package","movemove","movemoveapp","php","sdk-php"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/movemoveapp.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-09-30T18:47:58.000Z","updated_at":"2025-04-25T13:47:05.000Z","dependencies_parsed_at":"2024-06-21T14:14:39.725Z","dependency_job_id":null,"html_url":"https://github.com/movemoveapp/laravel-dadata","commit_stats":{"total_commits":52,"total_committers":1,"mean_commits":52.0,"dds":0.0,"last_synced_commit":"090e5d9d6561d75fe605a183e3801df77b8b83eb"},"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/movemoveapp/laravel-dadata","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/movemoveapp%2Flaravel-dadata","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/movemoveapp%2Flaravel-dadata/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/movemoveapp%2Flaravel-dadata/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/movemoveapp%2Flaravel-dadata/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/movemoveapp","download_url":"https://codeload.github.com/movemoveapp/laravel-dadata/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/movemoveapp%2Flaravel-dadata/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265251105,"owners_count":23734869,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dadata","laravel","laravel-package","movemove","movemoveapp","php","sdk-php"],"created_at":"2024-11-14T00:32:33.737Z","updated_at":"2025-07-14T06:08:37.280Z","avatar_url":"https://github.com/movemoveapp.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# \u003ca href=\"https://movemoveapp.com\" target=\"_blank\"\u003e\u003cimg src=\"https://avatars2.githubusercontent.com/u/69967331?s=20\u0026v=4\" width=\"20\"\u003e\u003c/a\u003e DaData Laravel SDK Package\n[![Build Status](https://app.travis-ci.com/movemoveapp/laravel-dadata.svg?branch=master)](https://app.travis-ci.com/movemoveapp/laravel-dadata)\n[![Latest Stable Version](https://poser.pugx.org/movemoveapp/laravel-dadata/v)](//packagist.org/packages/movemoveapp/laravel-dadata)\n[![Total Downloads](https://poser.pugx.org/movemoveapp/laravel-dadata/downloads)](//packagist.org/packages/movemoveapp/laravel-dadata)\n[![License](https://poser.pugx.org/movemoveapp/laravel-dadata/license)](//packagist.org/packages/movemoveapp/laravel-dadata)\n\n*DaData Laravel Package* - PHP SDK [Laravel](https://github.com/laravel/laravel) пакет для взаимодействия с API [DaData.ru](https://dadata.ru/) от [MoveMoveApp](https://movemoveapp.com/)\n\n## Требования\n- Версии PHP: 7.3, 7.4, 8.0, 8.1\n- Версии Laravel: 7.x, 8.x, 9.x\n- Версии Guzzle\": 7.0, 7.2\n\n## Установка\nВы можете установить пакет через composer:\n\n```shell script\ncomposer require movemoveapp/laravel-dadata\n```\n\nЕсли вы используете версию Laravel ниже **5.5**, то зарегистрируйте `DaDataServiceProvider` вручную, добавив в `config/app.php`в массиве `providers`:\n\n```shell script\n'providers' =\u003e [\n // ...\n MoveMoveIo\\DaData\\DaDataServiceProvider::class,\n],\n\n``` \n\nПубликация конфигурационного файла. Выполните `artisan` команду\n\n```shell script\nphp artisan vendor:publish --provider=\"MoveMoveIo\\DaData\\DaDataServiceProvider\"\n```\n\nНастройка проекта осществляется через `.env` вашего проекта. Вам необходимо указать три параметра\n- `DADATA_TOKEN` - token для раоты с API DaData\n- `DADATA_SECRET` - secret для работы с API DaData\n- `DADATA_TIMEOUT` - максимальное время ожидания ответа от API сервисов DaData в секундах. По умолчанию это значение равно 10 секунд.\n\nПример `.env`\n\n```php\nDADATA_TOKEN=\"c32c33ebaf450067d64516fbe041d2a8a6d4211f\"\nDADATA_SECRET=\"adccd63ac28701442e26b7eef57eb5eb0a72143e\"\nDADATA_TIMEOUT=10\n```\n\n## Методы\n\n- **Работа с адресами**\n - [Стандартизация адреса](https://github.com/movemoveapp/laravel-dadata#%D1%81%D1%82%D0%B0%D0%BD%D0%B4%D0%B0%D1%80%D1%82%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D1%8F-%D0%B0%D0%B4%D1%80%D0%B5%D1%81%D0%B0)\n - [Подсказки по адресам](https://github.com/movemoveapp/laravel-dadata#%D0%BF%D0%BE%D0%B4%D1%81%D0%BA%D0%B0%D0%B7%D0%BA%D0%B8-%D0%BF%D0%BE-%D0%B0%D0%B4%D1%80%D0%B5%D1%81%D0%B0%D0%BC)\n - [Определение адреса по координатам](https://github.com/movemoveapp/laravel-dadata#%D0%BE%D0%BF%D1%80%D0%B5%D0%B4%D0%B5%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5-%D0%B0%D0%B4%D1%80%D0%B5%D1%81%D0%B0-%D0%BF%D0%BE-%D0%BA%D0%BE%D0%BE%D1%80%D0%B4%D0%B8%D0%BD%D0%B0%D1%82%D0%B0%D0%BC)\n - [Определение адреса по IP](https://github.com/movemoveapp/laravel-dadata#%D0%BE%D0%BF%D1%80%D0%B5%D0%B4%D0%B5%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5-%D0%B0%D0%B4%D1%80%D0%B5%D1%81%D0%B0-%D0%BF%D0%BE-ip)\n - [Определение адреса по КЛАДР или ФИАС коду](https://github.com/movemoveapp/laravel-dadata#%D0%BE%D0%BF%D1%80%D0%B5%D0%B4%D0%B5%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5-%D0%B0%D0%B4%D1%80%D0%B5%D1%81%D0%B0-%D0%BF%D0%BE-%D0%BA%D0%BB%D0%B0%D0%B4%D1%80-%D0%B8%D0%BB%D0%B8-%D1%84%D0%B8%D0%B0%D1%81-%D0%BA%D0%BE%D0%B4%D1%83)\n - [Определение ближайшего отделения Почты России по адресу](https://github.com/movemoveapp/laravel-dadata#%D0%BE%D0%BF%D1%80%D0%B5%D0%B4%D0%B5%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5-%D0%B1%D0%BB%D0%B8%D0%B6%D0%B0%D0%B9%D1%88%D0%B5%D0%B3%D0%BE-%D0%BE%D1%82%D0%B4%D0%B5%D0%BB%D0%B5%D0%BD%D0%B8%D1%8F-%D0%BF%D0%BE%D1%87%D1%82%D1%8B-%D1%80%D0%BE%D1%81%D1%81%D0%B8%D0%B8-%D0%BF%D0%BE-%D0%B0%D0%B4%D1%80%D0%B5%D1%81%D1%83)\n - [Определение отделения Почты России почтовому индексу](https://github.com/movemoveapp/laravel-dadata#%D0%BE%D0%BF%D1%80%D0%B5%D0%B4%D0%B5%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5-%D0%BE%D1%82%D0%B4%D0%B5%D0%BB%D0%B5%D0%BD%D0%B8%D1%8F-%D0%BF%D0%BE%D1%87%D1%82%D1%8B-%D1%80%D0%BE%D1%81%D1%81%D0%B8%D0%B8-%D0%BF%D0%BE-%D0%BF%D0%BE%D1%87%D1%82%D0%BE%D0%B2%D0%BE%D0%BC%D1%83-%D0%B8%D0%BD%D0%B4%D0%B5%D0%BA%D1%81%D1%83)\n - [Определение отделения Почты России по координатам](https://github.com/movemoveapp/laravel-dadata#%D0%BE%D0%BF%D1%80%D0%B5%D0%B4%D0%B5%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5-%D0%BE%D1%82%D0%B4%D0%B5%D0%BB%D0%B5%D0%BD%D0%B8%D1%8F-%D0%BF%D0%BE%D1%87%D1%82%D1%8B-%D1%80%D0%BE%D1%81%D1%81%D0%B8%D0%B8-%D0%BF%D0%BE-%D0%BA%D0%BE%D0%BE%D1%80%D0%B4%D0%B8%D0%BD%D0%B0%D1%82%D0%B0%D0%BC)\n - [Определение идентификатора города в СДЭК, Boxberry и DPD](https://github.com/movemoveapp/laravel-dadata#%D0%BE%D0%BF%D1%80%D0%B5%D0%B4%D0%B5%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5-%D0%B8%D0%B4%D0%B5%D0%BD%D1%82%D0%B8%D1%84%D0%B8%D0%BA%D0%B0%D1%82%D0%BE%D1%80%D0%B0-%D0%B3%D0%BE%D1%80%D0%BE%D0%B4%D0%B0-%D0%B2-%D1%81%D0%B4%D1%8D%D0%BA-boxberry-%D0%B8-dpd)\n - [Адрес в ФИАС по идентификатору](https://github.com/movemoveapp/laravel-dadata#%D0%B0%D0%B4%D1%80%D0%B5%D1%81-%D0%B2-%D1%84%D0%B8%D0%B0%D1%81-%D0%BF%D0%BE-%D0%B8%D0%B4%D0%B5%D0%BD%D1%82%D0%B8%D1%84%D0%B8%D0%BA%D0%B0%D1%82%D0%BE%D1%80%D1%83)\n- **Работа с именами**\n - [ФИО](https://github.com/movemoveapp/laravel-dadata#%D1%84%D0%B8%D0%BE)\n - [Автодополнение при вводе («подсказки»)](https://github.com/movemoveapp/laravel-dadata#%D0%B0%D0%B2%D1%82%D0%BE%D0%B4%D0%BE%D0%BF%D0%BE%D0%BB%D0%BD%D0%B5%D0%BD%D0%B8%D0%B5-%D0%BF%D1%80%D0%B8-%D0%B2%D0%B2%D0%BE%D0%B4%D0%B5-%D0%BF%D0%BE%D0%B4%D1%81%D0%BA%D0%B0%D0%B7%D0%BA%D0%B8)\n- **Работа с электорнными (email) адресами**\n - [Email](https://github.com/movemoveapp/laravel-dadata#email)\n - [Подсказки по email](https://github.com/movemoveapp/laravel-dadata#%D0%BF%D0%BE%D0%B4%D1%81%D0%BA%D0%B0%D0%B7%D0%BE%D0%BA%D0%B8-%D0%BF%D0%BE-email)\n- **Работа с телефонными номерами**\n - [Проверить телефон](https://github.com/movemoveapp/laravel-dadata#%D0%BF%D1%80%D0%BE%D0%B2%D0%B5%D1%80%D0%B8%D1%82%D1%8C-%D1%82%D0%B5%D0%BB%D0%B5%D1%84%D0%BE%D0%BD)\n- **Работа с компаниями**\n - [Организация по ИНН](https://github.com/movemoveapp/laravel-dadata#%D0%BE%D1%80%D0%B3%D0%B0%D0%BD%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D1%8F-%D0%BF%D0%BE-%D0%B8%D0%BD%D0%BD)\n - [Автодополнение при вводе («подсказки»)](https://github.com/movemoveapp/laravel-dadata#%D0%B0%D0%B2%D1%82%D0%BE%D0%B4%D0%BE%D0%BF%D0%BE%D0%BB%D0%BD%D0%B5%D0%BD%D0%B8%D0%B5-%D0%BF%D1%80%D0%B8-%D0%B2%D0%B2%D0%BE%D0%B4%D0%B5-%D0%BF%D0%BE%D0%B4%D1%81%D0%BA%D0%B0%D0%B7%D0%BA%D0%B8-1)\n - [Поиск аффилированных компаний](https://github.com/movemoveapp/laravel-dadata#%D0%BF%D0%BE%D0%B8%D1%81%D0%BA-%D0%B0%D1%84%D1%84%D0%B8%D0%BB%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%BD%D1%8B%D1%85-%D0%BA%D0%BE%D0%BC%D0%BF%D0%B0%D0%BD%D0%B8%D0%B9)\n- **Работа с банками**\n - [Банк по БИК, SWIFT, ИНН или регистрационному номеру](https://github.com/movemoveapp/laravel-dadata#%D0%B1%D0%B0%D0%BD%D0%BA-%D0%BF%D0%BE-%D0%B1%D0%B8%D0%BA-swift-%D0%B8%D0%BD%D0%BD-%D0%B8%D0%BB%D0%B8-%D1%80%D0%B5%D0%B3%D0%B8%D1%81%D1%82%D1%80%D0%B0%D1%86%D0%B8%D0%BE%D0%BD%D0%BD%D0%BE%D0%BC%D1%83-%D0%BD%D0%BE%D0%BC%D0%B5%D1%80%D1%83)\n - [API подсказок по банкам](https://github.com/movemoveapp/laravel-dadata#api-%D0%BF%D0%BE%D0%B4%D1%81%D0%BA%D0%B0%D0%B7%D0%BE%D0%BA-%D0%BF%D0%BE-%D0%B1%D0%B0%D0%BD%D0%BA%D0%B0%D0%BC)\n- **Работа с паспортами**\n - [Проверка по реестру МВД](https://github.com/movemoveapp/laravel-dadata#%D0%BF%D1%80%D0%BE%D0%B2%D0%B5%D1%80%D0%BA%D0%B0-%D0%BF%D0%BE-%D1%80%D0%B5%D0%B5%D1%81%D1%82%D1%80%D1%83-%D0%BC%D0%B2%D0%B4)\n - [Кем выдан паспорт](https://github.com/movemoveapp/laravel-dadata#%D0%BA%D0%B5%D0%BC-%D0%B2%D1%8B%D0%B4%D0%B0%D0%BD-%D0%BF%D0%B0%D1%81%D0%BF%D0%BE%D1%80%D1%82) \n\n\n\n## Работа с адресами\n### Стандартизация адреса\n`DaDataAddress::standardization(string $address)` - разбивает адрес из строки по отдельным полям (регион, город, улица, дом, квартира) согласно КЛАДР/ФИАС. Определяет почтовый индекс, часовой пояс, ближайшее метро, координаты, стоимость квартиры и другую информацию об адресе.\n\nОсновные кейсы:\n\n- Разбивает адрес по отдельным полям (регион, город, улица, дом, квартира).\n- Рассчитывает корректный индекс по данным Почты России.\n- Определяет координаты.\n- Показывает округ и район города, ближайшее метро, площадь и стоимость квартиры.\n- Достает коды КЛАДР, ФИАС, ОКАТО, ОКТМО и ИФНС. \n\nПример вызова\n\n```php\n\u003c?php\n\nnamespace App;\n\nuse MoveMoveIo\\DaData\\Facades\\DaDataAddress;\n\n/**\n * Class DaData\n * @package App\\DaData\n */\nclass DaData\n{\n\n /**\n * DaData standardization example\n *\n * @return void\n */\n public function standardizationExample() : void\n {\n $dadata = DaDataAddress::standardization('мск сухонска 11/-89');\n\n dd($dadata); \n }\n\n}\n\n```\n\nПример ответа\n\n```php\narray:1 [\n 0 =\u003e array:80 [\n \"source\" =\u003e \"мск сухонска 11/-89\"\n \"result\" =\u003e \"г Москва, ул Сухонская, д 11, кв 89\"\n \"postal_code\" =\u003e \"127642\"\n \"country\" =\u003e \"Россия\"\n \"country_iso_code\" =\u003e \"RU\"\n \"federal_district\" =\u003e \"Центральный\"\n \"region_fias_id\" =\u003e \"0c5b2444-70a0-4932-980c-b4dc0d3f02b5\"\n \"region_kladr_id\" =\u003e \"7700000000000\"\n \"region_iso_code\" =\u003e \"RU-MOW\"\n \"region_with_type\" =\u003e \"г Москва\"\n \"region_type\" =\u003e \"г\"\n \"region_type_full\" =\u003e \"город\"\n \"region\" =\u003e \"Москва\"\n \"area_fias_id\" =\u003e null\n \"area_kladr_id\" =\u003e null\n \"area_with_type\" =\u003e null\n \"area_type\" =\u003e null\n \"area_type_full\" =\u003e null\n \"area\" =\u003e null\n \"city_fias_id\" =\u003e null\n \"city_kladr_id\" =\u003e null\n \"city_with_type\" =\u003e null\n \"city_type\" =\u003e null\n \"city_type_full\" =\u003e null\n \"city\" =\u003e null\n \"city_area\" =\u003e \"Северо-восточный\"\n \"city_district_fias_id\" =\u003e null\n \"city_district_kladr_id\" =\u003e null\n \"city_district_with_type\" =\u003e \"р-н Северное Медведково\"\n \"city_district_type\" =\u003e \"р-н\"\n \"city_district_type_full\" =\u003e \"район\"\n \"city_district\" =\u003e \"Северное Медведково\"\n \"settlement_fias_id\" =\u003e null\n \"settlement_kladr_id\" =\u003e null\n \"settlement_with_type\" =\u003e null\n \"settlement_type\" =\u003e null\n \"settlement_type_full\" =\u003e null\n \"settlement\" =\u003e null\n \"street_fias_id\" =\u003e \"95dbf7fb-0dd4-4a04-8100-4f6c847564b5\"\n \"street_kladr_id\" =\u003e \"77000000000283600\"\n \"street_with_type\" =\u003e \"ул Сухонская\"\n \"street_type\" =\u003e \"ул\"\n \"street_type_full\" =\u003e \"улица\"\n \"street\" =\u003e \"Сухонская\"\n \"house_fias_id\" =\u003e \"5ee84ac0-eb9a-4b42-b814-2f5f7c27c255\"\n \"house_kladr_id\" =\u003e \"7700000000028360004\"\n \"house_type\" =\u003e \"д\"\n \"house_type_full\" =\u003e \"дом\"\n \"house\" =\u003e \"11\"\n \"block_type\" =\u003e null\n \"block_type_full\" =\u003e null\n \"block\" =\u003e null\n \"flat_type\" =\u003e \"кв\"\n \"flat_type_full\" =\u003e \"квартира\"\n \"flat\" =\u003e \"89\"\n \"flat_area\" =\u003e \"34.6\"\n \"square_meter_price\" =\u003e \"198113\"\n \"flat_price\" =\u003e \"6854710\"\n \"postal_box\" =\u003e null\n \"fias_id\" =\u003e \"5ee84ac0-eb9a-4b42-b814-2f5f7c27c255\"\n \"fias_code\" =\u003e \"77000000000000028360004\"\n \"fias_level\" =\u003e \"8\"\n \"fias_actuality_state\" =\u003e \"0\"\n \"kladr_id\" =\u003e \"7700000000028360004\"\n \"capital_marker\" =\u003e \"0\"\n \"okato\" =\u003e \"45280583000\"\n \"oktmo\" =\u003e \"45362000\"\n \"tax_office\" =\u003e \"7715\"\n \"tax_office_legal\" =\u003e \"7715\"\n \"timezone\" =\u003e \"UTC+3\"\n \"geo_lat\" =\u003e \"55.8782557\"\n \"geo_lon\" =\u003e \"37.65372\"\n \"beltway_hit\" =\u003e \"IN_MKAD\"\n \"beltway_distance\" =\u003e null\n \"qc_geo\" =\u003e 0\n \"qc_complete\" =\u003e 0\n \"qc_house\" =\u003e 2\n \"qc\" =\u003e 0\n \"unparsed_parts\" =\u003e null\n \"metro\" =\u003e array:3 [\n 0 =\u003e array:3 [\n \"distance\" =\u003e 1.1\n \"line\" =\u003e \"Калужско-Рижская\"\n \"name\" =\u003e \"Бабушкинская\"\n ]\n 1 =\u003e array:3 [\n \"distance\" =\u003e 1.2\n \"line\" =\u003e \"Калужско-Рижская\"\n \"name\" =\u003e \"Медведково\"\n ]\n 2 =\u003e array:3 [\n \"distance\" =\u003e 2.5\n \"line\" =\u003e \"Калужско-Рижская\"\n \"name\" =\u003e \"Свиблово\"\n ]\n ]\n ]\n]\n```\n\nОписани ответа\n\n| **Название** | **Длина** | **Описание** |\n|:--------------------------|-------------:|:---------------------------------------------------------------|\n| `source` | 250 | Исходный адрес одной строкой |\n| `result` | 500 | Стандартизованный адрес одной строкой |\n| `postal_code` | 6 | Индекс |\n| `country` | 120 | Страна |\n| `country_iso_code` | 2 | ISO-код страны |\n| `federal_district` | 20 | Федеральный округ |\n| `region_fias_id` | 36 | ФИАС-код региона |\n| `region_kladr_id` | 19 | КЛАДР-код региона |\n| `region_iso_code` | 6 | ISO-код региона |\n| `region_with_type` | 131 | Регион с типом |\n| `region_type` | 10 | Тип региона (сокращенный) |\n| `region_type_full` | 50 | Тип региона |\n| `region` | 120 | Регион |\n| `area_fias_id` | 36 | ФИАС-код района |\n| `area_kladr_id` | 19 | КЛАДР-код района |\n| `area_with_type` | 131 | Район в регионе с типом |\n| `area_type` | 10 | Тип района в регионе (сокращенный) |\n| `area_type_full` | 50 | Тип района в регионе |\n| `area` | 120 | Район в регионе |\n| `city_fias_id` | 36 | ФИАС-код города |\n| `city_kladr_id` | 19 | КЛАДР-код города |\n| `city_with_type` | 131 | Город с типом |\n| `city_type` | 10 | Тип города (сокращенный) |\n| `city_type_full` | 50 | Тип города |\n| `city` | 120 | Город |\n| `city_area` | 120 | Административный округ (только для Москвы) |\n| `city_district_fias_id` | 36 | ФИАС-код района города (заполняется, только если район есть в ФИАС) |\n| `city_district_kladr_id` | 19 | КЛАДР-код района города (не заполняется) |\n| `city_district_with_type` | 131 | Район города с типом |\n| `city_district_type` | 10 | Тип района города (сокращенный) |\n| `city_district_type_full` | 50 | Тип района города |\n| `city_district` | 120 | Район города |\n| `settlement_fias_id` | 36 | ФИАС-код населенного пункта |\n| `settlement_kladr_id` | 19 | КЛАДР-код населенного пункта |\n| `settlement_with_type` | 131 | Населенный пункт с типом |\n| `settlement_type` | 10 | Тип населенного пункта (сокращенный) |\n| `settlement_type_full` | 50 | Тип населенного пункта |\n| `settlement` | 120 | Населенный пункт |\n| `street_fias_id` | 36 | ФИАС-код улицы |\n| `street_kladr_id` | 19 | КЛАДР-код улицы |\n| `street_with_type` | 131 | Улица с типом |\n| `street_type` | 10 | Тип улицы (сокращенный) |\n| `street_type_full` | 50 | Тип улицы |\n| `street` | 120 | Улица |\n| `house_fias_id` | 36 | ФИАС-код дома |\n| `house_kladr_id` | 19 | КЛАДР-код дома |\n| `house_type` | 10 | Тип дома (сокращенный) |\n| `house_type_full` | 50 | Тип дома |\n| `house` | 50 | Дом |\n| `block_type` | 10 | Тип корпуса/строения (сокращенный) |\n| `block_type_full` | 50 | Тип корпуса/строения |\n| `block` | 50 | Корпус/строение |\n| `flat_type` | 10 | Тип квартиры (сокращенный) |\n| `flat_type_full` | 50 | Тип квартиры |\n| `flat` | 50 | Квартира |\n| `flat_area` | 50 | Площадь квартиры |\n| `square_meter_price` | 50 | Рыночная стоимость м² |\n| `flat_price` | 50 | Рыночная стоимость квартиры |\n| `postal_box` | 50 | Абонентский ящик |\n| `fias_id` | 36 | ФИАС-код адреса (идентификатор ФИАС) |\n| | | `HOUSE.HOUSEGUID — если дом найден в ФИАС` |\n| | | `ADDROBJ.AOGUID — в противном случае` |\n| `fias_code` | | Иерархический код адреса в ФИАС (СС+РРР+ГГГ+ППП+СССС+УУУУ+ДДДД) |\n| `fias_level` | 2 | Уровень детализации, до которого адрес найден в ФИАС |\n| `fias_actuality_state` | | Признак актуальности адреса в ФИАС |\n| `kladr_id` | 19 | КЛАДР-код адреса |\n| `capital_marker` | 1 | Признак центра района или региона |\n| `okato` | 11 | Код ОКАТО |\n| `oktmo` | 11 | Код ОКТМО |\n| `tax_office` | 4 | Код ИФНС для физических лиц |\n| `tax_office_legal` | 4 | Код ИФНС для организаций |\n| `timezone` | 50 | Часовой пояс города для России, часовой пояс страны — для иностранных адресов. Если у страны несколько поясов, вернёт минимальный и максимальный через слеш: UTC+5/UTC+6 |\n| `geo_lat` | 12 | Координаты: широта |\n| `geo_lon` | 12 | Координаты: долгота |\n| `beltway_hit` | 8 | Внутри кольцевой? |\n| `beltway_distance` | 3 | Расстояние от кольцевой в км. Заполнено, только если beltway_hit = OUT_MKAD или OUT_KAD, иначе пустое |\n| `qc_geo` | 5 | Код точности координат |\n| `qc_complete` | 5 | Код пригодности к рассылке |\n| `qc_house` | 5 | Признак наличия дома в ФИАС |\n| `qc` | 5 | Код проверки адреса |\n| `unparsed_parts` | 250 | Нераспознанная часть адреса. Для адреса «Москва, Митинская улица, 40, вход с торца» вернет «ВХОД, С, ТОРЦА» |\n| `metro` | | Список ближайших станций метро (до трёх штук) |\n\nКоординаты есть у 97% домов в Москве, 91% в Санкт-Петербурге, 69% в других городах-миллиониках и 47% по остальной России. Площадь и стоимость есть у 70% квартир в России.\n\n**Exceptions**\n\nПри вызове методов, вы можете обрабатывать коды исключений и их сообщения\n\n| **Код** | **Описание** |\n|:---------------------|:--------------------------------------------------------------------------------------------|\n| `400` | Некорректный запрос |\n| `401` | В запросе отсутствует API-ключ или секретный ключ или в запросе указан несуществующий ключ |\n| `403` | Не подтверждена почта или недостаточно средств для обработки запроса, пополните баланс |\n| `405` | Запрос сделан с методом, отличным от POST |\n| `429` | Слишком много запросов в секунду или новых соединений в минуту |\n| `5xx` | Произошла внутренняя ошибка сервиса |\n\nБолее детальную информацию вы можете получить из сообщения исключения.\n\nПример получения сообщения исключения\n\n```php\n\u003c?php\n\nnamespace App;\n\nuse MoveMoveIo\\DaData\\Facades\\DaDataAddress;\n\n/**\n * Class DaData\n * @package App\\DaData\n */\nclass DaData\n{\n\n /**\n * DaData standardization example\n *\n * @return void\n */\n public function standardizationExample() : void\n {\n try {\n $dadata = DaDataAddress::standardization('мск сухонска 11/-89');\n\n dd($dadata);\n } catch (\\Exception $e) {\n dd($e-\u003egetMessage());\n }\n }\n\n}\n\n```\n\n### Подсказки по адресам\n`DaDataAddress::prompt(string $query, int $count, int $language, array $locations, array $locations_geo, array $locations_boost, array $from_bound, array $to_bound)` Ищет адреса по любой части адреса от региона до дома («тверская нижний 12» → «Нижегородская обл, г Нижний Новгород, ул Тверская, д 12»). Также ищет почтовому индексу («105568» → «г Москва, ул Магнитогорская»).\n\nОсновные кейсы:\n- Работает по всем странам мира (по России до дома, по остальным странам — до города). Ищет и показывает результаты как на русском языке («Самара, пр-кт Металлургов»), так и на английском («Russia, gorod Samara, prospekt Metallurgov»).\n- Находит актуальные адреса по историческим названиям (Свердловск → Екатеринбург) и синонимам (Питер → Санкт-Петербург).\n- Ищет по частичному совпадению («москва болот» → «г Москва, Болотная наб»), но только в последнем слове запроса («мос болот» не найдет).\n- Исправляет опечатки («самара авиционная») и запросы в неправильной раскладке («vjcrdf» → «москва»).\n-️ Раскладывает выбранный адрес на гранулярные части (от региона до квартиры).\n-️ Поддерживает гранулярные подсказки по отдельным частям адреса (регионы, города, улицы, дома).\n-️ Подсказывает адреса в конкретных регионах, районах, городах и населенных пунктах. Понимает названия («Петергоф»), коды КЛАДР («7800000800000») и ФИАС («8f238984-812b-4bb1-850b-49749fb5c56d»).\n-️ Учитывает, где вы находитесь (в связке с методом город по IP-адресу).\n\nВажно знать, что использовать данный метод не рекомендуется если вы \n- Хотите автоматически, без участия человека, обработать адреса из базы или файла.\n- Транслитерировать строки, например `moskva suhonskaja 11 → 127642` в `г Москва, ул Сухонская, д 11`.\n\nПодсказки не подходят для автоматической обработки адресов. Они предлагают варианты, но не гарантируют, что угадали правильно. Поэтому окончательное решение всегда должен принимать человек.\n\nДля автоматической обработки и транслитерации используйте `DaDataAddress::standardization(string $address)` метод.\n\n\nПараметры вызова\n\n| **Название** | **Тип** | **Optional** | **Default value** | **Описание** |\n|:------------------|:--------:|:------------:|:-----------------:|:--------------------------------------------|\n| `query` | `string` | `false` | | Текст запроса |\n| `count` | `int` | `true` | 10 | Колличество результатов. Максимум 20 |\n| `language` | `int` | `true` | 1 | Язык ответа. Он может быть **русский** значение `language = 1` или **английским**, значение `language = 2`. Мы призываем использовать константы `Language::RU` или `Language::EN` |\n| `locations` | `array` | `true` | [] | [Ограничение по родителю](https://confluence.hflabs.ru/pages/viewpage.action?pageId=204669108) (страна, регион, район, город, улица) |\n| `locations_geo` | `array` | `true` | [] | [Ограничение по радиусу окружности](https://confluence.hflabs.ru/pages/viewpage.action?pageId=990871806) | \n| `locations_boost` | `array` | `true` | [] | [Приоритет города при ранжировании](https://confluence.hflabs.ru/pages/viewpage.action?pageId=285343795) |\n| `from_bound` | `array` | `true` | [] | [Гранулярные подсказки по адресу](https://confluence.hflabs.ru/pages/viewpage.action?pageId=222888017) |\n| `to_bound` | `array` | `true` | [] | [Гранулярные подсказки по адресу](https://confluence.hflabs.ru/pages/viewpage.action?pageId=222888017) |\n\n\nПример вызова\n\n```php\n\u003c?php\n\nnamespace App;\n\nuse MoveMoveIo\\DaData\\Enums\\Language;\nuse MoveMoveIo\\DaData\\Facades\\DaDataAddress;\n\n/**\n * Class DaData\n * @package App\\DaData\n */\nclass DaData\n{\n\n /**\n * DaData prompt example\n *\n * @return void\n */\n public function promptExample() : void\n {\n $dadata = DaDataAddress::prompt('москва хабар', 2, Language::RU);\n\n dd($dadata); \n }\n\n}\n\n```\n\nПример ответа\n\n```php\narray:1 [\n \"suggestions\" =\u003e array:2 [\n 0 =\u003e array:3 [\n \"value\" =\u003e \"г Москва, ул Хабаровская\"\n \"unrestricted_value\" =\u003e \"г Москва, ул Хабаровская\"\n \"data\" =\u003e array:81 [\n \"postal_code\" =\u003e null\n \"country\" =\u003e \"Россия\"\n \"country_iso_code\" =\u003e \"RU\"\n \"federal_district\" =\u003e null\n \"region_fias_id\" =\u003e \"0c5b2444-70a0-4932-980c-b4dc0d3f02b5\"\n \"region_kladr_id\" =\u003e \"7700000000000\"\n \"region_iso_code\" =\u003e \"RU-MOW\"\n \"region_with_type\" =\u003e \"г Москва\"\n \"region_type\" =\u003e \"г\"\n \"region_type_full\" =\u003e \"город\"\n \"region\" =\u003e \"Москва\"\n \"area_fias_id\" =\u003e null\n \"area_kladr_id\" =\u003e null\n \"area_with_type\" =\u003e null\n \"area_type\" =\u003e null\n \"area_type_full\" =\u003e null\n \"area\" =\u003e null\n \"city_fias_id\" =\u003e \"0c5b2444-70a0-4932-980c-b4dc0d3f02b5\"\n \"city_kladr_id\" =\u003e \"7700000000000\"\n \"city_with_type\" =\u003e \"г Москва\"\n \"city_type\" =\u003e \"г\"\n \"city_type_full\" =\u003e \"город\"\n \"city\" =\u003e \"Москва\"\n \"city_area\" =\u003e null\n \"city_district_fias_id\" =\u003e null\n \"city_district_kladr_id\" =\u003e null\n \"city_district_with_type\" =\u003e null\n \"city_district_type\" =\u003e null\n \"city_district_type_full\" =\u003e null\n \"city_district\" =\u003e null\n \"settlement_fias_id\" =\u003e null\n \"settlement_kladr_id\" =\u003e null\n \"settlement_with_type\" =\u003e null\n \"settlement_type\" =\u003e null\n \"settlement_type_full\" =\u003e null\n \"settlement\" =\u003e null\n \"street_fias_id\" =\u003e \"32fcb102-2a50-44c9-a00e-806420f448ea\"\n \"street_kladr_id\" =\u003e \"77000000000713400\"\n \"street_with_type\" =\u003e \"ул Хабаровская\"\n \"street_type\" =\u003e \"ул\"\n \"street_type_full\" =\u003e \"улица\"\n \"street\" =\u003e \"Хабаровская\"\n \"house_fias_id\" =\u003e null\n \"house_kladr_id\" =\u003e null\n \"house_type\" =\u003e null\n \"house_type_full\" =\u003e null\n \"house\" =\u003e null\n \"block_type\" =\u003e null\n \"block_type_full\" =\u003e null\n \"block\" =\u003e null\n \"flat_type\" =\u003e null\n \"flat_type_full\" =\u003e null\n \"flat\" =\u003e null\n \"flat_area\" =\u003e null\n \"square_meter_price\" =\u003e null\n \"flat_price\" =\u003e null\n \"postal_box\" =\u003e null\n \"fias_id\" =\u003e \"32fcb102-2a50-44c9-a00e-806420f448ea\"\n \"fias_code\" =\u003e \"7700000000000007134\"\n \"fias_level\" =\u003e \"7\"\n \"fias_actuality_state\" =\u003e \"0\"\n \"kladr_id\" =\u003e \"77000000000713400\"\n \"geoname_id\" =\u003e \"524894\"\n \"capital_marker\" =\u003e \"0\"\n \"okato\" =\u003e \"45263564000\"\n \"oktmo\" =\u003e \"45305000\"\n \"tax_office\" =\u003e \"7718\"\n \"tax_office_legal\" =\u003e \"7718\"\n \"timezone\" =\u003e null\n \"geo_lat\" =\u003e \"55.821168\"\n \"geo_lon\" =\u003e \"37.82608\"\n \"beltway_hit\" =\u003e null\n \"beltway_distance\" =\u003e null\n \"metro\" =\u003e null\n \"qc_geo\" =\u003e \"2\"\n \"qc_complete\" =\u003e null\n \"qc_house\" =\u003e null\n \"history_values\" =\u003e array:1 [\n 0 =\u003e \"ул Черненко\"\n ]\n \"unparsed_parts\" =\u003e null\n \"source\" =\u003e null\n \"qc\" =\u003e null\n ]\n ]\n 1 =\u003e array:3 [\n \"value\" =\u003e \"г Москва, поселение Московский, г Московский, ул Хабарова\"\n \"unrestricted_value\" =\u003e \"г Москва, поселение Московский, г Московский, ул Хабарова\"\n \"data\" =\u003e array:81 [\n \"postal_code\" =\u003e null\n \"country\" =\u003e \"Россия\"\n \"country_iso_code\" =\u003e \"RU\"\n \"federal_district\" =\u003e null\n \"region_fias_id\" =\u003e \"0c5b2444-70a0-4932-980c-b4dc0d3f02b5\"\n \"region_kladr_id\" =\u003e \"7700000000000\"\n \"region_iso_code\" =\u003e \"RU-MOW\"\n \"region_with_type\" =\u003e \"г Москва\"\n \"region_type\" =\u003e \"г\"\n \"region_type_full\" =\u003e \"город\"\n \"region\" =\u003e \"Москва\"\n \"area_fias_id\" =\u003e \"762758bb-18b9-440f-bc61-8e1e77ff3fd8\"\n \"area_kladr_id\" =\u003e \"7701100000000\"\n \"area_with_type\" =\u003e \"поселение Московский\"\n \"area_type\" =\u003e \"п\"\n \"area_type_full\" =\u003e \"поселение\"\n \"area\" =\u003e \"Московский\"\n \"city_fias_id\" =\u003e \"fbcf1fff-1d7c-445e-ad92-b71c08b8aba3\"\n \"city_kladr_id\" =\u003e \"7701100200000\"\n \"city_with_type\" =\u003e \"г Московский\"\n \"city_type\" =\u003e \"г\"\n \"city_type_full\" =\u003e \"город\"\n \"city\" =\u003e \"Московский\"\n \"city_area\" =\u003e null\n \"city_district_fias_id\" =\u003e null\n \"city_district_kladr_id\" =\u003e null\n \"city_district_with_type\" =\u003e null\n \"city_district_type\" =\u003e null\n \"city_district_type_full\" =\u003e null\n \"city_district\" =\u003e null\n \"settlement_fias_id\" =\u003e null\n \"settlement_kladr_id\" =\u003e null\n \"settlement_with_type\" =\u003e null\n \"settlement_type\" =\u003e null\n \"settlement_type_full\" =\u003e null\n \"settlement\" =\u003e null\n \"street_fias_id\" =\u003e \"4d70a35d-9246-4d9c-bcf1-90812ad056a3\"\n \"street_kladr_id\" =\u003e \"77011002000003700\"\n \"street_with_type\" =\u003e \"ул Хабарова\"\n \"street_type\" =\u003e \"ул\"\n \"street_type_full\" =\u003e \"улица\"\n \"street\" =\u003e \"Хабарова\"\n \"house_fias_id\" =\u003e null\n \"house_kladr_id\" =\u003e null\n \"house_type\" =\u003e null\n \"house_type_full\" =\u003e null\n \"house\" =\u003e null\n \"block_type\" =\u003e null\n \"block_type_full\" =\u003e null\n \"block\" =\u003e null\n \"flat_type\" =\u003e null\n \"flat_type_full\" =\u003e null\n \"flat\" =\u003e null\n \"flat_area\" =\u003e null\n \"square_meter_price\" =\u003e null\n \"flat_price\" =\u003e null\n \"postal_box\" =\u003e null\n \"fias_id\" =\u003e \"4d70a35d-9246-4d9c-bcf1-90812ad056a3\"\n \"fias_code\" =\u003e \"7701100200000000037\"\n \"fias_level\" =\u003e \"7\"\n \"fias_actuality_state\" =\u003e \"0\"\n \"kladr_id\" =\u003e \"77011002000003700\"\n \"geoname_id\" =\u003e \"857690\"\n \"capital_marker\" =\u003e \"0\"\n \"okato\" =\u003e \"45297565001\"\n \"oktmo\" =\u003e \"45952000\"\n \"tax_office\" =\u003e \"7751\"\n \"tax_office_legal\" =\u003e \"7751\"\n \"timezone\" =\u003e null\n \"geo_lat\" =\u003e \"55.59483\"\n \"geo_lon\" =\u003e \"37.35963\"\n \"beltway_hit\" =\u003e null\n \"beltway_distance\" =\u003e null\n \"metro\" =\u003e null\n \"qc_geo\" =\u003e \"2\"\n \"qc_complete\" =\u003e null\n \"qc_house\" =\u003e null\n \"history_values\" =\u003e null\n \"unparsed_parts\" =\u003e null\n \"source\" =\u003e null\n \"qc\" =\u003e null\n ]\n ]\n ]\n]\n\n```\n\nОписание ответа\n\n| **Название** | **Описание** |\n|:--------------------------|:--------------------------------------------------------------------------------------------------------------|\n| `value` | Адрес одной строкой (как показывается в списке подсказок) |\n| `unrestricted_value` | Адрес одной строкой (полный, с индексом) |\n| `data` | Вложенный массив данных аналагичный структуре выдачи метода `DaDataAddress::standardization(string $address)` |\n\n**Exceptions**\n\nПри вызове методов, вы можете обрабатывать коды исключений и их сообщения\n\n| **Код** | **Описание** |\n|:---------------------|:--------------------------------------------------------------------------------------------|\n| `400` | Некорректный запрос |\n| `401` | В запросе отсутствует API-ключ |\n| `403` | Не подтверждена почта или недостаточно средств для обработки запроса, пополните баланс |\n| `405` | Запрос сделан с методом, отличным от POST |\n| `413` | Слишком большая длина запроса или слишком много условий |\n| `429` | Слишком много запросов в секунду или новых соединений в минуту |\n| `5xx` | Произошла внутренняя ошибка сервиса |\n\nБолее детальную информацию вы можете получить из сообщения исключения.\n\nПример получения сообщения исключения\n\n```php\n\u003c?php\n\nnamespace App;\n\nuse MoveMoveIo\\DaData\\Enums\\Language;\nuse MoveMoveIo\\DaData\\Facades\\DaDataAddress;\n\n/**\n * Class DaData\n * @package App\\DaData\n */\nclass DaData\n{\n\n /**\n * DaData prompt example\n *\n * @return void\n */\n public function promptExample() : void\n {\n try {\n $dadata = DaDataAddress::prompt('москва хабар', 2, Language::RU);\n\n dd($dadata);\n } catch (\\Exception $e) {\n dd($e-\u003egetMessage());\n }\n }\n\n}\n\n```\n\n### Определение адреса по координатам\n`DaDataAddress::geolocate(float $lat, float $lon, int $count, int $radius_meters, int $language)` Находит ближайшие адреса (дома, улицы, города) по географическим координатам. Только для России.\n \nПараметры вызова\n\n| **Название** | **Тип** | **Optional** | **Default value** | **Описание** |\n|:------------------|:--------:|:------------:|:-----------------:|:--------------------------------------------|\n| `lat` | `float` | `false` | | Географическая широта |\n| `lon` | `float` | `false` | | Географическая долгота |\n| `count` | `int` | `true` | 10 | Количество результатов (максимум — 20) |\n| `radius_meters` | `int` | `true` | 100 | Радиус поиска в метрах (максимум – 1000) |\n| `language` | `int` | `true` | 1 | Язык ответа. Он может быть **русский** значение `language = 1` или **английским**, значение `language = 2`. Мы призываем использовать константы `Language::RU` или `Language::EN` | \n\nПример вызова\n\n```php\n\u003c?php\n\nnamespace App;\n\nuse MoveMoveIo\\DaData\\Facades\\DaDataAddress;\n\n/**\n * Class DaData\n * @package App\\DaData\n */\nclass DaData\n{\n\n /**\n * DaData geolocate example\n *\n * @return void\n */\n public function geolocateExample() : void\n {\n $dadata = DaDataAddress::geolocate('55.878', '37.653', 2);\n\n dd($dadata); \n }\n\n}\n\n```\n\nПример ответа\n\n```php\narray:1 [\n \"suggestions\" =\u003e array:2 [\n 0 =\u003e array:3 [\n \"value\" =\u003e \"г Москва, ул Сухонская, д 11\"\n \"unrestricted_value\" =\u003e \"127642, г Москва, ул Сухонская, д 11\"\n \"data\" =\u003e array:81 [\n \"postal_code\" =\u003e \"127642\"\n \"country\" =\u003e \"Россия\"\n \"country_iso_code\" =\u003e \"RU\"\n \"federal_district\" =\u003e null\n \"region_fias_id\" =\u003e \"0c5b2444-70a0-4932-980c-b4dc0d3f02b5\"\n \"region_kladr_id\" =\u003e \"7700000000000\"\n \"region_iso_code\" =\u003e \"RU-MOW\"\n \"region_with_type\" =\u003e \"г Москва\"\n \"region_type\" =\u003e \"г\"\n \"region_type_full\" =\u003e \"город\"\n \"region\" =\u003e \"Москва\"\n \"area_fias_id\" =\u003e null\n \"area_kladr_id\" =\u003e null\n \"area_with_type\" =\u003e null\n \"area_type\" =\u003e null\n \"area_type_full\" =\u003e null\n \"area\" =\u003e null\n \"city_fias_id\" =\u003e \"0c5b2444-70a0-4932-980c-b4dc0d3f02b5\"\n \"city_kladr_id\" =\u003e \"7700000000000\"\n \"city_with_type\" =\u003e \"г Москва\"\n \"city_type\" =\u003e \"г\"\n \"city_type_full\" =\u003e \"город\"\n \"city\" =\u003e \"Москва\"\n \"city_area\" =\u003e null\n \"city_district_fias_id\" =\u003e null\n \"city_district_kladr_id\" =\u003e null\n \"city_district_with_type\" =\u003e null\n \"city_district_type\" =\u003e null\n \"city_district_type_full\" =\u003e null\n \"city_district\" =\u003e null\n \"settlement_fias_id\" =\u003e null\n \"settlement_kladr_id\" =\u003e null\n \"settlement_with_type\" =\u003e null\n \"settlement_type\" =\u003e null\n \"settlement_type_full\" =\u003e null\n \"settlement\" =\u003e null\n \"street_fias_id\" =\u003e \"95dbf7fb-0dd4-4a04-8100-4f6c847564b5\"\n \"street_kladr_id\" =\u003e \"77000000000283600\"\n \"street_with_type\" =\u003e \"ул Сухонская\"\n \"street_type\" =\u003e \"ул\"\n \"street_type_full\" =\u003e \"улица\"\n \"street\" =\u003e \"Сухонская\"\n \"house_fias_id\" =\u003e \"5ee84ac0-eb9a-4b42-b814-2f5f7c27c255\"\n \"house_kladr_id\" =\u003e \"7700000000028360004\"\n \"house_type\" =\u003e \"д\"\n \"house_type_full\" =\u003e \"дом\"\n \"house\" =\u003e \"11\"\n \"block_type\" =\u003e null\n \"block_type_full\" =\u003e null\n \"block\" =\u003e null\n \"flat_type\" =\u003e null\n \"flat_type_full\" =\u003e null\n \"flat\" =\u003e null\n \"flat_area\" =\u003e null\n \"square_meter_price\" =\u003e null\n \"flat_price\" =\u003e null\n \"postal_box\" =\u003e null\n \"fias_id\" =\u003e \"5ee84ac0-eb9a-4b42-b814-2f5f7c27c255\"\n \"fias_code\" =\u003e \"77000000000000028360004\"\n \"fias_level\" =\u003e \"8\"\n \"fias_actuality_state\" =\u003e \"0\"\n \"kladr_id\" =\u003e \"7700000000028360004\"\n \"geoname_id\" =\u003e \"524894\"\n \"capital_marker\" =\u003e \"0\"\n \"okato\" =\u003e \"45280583000\"\n \"oktmo\" =\u003e \"45362000\"\n \"tax_office\" =\u003e \"7715\"\n \"tax_office_legal\" =\u003e \"7715\"\n \"timezone\" =\u003e null\n \"geo_lat\" =\u003e \"55.878315\"\n \"geo_lon\" =\u003e \"37.65372\"\n \"beltway_hit\" =\u003e null\n \"beltway_distance\" =\u003e null\n \"metro\" =\u003e null\n \"qc_geo\" =\u003e \"0\"\n \"qc_complete\" =\u003e null\n \"qc_house\" =\u003e null\n \"history_values\" =\u003e null\n \"unparsed_parts\" =\u003e null\n \"source\" =\u003e null\n \"qc\" =\u003e null\n ]\n ]\n 1 =\u003e array:3 [\n \"value\" =\u003e \"г Москва, ул Сухонская, д 11А\"\n \"unrestricted_value\" =\u003e \"127642, г Москва, ул Сухонская, д 11А\"\n \"data\" =\u003e array:81 [\n \"postal_code\" =\u003e \"127642\"\n \"country\" =\u003e \"Россия\"\n \"country_iso_code\" =\u003e \"RU\"\n \"federal_district\" =\u003e null\n \"region_fias_id\" =\u003e \"0c5b2444-70a0-4932-980c-b4dc0d3f02b5\"\n \"region_kladr_id\" =\u003e \"7700000000000\"\n \"region_iso_code\" =\u003e \"RU-MOW\"\n \"region_with_type\" =\u003e \"г Москва\"\n \"region_type\" =\u003e \"г\"\n \"region_type_full\" =\u003e \"город\"\n \"region\" =\u003e \"Москва\"\n \"area_fias_id\" =\u003e null\n \"area_kladr_id\" =\u003e null\n \"area_with_type\" =\u003e null\n \"area_type\" =\u003e null\n \"area_type_full\" =\u003e null\n \"area\" =\u003e null\n \"city_fias_id\" =\u003e \"0c5b2444-70a0-4932-980c-b4dc0d3f02b5\"\n \"city_kladr_id\" =\u003e \"7700000000000\"\n \"city_with_type\" =\u003e \"г Москва\"\n \"city_type\" =\u003e \"г\"\n \"city_type_full\" =\u003e \"город\"\n \"city\" =\u003e \"Москва\"\n \"city_area\" =\u003e null\n \"city_district_fias_id\" =\u003e null\n \"city_district_kladr_id\" =\u003e null\n \"city_district_with_type\" =\u003e null\n \"city_district_type\" =\u003e null\n \"city_district_type_full\" =\u003e null\n \"city_district\" =\u003e null\n \"settlement_fias_id\" =\u003e null\n \"settlement_kladr_id\" =\u003e null\n \"settlement_with_type\" =\u003e null\n \"settlement_type\" =\u003e null\n \"settlement_type_full\" =\u003e null\n \"settlement\" =\u003e null\n \"street_fias_id\" =\u003e \"95dbf7fb-0dd4-4a04-8100-4f6c847564b5\"\n \"street_kladr_id\" =\u003e \"77000000000283600\"\n \"street_with_type\" =\u003e \"ул Сухонская\"\n \"street_type\" =\u003e \"ул\"\n \"street_type_full\" =\u003e \"улица\"\n \"street\" =\u003e \"Сухонская\"\n \"house_fias_id\" =\u003e \"abc31736-35c1-4443-a061-b67c183b590a\"\n \"house_kladr_id\" =\u003e \"7700000000028360005\"\n \"house_type\" =\u003e \"д\"\n \"house_type_full\" =\u003e \"дом\"\n \"house\" =\u003e \"11А\"\n \"block_type\" =\u003e null\n \"block_type_full\" =\u003e null\n \"block\" =\u003e null\n \"flat_type\" =\u003e null\n \"flat_type_full\" =\u003e null\n \"flat\" =\u003e null\n \"flat_area\" =\u003e null\n \"square_meter_price\" =\u003e null\n \"flat_price\" =\u003e null\n \"postal_box\" =\u003e null\n \"fias_id\" =\u003e \"abc31736-35c1-4443-a061-b67c183b590a\"\n \"fias_code\" =\u003e \"77000000000000028360005\"\n \"fias_level\" =\u003e \"8\"\n \"fias_actuality_state\" =\u003e \"0\"\n \"kladr_id\" =\u003e \"7700000000028360005\"\n \"geoname_id\" =\u003e \"524894\"\n \"capital_marker\" =\u003e \"0\"\n \"okato\" =\u003e \"45280583000\"\n \"oktmo\" =\u003e \"45362000\"\n \"tax_office\" =\u003e \"7715\"\n \"tax_office_legal\" =\u003e \"7715\"\n \"timezone\" =\u003e null\n \"geo_lat\" =\u003e \"55.878212\"\n \"geo_lon\" =\u003e \"37.652016\"\n \"beltway_hit\" =\u003e null\n \"beltway_distance\" =\u003e null\n \"metro\" =\u003e null\n \"qc_geo\" =\u003e \"0\"\n \"qc_complete\" =\u003e null\n \"qc_house\" =\u003e null\n \"history_values\" =\u003e null\n \"unparsed_parts\" =\u003e null\n \"source\" =\u003e null\n \"qc\" =\u003e null\n ]\n ]\n ]\n]\n\n```\n\nОписание ответа\n\n| **Название** | **Описание** |\n|:--------------------------|:--------------------------------------------------------------------------------------------------------------|\n| `value` | Адрес одной строкой (как показывается в списке подсказок) |\n| `unrestricted_value` | Адрес одной строкой (полный, с индексом) |\n| `data` | Вложенный массив данных аналагичный структуре выдачи метода `DaDataAddress::standardization(string $address)` |\n\n**Exceptions**\n\nПри вызове методов, вы можете обрабатывать коды исключений и их сообщения\n\n| **Код** | **Описание** |\n|:---------------------|:--------------------------------------------------------------------------------------------|\n| `400` | Некорректный запрос |\n| `401` | В запросе отсутствует API-ключ |\n| `403` | Не подтверждена почта или недостаточно средств для обработки запроса, пополните баланс |\n| `405` | Запрос сделан с методом, отличным от POST |\n| `413` | Слишком большая длина запроса или слишком много условий |\n| `429` | Слишком много запросов в секунду или новых соединений в минуту |\n| `5xx` | Произошла внутренняя ошибка сервиса |\n\nБолее детальную информацию вы можете получить из сообщения исключения.\n\nПример получения сообщения исключения\n\n```php\n\u003c?php\n\nnamespace App;\n\nuse MoveMoveIo\\DaData\\Facades\\DaDataAddress;\n\n/**\n * Class DaData\n * @package App\\DaData\n */\nclass DaData\n{\n\n /**\n * DaData geolocate example\n *\n * @return void\n */\n public function geolocateExample() : void\n {\n try {\n $dadata = DaDataAddress::geolocate('55.878', '37.653', 2);\n\n dd($dadata);\n } catch (\\Exception $e) {\n dd($e-\u003egetMessage());\n }\n }\n\n}\n\n```\n\n### Определение адреса по IP\n`DaDataAddress::iplocate(string $ip, int $count, int $language)` определяет город по IP адресу.\n\nОсновные кейсы:\n- Поддерживает как IPv4, так и IPv6 адреса\n- Возвращает детальную информацию о городе, в том числе почтовый индекс.\n- \"Я тебя по айпи вычислю!\"\n \nПараметры вызова\n\n| **Название** | **Тип** | **Optional** | **Default value** | **Описание** |\n|:------------------|:-----------:|:------------:|:-----------------:|:--------------------------------------------|\n| `ip` | `string` | `false` | | IPv4 или IPv6 |\n| `count` | `int` | `true` | 10 | Количество результатов (максимум — 20) |\n| `language` | `int` | `true` | 1 | Язык ответа. Он может быть **русский** значение `language = 1` или **английским**, значение `language = 2`. Мы призываем использовать константы `Language::RU` или `Language::EN` | \n\nПример вызова\n\n```php\n\u003c?php\n\nnamespace App;\n\nuse MoveMoveIo\\DaData\\Facades\\DaDataAddress;\n\n/**\n * Class DaData\n * @package App\\DaData\n */\nclass DaData\n{\n\n /**\n * DaData iplocate example\n *\n * @return void\n */\n public function iplocateExample() : void\n {\n $dadata = DaDataAddress::iplocate('46.226.227.20', 2);\n\n dd($dadata); \n }\n\n}\n\n```\n\nПример ответа\n\n```php\narray:1 [\n \"location\" =\u003e array:3 [\n \"value\" =\u003e \"г Краснодар\"\n \"unrestricted_value\" =\u003e \"350000, Краснодарский край, г Краснодар\"\n \"data\" =\u003e array:81 [\n \"postal_code\" =\u003e \"350000\"\n \"country\" =\u003e \"Россия\"\n \"country_iso_code\" =\u003e \"RU\"\n \"federal_district\" =\u003e \"Южный\"\n \"region_fias_id\" =\u003e \"d00e1013-16bd-4c09-b3d5-3cb09fc54bd8\"\n \"region_kladr_id\" =\u003e \"2300000000000\"\n \"region_iso_code\" =\u003e \"RU-KDA\"\n \"region_with_type\" =\u003e \"Краснодарский край\"\n \"region_type\" =\u003e \"край\"\n \"region_type_full\" =\u003e \"край\"\n \"region\" =\u003e \"Краснодарский\"\n \"area_fias_id\" =\u003e null\n \"area_kladr_id\" =\u003e null\n \"area_with_type\" =\u003e null\n \"area_type\" =\u003e null\n \"area_type_full\" =\u003e null\n \"area\" =\u003e null\n \"city_fias_id\" =\u003e \"7dfa745e-aa19-4688-b121-b655c11e482f\"\n \"city_kladr_id\" =\u003e \"2300000100000\"\n \"city_with_type\" =\u003e \"г Краснодар\"\n \"city_type\" =\u003e \"г\"\n \"city_type_full\" =\u003e \"город\"\n \"city\" =\u003e \"Краснодар\"\n \"city_area\" =\u003e null\n \"city_district_fias_id\" =\u003e null\n \"city_district_kladr_id\" =\u003e null\n \"city_district_with_type\" =\u003e null\n \"city_district_type\" =\u003e null\n \"city_district_type_full\" =\u003e null\n \"city_district\" =\u003e null\n \"settlement_fias_id\" =\u003e null\n \"settlement_kladr_id\" =\u003e null\n \"settlement_with_type\" =\u003e null\n \"settlement_type\" =\u003e null\n \"settlement_type_full\" =\u003e null\n \"settlement\" =\u003e null\n \"street_fias_id\" =\u003e null\n \"street_kladr_id\" =\u003e null\n \"street_with_type\" =\u003e null\n \"street_type\" =\u003e null\n \"street_type_full\" =\u003e null\n \"street\" =\u003e null\n \"house_fias_id\" =\u003e null\n \"house_kladr_id\" =\u003e null\n \"house_type\" =\u003e null\n \"house_type_full\" =\u003e null\n \"house\" =\u003e null\n \"block_type\" =\u003e null\n \"block_type_full\" =\u003e null\n \"block\" =\u003e null\n \"flat_type\" =\u003e null\n \"flat_type_full\" =\u003e null\n \"flat\" =\u003e null\n \"flat_area\" =\u003e null\n \"square_meter_price\" =\u003e null\n \"flat_price\" =\u003e null\n \"postal_box\" =\u003e null\n \"fias_id\" =\u003e \"7dfa745e-aa19-4688-b121-b655c11e482f\"\n \"fias_code\" =\u003e \"23000001000000000000000\"\n \"fias_level\" =\u003e \"4\"\n \"fias_actuality_state\" =\u003e \"0\"\n \"kladr_id\" =\u003e \"2300000100000\"\n \"geoname_id\" =\u003e \"542420\"\n \"capital_marker\" =\u003e \"2\"\n \"okato\" =\u003e \"03401000000\"\n \"oktmo\" =\u003e \"03701000001\"\n \"tax_office\" =\u003e \"2300\"\n \"tax_office_legal\" =\u003e \"2300\"\n \"timezone\" =\u003e null\n \"geo_lat\" =\u003e \"45.0401604\"\n \"geo_lon\" =\u003e \"38.9759647\"\n \"beltway_hit\" =\u003e null\n \"beltway_distance\" =\u003e null\n \"metro\" =\u003e null\n \"qc_geo\" =\u003e \"4\"\n \"qc_complete\" =\u003e null\n \"qc_house\" =\u003e null\n \"history_values\" =\u003e null\n \"unparsed_parts\" =\u003e null\n \"source\" =\u003e null\n \"qc\" =\u003e null\n ]\n ]\n]\n\n```\n\nОписание ответа\n\n| **Название** | **Описание** |\n|:--------------------------|:--------------------------------------------------------------------------------------------------------------|\n| `value` | Адрес одной строкой (как показывается в списке подсказок) |\n| `unrestricted_value` | Адрес одной строкой (полный, с индексом) |\n| `data` | Вложенный массив данных аналагичный структуре выдачи метода `DaDataAddress::standardization(string $address)` |\n\n**Exceptions**\n\nПри вызове методов, вы можете обрабатывать коды исключений и их сообщения\n\n| **Код** | **Описание** |\n|:---------------------|:--------------------------------------------------------------------------------------------|\n| `400` | Некорректный запрос |\n| `401` | В запросе отсутствует API-ключ |\n| `403` | Не подтверждена почта или недостаточно средств для обработки запроса, пополните баланс |\n| `405` | Запрос сделан с методом, отличным от POST |\n| `413` | Слишком большая длина запроса или слишком много условий |\n| `429` | Слишком много запросов в секунду или новых соединений в минуту |\n| `5xx` | Произошла внутренняя ошибка сервиса |\n\nБолее детальную информацию вы можете получить из сообщения исключения.\n\nПример получения сообщения исключения\n\n```php\n\u003c?php\n\nnamespace App;\n\nuse MoveMoveIo\\DaData\\Facades\\DaDataAddress;\n\n/**\n * Class DaData\n * @package App\\DaData\n */\nclass DaData\n{\n\n /**\n * DaData geolocate example\n *\n * @return void\n */\n public function geolocateExample() : void\n {\n try {\n $dadata = DaDataAddress::iplocate('46.226.227.20', 2);\n\n dd($dadata);\n } catch (\\Exception $e) {\n dd($e-\u003egetMessage());\n }\n }\n\n}\n\n```\n\n### Определение адреса по КЛАДР или ФИАС коду\n`DaDataAddress::id(string $ip, int $count, int $language)` определяет адреса по КЛАДР или ФИАС коду.\n\nОсновные кейсы:\n- Поиск по КЛАДР-код, только для России;\n- ФИАС-код, только для России;\n- Идентификатор OpenStreetMap, только для Белоруссии;\n- Идентификатор GeoNames, для всех остальных стран.\n \nПараметры вызова\n\n| **Название** | **Тип** | **Optional** | **Default value** | **Описание** |\n|:------------------|:-----------:|:------------:|:-----------------:|:--------------------------------------------|\n| `id` | `string` | `false` | | Текст запроса |\n| `count` | `int` | `true` | 10 | Количество результатов (максимум — 20) |\n| `language` | `int` | `true` | 1 | Язык ответа. Он может быть **русский** значение `language = 1` или **английским**, значение `language = 2`. Мы призываем использовать константы `Language::RU` или `Language::EN` | \n\nПример вызова\n\n```php\n\u003c?php\n\nnamespace App;\n\nuse MoveMoveIo\\DaData\\Enums\\Language;\nuse MoveMoveIo\\DaData\\Facades\\DaDataAddress;\n\n/**\n * Class DaData\n * @package App\\DaData\n */\nclass DaData\n{\n\n /**\n * DaData ID example\n *\n * @return void\n */\n public function idExample() : void\n {\n $dadata = DaDataAddress::id('9120b43f-2fae-4838-a144-85e43c2bfb29', 2, Language::RU);\n\n dd($dadata); \n }\n\n}\n\n```\n\nПример ответа\n\n```php\narray:1 [\n \"suggestions\" =\u003e array:1 [\n 0 =\u003e array:3 [\n \"value\" =\u003e \"г Москва, ул Снежная\"\n \"unrestricted_value\" =\u003e \"129323, г Москва, р-н Свиблово, ул Снежная\"\n \"data\" =\u003e array:81 [\n \"postal_code\" =\u003e \"129323\"\n \"country\" =\u003e \"Россия\"\n \"country_iso_code\" =\u003e \"RU\"\n \"federal_district\" =\u003e \"Центральный\"\n \"region_fias_id\" =\u003e \"0c5b2444-70a0-4932-980c-b4dc0d3f02b5\"\n \"region_kladr_id\" =\u003e \"7700000000000\"\n \"region_iso_code\" =\u003e \"RU-MOW\"\n \"region_with_type\" =\u003e \"г Москва\"\n \"region_type\" =\u003e \"г\"\n \"region_type_full\" =\u003e \"город\"\n \"region\" =\u003e \"Москва\"\n \"area_fias_id\" =\u003e null\n \"area_kladr_id\" =\u003e null\n \"area_with_type\" =\u003e null\n \"area_type\" =\u003e null\n \"area_type_full\" =\u003e null\n \"area\" =\u003e null\n \"city_fias_id\" =\u003e \"0c5b2444-70a0-4932-980c-b4dc0d3f02b5\"\n \"city_kladr_id\" =\u003e \"7700000000000\"\n \"city_with_type\" =\u003e \"г Москва\"\n \"city_type\" =\u003e \"г\"\n \"city_type_full\" =\u003e \"город\"\n \"city\" =\u003e \"Москва\"\n \"city_area\" =\u003e \"Северо-восточный\"\n \"city_district_fias_id\" =\u003e null\n \"city_district_kladr_id\" =\u003e null\n \"city_district_with_type\" =\u003e \"р-н Свиблово\"\n \"city_district_type\" =\u003e \"р-н\"\n \"city_district_type_full\" =\u003e \"район\"\n \"city_district\" =\u003e \"Свиблово\"\n \"settlement_fias_id\" =\u003e null\n \"settlement_kladr_id\" =\u003e null\n \"settlement_with_type\" =\u003e null\n \"settlement_type\" =\u003e null\n \"settlement_type_full\" =\u003e null\n \"settlement\" =\u003e null\n \"street_fias_id\" =\u003e \"9120b43f-2fae-4838-a144-85e43c2bfb29\"\n \"street_kladr_id\" =\u003e \"77000000000268400\"\n \"street_with_type\" =\u003e \"ул Снежная\"\n \"street_type\" =\u003e \"ул\"\n \"street_type_full\" =\u003e \"улица\"\n \"street\" =\u003e \"Снежная\"\n \"house_fias_id\" =\u003e null\n \"house_kladr_id\" =\u003e null\n \"house_type\" =\u003e null\n \"house_type_full\" =\u003e null\n \"house\" =\u003e null\n \"block_type\" =\u003e null\n \"block_type_full\" =\u003e null\n \"block\" =\u003e null\n \"flat_type\" =\u003e null\n \"flat_type_full\" =\u003e null\n \"flat\" =\u003e null\n \"flat_area\" =\u003e null\n \"square_meter_price\" =\u003e null\n \"flat_price\" =\u003e null\n \"postal_box\" =\u003e null\n \"fias_id\" =\u003e \"9120b43f-2fae-4838-a144-85e43c2bfb29\"\n \"fias_code\" =\u003e \"77000000000000026840000\"\n \"fias_level\" =\u003e \"7\"\n \"fias_actuality_state\" =\u003e \"0\"\n \"kladr_id\" =\u003e \"77000000000268400\"\n \"geoname_id\" =\u003e \"524901\"\n \"capital_marker\" =\u003e \"0\"\n \"okato\" =\u003e \"45280580000\"\n \"oktmo\" =\u003e \"45361000\"\n \"tax_office\" =\u003e \"7716\"\n \"tax_office_legal\" =\u003e \"7716\"\n \"timezone\" =\u003e null\n \"geo_lat\" =\u003e \"55.8523466\"\n \"geo_lon\" =\u003e \"37.6469376\"\n \"beltway_hit\" =\u003e null\n \"beltway_distance\" =\u003e null\n \"metro\" =\u003e null\n \"qc_geo\" =\u003e \"2\"\n \"qc_complete\" =\u003e null\n \"qc_house\" =\u003e null\n \"history_values\" =\u003e null\n \"unparsed_parts\" =\u003e null\n \"source\" =\u003e null\n \"qc\" =\u003e null\n ]\n ]\n ]\n]\n\n\n```\n\nОписание ответа\n\n| **Название** | **Описание** |\n|:--------------------------|:--------------------------------------------------------------------------------------------------------------|\n| `value` | Адрес одной строкой (как показывается в списке подсказок) |\n| `unrestricted_value` | Адрес одной строкой (полный, с индексом) |\n| `data` | Вложенный массив данных аналагичный структуре выдачи метода `DaDataAddress::standardization(string $address)` |\n\n**Exceptions**\n\nПри вызове методов, вы можете обрабатывать коды исключений и их сообщения\n\n| **Код** | **Описание** |\n|:---------------------|:--------------------------------------------------------------------------------------------|\n| `400` | Некорректный запрос |\n| `401` | В запросе отсутствует API-ключ |\n| `403` | Не подтверждена почта или недостаточно средств для обработки запроса, пополните баланс |\n| `405` | Запрос сделан с методом, отличным от POST |\n| `413` | Слишком большая длина запроса или слишком много условий |\n| `429` | Слишком много запросов в секунду или новых соединений в минуту |\n| `5xx` | Произошла внутренняя ошибка сервиса |\n\nБолее детальную информацию вы можете получить из сообщения исключения.\n\nПример получения сообщения исключения\n\n```php\n\u003c?php\n\nnamespace App;\n\nuse MoveMoveIo\\DaData\\Enums\\Language;\nuse MoveMoveIo\\DaData\\Facades\\DaDataAddress;\n\n/**\n * Class DaData\n * @package App\\DaData\n */\nclass DaData\n{\n\n /**\n * DaData geolocate example\n *\n * @return void\n */\n public function geolocateExample() : void\n {\n try {\n $dadata = DaDataAddress::id('9120b43f-2fae-4838-a144-85e43c2bfb29', 2, Language::RU);\n\n dd($dadata);\n } catch (\\Exception $e) {\n dd($e-\u003egetMessage());\n }\n }\n\n}\n\n```\n\n### Определение ближайшего отделения Почты России по адресу\n`DaDataAddress::postalUnitByAddress(string $address, int $count, int $language)` определяет ближайшее почтовые отделения по адресу\n\nЕсли интернет-магазин доставляет покупки почтой по России, хорошо бы подсказать человеку, где и когда он может забрать посылку. В этом поможет справочник почтовых отделений — в нём есть точный адрес, координаты и часы работы отделения, а ещё отметка, если оно временно закрыто.\n \nПараметры вызова\n\n| **Название** | **Тип** | **Optional** | **Default value** | **Описание** |\n|:------------------|:-----------:|:------------:|:-----------------:|:--------------------------------------------|\n| `address` | `string` | `false` | | Адресс |\n| `count` | `int` | `true` | 10 | Количество результатов (максимум — 20) |\n| `language` | `int` | `true` | 1 | Язык ответа. Он может быть **русский** значение `language = 1` или **английским**, значение `language = 2`. Мы призываем использовать константы `Language::RU` или `Language::EN` | \n\nПример вызова\n\n```php\n\u003c?php\n\nnamespace App;\n\nuse MoveMoveIo\\DaData\\Enums\\Language;\nuse MoveMoveIo\\DaData\\Facades\\DaDataAddress;\n\n/**\n * Class DaData\n * @package App\\DaData\n */\nclass DaData\n{\n\n /**\n * DaData fine postal unit by address example\n *\n * @return void\n */\n public function postalUnitByAddressExample() : void\n {\n $dadata = DaDataAddress::postalUnitByAddress('дежнева 2а', 2, Language::RU);\n\n dd($dadata); \n }\n\n}\n\n```\n\nПример ответа\n\n```php\narray:1 [\n \"suggestions\" =\u003e array:1 [\n 0 =\u003e array:3 [\n \"value\" =\u003e \"127642\"\n \"unrestricted_value\" =\u003e \"г Москва, проезд Дежнёва, д 2А\"\n \"data\" =\u003e array:15 [\n \"postal_code\" =\u003e \"127642\"\n \"is_closed\" =\u003e false\n \"type_code\" =\u003e \"ГОПС\"\n \"address_str\" =\u003e \"г Москва, проезд Дежнёва, д 2А\"\n \"address_kladr_id\" =\u003e \"7700000000000\"\n \"address_qc\" =\u003e \"0\"\n \"geo_lat\" =\u003e 55.872127\n \"geo_lon\" =\u003e 37.651223\n \"schedule_mon\" =\u003e \"08:00-20:00\"\n \"schedule_tue\" =\u003e \"08:00-20:00\"\n \"schedule_wed\" =\u003e \"08:00-20:00\"\n \"schedule_thu\" =\u003e \"08:00-20:00\"\n \"schedule_fri\" =\u003e \"08:00-20:00\"\n \"schedule_sat\" =\u003e \"09:00-18:00\"\n \"schedule_sun\" =\u003e \"09:00-18:00\"\n ]\n ]\n ]\n]\n\n\n```\n\nОписание ответа\n\n| **Название** | **Описание** |\n|:--------------------------|:--------------------------------------------------------------------------------------------------------------|\n| `value` | Адрес одной строкой (как показывается в списке подсказок) |\n| `unrestricted_value` | Адрес одной строкой (полный, с индексом) |\n| `data` | Вложенный массив рассмотренный ниже |\n\nОписание вложенного массива `data`\n\n| **Название** | **Описание** |\n|:--------------------------|:--------------------------------------------------------------------------------------------------------------|\n| `value` | Адрес одной строкой (как показывается в списке подсказок) |\n| `postal_code` | Индекс |\n| `is_closed` | `true`, если отделение закрыто, иначе `false` |\n| `type_code` | Тип отделения |\n| `address_str` | Адрес одной строкой |\n| `address_kladr_id` | КЛАДР-код населённого пункта |\n| `address_qc` | Код проверки адреса |\n| `geo_lat` | Широта |\n| `geo_lon` | Долгота |\n| `schedule_mon` | Режим работы в понедельник |\n| `schedule_tue` | Режим работы во вторник |\n| `schedule_wed` | Режим работы в среду |\n| `schedule_thu` | Режим работы в четверг |\n| `schedule_fri` | Режим работы в пятницу |\n| `schedule_sat` | Режим работы в субботу |\n| `schedule_sun` | Режим работы в воскресенье |\n\n\n**Exceptions**\n\nПри вызове методов, вы можете обрабатывать коды исключений и их сообщения\n\n| **Код** | **Описание** |\n|:---------------------|:--------------------------------------------------------------------------------------------|\n| `400` | Некорректный запрос |\n| `401` | В запросе отсутствует API-ключ |\n| `403` | Не подтверждена почта или недостаточно средств для обработки запроса, пополните баланс |\n| `405` | Запрос сделан с методом, отличным от POST |\n| `413` | Слишком большая длина запроса или слишком много условий |\n| `429` | Слишком много запросов в секунду или новых соединений в минуту |\n| `5xx` | Произошла внутренняя ошибка сервиса |\n\nБолее детальную информацию вы можете получить из сообщения исключения.\n\n### Определение отделения Почты России почтовому индексу\n`DaDataAddress::postalUnitById(int $code, int $count, int $language)` определяет адреса почтовых отделений почтовому коду\n \nПараметры вызова\n\n| **Название** | **Тип** | **Optional** | **Default value** | **Описание** |\n|:------------------|:-----------:|:------------:|:-----------------:|:--------------------------------------------|\n| `code` | `int` | `false` | | Индекс |\n| `count` | `int` | `true` | 10 | Количество результатов (максимум — 20) |\n| `language` | `int` | `true` | 1 | Язык ответа. Он может быть **русский** значение `language = 1` или **английским**, значение `language = 2`. Мы призываем использовать константы `Language::RU` или `Language::EN` | \n\nПример вызова\n\n```php\n\u003c?php\n\nnamespace App;\n\nuse MoveMoveIo\\DaData\\Enums\\Language;\nuse MoveMoveIo\\DaData\\Facades\\DaDataAddress;\n\n/**\n * Class DaData\n * @package App\\DaData\n */\nclass DaData\n{\n\n /**\n * DaData fine postal unit by zip example\n *\n * @return void\n */\n public function postalUnitByIdExample() : void\n {\n $dadata = DaDataAddress::postalUnitById(127642, 2, Language::RU);\n\n dd($dadata); \n }\n\n}\n\n```\n\nПример ответа\n\n```php\narray:1 [\n \"suggestions\" =\u003e array:1 [\n 0 =\u003e array:3 [\n \"value\" =\u003e \"127642\"\n \"unrestricted_value\" =\u003e \"г Москва, проезд Дежнёва, д 2А\"\n \"data\" =\u003e array:15 [\n \"postal_code\" =\u003e \"127642\"\n \"is_closed\" =\u003e false\n \"type_code\" =\u003e \"ГОПС\"\n \"address_str\" =\u003e \"г Москва, проезд Дежнёва, д 2А\"\n \"address_kladr_id\" =\u003e \"7700000000000\"\n \"address_qc\" =\u003e \"0\"\n \"geo_lat\" =\u003e 55.872127\n \"geo_lon\" =\u003e 37.651223\n \"schedule_mon\" =\u003e \"08:00-20:00\"\n \"schedule_tue\" =\u003e \"08:00-20:00\"\n \"schedule_wed\" =\u003e \"08:00-20:00\"\n \"schedule_thu\" =\u003e \"08:00-20:00\"\n \"schedule_fri\" =\u003e \"08:00-20:00\"\n \"schedule_sat\" =\u003e \"09:00-18:00\"\n \"schedule_sun\" =\u003e \"09:00-18:00\"\n ]\n ]\n ]\n]\n\n\n```\n\nОписание ответа\n\n| **Название** | **Описание** |\n|:--------------------------|:--------------------------------------------------------------------------------------------------------------|\n| `value` | Адрес одной строкой (как показывается в списке подсказок) |\n| `unrestricted_value` | Адрес одной строкой (полный, с индексом) |\n| `data` | Вложенный массив рассмотренный ниже |\n\nОписание вложенного массива `data`\n\n| **Название** | **Описание** |\n|:--------------------------|:--------------------------------------------------------------------------------------------------------------|\n| `value` | Адрес одной строкой (как показывается в списке подсказок) |\n| `postal_code` | Индекс |\n| `is_closed` | `true`, если отделение закрыто, иначе `false` |\n| `type_code` | Тип отделения |\n| `address_str` | Адрес одной строкой |\n| `address_kladr_id` | КЛАДР-код населённого пункта |\n| `address_qc` | Код проверки адреса |\n| `geo_lat` | Широта |\n| `geo_lon` | Долгота |\n| `schedule_mon` | Режим работы в понедельник |\n| `schedule_tue` | Режим работы во вторник |\n| `schedule_wed` | Режим работы в среду |\n| `schedule_thu` | Режим работы в четверг |\n| `schedule_fri` | Режим работы в пятницу |\n| `schedule_sat` | Режим работы в субботу |\n| `schedule_sun` | Режим работы в воскресенье |\n\n\n**Exceptions**\n\nПри вызове методов, вы можете обрабатывать коды исключений и их сообщения\n\n| **Код** | **Описание** |\n|:---------------------|:--------------------------------------------------------------------------------------------|\n| `400` | Некорректный запрос |\n| `401` | В запросе отсутствует API-ключ |\n| `403` | Не подтверждена почта или недостаточно средств для обработки запроса, пополните баланс |\n| `405` | Запрос сделан с методом, отличным от POST |\n| `413` | Слишком большая длина запроса или слишком много условий |\n| `429` | Слишком много запросов в секунду или новых соединений в минуту |\n| `5xx` | Произошла внутренняя ошибка сервиса |\n\nБолее детальную информацию вы можете получить из сообщения исключения.\n\n### Определение отделения Почты России по координатам\n`DaDataAddress::postalUnitByGeoLocate(float $lat, float $lon, int $radius_meters, int $count, int $language)` определяет адреса почтовых отделений по координатам\n \nПараметры вызова\n\n| **Название** | **Тип** | **Optional** | **Default value** | **Описание** |\n|:------------------|:-----------:|:------------:|:-----------------:|:--------------------------------------------|\n| `lat` | `int` | `false` | | Широта |\n| `lon` | `int` | `false` | | Долгота |\n| `radius_meters` | `int` | `false` | 1000 | Радиус поиска в метрах. Максимум 1000 |\n| `count` | `int` | `true` | 10 | Количество результатов (максимум — 20) |\n| `language` | `int` | `true` | 1 | Язык ответа. Он может быть **русский** значение `language = 1` или **английским**, значение `language = 2`. Мы призываем использовать константы `Language::RU` или `Language::EN` | \n\nПример вызова\n\n```php\n\u003c?php\n\nnamespace App;\n\nuse MoveMoveIo\\DaData\\Enums\\Language;\nuse MoveMoveIo\\DaData\\Facades\\DaDataAddress;\n\n/**\n * Class DaData\n * @package App\\DaData\n */\nclass DaData\n{\n\n /**\n * DaData fine postal unit by GEO\n *\n * @return void\n */\n public function postalUnitByGeoLocateExample() : void\n {\n $dadata = DaDataAddress::postalUnitByGeoLocate('55.878', '37.653', 1000, 2, Language::RU);\n\n dd($dadata); \n }\n\n}\n\n```\n\nПример ответа\n\n```php\narray:1 [\n \"suggestions\" =\u003e array:2 [\n 0 =\u003e array:3 [\n \"value\" =\u003e \"127642\"\n \"unrestricted_value\" =\u003e \"г Москва, проезд Дежнёва, д 2А\"\n \"data\" =\u003e array:15 [\n \"postal_code\" =\u003e \"127642\"\n \"is_closed\" =\u003e false\n \"type_code\" =\u003e \"ГОПС\"\n \"address_str\" =\u003e \"г Москва, проезд Дежнёва, д 2А\"\n \"address_kladr_id\" =\u003e \"7700000000000\"\n \"address_qc\" =\u003e \"0\"\n \"geo_lat\" =\u003e 55.872127\n \"geo_lon\" =\u003e 37.651223\n \"schedule_mon\" =\u003e \"08:00-20:00\"\n \"schedule_tue\" =\u003e \"08:00-20:00\"\n \"schedule_wed\" =\u003e \"08:00-20:00\"\n \"schedule_thu\" =\u003e \"08:00-20:00\"\n \"schedule_fri\" =\u003e \"08:00-20:00\"\n \"schedule_sat\" =\u003e \"09:00-18:00\"\n \"schedule_sun\" =\u003e \"09:00-18:00\"\n ]\n ]\n 1 =\u003e array:3 [\n \"value\" =\u003e \"127221\"\n \"unrestricted_value\" =\u003e \"г Москва, ул Полярная, д 16 к 1\"\n \"data\" =\u003e array:15 [\n \"postal_code\" =\u003e \"127221\"\n \"is_closed\" =\u003e false\n \"type_code\" =\u003e \"ГОПС\"\n \"address_str\" =\u003e \"г Москва, ул Полярная, д 16 к 1\"\n \"address_kladr_id\" =\u003e \"7700000000000\"\n \"address_qc\" =\u003e \"0\"\n \"geo_lat\" =\u003e 55.876607\n \"geo_lon\" =\u003e 37.637308\n \"schedule_mon\" =\u003e \"08:00-20:00\"\n \"schedule_tue\" =\u003e \"08:00-20:00\"\n \"schedule_wed\" =\u003e \"08:00-20:00\"\n \"schedule_thu\" =\u003e \"08:00-20:00\"\n \"schedule_fri\" =\u003e \"08:00-20:00\"\n \"schedule_sat\" =\u003e \"09:00-18:00\"\n \"schedule_sun\" =\u003e \"09:00-18:00\"\n ]\n ]\n ]\n]\n\n```\n\nОписание ответа\n\n| **Название** | **Описание** |\n|:--------------------------|:--------------------------------------------------------------------------------------------------------------|\n| `value` | Адрес одной строкой (как показывается в списке подсказок) |\n| `unrestricted_value` | Адрес одной строкой (полный, с индексом) |\n| `data` | Вложенный массив рассмотренный ниже |\n\nОписание вложенного массива `data`\n\n| **Название** | **Описание** |\n|:--------------------------|:--------------------------------------------------------------------------------------------------------------|\n| `value` | Адрес одной строкой (как показывается в списке подсказок) |\n| `postal_code` | Индекс |\n| `is_closed` | `true`, если отделение закрыто, иначе `false` |\n| `type_code` | Тип отделения |\n| `address_str` | Адрес одной строкой |\n| `address_kladr_id` | КЛАДР-код населённого пункта |\n| `address_qc` | Код проверки адреса |\n| `geo_lat` | Широта |\n| `geo_lon` | Долгота |\n| `schedule_mon` | Режим работы в понедельник |\n| `schedule_tue` | Режим работы во вторник |\n| `schedule_wed` | Режим работы в среду |\n| `schedule_thu` | Режим работы в четверг |\n| `schedule_fri` | Режим работы в пятницу |\n| `schedule_sat` | Режим работы в субботу |\n| `schedule_sun` | Режим работы в воскресенье |\n\n\n**Exceptions**\n\nПри вызове методов, вы можете обрабатывать коды исключений и их сообщения\n\n| **Код** | **Описание** |\n|:---------------------|:--------------------------------------------------------------------------------------------|\n| `400` | Некорректный запрос |\n| `401` | В запросе отсутствует API-ключ |\n| `403` | Не подтверждена почта или недостаточно средств для обработки запроса, пополните баланс |\n| `405` | Запрос сделан с методом, отличным от POST |\n| `413` | Слишком большая длина запроса или слишком много условий |\n| `429` | Слишком много запросов в секунду или новых соединений в минуту |\n| `5xx` | Произошла внутренняя ошибка сервиса |\n\nБолее детальную информацию вы можете получить из сообщения исключения.\n\n### Определение идентификатора города в СДЭК, Boxberry и DPD\n`DaDataAddress::delivery(string $code)` помогает решить сзадачу определения идентификатора города в СДЭК, Boxberry и DPD\n\nСлужбы доставки часто используют собственные идентификаторы городов, и требуют от магазина указывать их в заказе.\n\nМетод `DaDataAddress::delivery(string $code)` определяет идентификатор города в службе доставке на основании КЛАДР-кода города. \n \nПараметры вызова\n\n| **Название** | **Тип** | **Optional** | **Default value** | **Описание** |\n|:------------------|:-----------:|:------------:|:-----------------:|:--------------------------------------------|\n| `code` | `string` | `false` | | Код |\n\nПример вызова\n\n```php\n\u003c?php\n\nnamespace App;\n\nuse MoveMoveIo\\DaData\\Facades\\DaDataAddress;\n\n/**\n * Class DaData\n * @package App\\DaData\n */\nclass DaData\n{\n\n /**\n * DaData define city code by delivery code\n *\n * @return void\n */\n public function deliveryExample() : void\n {\n $dadata = DaDataAddress::delivery('3100400100000');\n\n dd($dadata); \n }\n\n}\n\n```\n\nПример ответа\n\n```php\narray:1 [\n \"suggestions\" =\u003e array:1 [\n 0 =\u003e array:3 [\n \"value\" =\u003e \"3100400100000\"\n \"unrestricted_value\" =\u003e \"fe7eea4a-875a-4235-aa61-81c2a37a0440\"\n \"data\" =\u003e array:5 [\n \"kladr_id\" =\u003e \"3100400100000\"\n \"fias_id\" =\u003e \"fe7eea4a-875a-4235-aa61-81c2a37a0440\"\n \"boxberry_id\" =\u003e \"01929\"\n \"cdek_id\" =\u003e \"344\"\n \"dpd_id\" =\u003e \"196006461\"\n ]\n ]\n ]\n]\n\n```\n\nОписание ответа\n\n| **Название** | **Описание** |\n|:--------------------------|:--------------------------------------------------------------------------------------------------------------|\n| `value` | Адрес одной строкой (как показывается в списке подсказок) |\n| `unrestricted_value` | Адрес одной строкой (полный, с индексом) |\n| `data` | Вложенный массив рассмотренный ниже |\n\nОписание вложенного массива `data`\n\n| **Название** | **Описание** |\n|:--------------------------|:--------------------------------------------------------------------------------------------------------------|\n| `kladr_id` | КЛАДР-код города |\n| `fias_id` | ФИАС-код города |\n| `boxberry_id` | Идентификатор города по справочнику Boxberry |\n| `cdek_id` | Идентификатор города по справочнику СДЭК |\n| `dpd_id` | Идентификатор города по справочнику DPD |\n\n**Ex","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmovemoveapp%2Flaravel-dadata","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmovemoveapp%2Flaravel-dadata","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmovemoveapp%2Flaravel-dadata/lists"}