Автомобиль нөмірлерін тану
Автомобиль нөмірлерін тану — detect әдісін қолданудың жеке жағдайы — бұл әдіс фотосуреттен әртүрлі объектілерді табуға мүмкіндік береді.
Авторизация деректері сұрау жолында беріледі:
Параметр | Тип | Значение |
|---|---|---|
oauth_token | string | OAuth2 access token (required non-empty) |
oauth_provider | string | OAuth2 провайдері (required non-empty) |
Қолдау көрсетілетін OAuth2 провайдерлері:
Провайдер | Значение oauth_provider | Получение токена |
|---|---|---|
VK Cloud | mcs | мақаланы қараңыз |
VK Cloud | mr | мақаланы қараңыз |
Сұрау параметрлері name="meta" параметрімен сұрау денесінде JSON форматында беріледі:
Параметр | Тип | Значение |
|---|---|---|
mode | []string | Берілген кескіндерден іздеу қажет объектілер түрлері (required non-empty) |
images | []image_meta | Берілетін кескіндердің метадеректері (required non-empty) |
mode мүмкін мәндері:
Параметр | Значение |
|---|---|
object | Кескіннен объектілерді іздеу |
scene | Кескіннен сахналарды іздеу |
car_number | Кескіннен автомобиль нөмірлерін іздеу |
multiobject | Кескіннен мультиобъектілерді іздеу - объектілер және табылған барлық объектілердің барлық бокстар жиынтығы |
pedestrian | Кескіннен адамдарды іздеу (кескіндегі барлық адамдардың бокстар жиынтығын дәлірек анықтайды) |
mode бір немесе бірнеше режимді қамтуы мүмкін. Мысалы:
"mode":["object"]<-- тек объектілерді іздеу;"mode":["scene"]<-- тек сахналарды іздеу;"mode":["object","scene"]<-- сахналар мен объектілерді іздеу.
image_meta параметрлері:
Параметр | Тип | Значение |
|---|---|---|
name | string | Сұраудағы және жауаптағы файлдарды сәйкестендіруге арналған файл атаулары (required non-empty) |
Кескіндер сұрау денесінде беріледі, name өрісінің мәндері images ішінде берілген мәндерге сәйкес болуы тиіс.
curl -X 'POST' 'https://smarty.mail.ru/api/v1/objects/detect?oauth_token=<ваш токен>&oauth_provider=mcs' -H 'accept: application/json' -H 'Content-Type: multipart/form-data' -F 'file=@objects_detect_ok_car_number.jpg;type=image/jpeg' -F 'meta={"mode": ["car_number"],"images": [{"name": "file"}]}'
Параметр | Тип | Значение |
|---|---|---|
status | int | Сәтті болған жағдайда 200, әйтпесе қате сипаттамасы body ішінде болады |
body | string | Жауап денесі |
response параметрлері:
Параметр | Тип | Значение |
|---|---|---|
scene_labels | []object | Сахналары бар әрбір файл үшін жауаптар массиві (болмауы мүмкін) |
object_labels | []object | Объектілері бар әрбір файл үшін жауаптар массиві (болмауы мүмкін) |
car_number_labels | []object | Автомобиль нөмірлері бар әрбір файл үшін жауаптар массиві (болмауы мүмкін) |
multiobject_labels | []object | Мультиобъектілері бар әрбір файл үшін жауаптар массиві (болмауы мүмкін) |
pedestrian_labels | []object | Адамдары бар әрбір файл үшін жауаптар массиві (болмауы мүмкін) |
object параметрлері:
Параметр | Тип | Значение |
|---|---|---|
status | enum | Орындау нәтижесі: - 0 — сәтті;- 1 — беттен табылған құжат түрлерінің массиві;- 2 — уақытша қате |
error | string | Қатенің мәтіндік сипаттамасы (optional) |
name | string | Сұраудағы және жауаптағы файлдарды сәйкестендіруге арналған файл атауы |
labels | []label | Кескіннен табылған объектілер (белгілер) тізімі |
count_by_density | int | Тығыздық картасының көмегімен есептелген кадрдағы адамдар саны ( mode="pedestrian" үшін ғана) |
label параметрлері:
Параметр | Значение |
|---|---|
eng | Табылған объектіге арналған белгі (атауы) ағылшын тілінде |
rus | Табылған объектінің белгісі (атауы) орыс тілінде |
eng_categories | Санаттар тізімі (әрбір санатқа көптеген белгілер кіреді) ағылшын тілінде (optional) |
rus_categories | Санаттар тізімі (әрбір санатқа көптеген белгілер кіреді) орыс тілінде (optional) |
prob | Кескінде дәл осы объектінің бар екеніне сенімділік дәрежесі |
coord | Табылған объектінің координаттары (optional) |
types_prob | Нөмірлік белгілер түрлерінің ықтималдықтар массиві. Қазіргі уақытта келесі түрлерге қолдау көрсетіледі: rus — Ресей нөмірлерінің барлық түрлері, cis — ТМД нөмірлері (жеке және украиналық әскери нөмірлерден басқа), eu — Еуропаның бірқабатты нөмірлері (optional, only for car_number mode) |
Сұрау үлгісі:
curl -X 'POST' 'https://smarty.mail.ru/api/v1/objects/detect?oauth_token=<ваш токен>&oauth_provider=mcs' -H 'accept: application/json' -H 'Content-Type: multipart/form-data' -F 'file=@persons_set_error_no_face.jpg;type=image/jpeg' -F 'meta={"mode": ["car_number"],"images": [{"name": "file"}]}'
Жауап үлгісі:
{"status": 200,"body": {"car_number_labels": [{"status": 0,"name": "file"}]},"htmlencoded": false,"last_modified": 0}
Сұрау үлгісі:
curl -X 'POST' 'https://smarty.mail.ru/api/v1/objects/detect?oauth_token=<ваш токен>&oauth_provider=mcs' -H 'accept: application/json' -H 'Content-Type: multipart/form-data' -F 'file=@empty.jpg;type=image/jpeg' -F 'meta={"mode": ["car_number"],"images": [{"name": "file"}]}'
Жауап үлгісі:
{"status": 400,"body": "empty image","htmlencoded": false,"last_modified": 0}
Сұрау үлгісі:
curl -X 'POST' 'https://smarty.mail.ru/api/v1/objects/detect?oauth_token=<ваш токен>&oauth_provider=mcs' -H 'accept: application/json' -H 'Content-Type: multipart/form-data' -F 'file=@persons_set_ok.jpg;type=image/jpeg' -F 'meta={"mode": ["car_number"],"images": [{"name": "file1"}]}'
Жауап үлгісі:
{"status": 400,"body": "could not get image by name file1: http: no such file","htmlencoded": false,"last_modified": 0}