Help Center/ Video Intelligent Analysis Service/ API Reference/ Alarm Information/ Water Level Gauge Reading
Updated on 2024-02-29 GMT+08:00
View PDF

Water Level Gauge Reading

  • Data streams in JSON format are output to the specified webhook URLs, including structured data.
  • Result example:
    { 
    "task_id": "task7qe4sbmo", 
    "stream_id": "123456", 
    "timestamp": 1569418161, 
    "event_type": 33816579, 
    "image_base64": "/9j/4AAQSkZJRgA...", 
    "message_id": "7BA3A6AE-DF98-11E9-A00A-34B354BC6688",
    "data": {
        "water_level_list": [{
            "water_level":12.00,
            "polygon": [
                {"x":494,"y":302},
                {"x":565,"y":302},
                {"x":565,"y":321},
                {"x":494,"y":321}
            ]
        }]
    }
}
  • JSON format

    Field

    Type

    Description

    task_id

    String

    ID of the visual task delivered by IVA

    stream_id

    String

    ID of the camera on VCN

    timestamp

    Int

    Timestamp when an event occurs, in seconds

    event_type

    Int

    Event type of the output message. The value is fixed to 33816579.

    image_base64

    String

    Base64 encoding results of the image correspond to the video frame when an event occurs

    message_id

    String

    Event ID, which is a unique string

    data

    Object

    Event description, including water level readings. For details, see the following table.
  • Event list

    Field

    Type

    Description

    water_level_list

    List[Object]

    List of water level readings
  • Event information

    Field

    Type

    Description

    water_level

    Float

    Water level reading, in cm.

    When an exception occurs, this field is used as an error code. There are three types of error codes:

    • 999 indicates that the calibration information (calibration_info) provided during job creation does not comply with the specifications.
    • 998 indicates that there is no water level gauge in the image.
    • 997 indicates that there is a water level gauge in the image, but the result is unreliable because the horizontal distance between the detected intersection point of the water level gauge and the water surface and the leftmost or rightmost vertex of the calibration information is too long.

    polygon

    List[Object]

    Four vertices of a rectangle whose midpoint is the intersection point of the water level gauge and the water surface. The information is not directly related to the service and is not perceivable to users.
Parent topic: Alarm Information