Immagini supportate

Formati file

L'API Vision supporta i seguenti tipi di immagini:

• JPEG
• PNG8
• PNG24
• GIF
• GIF animata (solo primo fotogramma)
• BMP
• WEBP
• RAW
• ICO
• PDF
• TIFF

Tieni presente che alcuni di questi formati di immagine sono "con perdita" (ad esempio JPEG). La riduzione delle dimensioni dei file per questi formati con perdita di dati può comportare un peggioramento della qualità delle immagini e, di conseguenza, dell'accuratezza dell'API Vision.

Dimensioni delle immagini

Per consentire il rilevamento accurato delle immagini all'interno dell'API Vision, in genere le immagini devono avere dimensioni minime di 640 x 480 pixel (circa 300.000 pixel). Di seguito sono riportati i dettagli completi dei diversi tipi di richieste di funzionalità dell'API Vision:

Funzionalità dell'API Vision	Dimensioni consigliate *	Note
FACE_DETECTION	1600 x 1200	La distanza tra gli occhi è la più importante
LANDMARK_DETECTION	640 x 480
LOGO_DETECTION	640 x 480
LABEL_DETECTION	640 x 480
TEXT_DETECTION e DOCUMENT_TEXT_DETECTION	1024 x 768	L'OCR richiede una risoluzione maggiore per rilevare i caratteri
SAFE_SEARCH_DETECTION	640 x 480

Nota: l'API Vision richiede che le immagini siano di dimensioni sufficienti per distinguere facilmente le funzionalità importanti all'interno della richiesta. Potrebbero essere accettate anche dimensioni inferiori o superiori a quelle consigliate. Tuttavia, dimensioni più piccole possono comportare una minore precisione, mentre dimensioni maggiori possono aumentare i tempi di elaborazione e l'utilizzo della larghezza di banda senza offrire vantaggi paragonabili in termini di precisione. Le dimensioni delle immagini non devono superare i 75 milioni di pixel (lunghezza x larghezza) per l'analisi OCR. Se le dimensioni dell'immagine superano i 75 milioni di pixel (lunghezza x larghezza) , l'API Vision ridimensiona l'immagine; in caso contrario, l'API Vision utilizza l'immagine originale.

Queste dimensioni consigliate variano in base alla funzionalità rilevata. Ad esempio, le richieste FACE_DETECTION in genere richiedono dimensioni delle immagini maggiori perché gli elementi rilevati (volti) sono più piccoli dell'immagine stessa. Le richieste LABEL_DETECTION, invece, valutano generalmente un'intera immagine.

In pratica, nella maggior parte dei casi è sufficiente una dimensione standard di 640 x 480 pixel. Le dimensioni superiori potrebbero non aumentare molto l'accuratezza, diminuendo notevolmente la velocità in bit. Se possibile, pre-elabora le immagini per ridurne le dimensioni a questi standard minimi.

Dimensioni file

I file immagine inviati all'API Vision non devono superare i 20 MB. I file superiori a 20 MB generano un errore. L'API Vision non ridimensiona i file di queste dimensioni. La riduzione delle dimensioni del file può migliorare notevolmente il throughput. Tuttavia, fai attenzione a non ridurre la qualità delle immagini durante l'operazione. Tieni presente che l'API Vision impone un limite di dimensione della richiesta JSON di 10 MB. I file di dimensioni maggiori devono essere ospitati su Cloud Storage o sul web, anziché essere trasmessi come contenuti con codifica Base64 nel JSON stesso.