The Best Java API for Global License Plate OCR (Free Image Testing)

// 💰 Save 30%+ vs competitors. Get 200 free credits instantly:
// 👉 https://structocr.com/register

import java.io.IOException;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.file.Files;
import java.nio.file.Path;
import java.util.Base64;
import com.google.gson.Gson;
import com.google.gson.JsonObject;

public class LicensePlateOcr {

    public static void main(String[] args) throws IOException, InterruptedException {
        String apiKey = "YOUR_API_KEY"; // Replace with your actual API key
        String imagePath = "path/to/your/vehicle_image.jpg"; // Replace with the path to your image

        // 1. Read image and encode to Base64
        byte[] fileContent = Files.readAllBytes(Path.of(imagePath));
        String base64Img = Base64.getEncoder().encodeToString(fileContent);

        // 2. Create JSON payload
        JsonObject payload = new JsonObject();
        payload.addProperty("img", base64Img);
        String jsonPayload = new Gson().toJson(payload);

        // 3. Build the HTTP request (Requires application/json)
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create("https://api.structocr.com/v1/license-plate"))
                .header("x-api-key", apiKey)
                .header("Content-Type", "application/json")
                .POST(HttpRequest.BodyPublishers.ofString(jsonPayload))
                .build();

        System.out.println("Uploading Base64 image to StructOCR API...");

        // 4. Send the request and receive the response
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

        // 5. Parse the JSON response
        Gson gson = new Gson();
        JsonObject jsonResponse = gson.fromJson(response.body(), JsonObject.class);

        // 6. Extract the License Plate data
        if (jsonResponse.has("success") && jsonResponse.get("success").getAsBoolean()) {
            JsonObject data = jsonResponse.getAsJsonObject("data");
            System.out.println("✅ Extraction Successful!");
            System.out.println("Plates Detected: " + data.getAsJsonArray("plates").size());
            System.out.println("Country Guess: " + (data.get("country_guess").isJsonNull() ? "N/A" : data.get("country_guess").getAsString()));
            System.out.println("Confidence: " + data.get("confidence").getAsString());
            System.out.println("\n--- Raw Data ---");
            System.out.println(new Gson().toJson(data));
        } else {
            String errorCode = jsonResponse.has("code") ? jsonResponse.get("code").getAsString() : "Unknown Code";
            String errorMsg = jsonResponse.has("message") ? jsonResponse.get("message").getAsString() : "Unknown Error";
            System.out.println("❌ Error [" + errorCode + "]: " + errorMsg);
        }
    }
}