Frequently Asked Questions (FAQ)
How to Сonfigure the Hardware Tab Settings?
Select the hardware type:
- Select the CPU hardware type to run the analytics processing on the central processor.
- Select the GPU hardware type to run the analytics processing on the graphics processor.
Select the decoding type. Depending on the type of decoding, the video is processed on different devices:
- CPU selection provides video decoding on the central processor.
- Intel selection provides video decoding on the Intel Integrated Graphics Processor (Intel HD Graphics).
- NVDEC selection provides video decoding on the NVIDIA graphics processor.
The FPS mode allows to set the number of frames per second processed by the analytics:
- A higher frame rate gives a better result if the video contains dynamic objects (e.g. the people flow in a shopping center or the vehicle traffic on the road).
- A lower frame rate is sufficient if the video contains static objects (e.g. vehicles in a parking lot).
The Key Frame mode selects only keyframes from the video stream. Keyframes have the lowest compression ratio, which saves resources for decoding and processing the video stream by the analytics.
The Once Every X Seconds mode processes 1 frame after a set period of time, while the remaining frames are skipped.
How to Get Google Maps API Key?
To get the Google Maps API key, open the Google Maps Platform by the link and click the Get Started button:
Once signed in, verify the Google billing account.
Step 1:
- Select the appropriate answers from the drop-down lists
- Carefully read the Terms of Service and check the box to agree
- Click the Continue button
Step 2:
- Enter the phone number
- Click the Send Code button
Once the verification code is obtained by SMS:
- Fill in the required field with the obtained verification code
- Click the Verify button
Step 3:
- Fill in the required fields
- Click the Start My Free Trial button
Once the billing account is verified:
- Answer a few questions
- Click the Submit button
After the submission, a new window with the generated API key opens:
- Copy the API key to the clipboard
- Click the Maybe Later button
After redirecting to the control console, select the APIs item:
In the APIs item, make sure the following APIs are enabled:
- Geocoding API
- Maps JavaScript API
- Roads API
- Street View Static API
How to Access API Documentation?
To access the API documentation (Swagger), use one of the following methods.
Access API Documentation through the Settings section:
- Navigate to the Settings section
- Open the General item
- Click the View API Documentation button within the API Token tab
Access API Documentation via URL:
- Copy the following URL: http://your-server-ip-address/settings/plugin_docs
- Paste the URL into the address bar of your browser
- Replace "your-server-ip-address" in the URL with the IP address of your server
How to Create a Cyclic RTSP Video Stream from a Video File?
To create a cycled RTSP video stream from a video file, proceed with the following instructions.
Download the ZIP archive with the MediaMTX software at the following link: Download MediaMTX. Extract the downloaded archive in the root folder of your Drive C:
Open the "mediamtx_v0.23.6" folder on Drive C:
Copy the video files intended for conversion into an RTSP video stream into the "demo" folder:
The example of video files inserted in the "demo" folder:
Execute the "mediamtx.exe" file:
Allow firewall access:
- Ensure that TCP Port 8554 is available when launching the MediaMTX program.
- You can add new video files to the "demo" folder without exiting the MediaMTX program.
- For proper video stream operation, the MediaMTX program must be continuously running.
Check in the VLC Player that the video stream opens and plays:
- Enter the address as follows: rtsp://localhost:8554/LPR_005_GERMANY.avi
- Click the Play button
After following these steps, the video stream should open and play, as shown in the example:
Add the video stream obtained from the video file to the system. Configure the mandatory parameters following these steps:
- Select the Camera button in the Video Streams section
- Choose RTSP as the stream type
- Enter the server address in the Host field
- Enter 8554 in the Port field
- Specify the /video_file_name in the Path field, as shown in the example: /LPR_005_GERMANY.avi
- Provide the complete stream address in the Video Source Address field, as shown in the example: rtsp://localhost:8554/LPR_005_GERMANY.avi
Once the video stream is saved, the Success Notification identifies, that the video stream was successfully created and can be used for video analytics:
Check the video stream grabs the frame:
- Find the desired video stream in the Description block
- Hover the mouse over the Settings icon to open the drop-down menu
- Select the View Camera information option
- Click the Update button in the pop-up window
If you are not receiving an image, please ensure that you have correctly specified the following:
- IP address is entered correctly in the Host field
- File name is specified correctly in the Path field
- MediaMTX program is continuously running
If everything has been done correctly, then the issue is with the video content, resulting in an error, which indicates that the frame can not be grabbed from the video stream:
How to Change the Region for LPR Analytics Without Reinstalling the System?
To modify the region for License Plate Recognition (LPR) analytics, proceed with the following steps.
Navigate to the "alpr.properties" file, which is, by default, located at:
C:\ProgramData\Incoresoft\process-runner\alpr.properties
Edit the "alpr.properties" file.
Open the alpr.properties file in a text editor and locate the following section:
{ "motion": "false", "model": "EUROPE" }
To change the LPR model for the desired region, update the value for the "model" parameter to one of the following options:
- "EUROPE"
- "ARABIC"
- "AUSTRALIA"
- "USA"
For the "USA" model, also add the "submodel_id" parameter, and set its value to "1":
{ "motion": "true", "submodel_id": "1", "model": "USA" }
Save the modified "alpr.properties" file, ensuring that the JSON structure remains valid, and all values are enclosed in quotes.
After editing the "alpr.properties" file, restart the IncoreSoft ProcessRunner service to apply the changes.
For the "ARABIC" model, additionally enable UTF-8 support. In the Windows OS open the Start menu, select the Control Panel, and choose Regional Standards. In the Region window, follow these steps:
- Navigate to the Administrative tab
- Click the Change System Locale button. In the Region Settings pop-up window:
- Check the box for Beta: Use Unicode UTF-8 for Worldwide Language Support
- Click the Ok button
- Click the Apply button to save the changes
How to Enable Video Stream Display in the Analytics Live View?
If the analytics is functioning correctly and producing results, but the video stream is not displaying in the live mode, and you see the message "Failed to load the video in MJPEG format. Please try to update the video stream" or "Reconnecting to the video stream. Please wait...", follow these steps:
- Open the Settings section
- Navigate to the Servers item
- Click the Settings icon on the toolbox for the required server
- Specify the IP address of the analytic server responsible for broadcasting real-time analytics in the Interface IP field
- Click the Save button to save the changes
How to Change the System User Language in Windows?
Changing the system user language in Windows can be beneficial when encountering issues such as difficulty with initial system login, adding a video stream to the system, or creating analytics. This is particularly relevant when the "Request processing error" system message appears, often associated with the system user language set to Turkish.
To change the system user language in Windows, follow these steps:
- Open the Start Menu
- Navigate to Settings
- Select the Time & Language settings block
- Click the Language section in the left menu
Proceed with the following steps:
- Choose English for the Windows Display Language setting
- Go to Administrative Language Settings
- Click the Copy Settings... button
- Check the box for Welcome Screen and System Accounts
- Click the Ok button in the Welcome Screen and New User Accounts Settings pop-up window
- Click the Apply button in the Region pop-up window to save changes
After applying these settings, restart the PC for the changes to take effect.