Как использовать OCR с GroupDocs.Parser Java

Ищете эффективный способ извлечения текста из изображений или отсканированных документов? Как использовать OCR с библиотекой GroupDocs.Parser для Java предлагает надёжное решение, позволяющее бесшовно интегрировать оптическое распознавание символов (OCR) в ваши приложения. Это подробное руководство проведёт вас через процесс извлечения областей текста из файлов изображений с использованием коннектора Aspose OCR вместе с GroupDocs.Parser в Java, улучшая возможности обработки документов.

Что вы узнаете

Настройка и использование GroupDocs.Parser для Java.
Инициализация ParserSettings с OCR‑коннектором.
Техники извлечения областей текста из изображений с использованием технологии Aspose OCR.
Практические применения этой функции в реальных сценариях, таких как java image to text конвертация и извлечение позиций текста в Java.

Быстрые ответы

Что означает “how to use OCR”? Это относится к интеграции OCR‑движка для чтения текста из файлов, основанных на изображениях.
Какая библиотека предоставляет OCR для Java? GroupDocs.Parser в сочетании с коннектором Aspose OCR.
Нужна ли лицензия? Доступна бесплатная пробная версия; для продакшн‑использования требуется постоянная лицензия.
Можно ли получить координаты текста? Да, API возвращает позиции областей текста (left, top, width, height).
Какая версия Java требуется? Рекомендуется Java 8 или новее.

Что такое извлечение текста с помощью OCR?

Оптическое распознавание символов (OCR) преобразует визуальный текст — найденный в отсканированных изображениях, PDF‑файлах или фотографиях — в машинно‑читаемые символы. Когда вы как использовать OCR в Java, вы позволяете своим приложениям искать, редактировать и анализировать ранее статические документы.

Почему использовать GroupDocs.Parser для OCR?

Unified API – Обрабатывает PDF, изображения и многие другие форматы с единой кодовой базой.
Accurate Recognition – Работает на базе Aspose OCR, поддерживающего множество языков и шрифтов.
Position Data – Получает точные координаты каждого блока текста, идеально подходит для обработки с учётом макета.
Scalable – Работает с небольшими изображениями или крупными пакетными заданиями, может быть развернут локально или в облаке.

Предварительные требования

Прежде чем начать, убедитесь, что у вас есть следующее:

Требуемые библиотеки и зависимости

GroupDocs.Parser for Java: версия 25.5 или новее.
Maven или прямой способ загрузки для установки библиотеки.
Aspose OCR Connector: Необходим доступ к технологии OCR от Aspose.

Требования к настройке окружения

Совместимая IDE (IntelliJ IDEA, Eclipse и т.д.), работающая на Java 8+.
Установленный Maven, если вы предпочитаете подход через репозиторий Maven.

Требования к знаниям

Базовые навыки программирования на Java.
Знакомство с управлением зависимостями проекта.

Настройка GroupDocs.Parser для Java

Вы можете добавить библиотеку через Maven или загрузить её напрямую.

Использование Maven

Добавьте следующие конфигурации в ваш файл pom.xml:

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/parser/java/</url>
   </repository>
</repositories>

<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-parser</artifactId>
      <version>25.5</version>
   </dependency>
</dependencies>

Прямая загрузка

В качестве альтернативы загрузите последнюю версию с GroupDocs.Parser for Java releases.

Шаги получения лицензии

Free Trial – Оцените библиотеку бесплатно.
Temporary License – Используйте ограниченный по времени ключ для расширенного тестирования.
Purchase – Приобретите полную лицензию для продакшн‑развёртываний.

Базовая инициализация и настройка

После того как библиотека доступна, вы можете инициализировать парсер. Ниже приведён основной Java‑код, создающий экземпляр ParserSettings с коннектором Aspose OCR:

import com.groupdocs.parser.Parser;
import com.groupdocs.parser.options.ParserSettings;
import com.groupdocs.parser.ocr.AsposeOcrOnPremise;

ParserSettings settings = new ParserSettings(new AsposeOcrOnPremise());

После того как основы готовы, давайте перейдём к извлечению областей текста OCR.

Как извлечь области текста с помощью OCR (по шагам)

1. Инициализировать `ParserSettings` с OCR‑коннектором

OCR‑коннектор позволяет распознавать текст в документах, содержащих только изображения.

// Initialize ParserSettings with OCR Connector
ParserSettings settings = new ParserSettings(new AsposeOcrOnPremise());

2. Открыть документ и настроить параметры извлечения

Мы используем PageTextAreaOptions, чтобы указать парсеру возвращать позиционные данные для каждого распознанного слова.

try (Parser parser = new Parser("YOUR_DOCUMENT_DIRECTORY", settings)) {
    // Configure PageTextAreaOptions for OCR processing
    PageTextAreaOptions options = new PageTextAreaOptions(true);
    
    // Extract text areas from the document
    java.lang.Iterable<PageTextArea> areas = parser.getTextAreas(options);

    if (areas == null) {
        return; // Exit if text areas extraction is not supported
    }
    
    for (PageTextArea a : areas) {
        String text = a.getText();
        int leftPosition = a.getRectangle().getLeft();
        int topPosition = a.getRectangle().getTop();
        int width = a.getRectangle().getSize().getWidth();
        int height = a.getRectangle().getSize().getHeight();

        // Process the extracted data as needed
    }
} catch (java.lang.Exception ex) {
    // Handle any exceptions that occur during processing
}

Что делает этот код

Creates экземпляр Parser, указывающий на папку с вашими документами.
Enables OCR через PageTextAreaOptions(true).
Iterates по каждому PageTextArea, предоставляя распознанный текст и его точный прямоугольник (позицию и размер).
Allows вам сохранять или манипулировать данными, например вставлять их в базу данных или накладывать на пользовательский интерфейс.

3. Обработать результаты

Теперь вы можете использовать извлечённый текст и координаты в различных сценариях:

Document Digitization – Преобразовать отсканированные контракты в поисковые PDF.
Data Entry Automation – Извлекать поля, такие как номера счетов, непосредственно из изображений чеков.
Content Management – Индексировать позиции текста для расширенного выделения в поиске.

Распространённые проблемы и решения

Симптом	Вероятная причина	Решение
No text areas returned	OCR‑коннектор не настроен или путь к изображению неверен	Убедитесь, что экземпляр `AsposeOcrOnPremise` правильно лицензирован и путь к файлу доступен.
Garbled characters	Низкое качество изображения или язык не поддерживается	Используйте сканы более высокого разрешения и настройте языковой пакет OCR.
Out‑of‑memory errors on large PDFs	Обработка большого количества страниц высокого разрешения одновременно	Обрабатывайте страницы пакетами или включите режим потоковой обработки (`ParserSettings.setEnableStreaming(true)`).

Часто задаваемые вопросы

Q: Как установить GroupDocs.Parser для Java?
A: Добавьте его как зависимость Maven (см. XML‑фрагмент выше) или загрузите напрямую со страницы официальных выпусков.

Q: Что такое Aspose OCR и почему использовать его с GroupDocs.Parser?
A: Aspose OCR — это высокоточный движок распознавания текста. В сочетании с GroupDocs.Parser он расширяет возможности парсера для обработки файлов, содержащих только изображения, и предоставляет точные позиции текста.

Q: Можно ли обрабатывать несколько форматов изображений?
A: Да. GroupDocs.Parser поддерживает JPEG, PNG, BMP, TIFF и другие — просто убедитесь, что OCR‑коннектор может читать данный формат.

Q: Что делать, если не извлекаются области текста?
A: Проверьте путь к файлу, убедитесь, что OCR‑коннектор лицензирован, и проверьте, поддерживается ли тип документа Aspose OCR.

Q: Где можно найти больше ресурсов по GroupDocs.Parser?
A: Посетите GroupDocs Documentation для подробных руководств и справочников API.

Ресурсы

Изучите эти ресурсы, чтобы углубить свои знания и расширить возможности GroupDocs.Parser в ваших проектах.

Последнее обновление: 2026-02-09
Тестировано с: GroupDocs.Parser 25.5 for Java
Автор: GroupDocs