Export task

Task allows to collect objects of interest (either events or faces) and export them in form of zip archive. Zip archive contains csv file with rows representing requested objects and, if requested, corresponding samples (images).

Please note, the task uses memory when collecting data. So, its possible that worker will be killed by OOM if you request a lot of data.

Currently, there are two types of objects you can export from the system - faces and events. One should specify what type of objects is required by setting field objects_type when creating a task.

One can narrow request by providing filters.

Filters for faces:

account_id: required, filter by account id
list_id: id of the list, which faces will be linked to
create_time__gte: lower included bound for object create_time
create_time__lt: upper bound for object create_time (current time for default)
face_ids: face ids
user_data: user data filter
external_ids: filter by list of external Ids
face_id__lt: face_id upper excluded boundary
face_id__gte: face_id lower included boundary

Filters for events:

account_id: required, filter by account id
external_ids: filter by list of external Ids
create_time__lt: upper bound for object create time (current time for default)
create_time__gte: lower included bound for object create_time
sources: source filter
event_ids: event ids
event_id__lt: event_id upper excluded boundary
event_id__gte: event_id lower included boundary
handler_ids: handler ids
top_matching_candidates_label: top matching candidate label
top_similar_object_ids: top similar object ids
top_similar_external_ids: top similar external ids
top_similar_object_similarity__gte: top similar object similarity lower included bound
top_similar_object_similarity__lt: top similar object similarity upper excluded bound
age__lt: age upper excluded bound
age__gte: age lower included bound
gender: gender filter
emotions: emotions filter
ethnic_groups: ethnic group filter
face_ids: face ids
user_data: user data filter
tags: tags filter
cities: city location filter
areas: area location filter
districts: district location filter
streets: street location filter
house_numbers: house number location filter
geo_position: geo position filter
masks: medical mask state filter
track_ids: track id filter

Csv examples:

event_id,create_time,external_id,handler_id,source,top_match,face_id,gender,age,emotion,ethnic_group,user_data,mask,track_id,city,area,district,street,house_number,geo_position
0370f6b6-643a-4ad6-8c30-57849d7b070d,2021-06-18T09:01:45.115401+03:00,a2c4ef84-8ed6-4b9c-b4ac-b96e7ae4d973,0f474053-8b2c-4d62-bfd0-b2f6072464cd,a7f009a9-3a98-4e5b-8e45-0c43290c84df,"{'face_id': '23978f64-305f-4c43-8c01-c40bafabe554', 'label': '3a118ebc-18e2-4ed0-a0f0-3a50db652729', 'similarity': 0.6, 'external_id': 'e0'}",f687a4d1-0d25-4940-bbda-192b7b964fed,1,33,7,1,1111632d-70fc-4e2e-b336-d5a68e1deb14,1,09e6642b-1ebe-405d-9bcd-86bbe254dc4f,27187d70-190c-460d-b344-1c0e432097c9,e67c212a-e78f-4568-ae18-0e62bef67943,cccd64ef-2f37-46b4-8968-9f98a70d505d,e6cdc2ee-d93a-439c-9506-7dbd466aafb9,6471cc07-f7d0-4986-8887-6b8acb1c62cd,"55.752,36.616"
0370f6b6-643a-4ad6-8c30-57849d7b070c,2021-06-18T09:01:45.115206+03:00,2ba4dcb3-0ca6-43b2-a588-42cd776a09ab,2daa17f1-a5e6-4d7b-bae4-a224eec35eee,c038bede-f002-4c74-98fe-d3686b043fcd,"{'face_id': 'ad008886-942c-4c13-934c-8232dc7eefb2', 'label': '15859afa-37d3-41e2-8bc2-cb6f970dc6a0', 'similarity': 0.6, 'external_id': 'e1'}",ed5ea7ce-02b3-4129-b3e8-4721b678c463,1,33,7,1,42d908a4-52c5-4f46-87bd-4903ee315260,1,b152f0a9-2fe7-458d-9107-9783cf14e491,30cfdf82-e884-41b7-9d4b-691e372a1126,53ba74e8-cdf7-423d-92ad-4e3a325793d7,9590aa0a-2fd9-4fc5-ad6a-314b2909166b,c85fc383-3163-4267-9d2a-80c887eebc47,513c4901-0ca2-4670-b00e-274b59e90562,"55.752,36.616"
0370f6b6-643a-4ad6-8c30-57849d7b070b,2021-06-18T09:01:45.115014+03:00,ca23bb19-6c15-4466-a89c-b1181adaf874,757318b2-3570-496a-b3c2-5d8a024e0ae1,4fd91006-d51a-4491-8923-1c6341a579c4,"{'face_id': 'c77bda6b-74ea-412f-989f-f27fd5be1e20', 'label': '3ac8c676-c717-4da4-8ed3-6ca9e6139c6d', 'similarity': 0.6, 'external_id': 'e2'}",ae6381e6-0341-47bb-9989-3a3706ae99f9,1,33,7,1,079c8ecc-d29b-4ab5-aa65-d1954b5101d6,1,e6495a29-7c25-45bd-b9f6-17d954f5a485,1b5f121a-b010-479a-aaa8-9f4773d1576e,75ce6466-9422-4003-817f-1ff5ab947a6f,42bbcdc9-964a-4219-b6fb-1ff7c044f90a,9b85b48b-e763-4869-aa81-4d64409ba94b,eb00d36a-aad8-4fee-9529-3c1e8c01d523,"55.752,36.616"
0370f6b6-643a-4ad6-8c30-57849d7b070a,2021-06-18T09:01:45.114805+03:00,7e1c37d0-74f1-4ca7-8fbe-f5c26b6a5fb7,7c57c339-4fc3-4a1a-90e3-e932eb4b022d,8391e7c7-a8b1-4466-8b1e-76433f3e92a7,"{'face_id': '477a4ef7-16dc-4189-ab3b-91b1d342e101', 'label': '64058eac-eff1-4efc-b6c3-982133523a31', 'similarity': 0.6, 'external_id': 'e3'}",830bc063-d5ca-4eba-a8c3-2094d9e4bd32,1,33,7,1,5068d60e-5f50-4e45-bdbf-d68a3020097c,1,b3b780ea-76f2-4147-ae4e-674bbf8c8aa0,40dbc6f9-746d-46d9-9da6-346503bd8568,d2baae0e-a936-4693-adf9-265aea95bc4a,60c5dbb4-9133-4ff5-aa67-c1ec1dfeb8be,e60dd9d4-e7e3-4bd3-9f5d-682ea6dc14ba,035c03af-31f0-4d5a-900b-e6c14521dcff,"55.752,36.616"
0370f6b6-643a-4ad6-8c30-57849d7b0709,2021-06-18T09:01:45.114531+03:00,3a95f340-9b02-4b4d-b56c-bc6aeaae46db,aa7d4de1-d4fb-4052-acb4-1ccb5be99ece,c1275d2f-95d1-4034-870f-da0a8f9d02b8,"{'face_id': '7f5bf6fb-2ad0-42bf-98f2-fe949516db7d', 'label': 'be309d4d-deaa-479e-ba70-026a712f39e2', 'similarity': 0.6, 'external_id': 'e4'}",64c4f42e-e7e3-4a72-93d8-399e5c8451c9,1,33,7,1,7bcc784c-d699-492e-99e5-5c3cdea79764,1,d0e339e3-472a-4da0-b90a-43693ca5fb47,bbfd5d28-accc-4a0b-b284-ff326d41aca3,96224d95-e4fa-4232-8a0d-4c4b59d60547,5e35ace6-f0e3-4c0a-b192-7de03cd6f9e3,9eee5b1f-a40b-42e2-80b8-28603bbca53d,93257670-44a7-425b-a149-bbffe7d7ed24,"55.752,36.616"

face_id,user_data,create_time,external_id,avatar,event_id
12ac141d-41bc-492d-abe1-20ec9859f081,,2021-06-18T07:57:31.898254+03:00,cde3a087-f653-4f55-9b60-54b8a6aa5724,http://image-store:5020/1/buckets/visionlabs-samples/images/993d7f29-bce8-4ce1-b843-75e1ee999115,
12ac141d-41bc-492d-abe1-20ec9859f080,,2021-06-18T07:57:31.890626+03:00,f63db608-879d-4f0c-b5be-daffff14097f,http://image-store:5020/1/buckets/visionlabs-samples/images/71c89050-ce26-49b3-bf9c-ab5ddd065326,