Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

General request format:

POST http://IP-address:port/prefix/firserver/GetAnalitycByTime

Request parameters:

ParameterRequiredParameter description
server_idYes

Identifier of the Face Recognition Server in Face Intellect

(see Configuring the Face Recognition Server object)

minAgeNoMinimum age of persons
maxAge NoMaximum age of persons
dateTimeFrom YesTime in UTC format, starting from which the data should be obtained
dateTimeTo YesTime in UTC format, up to which the data should be obtained
cameraIds NoCamera IDs in Face Intellect
 (see Creating and configuring the Camera object)
genders YesGender of persons whose data should be obtained: 0 - Unknown, 1 - Males, 2 - Females
returnLocalTimeNoTime format of the face capture: 0 - time in UTC format, 1- local time of the Server
timePeriodNoType of grouping the analytic data: 0 - by hour, 1 - by day, 2 - by month, 3 - by year

...

Request example:

POST http://localhost:10000/firserver/GetAnalitycByTime

Expand


Code Block
{
  "server_id": "1",
  "minAge": 20,
  "maxAge": 30,
  "dateTimeFrom": "2019-02-25T21:00:00.000",
  "dateTimeTo": "2019-02-29T20:59:59.000",
  "cameraIds": [
    "1"
  ],
  "genders": [
    0
    1,
    2
  ],
  "returnLocalTime" : 0,
  "timePeriod" : 0
}

...


Response example:

Expand


Code Block
{
    "Rows": [
        {
            "timestamp": "2019-02-27T180000.000",
            "value": [
                {
                    "age": 27,
                    "gender": {
                        "males": 10,
                        "females": 9,
                        "unknown": 0
  					},
					"smile": {
 						"males": 3,
 						"females": 1,
						"unknown": 0
					},
					"angry": {
						"males": 1,
  						"females": 2,
  						"unknown": 0
                	},
					"fear": {
 						"males": 1,
 						"females": 2,
						"unknown": 0
					},
					"happiness": {
						"males": 1,
  						"females": 1,
  						"unknown": 0
                	},
					"neutral": {
 						"males": 2,
 						"females": 1,
						"unknown": 0
					},
					"sadness": {
						"males": 1,
  						"females": 1,
  						"unknown": 0
                	},
					"surprise": {
						"males": 1,
  						"females": 1,
  						"unknown": 0
                	}
				}
            ]
        }
    ]
    "ResponceResponse": {
        "Status": "SUCCESS"
    }
}


Response parameters:

ParameterParameter description
RowsList of unique faces
timestampFirst pass time in UTC format
value
Responce
List of additional face characteristics (for more details, see Getting the recognition protocol)
ResponseResponse
StatusCompleted request status: SUCCESS - successful
Status