razmik/yandex-vision

There is no license information available for the latest version (0.1.0) of this package.

Распознавание документов

0.1.0 2022-11-10 16:57 UTC

Requires

• php: >=7.2

Unknown License

• Ilia Rozinsky

README

Yandex Vision — сервис компьютерного зрения для анализа изображений.

Возможности:

• распознавание документов (паспорт, водительское удостоверение, регистрационные номера автомобилей).
• Классификация изображений (оценивает качество, оценивает соответствие признакам)
• Обнаружение лиц

Установка

Устанавливать рекомендуется через [composer][] выполнив:

composer razmik/yandex-vision "~0.1.0"

Использование

Пример распознавания документа

// Создание стандартного экземпляра HTTP клиента
$client = new YandexVisionApiClient('<token>', '<folderId>');
$yandexVision = new YandexVision($client);

// Документ на отправку
$document = new ImageDocument('./passport.jpg');

// Модель паспорта для распознавания
$model = new PassportModel();

// Получение данных
$results = $vision->getDetectedText($document, $model);

Пример классификации изображения

...

// Модель определения качества
$model = new QualityModel();

// Получение данных
$result = $vision->getClassifiedProperties($document, $model);

Пример обнаружения лиц

...

// Модель обнаружение лиц
$model = new FaceDetectionModel();

// Получение данных
$results = $vision->getFaceCoordinates($document, $model);

Типы документов

Модели распознавания

Распознавание текста

Классификация изображения

Обнаружение лиц

Обработка ошибок

Исключения

IAM токен

Изменение места хранения

По умолчанию токен авторизации сохраняется во временный файл YandexVisionIAMToken. Для изменения места хранения токена можно создать свое хранилище:

// Создание своего хранилища
class MyStorage implements IAMTokenStorageInterface
{
    ...
}

$storage = new MyStorage();

// Смена хранилища
$yandexVision = new YandexVision($client);
$yandexVision->setIamTokenStorage($storage);

Изменение времени хранения IAM токена

По умолчанию токен авторизации храниться 8 часов. Изменить время хранения токена:

// Задать время хранения IAM токена в секундах
IAMToken::$expiredAt = 4 * 3600;

HTTP клиент

Использование своего HTTP клиента

По умолчанию запросы отправляются через curl. Для подключения своего HTTP клиента:

// Создание своего HTTP клиента
class MyHTTPClient extends AbstractYandexVisionApiClient
{
    ...
}

$client = new MyHTTPClient();

// Использование HTTP клиента
$yandexVision = new YandexVision($client);

Контакы

Не стесняйтесь обращаться ко мне по email