Поиск объектов в системе

FindFace Multi позволяет выполнять поиск лиц, силуэтов и транспортных средств (далее — объектов) по всей системе.

Вы можете выполнить поиск объектов одним из следующих способов:

  • загрузив фотографию

  • по ID события

  • по ID объекта

  • по ID кластера

Чтобы найти объект по загруженной фотографии, выполните следующие действия:

  1. Загрузите фотографию с помощью метода POST /detect: прикрепите исходный файл изображения и отправьте POST-запрос.

  2. Проверьте ответ: он будет содержать id обнаруженного объекта и координаты ограничивающей рамки (bbox) вокруг этого объекта.

  3. Если на изображении несколько объектов, выберите один из них, нужный вам, и скопируйте его id.

  4. Используйте один из следующих методов для поиска выбранного объекта:

    • GET /cards/humans/ (поиск в карточках людей)

    • GET /cards/cars/ (поиск в карточках транспортных средств)

    • GET /events/faces/ (поиск в событиях с лицами)

    • GET /events/bodies/ (поиск в событиях с силуэтами)

    • GET /events/cars/ (поиск в событиях с транспортными средствами)

    • GET /clusters/faces/ (поиск в кластерах лиц)

    • GET /clusters/bodies/ (поиск в кластерах силуэтов)

    • GET /clusters/cars/ (поиск в кластерах транспортных средств)

  5. В параметре looks_like выбранного метода укажите скопированный id в следующем формате: detection:<detection_id>. Указанный id должен соответствовать типу объекта, который поддерживается выбранным методом. Например, если вы используете метод GET /cards/humans/, то указанный id должен принадлежать лицу или силуэту.

  6. При необходимости ограничьте поиск, указав дополнительные параметры фильтрации, такие как список наблюдения (watch_lists, matched_lists), порог срабатывания (threshold) и т. д.

  7. Отправьте GET-запрос. Ответ будет содержать результаты поиска. Например, если вы используете метод GET /cards/humans/ для поиска по id лица, обнаруженного на фотографии, то метод вернет одну или несколько карточек, каждая из которых будет включать объект looks_like с параметром matched_object, содержащим ID лица, которое похоже на искомое лицо. Пример.

Помимо загрузки фотографии, вы можете найти нужный объект непосредственно по ID события, объекта или кластера следующим образом:

  1. Выберите один из методов, перечисленных в пункте 4 выше.

  2. В параметре looks_like выбранного метода укажите одно или несколько поисковых выражений. Каждое выражение должно соответствовать следующему формату: {face|body|car}{event|object|cluster}:<id>, где face (лицо), body (силуэт) и car (транспортное средство) обозначают тип объекта.
    Указанные выражения должны содержать только тот тип объекта, который поддерживается выбранным методом. Допустимые выражения для каждого метода приведены в таблице ниже.

Примечание

При необходимости в параметре looks_like можно указать приведенные ниже выражения вместе с выражением detection:<detection_id>.

Метод

Допустимые выражения для параметра looks_like

GET /cards/humans/

{face|body}event:<event_id>, {face|body}object:<object_id>, {face|body}cluster:<cluster_id>

GET /cards/cars/

carevent:<event_id>, carobject:<object_id>, carcluster:<cluster_id>

GET /events/faces/

faceevent:<event_id>, faceobject:<object_id>, facecluster:<cluster_id>

GET /events/bodies/

bodyevent:<event_id>, bodyobject:<object_id>, bodycluster:<cluster_id>

GET /events/cars/

carevent:<event_id>, carobject:<object_id>, carcluster:<cluster_id>

GET /clusters/faces/

faceevent:<event_id>, faceobject:<object_id>, facecluster:<cluster_id>

GET /clusters/bodies/

bodyevent:<event_id>, bodyobject:<object_id>, bodycluster:<cluster_id>

GET /clusters/cars/

carevent:<event_id>, carobject:<object_id>, carcluster:<cluster_id>