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);
Тип документа | Экземпляр класса |
---|---|
Изображение | $document = new ImageDocument('./file'); |
$document = new PdfDocument('./file'); |
Модель | Экземпляр класса |
---|---|
Паспорт | $model = new PassportModel(); |
ВУ, лицевая сторона | $model = new DriverLicenseFrontModel(); |
ВУ, обратная сторона | $model = new DriverLicenseBackModel(); |
Регистрационные номера | $model = new LicensePlateModel(['ru']); |
Модель | Экземпляр класса |
---|---|
Качество изображения | $model = new QualityModel(); |
Признаки изображения | $model = new ModerationModel(); |
Модель | Экземпляр класса |
---|---|
Обнаружение лиц | $model = new FaceDetectionModel(); |
Модель | Экземпляр класса |
---|---|
Интерфейс всех исключений | YandexVisionExceptionInterface(); |
Не корректный документ | YandexVisionDocumentException(); |
Не корректный запрос | YandexVisionRequestException(); |
Ошибка работы с IAM токеном | YandexVisionIAMTokenException(); |
Ошибка авторизации | YandexVisionAuthException(); |
По умолчанию токен авторизации сохраняется во временный файл YandexVisionIAMToken. Для изменения места хранения токена можно создать свое хранилище:
// Создание своего хранилища
class MyStorage implements IAMTokenStorageInterface
{
...
}
$storage = new MyStorage();
// Смена хранилища
$yandexVision = new YandexVision($client);
$yandexVision->setIamTokenStorage($storage);
По умолчанию токен авторизации храниться 8 часов. Изменить время хранения токена:
// Задать время хранения IAM токена в секундах
IAMToken::$expiredAt = 4 * 3600;
По умолчанию запросы отправляются через curl. Для подключения своего HTTP клиента:
// Создание своего HTTP клиента
class MyHTTPClient extends AbstractYandexVisionApiClient
{
...
}
$client = new MyHTTPClient();
// Использование HTTP клиента
$yandexVision = new YandexVision($client);
Не стесняйтесь обращаться ко мне по email