alexbklnv/laravel-dadata

Laravel DaData API

0.1.2 2023-01-13 14:20 UTC

Requires

• alexbklnv/php-dadata-client: ^0.1.2
• illuminate/config: >=7
• illuminate/support: >=7
• yzen.dev/plain-to-class: ^0.4.2

Requires (Dev)

• orchestra/testbench: ^6.24
• phpunit/phpunit: ^9.5
• roave/security-advisories: dev-latest

MIT

• AlexBklnv

• php
• address
• laravel
• profile
• DaData
• alexbklnv
• sugggestions

README

📜 Installation

Установка пакета:

composer require alexbklnv/laravel-dadata

Опубликовать конфиг:

php artisan vendor:publish --provider="AlexBklnv\DaData\DaDataServiceProvider"

Задать токен (и ключ для API стандартизации) в config/dadata.php или .env

    'token' => env('DADATA_TOKEN', ''),
    'secret' => env('DADATA_SECRET', ''),

📜 Usage

1. Работа с адресами и геокоординатами.

• Разбор адреса из строки («стандартизация»)
• Автодополнение адреса при вводе («подсказки»)
• Геокодирование (координаты по адресу)
• Обратное геокодирование (адрес по координатам)
• Город по IP-адресу
• Поиск адреса по коду КЛАДР или ФИАС
• Кадастровый номер
• Ближайшее почтовое отделение
• Поиск стран

1. Работа с профилем пользователя

• Проверка баланса
• Получение статистики
• Справка по актуальности справочников

Работа с почтовыми адресами и геокоординатами.

Необходимо использовать следующий фасад:

use AlexBklnv\DaData\Facades\DaDataAddress;

Разбор адреса из строки («стандартизация») (Документация)

$result = DaDataAddress::cleanAddress('мск сухонска 11/-89');

Подсказки по адресам (Документация)

$result = DaDataAddress->suggestAddress('москва хабар');

Геокодирование (координаты по адресу) (Документация)

$result = DaDataAddress::geocodeAddress('москва сухонская 11');

Обратное геокодирование (адрес по координатам) (Документация)

$result = DaDataAddress::geolocate('55.87', '37.653');

Город по IP-адресу (Документация)

$result = DaDataAddress::iplocate('46.226.227.20');

Поиск адреса по коду КЛАДР или ФИАС (Документация)

$result = DaDataAddress::findByCode('9120b43f-2fae-4838-a144-85e43c2bfb29');

Кадастровый номер по КЛАДР или ФИАС (Документация)

$result = DaDataAddress::findByCadastre('9120b43f-2fae-4838-a144-85e43c2bfb29');

Поиск отделений Почта России (Документация)

$result = DaDataAddress::findPostUnit('дежнева 2а');

Поиск стран (Документация)

$result = DaDataAddress::suggestCountry('та');

Работа с профилем пользователя

Необходимо использовать следующий фасад:

use AlexBklnv\DaData\Facades\DaDataProfile;

Проверка баланса (Документация)

$result = DaDataProfile::getBalance();

Получение статистики (Документация)

На текущий день:

$result = DaDataProfile::getStat();

На любую другую дату:

$result = DaDataProfile::getStat('2019-11-01');
$result = DaDataProfile::getStat(new DateTime());
$result = DaDataProfile::getStat(\Carbon\Carbon::create('2014', '12', '12'));

Справка по актуальности справочников (Документация)

$result = DaDataProfile::getRelevance();