JSON Fields (Protocol 1.6) \ JSON example

JSON Fields (Protocol 1.6) \ JSON example


Token

Type

Format / Value

Description

packetCounter

Unsigned int


Counter of packets. Starts from “1”. Counter starts after successful connection or after start of device. It does not matter.

datetime

string

YYYYMMDD HHMMSSFFF


YYYY - year 4 digits

MM - month 2 digits ( with leading 0 )

DD - day 2 digits ( with leading 0 )(space)

HH - hours

MM - minutes

SS - seconds

FFF - milliseconds

TimeZone in form +-HHMM optional.


%Y%m%d %H%M%S%3d

plateUTF8

UTF string

"RZ3832H"


plateUnicode

Unicode string

"RZ3832H"


plateText

Unicode string

\u0041\u0041….

Plate number in the unicode translation

https://www.branah.com/unicode-converter

plateCountry

ASCII string

[DNK,......UKR]

Country, ISO3166, ALPHA3

plateConfidence

float


Recognition confidence

carState

ASCII string

[new,updated,lost]

Event type. 

geotag: {
“lat”:,”lon”:
}

Json object with 

floats

50.418114,30.476213

Latitude, longitude

imageType

ASCII string

“plate” | “mmrcrop” | “vehicle” | “frame”

The kind of attached image: plate only rectangle with plate number, frame - full frame.

plateImageType

ASCII string

[png,jpeg,bmp]

The type of attached image. HTTP header must use the same type with header 

Content-type: image/...

plateImageSize

Unsigned long

0

The size in bytes of attached image, may be zero.

carMoveDirection

string

[unk,in,out]

The kind of detected movement

timeProcessing

Unsigned int


Time of image processing. ms

plateCoordinates

Array of unsigned int

[left,top,width,height]

Plate coordinates

carID

Unsigned long long


Internal runtime plate ID

sensorProviderID

ASCII string


The Human name of sensor

roiID

Unsigned int

1,2

Number of region of interest. ACAP support max 2 

frame_timestamp

unsigned long long

155131902113266

The returned value is nanoseconds for the system uptime(Frame time)

capture_timestamp

unsigned long long

1558090545839

Obtain the timestamp of the media_frame, measured in nanosecond. in the millisecond

capture_ts



To be deprecated

"vehicle_info":{"brand":"l",

"model":"","type":"","color":"",
"confidenceMMR":"",
"confidenceColor":"",
"coordinates":[]},

string

"vehicle_info":{"brand":"Opel","model":"Astra G",

"type":"CAR","color":"SILVER"
,"confidenceMMR":"96.657967",
"confidenceColor":"97.237495",
"coordinates":[1012, 272, 458, 272]},

Vehicle recognition date

Brand

Model 

Type

Color 

Confidence level  for MMR

Confidence level  for Color

Vehicle coordinated

imagesURI

string

["/local/fflprapp/tools.cgi?action=getImage&name=

2/20230519165230_615401lp_
H634TK750_210.jpg",
"/local/fflprapp/tools.cgi?action=getImage&name=
3/20191010165230_618056roi_
H634TK750_210.jpg"],

List of available event images’ URIs

"camera_info":{"SerialNumber":"",

"ProdShortName":""
,"MACAddress":""},

"sensorProviderID":"

string

"camera_info":{"SerialNumber":

"ACCC8EA617EF",
"ProdShortName":
"AXIS P1445-LE","MACAddress":
"AC:CC:8E:A6:17:EF"},

"sensorProviderID":"defaultID_175"

Camera Serial Number

Camra name 

Camera MAC address

SensorProviderID (from application)


JSON example

{"packetCounter":"7595700",

"capture_timestamp":"1638961134132",

"frame_timestamp":"1638961134132653",

"capture_ts":"1638961134132000000",

"datetime":"20231905 125854132",

"plateText":"\u0043\u0041\u0032\u0032\u0032\u0038\u0041\u004d",

"plateUnicode":"\u0043\u0041\u0032\u0032\u0032\u0038\u0041\u004d",

"plateUTF8":"CA2228AM",

"plateASCII":"CA2228AM",

"plateCountry":"UKR",

"plateConfidence":"0.708942",

"carState":"new",

"roiID":"1",

"geotag":{"lat": 50.418114,"lon": 30.476213},"imageType": "frame","plateImageType": "jpeg","plateImageSize": "0","carMoveDirection":"unknown",

"timeProcessing":"0",

"plateCoordinates":[1193, 439, 98, 20],

"plateCoordinatesRelative":[1176, 439, 98, 20],

"carID":"521893",

"GEOtarget":"Camera",

"imagesURI":["/local/fflprapp/tools.cgi?action=getImage&name=24/20231905105854_132_lp_CA2228AM_UKR_Opel_Astra G_SILVER.jpg","/local/fflprapp/tools.cgi?action=getImage&name=25/20231905105854_132_roi_CA2228AM_UKR_Opel_Astra G_SILVER.jpg"],

"imageFile":"/var/spool/storage/SD_DISK/fflprapp/images/25/20231905105854_132_roi_CA2228AM_UKR_Opel_Astra G_SILVER.jpg",

"vehicle_info":{"brand":"Opel","model":"Astra G","type":"CAR","color":"SILVER","confidenceMMR":"96.657967","confidenceColor":"97.237495","coordinates":[1012, 272, 458, 272]},

"camera_info":{"SerialNumber":"ACCC8EA617EF","ProdShortName":"AXIS P1445-LE","MACAddress":"AC:CC:8E:A6:17:EF"},

"sensorProviderID":"defaultID_175"

}

​


    • Related Articles

    • Event response \ Event response data example

      Response contains XML document, data fields are as follows: Field Description TS Event timestamp, Unix timestamp, UTC, milliseconds MOD_TS Event timestamp, human readable CAR_ID Vehicle ID, per database id LPR Number plate as text RTIME License plate ...

    • API FF Integration Events \ HTTP Multipart POST

      New Event: This event occurs when a vehicle is detected for the first time. The direction of the vehicle is undefined. Update Event: This event occurs when there is a change in the data package. It can include updates to the recognized license plate, ...

    • FF-Events Configuration

      To send the recognized data to other applications such as VMS (Video Management Systems) or Data Management Systems, you can utilize FF-Events in CAMMRA. Follow these steps to set up event sending: Go to the application's web page and select the ...

    • Events Request \ Request URL Examples

      To download event records from the on-camera database, you can make an HTTP GET request using the following target: http://<camera-IP-address>/local/fflprapp/search.cgi?<paramName1>=<value1>&<paramName2>=<value2> The request allows you to specify ...

    • Real-time Events API (VAPIX or ONVIF)

      To receive real-time recognition events from the camera, you can utilize either the VAPIX or ONVIF protocol. These protocols allow you to access event data packets containing relevant information without the actual image. The packet structure for ...