Versions Compared

Key

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

GET http://IP Address:port/prefix/archive/events/detectors/{ENDTIME}/{BEGINTIME}get detections from all Axxon-domain Servers—모든 Axxon 도메인 서버에서 감지 이벤트를 가져옵니다.

Note
titleAttention!

The ENDTIME and BEGINTIME syntax is described inENDTIME과 BEGINTIME 구문은 아카이브 내용 가져오기.

If ENDTIME < BEGINTIME in the request, then the events in the response will be sorted by time in ascending order.

섹션에 설명되어 있습니다.

요청에서 ENDTIME이 BEGINTIME보다 작으면 응답의 이벤트는 시간이 오름차순으로 정렬됩니다.

ENDTIME이 BEGINTIME보다 크면 이벤트는 내림차순으로 정렬됩니다If ENDTIME > BEGINTIME, then the events will be sorted in descending order.

GET http://IP Address:port/prefix/archive/events/detectors/{HOSTNAME}/{ENDTIME}/{BEGINTIME}get detections from a certain Server.—특정 서버에서 검출 이벤트 가져오기

Tip

{HOSTNAME}Server name (see —서버 이름 (서버 목록 가져오기 참조).

GET http://IP Address:port/prefix/archive/events/detectors/{VIDEOSOURCEID}/{ENDTIME}/{BEGINTIME}get detections from a certain camera.—특정 카메라에서 검출 이벤트 가져오기

Tip

{VIDEOSOURCEID}three-component source endpoint ID (see —3부 구성 소스 엔드포인트 ID (비디오 카메라 목록 및 정보 가져오기 참조). For instance, 예: "SERVER1/DeviceIpint.3/SourceEndpoint.video:0:0".


Parameter파라미터터Required필수Description설명
limitNoLimit of detections in the response. If not specified, it is equal to 100

응답에서 감지의 제한. 지정되지 않으면 기본값은 100입니다.

offsetNoThe results offset by the specified number. For example, if a query with offset=0 returned 100 results, then in order to get the next results, it is necessary to run a query with offset=100. If the second query returned 250 results, then in order to get the next results, it is necessary to run a query with offset=350, etc지정된 수만큼 결과가 오프셋됩니다. 예를 들어, offset=0으로 쿼리하여 100개의 결과를 반환했다면 다음 결과를 얻기 위해서는 offset=100으로 쿼리를 실행해야 합니다. 두 번째 쿼리가 250개의 결과를 반환했다면 다음 결과를 얻기 위해서는 offset=350으로 쿼리를 실행해야 합니다. 이와 같은 방식입니다.
typeNo

Get detections from a certain detection tool. The values of the type parameter are listed in the table below.

If you need to get detections from several detection tools, you need to list them separated by commas특정 감지 도구에서 감지 이벤트를 가져옵니다. type 매개변수의 값은 아래 표에 나와 있습니다.
여러 감지 도구에서 감지 이벤트를 가져오려면 쉼표로 구분하여 나열해야 합니다.

joinNo

If join=1, then in the response, the two-phase events will be merged together, and the duration parameter will be returned which corresponds to the event duration.If join=0, then in the response, the two-phase events will not be merged together이면 응답에서 두 단계 이벤트가 병합되고, duration 매개변수가 이벤트 지속 시간에 해당하는 값으로 반환됩니다.

join=0이면 응답에서 두 단계 이벤트가 병합되지 않습니다.

limit_to_archiveNo

If limit_to_archive=1 , then the response will return the events only from the accessible part of the archive (see Configuring access restrictions to archive이면 응답은 접근 가능한 아카이브 부분에서만 이벤트를 반환합니다 (아카이브 접근 제한 구성 참조)

archiveNo

The name of the archive from the request to receive the list of archives (see 아카이브 목록을 가져오기 위한 요청에서 아카이브 이름을 지정해야 합니다(아카이브 내용 가져오기 참조)

detectorNo

Starting with Axxon One2.0

Get detections from a certain detection tool. The values of the detector parameter are listed in the table below

0부터

특정 검출 도구에서 감지 이벤트를 가져올 수 있으며 detector 매개변수의 값은 아래 표에 나와 있습니다.

샘플 요청Sample requests:

  • http://127.0.0.1:80/archive/events/detectors/Server1/DeviceIpint.2/SourceEndpoint.video:0:0/past/future?limit=10&offset=0get detections from a certain camera, sorted in descending order. The maximum limit is 10특정 카메라에서 감지 이벤트 가져오기, 내림차순 정렬. 최대 제한은 10입니다.
  • http://127.0.0.1:80/archive/events/detectors/Server1/past/future?limit=5&offset=0get detections from all detection tools of Server1. The maximum limit for each detection tool is 5—Server1의 모든 검출 도구에서 감지 이벤트 가져오기. 각 감지 도구에 대한 최대 제한은 5입니다.
  • http://127.0.0.1:80/archive/events/detectors/Server1/past/future?limit=5&offset=0&type=Rayget detections from all sensors of Server1. The maximum limit for each sensor is 5—Server1의 모든 센서에서 감지 이벤트 가져오기. 각 센서에 대한 최대 제한은 5입니다.
  • http://127.0.0.1:80/archive/events/detectors/A-ZHUKOV/DeviceIpint.1/SourceEndpoint.video:0:0/future/past?limit=100&detector=hosts/Server1/AVDetector.1/EventSupplier—get detections from a certain detection tool of Server1.EventSupplier—Server1의 특정 검출 도구에서 감지 이벤트 가져오기
  • http://root:root@127.0.0.1:80/archive/events/detectors/Server1/DeviceIpint.1/SourceEndpoint.video:0:0/20230323T112000.000/20230430T210000.000?limit=100&offset=0&type=listed_face_detected,MotionDetected—get detections from several detection tools of Server1. The detection tools must be listed separated by commas—Server1의 여러 감지 도구에서 감지 이벤트 가져오기. 감지 도구는 쉼표로 구분하여 나열해야 합니다.
  • http://127.0.0.1:80/archive/events/detectors/past/future?limit=1&type=Rayget the current state of all sensors of the Axxon-domain.—Axxon 도메인의 모든 센서에서 현재 상태 가져오기
Note
titleAttention!

It is recommended to use the 첫 번째 요청에서는 past/future parameter only in the first request. Then you should get the timestamp of the most recent record and use it to request subsequent records. Using the past/future parameter along with the limit and offset parameters in subsequent requests can result in duplicate records.매개변수를 사용하는 것이 좋습니다. 이후에는 가장 최근 기록의 타임스탬프를 얻어 이를 사용하여 후속 기록을 요청해야 합니다. 이후 요청에서 past/future 매개변수와 limit, offset 매개변수를 함께 사용하면 중복된 기록이 반환될 수 있습니다.

샘플 응답Sample response:

Expand
titleClick to expand

1) join=1

Code Block
{
    "events": [
        {
            "duration": "000000.467000",
            "id": "09b8729a-a6fc-4ffa-8a83-aebc5c19d171",
            "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
            "rectangles": [
                {
                    "bottom": "0.20831976890563964",
                    "index": "0",
                    "left": "0.57320795059204099",
                    "right": "0.6804207420349121",
                    "top": "0.09125151634216308"
                }
            ],
            "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
            "timestamp": "20190618T112815.527000",
            "type": "moveInZone"
        },
        {
            "duration": "000004.154000",
            "id": "90c5d09e-c0bb-4c49-bf8b-22d3afffe8c1",
            "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
            "rectangles": [
                {
                    "bottom": "0.72451157569885249",
                    "index": "0",
                    "left": "0.092941055297851571",
                    "right": "0.24284084320068361",
                    "top": "0.4965816402435303"
                }
            ],
            "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
            "timestamp": "20190618T112814.426000",
            "type": "moveInZone"
        },
        {
            "duration": "000005.155000",
            "id": "dc953fad-bb08-4bae-bdce-62a09ab2dbd9",
            "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
            "rectangles": [
                {
                    "bottom": "0.37916545867919921",
                    "index": "0",
                    "left": "0.10621988296508789",
                    "right": "0.2311831474304199",
                    "top": "0.11115360260009766"
                }
            ],
            "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
            "timestamp": "20190618T112814.293000",
            "type": "moveInZone"
        },
        {
            "duration": "000003.170000",
            "id": "f00875f0-bad7-4e74-879c-0a564baa9d36",
            "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
            "rectangles": [
                {
                    "bottom": "0.2848846626281738",
                    "index": "0",
                    "left": "0.11811468601226806",
                    "right": "0.18662774562835693",
                    "top": "0.11245393753051756"
                }
            ],
            "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
            "timestamp": "20190618T112813.358000",
            "type": "moveInZone"
        }
    ],
    "more": true
}

2) join=0

Code Block
{
 "events": [
  {
   "alertState": "ended",
   "id": "cd3571bb-73c1-45cb-8965-a01e167836db",
   "multiPhaseSyncId": "6d72973d-7188-4fa7-9bf9-e3ba6013f2e3",
   "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
   "rectangles": [],
   "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
   "timestamp": "20190618T125142.417000",
   "type": "moveInZone"
  },
  {
   "alertState": "began",
   "id": "310ce582-5f0d-4c27-a1d5-b14ccc5a877d",
   "multiPhaseSyncId": "6d72973d-7188-4fa7-9bf9-e3ba6013f2e3",
   "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
   "rectangles": [
    {
     "bottom": "0.46943313598632813",
     "index": "0",
     "left": "0.14642228603363036",
     "right": "0.23025640964508054",
     "top": "0.027766456604003897"
    }
   ],
   "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
   "timestamp": "20190618T125142.200000",
   "type": "moveInZone"
  },
  {
   "alertState": "began",
   "id": "aa193bbc-89e8-4204-8805-ac8c915b323c",
   "multiPhaseSyncId": "807248bf-4cee-431e-a29f-18ee0ed911ce",
   "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
   "rectangles": [
    {
     "bottom": "0.36835212707519532",
     "index": "0",
     "left": "0.072501201629638662",
     "right": "0.19335731506347656",
     "top": "0.03212909698486327"
    }
   ],
   "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
   "timestamp": "20190618T125141.966000",
   "type": "moveInZone"
  },
  {
   "alertState": "ended",
   "id": "5b15234d-2a7f-415f-af57-2ac1ce5aa75a",
   "multiPhaseSyncId": "17fca913-f7a3-4f29-997f-d02a575d9fc4",
   "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
   "rectangles": [],
   "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
   "timestamp": "20190618T125136.978000",
   "type": "moveInZone"
  },
  {
   "alertState": "ended",
   "id": "48882f92-a809-424c-b7a7-55ac56b05061",
   "multiPhaseSyncId": "8bb9edbe-4391-4c26-8c7a-7faf620a62eb",
   "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
   "rectangles": [],
   "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
   "timestamp": "20190618T125136.661000",
   "type": "moveInZone"
  },
  {
   "alertState": "ended",
   "id": "6e98f979-c4f4-4c78-bbf4-6fc268219d79",
   "multiPhaseSyncId": "92534e2f-0f88-4698-a1a2-4e70d10cb00a",
   "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
   "rectangles": [],
   "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
   "timestamp": "20190618T125136.477000",
   "type": "moveInZone"
  },
  {
   "alertState": "ended",
   "id": "c9dff8bc-423b-414b-8dee-0a0b119a43df",
   "multiPhaseSyncId": "c8785151-f344-4c21-88de-6c339139afdf",
   "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
   "rectangles": [],
   "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
   "timestamp": "20190618T125135.843000",
   "type": "moveInZone"
  },
  {
   "alertState": "ended",
   "id": "db1f1147-ed50-46ff-84b7-8f06676d8f8e",
   "multiPhaseSyncId": "7eceb0b4-c04d-4e17-a405-3aff419fd94a",
   "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
   "rectangles": [],
   "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
   "timestamp": "20190618T125135.677000",
   "type": "moveInZone"
  },
  {
   "alertState": "began",
   "id": "f9ccceda-9e16-4832-9f1f-1270fd0be365",
   "multiPhaseSyncId": "17fca913-f7a3-4f29-997f-d02a575d9fc4",
   "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
   "rectangles": [
    {
     "bottom": "0.30296741485595702",
     "index": "0",
     "left": "0.14849423646926879",
     "right": "0.21262614011764525",
     "top": "0.092105445861816404"
    }
   ],
   "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
   "timestamp": "20190618T125135.677000",
   "type": "moveInZone"
  },
  {
   "alertState": "began",
   "id": "87ca4e1e-4a8c-433a-8b67-6e73f65fa0e2",
   "multiPhaseSyncId": "7eceb0b4-c04d-4e17-a405-3aff419fd94a",
   "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
   "rectangles": [
    {
     "bottom": "0.22597263336181642",
     "index": "0",
     "left": "0.080717468261718744",
     "right": "0.19577339172363281",
     "top": "0.014194698333740235"
    }
   ],
   "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
   "timestamp": "20190618T125134.909000",
   "type": "moveInZone"
  }
 ],
 "more": true
}                             



Note
titleAttention!

기본적으로 요청 타임아웃은 10초입니다.

서버가 10초 이내에 모든 이벤트(수량은 limit 매개변수에 설정됨)를 반환하지 못하면, 응답은 다음과 같습니다

By default, the request timeout is 10 seconds.

If the Server fails to return all events (the quantity is set in the limit parameter) in 10 seconds, the response will be as follows:

Code Block
{
   "events": [],
   "more": false
}

In this case, it is necessary to repeat the request and reduce the value of the limit parameter이 경우, 요청을 반복하고 limit 매개변수의 값을 줄여야 합니다.


Info
titleNote

The multiPhaseSyncId parameter will be in the response only for two-phase alarms with alertState parameter.

Field timestamp is not unique so it might be necessary to skip the previously received alarms starting from the search interval.

multiPhaseSyncId 매개변수는 alertState 매개변수가 있는 이중 단계 알람에 대해서만 응답에 포함됩니다.

timestamp 필드는 고유하지 않으므로 검색 간격부터 시작하여 이전에 수신한 알람을 건너뛰어야 할 수 있습니다.

대기열 감지 도구 트리거링을 요청할 때, 응답에는 최소값과 최대값으로 표현된 큐 길이 추정값을 포함하는 추가 매개변수가 포함됩니다When requesting the queue detection tool triggerings, the response will include an additional extra parameter that will contain the queue length estimate expressed by the minimum and maximum values.

Code Block
       {
            "alertState": "happened",
            "extra": [
                {
                    "queueMax": "4"
                },
                {
                    "queueMin": "4"
                }
            ],
            "id": "b17129b2-1588-794b-94f6-d078a226efb2",
            "origin": "hosts/Server1/AVDetector.4/EventSupplier",
            "rectangles": [],
            "source": "hosts/Server1/DeviceIpint.2/SourceEndpoint.video:0:0",
            "timestamp": "20181206T075621.621000",
            "type": "QueueDetected"
        }
}

When requesting the detections from License plate recognition, the response will include an additional plate parameter that will contain the recognized license plate in Unicode format번호판 인식에서 감지 결과를 요청할 때, 응답에는 인식된 번호판을 유니코드 형식으로 포함하는 추가 plate 매개변수가 포함됩니다.

Code Block
  "alertState" : "happened",
            "id" : "f1f334a3-3fb3-4770-80bf-c6519240b5cf",
            "origin" : "hosts/Server1/AVDetector.1/EventSupplier",
            "plate" : "\u0045\u0041\u0033",
            "rectangles" :
            [
                {
                    "bottom" : 0.70833333333333337,
                    "index" : 0,
                    "left" : 0.4597222222222222,
                    "right" : 0.67222222222222228,
                    "top" : 0.64409722222222221
                }
            ],
            "source" : "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
            "timestamp" : "20230725T140945.208000",
            "type" : "plateRecognized"
        }

Possible values of the type parametertype 매개변수의 가능한 값들:

Detection tool검출 도구type
Scene Analytics detection tools
Line crossingoneLine
Motion in areamoveInZone
Stop in areastopInZone
Appearance in areacomeInZone
Disappearance in areaoutOfZone
LoiteringlongInZone
Multiple objectslostObject
Number Plate RecognitionplateRecognized
Number Plate Recognition (from the list)listed_lpr_detected
Face detectionfaceAppeared
Face detection (from the list)listed_face_detected
Visitors counterPeopleIn, PeopleOut
Queue detectionQueueDetected
Fire detectionFireDetected
Smoke detectionSmokeDetected
Neural countinglotsObjects
Position changeSceneChangeDetected
Image Noise DetectionCameraBlindDetected
Loss of qualityImageDegradation
Blurred Image DetectionBlurredDegradation
Compression Artifacts DetectionCompressedDegradation
Motion detectionMotionDetected
No signalNullAudio
SignalSignalAudio
Noise

NoiseAudio

Pose detection
Man down detectionrecumbent
Sitting person detectionsitDown
Hands up detectionhandsUp
Water level detectionLevelOut
Handrail holding detectionhandRail
People counterlotsObjects
Close-standing people detectionpeopleDistance
People maskingenabledMaskEvents

Possible values of the detector parameterdetector 매개변수의 가능한 값들:

detector

Detection
tool검출 도구
SceneDescriptionScene Analytics detection tools
CrossOneLineLine crossing
moveInZoneMotion in area
StopInZoneStop in area
ComeInZoneAppearance in area
OutOfZoneDisappearance in area
LongInZoneLoitering
lostObjectMultiple objects
LprDetectorNumber Plate Recognition
TvaFaceDetectorFace detection
PeopleCounterVisitors counter
QueueDetectorQueue detection
FireDetectorFire detection
SmokeDetectorSmoke detection
NeuroCounterNeural counting
SceneChangePosition change
QualityDegradationLoss of quality
QualityDegradation_v2

Image Noise Detection

BlurredDegradationBlurred Image Detection
CompressedDegradationCompression Artifacts Detection
MotionDetectionMotion detection
NullAudioDetectionNo signal
SignalAudioDetectionSignal
NoiseAudioDetection

Noise

PoseDetectorPose detection
RecumbentDetectorMan down detection
SitDownDetectorSitting person detection
HandsUpDetectorHands up detection
ActiveShooterDetectorShooter detection
WaterLevelDetectorWater level detection
HandRailDetectorHandrail holding detection
PeopleCountDetectorBySkeletonPeople counter
PeopleDistanceDetectorClose-standing people detection
PoseMaskingDetectorPeople masking


Note
titleAttention!
  • Case sensitivity of detection tool triggering types is not guaranteed. For instance검출 도구 트리거링 유형의 대소문자 구분은 보장되지 않습니다. 예를 들어, 'ComeInZone', 'comeInZone' and , 'COMEINZOne' values are to be considered as the same ones.값은 동일한 것으로 간주됩니다.
  • 리스트에 포함되지 않은 값을 받은 경우, 내장된 검출 도구가 트리거된 것입니다If you received a value not included in the list, then an embedded detection tool triggered.