Description

This document will introduce how to integrate between Milesight LPR camera and NVR or VMS (Including Milesight brand and the third parties brand). There are three post types: TCP, HTTP and RTSP.

Note:

1. For the Evidence function, please make sure your camera’s model is TSxxxx-xxC or MS-Cxxxx-xLC and your camera’s version is 45.8.0.3-      

     LPR*-r1 or above. 

2. For the Parking Detection, please make sure your camera’s model is TSxxxx-FPC/P and your camera’s version is 45.8.0.3-LPR*-r3 or above.

3. For the Vehicle Counting, please make sure your camera’s model is TSxxxx-xxC (Except for TSxxxx-FPC/P).

{
 “registerAll”: 1,
}
②When you want to register only one feature, you can set that feature to 1 and set the “registerAll” to 0, refer to the following case:
{
 “registerAll”: 0,
     “vehiclecount”: 1
}
Or
{
 “registerAll”: 0,
      “lprparking”: 1
}

l Vehicle Type Table

There are two post modes for the Parking Detection: Trigger mode and Period mode, please refer to the following cases:

①Trigger Mode

{
"event":"Parking Detection",
"device":"Network Camera",
"time":"2023-01-02 23:46:24",
"report_type":"trigger",
"region":1,
"region name":"ROI1",
"state":0,
"Length of Parking":"00:00:31",
"License Plate":"BD925RA",
"Plate Color":"Blue",
"Vehicle Type":"Car",
"Vehicle Color":"Blue",
"Vehicle Brand":"Buick",
"Object tracking box_x1":732,
"Object tracking box_y1":885,
"Object tracking box_x2":1193,
"Object tracking box_y2":1558,
"plateSnap":"....(BASE64 code)",
"bkgSnap":"....(BASE64 code)"
}

②Period Mode

{
"event":"Parking Detection",
"device":"Network Camera",
"time":"2023-01-02 23:54:54",
"report_type":"interval",
"total_occupied":1,
"total_available":3,
"region":[1, 2, 3, 4],
"region name":["ROI_1", "ROI_2", "ROI_3", "ROI_4"],
"state":[1, 0, 0, 0],
"data list":[{
"region":1,
"region name":"ROI_1",
"state":1,
"Length of Parking":"00:00:17",
"License Plate":"DD925RA",
"Plate Color":"Blue",
"Vehicle Type":"SUV",
"Vehicle Color":"Blue",
"Vehicle Brand":"Buick",
"Object tracking box_x1":1092,
"Object tracking box_y1":870,
"Object tracking box_x2":1509,
"Object tracking box_y2":1541,
            "plateSnap":"....(BASE64 code)"
        },
        {
"region":2,
"region name":"ROI_2",
"state":1,
"Length of Parking":"00:01:17",
"License Plate":"DD92AAA",
"Plate Color":"Blue",
"Vehicle Type":"SUV",
"Vehicle Color":"Blue",
"Vehicle Brand":"Buick",
"Object tracking box_x1":1092,
"Object tracking box_y1":870,
"Object tracking box_x2":1509,
"Object tracking box_y2":1541,
            "plateSnap":"....(BASE64 code)"
        }
    ],
"bkgSnap":"....(BASE64 code)"
}

l COMM_COUNTING_POST

This is specifically for the Vehicle Counting, make sure your camera’s model and firmware version support this function, as shown below:

There are two post modes for the Vehicle Counting: Instant mode and Customize mode, please refer to the following cases:

{
"event":"Vehicle Counting",
"device":"Network Camera",
"time":"2023-01-03 00:28:07",
"region":1,
"region name":"ROI_1",
"All-Car":1,
"All-Motorcycle":0,
"All-Non-motor":0,
"Car":1,
"Motorbike":0,
"Bus":0,
"Truck":0,
"Van":0,
"SUV":0,
"Fire engine":0,
"Ambulance":0,
"Bicycle":0,
"Other":0,
"snapshot":"....(BASE64 code)"
}

②Customize Mode

{
"event":"Vehicle Counting",
"device":"Network Camera",
"time":"2023-01-03 01:00:00",
"regionList":[{
"region":1,
"region name":"ROI_1",
"All-Car":23,
"All-Motorcycle":0,
"All-Non-motor":0,
"Car":19,
"Motorbike":0,
"Bus":0,
"Truck":1,
"Van":0,
"SUV":3,
"Fire engine":0,
"Ambulance":0,
"Bicycle":0,
"Other":0
}, {
"region":2,
"region name":"ROI_2",
"All-Car":40,
"All-Motorcycle":1,
"All-Non-motor":0,
"Car":35,
"Motorbike":1,
"Bus":2,
"Truck":2,
"Van":0,
"SUV":1,
"Fire engine":0,
"Ambulance":0,
"Bicycle":0,
"Other":0
}, {
"region name":"Total",
"All-Car":63,
"All-Motorcycle":1,
"All-Non-motor":0,
"Car":54,
"Motorbike":1,
"Bus":2,
"Truck":3,
"Van":0,
"SUV":4,
"Fire engine":0,
"Ambulance":0,
"Bicycle":0,
"Other":0
}],
"snapshot":"....(BASE64 code)"
}

1. HTTP Type

  l Integrate Method

For the HTTP Type, currently our LPR camera supports HTTP Post and Get request method.

VMS or NVR needs to develop matched API to receive the LPR information from the camera. The matched API URL may be like below:

URL of Post Method: http://IP:Port/xxxx

URL of Get Method: http://IP:Port/xxxx? 

After VMS or NVR has completed the API, our LPR camera could use the API URL to send LPR information to the VMS or NVR when the license plate is recognized.

  l LPR Information transfer

    ü Post Method

Take an example, the API URL from a VMS is like：

“http://192.168.69.28:8092/api/httpEvent” 

Fill in the specified URL in camera’s web UI (if the VMS requires the authentication, please also fill in) : 

Camera will post the LPR information data in json format to the VMS or NVR in real time when it is recognized.

The content that will be sent is as follows:

For sending the license plate information, the LPR camera will automatically add the license plate parameters to the URL.

For example, the license plate is “MS12345”. Once it’s detected, the LPR camera will send below URL to VMS:

http://192.168.69.28:8092/api/httpEventsource=LPR&description=MS12345

If the license plate information is to be displayed in VMS, the VMS side needs to extract it from the URL.

<tt:MetaDataStream>
 <tt:Event>
 <wsnt:NotificationMessage>
 <wsnt:Topic Dialect="http://www.onvif.org/ver10/tev/topicExpression/ConcreteSet">tns1:RuleEngine/LicensePlateDetector/LicensePlate</wsnt:Topic>
 <wsnt:Message>
 <tt:Message UtcTime="2018-05-15T06:19:34Z" PropertyOperation="Changed">
 <tt:Source>
 <tt:SimpleItem Name="VideoSourceConfigurationToken" Value="VideoSourceToken"/>
 <tt:SimpleItem Name="VideoAnalyticsConfigurationToken" Value="VideoAnalyticsToken"/>
 <tt:SimpleItem Name="Rule" Value="MyLicensePlateDetectorRule"/>
  </tt:Source>
 <tt:Key>
 <tt:SimpleItem Name="LicensePlateResult" Value="43거6510"/>
  </tt:Key>
  <tt:Data>
 <tt:SimpleItem Name="LicensePlatePicturePath" Value="/LPR/2018051506193401.jpg"/>
<tt:SimpleItem Name="LicenseCarSpeed" Value="25km/h"/>
<tt:SimpleItem Name="LicenseCarDirection" Value="1"/>
  </tt:Data>
  </tt:Message>
  </wsnt:Message>
  </wsnt:NotificationMessage>
  </tt:Event>
  </tt:MetaDataStream>

Description: You can receive the recognized license plate image through the snapshot path and the command named get ( ex. http://IP:PORT/LPR/2018051506193401.jpg). Only 10 latest images are available for download. (If you can't see image in the NVR or VMS, type url ( ex.http://IP:PORT/LPR/2018051506193401.jpg) in the web browser address box to see if the image is visible.)

  l LPR information transfer 

When the integration is complete, the LPR camera sends an xml containing LPR information to the VMS or NVR in real time when it is recognized.

—END—