Java Example Program for Tolling Vision

This repository contains a sample Java application that demonstrates how to use Tolling Vision. Tolling Vision is a Dockerized service for tolling companies utilizing AI-based recognition engines. It extracts ANPR/ALPR (Automatic Number Plate Recognition), MMR (Make and Model Recognition), and ADR (Dangerous Goods Signs Recognition) information from images and image sequences.

Tolling Vision is highly scalable and can be easily integrated into existing systems via gRPC (visit our How to use Tolling Vision tutorial for more details), enabling seamless image analysis directly within your application pipeline. The sample program in this repository specifically utilizes the analyze function of the TollingVisionService, which is designed for complex analysis scenarios. This function processes multiple images of a vehicle — such as front, rear, and overview shots — to determine the front and rear license plates, as well as to extract MMR (Make and Model recognition) information.

📖 Prerequisites

Before you begin, ensure you have met the following requirements:

• Java JDK: Make sure you have Java Development Kit (JDK) 17 or higher installed.
• Maven: This project uses Maven as the build tool. Ensure Maven is installed on your system.
• Tolling Vision: Tolling Vision application should be installed and running. See our Get Started page for detailed instructions.

📋 Instructions

👨‍💻 Clone the Repository

git clone https://github.com/smartcloudsol/tollingvision-java-sample.git
cd tollingvision-java-sample

💻 Build the project

Use Maven to build the project:

mvn clean install

🚘 Run the Sample

You can run the application using the following command:

java -cp target:target/* com.smartcloudsolutions.tollingvision.TollingVisionSample <ADDRESS> <SECURED> <THREAD_COUNT> <IMAGE_FOLDER> <RESULT_FILE> <GROUP_PATTERN> <FRONT_PATTERN> <REAR_PATTERN> <OVERVIEW_PATTERN>

Explanation of Parameters:

• ADDRESS: The address of the Tolling Vision service in ip:port format.
• SECURED: true/false to indicate whether the communication channel is encrypted (SSL/TLS).
• THREAD_COUNT: Number of parallel requests to the Tolling Vision service (set this to the number of images you want to process simultaneously, up to the maximum allowed by your license).
• IMAGE_FOLDER: Directory path containing the images to be processed.
• RESULT_FILE: Path to the file where the results will be saved in CSV format.
• GROUP_PATTERN: Regular expression used to group images for the analyze function (e.g., "^.{7}" - based on the first 7 characters of the file names).
• FRONT_PATTERN: Regular expression to identify front images within each group (e.g., ".*front.*" - files in the group that contains the "front" word).
• REAR_PATTERN: Regular expression to identify rear images within each group (e.g., ".*rear.*" - files in the group that contains the "rear" word).
• OVERVIEW_PATTERN: Regular expression to identify overview images within each group (e.g., ".*scene.*" - files in the group that contains the "scene" word).