Utilizzo di Vision con il framework Spring

Spring Cloud Google Cloud offre pratiche librerie per interfacciarsi con l'API Vision da un'applicazione Spring. Queste librerie includono classi helper e configurazione automatica e classi Spring Boot Template per consentire agli sviluppatori di iniziare rapidamente a utilizzare l'API Vision.

Se hai già familiarità con il framework Spring, Spring Cloud Vision può semplificare l'utilizzo dell'API Vision nella tua applicazione e ridurre la quantità di codice da scrivere.

Questa pagina spiega come aggiungere Spring Cloud Vision a un'applicazione Java. Per informazioni dettagliate sul modulo, consulta il riferimento di Spring Cloud Vision.

Configurazione delle dipendenze

Per iniziare a utilizzare questa libreria, aggiungi l'artefatto spring-cloud-gcp-starter-vision al progetto.

Coordinate Maven, utilizzando il BOM di Google Cloud Spring Cloud:

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>org.springframework.cloud</groupId>
      <artifactId>spring-cloud-gcp-dependencies</artifactId>
      <version>1.2.8.RELEASE</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-dependencies</artifactId>
      <version>${spring.version}</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>
<dependency>
  <groupId>org.springframework.cloud</groupId>
  <artifactId>spring-cloud-gcp-starter-vision</artifactId>
</dependency>

Per ulteriori informazioni, consulta le istruzioni per la configurazione di un ambiente di sviluppo Java. Non è necessario installare la libreria client di Google Cloud per Java: il comando iniziale Spring Boot installa automaticamente la libreria client.

Analisi delle immagini

Dopo aver configurato le dipendenze di Google Cloud Vision di Spring Cloud sul classpath, puoi iniziare immediatamente a elaborare le immagini ottenendo un'istanza di CloudVisionTemplate utilizzando Spring dipendenza injection.

@Autowired private CloudVisionTemplate cloudVisionTemplate;

CloudVisionTemplate è un wrapper per le librerie client dell'API Vision e consente di elaborare facilmente le immagini tramite l'API Vision. Per ulteriori informazioni sulle funzionalità CloudVisionTemplate, consulta la pagina di riferimento del modello di Cloud Vision.

Le seguenti sezioni contengono esempi di codice per casi d'uso comuni di CloudVisionTemplate. Tutti gli snippet di codice provengono dall'applicazione di esempio Spring e Cloud Vision.

Recupero delle etichette di classificazione di un'immagine

Il codice in basso estrae le etichette di classificazione di un'immagine, fornendoti descrizioni generali dei contenuti dell'immagine.

AnnotateImageResponse response =
    this.cloudVisionTemplate.analyzeImage(
        this.resourceLoader.getResource(imageUrl), Type.LABEL_DETECTION);

Map<String, Float> imageLabels =
    response.getLabelAnnotationsList().stream()
        .collect(
            Collectors.toMap(
                EntityAnnotation::getDescription,
                EntityAnnotation::getScore,
                (u, v) -> {
                  throw new IllegalStateException(String.format("Duplicate key %s", u));
                },
                LinkedHashMap::new));

Estrazione del testo di un'immagine

L'esempio di codice seguente descrive un'altra operazione comune per l'estrazione del testo da un'immagine.

String textFromImage =
    this.cloudVisionTemplate.extractTextFromImage(this.resourceLoader.getResource(imageUrl));
return "Text from image: " + textFromImage;

Passaggi successivi