Immagini supportate

Formati file

L'API Vision supporta i seguenti tipi di immagini:

• JPEG
• PNG8
• PNG24
• GIF
• GIF animata (solo il primo frame)
• BMP
• WEBP
• Raw
• ICO
• PDF
• TIFF

Tieni presente che alcuni di questi formati delle immagini sono "con perdita di dati" (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.

Ridimensionamento delle immagini

Per consentire un rilevamento accurato nell'API Vision, le immagini devono in genere avere dimensioni minime di 640 x 480 pixel (circa 300.000 pixel). Di seguito sono riportati i dettagli completi per i 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	Il riconoscimento ottico dei caratteri richiede una risoluzione maggiore per rilevare i caratteri
SAFE_SEARCH_DETECTION	640 x 480

Nota: l'API Vision richiede che le immagini abbiano dimensioni sufficienti in modo che le funzionalità importanti all'interno della richiesta possano essere facilmente distinguibili. Le dimensioni più piccole o più grandi di quelle consigliate potrebbero andare bene. Tuttavia, dimensioni più piccole possono comportare una minore precisione, mentre dimensioni più grandi possono aumentare i tempi di elaborazione e l'utilizzo della larghezza di banda senza offrire vantaggi comparabili in termini di accuratezza. Le dimensioni delle immagini non devono superare i 75 M pixel (lunghezza x larghezza) per l'analisi OCR. Se le dimensioni dell'immagine superano i 75 M pixel (lunghezza x larghezza) , l'API Vision ridimensiona l'immagine, altrimenti l'API Vision utilizza l'immagine originale.

Le dimensioni consigliate variano in base alla funzionalità rilevata. Ad esempio, le richieste FACE_DETECTION di solito richiedono immagini di dimensioni maggiori perché le caratteristiche rilevate (i volti) sono più piccole dell'immagine stessa. Le richieste LABEL_DETECTION, invece, in genere valutano un'intera immagine.

In pratica, una dimensione standard di 640 x 480 pixel è la più adatta nella maggior parte dei casi; dimensioni superiori a queste potrebbero non ottenere un maggiore grado di precisione, riducendo al contempo la velocità effettiva. Se possibile, pre-elabora le immagini per ridurne le dimensioni in base a questi standard minimi.

Dimensioni file

I file immagine inviati all'API Vision non devono superare i 20 MB. I file di dimensioni 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 la velocità effettiva; tuttavia, fai attenzione a non ridurre la qualità dell'immagine durante il processo. Tieni presente che l'API Vision impone un limite per le dimensioni delle richieste JSON di 10 MB. I file più grandi dovrebbero essere ospitati su Cloud Storage o sul web, invece di essere passati come contenuti con codifica Base64 nel JSON stesso.