AXIS Queue Monitor User Manual

AXISQueueMonitor

UserManual

AXISQueueMonitor

TableofContents

Solutionoverview...........................................3

AXISQueueMonitor.............................................3

Howtomountthecamera....................................4

Findthedeviceonthenetwork................................5

Accessthedevice...............................................5

Securepasswords...............................................5

Installtheapplicationonthecamera...............................5

Additionalsettings..........................................7

Howtosetdateandtime.........................................7

Howtosetupauseraccount......................................7

Howtosetupqueueareas........................................7

Howtotriggeranevent..........................................8

Howtosetupaschedule.........................................9

Howtoanonymizepeople........................................9

Howtocopytheapplicationsettingstoanothercamera................9

Aboutthestatistics.........................................10

Aboutthedifferentcharts........................................10

ConnectacameratoafolderinAXISStoreDataManager..............12

Howtodownloadstatistics.......................................12

Troubleshooting............................................13

Howtorestarttheapplication.....................................13

Howtoresettheapplication......................................13

Howtobackupthesettings.......................................13

Howtorestorethesettings.......................................13

Howtogeneratealogreport......................................13

Howtomanageyourlicense......................................13

QueuemonitorAPI..........................................15

Commonexamples..............................................15

APIspecication................................................16

2

AXISQueueMonitor

Solutionoverview

Solutionoverview

Anoverviewofthedifferentdevices,applications,andtoolsneededforacompletesystem.

AXISQueueMonitor

AXISQueueMonitorisananalyticapplicationthatcanbeinstalledonanetworkcamera.Theapplicationmonitorsthenumberof
peoplewaitinginline.

AXISQueueMonitorisintendedforretailandotherenvironmentswhereyouwanttodetectthenumberofpeopleinaqueueor
monitortheintensityofmovementinanareaforfurtheranalysisoractions.

Howdoesitwork?

Togetherwiththenetworkcamera’seventsystem,theapplicationcantriggeranoticationwhenaqueueistoolong.Thetriggercan
forexamplegooffwhenthreeormorepeoplearestandinginlineformorethan10seconds.Thetriggerthenactivatesaneventin
thecamerathatinturnsendsanemailortriggersanaudiooutput.

Oneapplicationcanhandleuptothreequeuelinessimultaneouslyandtriggeralarmsifthequeuebecomestoolong.Thecapacity
dependsontheinstallationsituation,thecameraheight,andtheviewofthescene.

3

AXISQueueMonitor

Howtomountthecamera

Howtomountthecamera

FortheAXISQueueMonitortoworkasexpected,thecamerashouldbeinstalledatahighpositionwithagoodoverviewofthe
scene.Aslightangleisokayaslongastheobjectmeasuredisaboutthesamesizeineverypositionintheliveview.

4

AXISQueueMonitor

Findthedeviceonthenetwork

Findthedeviceonthenetwork

TondAxisdevicesonthenetworkandassignthemIPaddressesinWindows®,useAXISIPUtilityorAXISDeviceManager .Both
applicationsarefreeandcanbedownloadedfromaxis.com/support.

FormoreinformationabouthowtondandassignIPaddresses,seethedocumentHowtoassignanIPaddressandaccessyour
deviceonthedevicepageataxis.com.

Accessthedevice

1.OpenabrowserandentertheIPaddressorhostnameoftheAxisdevice.

IfyouhaveaMaccomputer(OSX),gotoSafari,clickBonjourandselectthedevicefromthedrop-downlist.Toadd
Bonjourasabrowserbookmark,gotoSafari>Preferences.

IfyoudonotknowtheIPaddress,useAXISIPUtilityorAXISDeviceManagertondthedeviceonthenetwork.

2.Entertheusernameandpassword.Ifyouaccessthedeviceforthersttime,youmustsettherootpassword.SeeSeta
newpasswordfortherootaccountonpage5.

3.Theliveviewpageopensinyourbrowser.

Securepasswords

Important

Axisdevicessendtheinitiallysetpasswordincleartextoverthenetwork.Toprotectyourdeviceaftertherstlogin,set
upasecureandencryptedHTTPSconnectionandthenchangethepassword.

Thedevicepasswordistheprimaryprotectionforyourdataandservices.Axisdevicesdonotimposeapasswordpolicyasthey
maybeusedinvarioustypesofinstallations.

Toprotectyourdatawestronglyrecommendthatyou:

•Useapasswordwithatleast8characters,preferablycreatedbyapasswordgenerator .

•Don’texposethepassword.

•Changethepasswordatarecurringinterval,atleastonceayear.

Setanewpasswordfortherootaccount

Important

Thedefaultadministratorusernameisroot.Ifthepasswordforrootislost,resetthedevicetofactorydefaultsettings.

1.Typeapassword.Followtheinstructionsaboutsecurepasswords.SeeSecurepasswordsonpage5.

2.Retypethepasswordtoconrmthespelling.

3.ClickCreatelogin.Thepasswordhasnowbeencongured.

Installtheapplicationonthecamera

Note

•Thelicenseisonlyvalidforonecamera.Youcannotactivatethelicenseonanothercamerawithoutanewregistrationkey.

•Toinstallapplicationsonthecamerayouneedadministratorrights.

5

AXISQueueMonitor

Findthedeviceonthenetwork

1.Installthecameraonyournetwork..

2.Gotothecamera’swebpageinyourbrowser,seetheUserManualforthecamera.

3.Forproductswithrmware7.10orlater,gotoSettings>Apps.

Forproductswithrmware6.50orprevious,gotoSetup>Applications.

4.Uploadtheapplicationle(.eap)tothecamera.

5.Activatethelicense.Ifyou’reonline,enterthelicensecode.Theapplicationautomaticallyactivatesthelicense.

Howtoactivatethelicensewhenyou’reofine

Toactivatethelicensewhenyou’reofine,youneedalicensekey.Ifyoudon’thavealicensekeyonthecomputer,dothefollowing:

1.Gotowww.axis.com/applications

2.GotoLicensekeyregistration.YouneedthelicensecodeandtheAxisdeviceserialnumber .

3.Savethelicensekeyleonthecomputerandselectthelewhentheapplicationasksforit.

Accesstheapplicationsettings

1.Inthecamera’swebpage,gotoSettings>Apps,selecttheapplicationandclickOpen.

6

AXISQueueMonitor

Additionalsettings

Additionalsettings

Howtosetdateandtime

Thedateandtimesettingsareimportantforyourcameratokeepthecorrecttimeforalongerperiodoftime,andforthestatistics
tobeattributedtothecorrecttime.

1.Tosetthedateandtimeyouneedtogotothecamera’swebpage.

-Forproductswithrmware7.10orlater,gotoSettings>System>Dateandtime.

-Forproductswithrmware6.50orprevious,gotoSetup>SystemOptions>Date&Time.

2.Fordetailedinstructionsabouttheuseraccount,gototheproduct’sbuilt-inhelp

1.Inthecamera’swebpage,gotoSetup>SystemOptions>Date&Time.

2.Intheapplication,gotoSettings>Generalandselectthecorrecttimezone.

.

Howtosetupauseraccount

Inthecamerayoucansetupdifferentaccountprivilegessothatunauthorizedpersonnelcanviewstatisticsbutnotchange
anysettingsofthecounter.

1.Tosetupauseraccount,gotothecamera’swebpage.

-Forproductswithrmware7.10orlater,gotoSettings>System>Users.

-Forproductswithrmware6.50orprevious,gotoSetup>SystemOptions>Security>Users.

2.Fordetailedinstructionsabouttheuseraccount,gotothecamera’sbuilt-inhelp.

Howtosetupqueueareas

1.GotothewebpageforAXISQueueMonitor.

2.GotoSettings>Queueareas.

3.Tofacilitatethedrawingyoucanenableagridbyclickingintheimage.

4.SelecttheEmptyregions1anddrawtherstqueuearea.

Holdtheshiftkeydownwhendrawingyourregiontogetalargerbrush

5.ContinuewithEmptyregions2and3ifyouwantmorethanonequeuearea.

6.ClickonLivecalibrationtocongurethenumberofpeoplethattsinthequeuearea,i.e.yourdenitionofaqueue
situation.

Aboutlevelofintensity

Therearethreedifferentlevelsofintensityinaqueuearea:Low,Mid,andHigh.Thesecategoriesareusedinthestatisticalchartsto
showhowlongaqueuehashadlow,mid,orhighintensity.

1.Low:Noqueue

2.Mid:1person

3.High:4people

7

AXISQueueMonitor

Additionalsettings

Howtosetthelevelofintensity

4.Max:Themaximumnumberofpeoplethatcantinthequeueareaatthesametime,approximately6inthisexample.

Note

Tomakethesetupandne-tuningofthequeueareaeasier,werecommendplacingpeopleunderthecameratoforman
actualqueue.

1.StartbydeninghowmanypeoplerepresentMidandHigh.

2.SettheMaxnumberofpeoplethattsinthequeuearea.

3.Adjusttheslidertone-tunetherepresentationforLow,Mid,andHighqueue.

4.ClickSubmit.

5.Gotoliveviewtoverifythesettings.

Howtotriggeranevent

1.GotoSettings>Triggers.

2.SelectEnable.

3.Selecttheamountoftimebeforethetriggershouldgooff.

4.Selectthequeuearea.

5.Selecthowmanypeopleshouldbeinthequeueforthetriggertogooff.

6.Click+toaddmoretriggers.

7.ClickSubmit.

8.Gotothecamera’swebpagetoaccesstheeventsystem.

9.Intheeventsetup,usethetriggerApplication>QueueEvent.

10.Followthebuilt-ininstructionstosetupanevent.

8

AXISQueueMonitor

Additionalsettings

Howtosetupaschedule

Toavoidunwanteddetectionduringthenightorduringholidays,werecommendthatyousetupaschedule.

1.GotoSettings>Schedule.

2.Selectstartandstoptimesbymovingtheslider.YoucansetindividualschedulesforeachdayoftheweekbyselectingPer

dayscheduleandthenmovethecorrespondingslider.

Howtodisabletheapplicationonaspecicdayoftheweek

Deselectthecheckboxnexttotheslider.

Howtodisabletheapplicationduringholidays

SelecttheholidaydatesinthecalendarunderHolidays.

Howtoanonymizepeople

Youcanconguretheapplicationsothatpeoplecannolongerbeidentiedfromthecamera.Therearetwolevelsofanonymization;
softandhard.

Anonymizesoft

Thisfeatureblocksallvideostreamsandimagesfromthecamera.Theliveviewstillshowsablurredimagewhichmeansyou
canstillseewhatisgoingonbutyoucan'tidentifypeople.

1.GotoMaintenance>Anonymize.

2.ClickAnonymizesoft.

3.Togobacktonormalmode,clickResetanonymization.Onlyuserswithanadministratoraccountcandothis.

Anonymizehard

Important

Anonymizehardremovesalladministratorusers,lockstherootpassword,andcanonlybereversedbydoingareset
tofactorydefaultonthecamera.

1.GotoMaintenance>Anonymize.

2.ClickAnonymizehard.

Howtocopytheapplicationsettingstoanothercamera

Usethecopyfunctionalityifyouwanttocopytheapplicationsettingsto,forexample,othercamerasinthesamestorewiththe
samemountingheight.Camera-specicsettings,suchastheapplicationlicenseandcameraname,arenotincluded.

1.Tocopytheapplicationsettings,gotoMaintenance>Parameterbackups.

2.ClickCopy.Thecomputersavestheleinyourbrowser’sdefaultfolderfordownloads.

9

AXISQueueMonitor

Aboutthestatistics

Aboutthestatistics

Thereareseveralwaystousethestatisticsfromthecounter:

•Intheapplication’swebpage,viewreal-timecountingdatainthebuilt-ingraphs.

•Viewbuilt-ingraphsindayandweekviewfromthestatisticspage.Thedataisupdatedinrealtime.

Dataisavailableonthecameraforupto90daysandupdatedeveryminute.

•Viewgraphsofhistoricaldatadirectlyonthecamera.

•DownloaddatathroughanopenAPI.

•UseAXISStoreDataManager,asoftwarepackagethatactsasacentralpointtostoreandmanagedatacollectedfromall
cameras.SeeConnectacameratoafolderinAXISStoreDataManageronpage12.

•UseAXISStoreReporter,astatisticalweb-basedsolution,formanagingandmonitoringhistoricaldata.

•Downloadstatisticstoyourcomputer,seeHowtodownloadstatisticsonpage12.

Aboutthedifferentcharts

Weekchart

IntheStatisticsmenu,youcanndaweekchartcontaininginformationabouttheamountoftimeinwhichtherehasbeen
MediumandHighqueuelevelsduringthelastsevendays.

Inthisscenario,MediumqueueequalstwopeopleandHighqueueequalsthreeormorepeople.

•Queuearea1(blue)didnothaveanyminuteswithHighqueuevalue.

•Queuearea2(green)hadbarelyanyminuteswithHighqueuevalue.

•Queueareanumber3(orange)hadthemostminuteswithHighqueuevalue(threeormorepeople).

TheHighqueuevalueshowsupasadarkershadeofcolor.TheMediumandHighvaluesdependonthevalues

thatwereassignedtoeachqueueareaduringthecalibrationprocess.

10

AXISQueueMonitor

Aboutthestatistics

Daychart(Minuteswithqueue)

InthedaychartyouwillgetinformationabouttheminutesofMidandHighqueueforeachqueuearea.Bylookingatthechart
wecanseethatqueue1(purpleline)haveover20minutesofhighqueueattwelveo’clock.Inthisexamplehighqueueequals
aboutthreetofourpeople.

Daychart(Peopleinqueue)

Youcanalsogetinformationabouttheaverageofpeopleinthequeueduringtheday .Bylookingatthechartbelowwecansee
whenpeoplestartstoqueueandgetanestimateofhowmanypeoplequeueduringdifferenttimeintervalsforeachqueuearea.

11

AXISQueueMonitor

Aboutthestatistics

ConnectacameratoafolderinAXISStoreDataManager

Toperformthistask,theapplicationmustbeinstalledonthecamera.

1.InAXISStoreDataManager,gotoSourcesandgettheFolderconnectionidentierandtheFolderconnectionpassword
forthefolderyouwanttoconnectto.

2.Inthecamera’swebpage,gotoSettings>Appsandopentheapplication’swebpage.

3.Intheapplication’swebpage,gotoSettings>Reporting.

4.Toenablepushingdatatoaserver,selectEnabled.

5.EnterthewebaddressforAXISStoreDataManager,forexample
http://[systemintegrator1].asdm.axis.com/datamanagerwhere[systemintegrator1]is
replacedbyauniquename.

6.EntertheFolderconnectionidentierandFolderconnectionpassword.

7.Totesttheconnection,clickRuntest.

8.ClickSubmit.

Howtodownloadstatistics

Youcandownloadthedatadirectlyfromthecamerain.csvformat.

1.GotoStatistics>Downloadstatistics.

2.SelectbetweenMinuteswithqueueorPeopleinqueue.

-Minuteswithqueuedataisstoredfor90daysinthecameraandtheshortesttimeintervalis15minutes.

-Peopleinqueuedataisstoredfor90daysintimeintervalsof15minutesor30daysintimeintervalsof
oneminute.

3.Selectthedateinthecalendar.Thebrowsersavestheleinthedefaultdownloadfolder.

Ifyouwanttodownloadallavailabledataforthe90-or30-dayperiod,clickDownloadallnexttotheleformat.

12

AXISQueueMonitor

Troubleshooting

Troubleshooting

Ifyoucan’tndwhatyou’relookingforhere,trythetroubleshootingsectionataxis.com/support.

IssueAction

ThesoftwaredoesnotuploadtoAXISStoreDataManager.

Howtorestarttheapplication

Ifthecountingisinaccurateorthewebinterfaceunusuallyslow,youcantryrestartingtherunningservicesorrestartthecamera.

GotoMaintenance>Restart.

Howtoresettheapplication

GotoMaintenance>Resetanddooneofthefollowing:

Themostcommonreasonisnetworkcommunicationproblems.
RuntheconnectiontestunderSettings>Reportingtoget
informationabouttherootcausefortheproblem.

•Toclearallcountingdatafromthecamera,clickCleardata.

•Torestoreallsettingsoftheapplicationtodefault,clickRestoresettings.

Howtobackupthesettings

1.Tobackuptheapplicationsettings,gotoMaintenance>Parameterbackups.

2.ClickBackup.Thecomputersavestheleinyourbrowser’sdefaultfolderfordownloads.

Howtorestorethesettings

1.GotoMaintenance>Parameterbackups.

2.BrowsetoselectthepreviouslysavedbackupleandthenclickRestore.

Howtogeneratealogreport

Ifyouhaveanytroublewithyourcamerayoucangeneratealogreport.

1.GotoMaintenance>Logs.

2.ClickGeneratelogs.

3.Thebrowsersavestheleonthedefaultdownloadbrowseronthecomputer.

4.Attachthelogreportwhensubmittinganissuetosupport.

Howtomanageyourlicense

GotoMaintenance>Registration.

•Toregisteralicense,clickontheRegistrationpage.

•Ifyouwanttoremoveyoulicensefromthisproduct,clickClearregistration.

13

AXISQueueMonitor

Troubleshooting

•Ifyouhaveanupdatedlicense,clickRenewlicense.

14

AXISQueueMonitor

QueuemonitorAPI

QueuemonitorAPI

Commonexamples

Example

Requestthenumberofpeoplestandinginqueueatthismoment.

Request

http://<servername>/local/queue/.api?live-sum-people.json

Return

{

"serial":"ACCC8E20F09B",
"name":"ServiceCounter",
"timestamp":"20170113181132",
"region1name":"ProductDisplay",
"region1people":1,
"region2name":"AisleDisplay",
"region2people":0,
"region3name":"ServiceCounter",
"region3people":3

}

SeeGetrealtimepeopleinqueuedataonpage16formoreinformation.

Example

RequesthistoricalminutesofqueuedatainCSVformatforthe1standthe3rdofMay2017witha5hourresolution.

Request

http://<servername>/local/queue/.api?export-csv-minutes&date=20170501,20170503&res=5h

Return

Intervalstart,Intervalstop,Cameraserialnumber,Name,Region1High,Region1
Mid,Region1Low,Region2High,Region2Mid,Region2Low,Region3High,Region3Mid,Region3
Low
2017-05-0100:00:00,2017-05-0105:00:00,00XXXXXXXXXX,Camera1,0,0,300,0,0,300,0,0,300
2017-05-0105:00:00,2017-05-0110:00:00,00XXXXXXXXXX,Camera1,0,0,300,0,0,300,0,20,280
2017-05-0110:00:00,2017-05-0115:00:00,00XXXXXXXXXX,Camera1,0,0,300,0,0,300,0,174,126
2017-05-0115:00:00,2017-05-0120:00:00,00XXXXXXXXXX,Camera1,0,0,300,0,0,300,0,109,191
2017-05-0120:00:00,2017-05-0201:00:00,00XXXXXXXXXX,Camera1,0,0,300,0,0,300,0,0,300
2017-05-0300:00:00,2017-05-0305:00:00,00XXXXXXXXXX,Camera1,0,0,300,0,0,300,0,0,300
2017-05-0305:00:00,2017-05-03
10:00:00,00XXXXXXXXXX,Camera1,0,34,266,0,17,283,8,67,225

SeeRequestCSVminutedataonpage16formoreinformation.

Example

Requesthistoricalpeopleinqueuedata,inCSVformat,forthe4thofAprilandthe3rdofMay2017witha120minuteresolution.

Request

http://<servername>/local/queue/.api?export-csv-people&date=20170428,20170503&res=120m

Return

Intervalstart,Intervalstop,Cameraserialnumber,Name,PeopleinRegion1,Peoplein
Region2,PeopleinRegion3
2017-05-0300:00:00,2017-05-0302:00:00,00XXXXXXXXXX,Camera2,0,0,2
2017-05-0302:00:00,2017-05-0304:00:00,00XXXXXXXXXX,Camera2,1,1,1
2017-05-0304:00:00,2017-05-0306:00:00,00XXXXXXXXXX,Camera2,1,0,1
2017-05-0306:00:00,2017-05-0308:00:00,00XXXXXXXXXX,Camera2,1,0,2
2017-05-0308:00:00,2017-05-0310:00:00,00XXXXXXXXXX,Camera2,1,0,1

15

AXISQueueMonitor

QueuemonitorAPI

SeeRequestCSVpeopledataonpage17formoreinformation.

APIspecication

Getrealtimepeopleinqueuedata

Request

http://<servername>/local/queue/.api?live-sum-people.json

Return

{

"serial":"<camera-serial>",
"name":"<counter-name>",
"timestamp":"<timestamp>",
"region1name":"<name1>",
"region1people":<people1>,
"region2name":"<name2>",
"region2people":<people2>,
"region3name":"<name3>",
"region3people":<people3>

}

Returnvaluedescriptions

ValueDescription

<camera-serial>cameraserialnumber

<counter-name>

<timestamp>timeinthecameraintheformatYYYYMMDDhhmmss

<region1name>nameofregion1

<region1people>numberofpeoplestandinginregion1

nameofthecounter

RequestCSVminutedata

Request

http://<servername>/local/queue/.api?export-csv-minutes[&date=<date>][&res=<res>]

Requestparameterdescriptions

ParameterDescription

adateoftheformYYYYMMDD

<date>

<res>

adateintervaloftheformYYYYMMDD-YYYYMMDD

commaseparateddatesoftheformYYYYMMDD,[..],YYYYMMDD

all(default)forallavailabledata

15m(default)fordatain15minutebins

1hfordatain1hourbins

24hfordatain1daybins

Return

Thisscriptreturnsdatainplaintext,comma-separatedvalues.Therstlineisacomma-separatedheaderdescribingeach
column.Eachintegervaluestatesthenumberofminutesforwhichtherehasbeenacertainamountofqueue(High/Mid/Low)
foracertainregion.

16

AXISQueueMonitor

QueuemonitorAPI

RequestCSVpeopledata

Request

http://<servername>/local/queue/.api?export-csv-people[&date=<date>][&res=<res>]

Requestparameterdescriptions

ParameterDescription

<date>

<res>

adateoftheformYYYYMMDD

adateintervaloftheformYYYYMMDD-YYYYMMDD

commaseparateddatesoftheformYYYYMMDD,[..],YYYYMMDD

all(default)forallavailabledata

1mfordatain1minutebins

15m(default)fordatain15minutebins

1hfordatain1hourbins

24hfordatain1daybins

Return

Thisscriptreturnsdatainplaintext,comma-separatedvalues.Therstlineisacommaseparatedheaderdescribingeachcolumn.
Eachintegervaluestatestheaveragenumberofpeoplewithinacertainregionofinterest.

Clearlocalqueuedata

Request

http://<servername>/local/queue/.apioperator?clear-data

Return

OK

Listapplicationparameters

Request

http://<servername>/local/queue/.api?params.json

Return

AJSONobjectofalltheapplicationrelatedparameters.

Setapplicationrelatedparameters

Thepostformathasaformatwherepairsandvaluesneedtobespecied,bestdescribedbyanexample:

&p1=Counter.Enabled&v1=1&p2=WebReportUpload.Enabled&v2=1

Request

http://<servername>/local/queue/.apioperator?setparams

Return

OK

Showthesystemlog

Request

http://<servername>/local/queue/.apioperator?show-logs

Return

17

AXISQueueMonitor

QueuemonitorAPI

Displaysthesystemlogs.

Generatealogarchive

Request

http://<servername>/local/queue/.apioperator?generate-logs

Return

Alogarchive

18

UserManualVer.M3.2
AXISQueueMonitor
©AxisCommunicationsAB,2017-2018

Date:May2018

PartNo.T10098450