Formati file
L'API Vision supporta i seguenti tipi di immagini:
- JPEG
- PNG8
- PNG24
- GIF
- GIF animata (solo il primo fotogramma)
- BMP
- WEBP
- RAW
- ICO
- TIFF
Tieni presente che alcuni di questi formati immagine sono "lossy" (ad esempio, JPEG). La riduzione delle dimensioni dei file per questi formati con perdita potrebbe comportare un peggioramento della qualità dell'immagine e, di conseguenza, dell'accuratezza dell'API Vision.
Dimensioni delle immagini
Per consentire il rilevamento accurato delle immagini all'interno dell'API Vision, le immagini devono in genere avere una dimensione minima 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 | L'OCR richiede una risoluzione maggiore per rilevare i caratteri |
| SAFE_SEARCH_DETECTION | 640 x 480 |
Le dimensioni consigliate variano in base alla funzionalità rilevata. Ad esempio,
le richieste FACE_DETECTION in genere richiedono immagini di dimensioni maggiori perché le
funzionalità rilevate (volti) sono più piccole dell'immagine stessa.
Le richieste LABEL_DETECTION, invece, valutano generalmente un'intera
immagine.
In pratica, una dimensione standard di 640 x 480 pixel funziona bene nella maggior parte dei casi; dimensioni maggiori potrebbero non migliorare molto l'accuratezza, riducendo notevolmente il throughput. Quando 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 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 significativamente la velocità effettiva, ma fai attenzione a non ridurre la qualità dell'immagine durante la procedura. Tieni presente che l'API Vision impone un limite di 10 MB per le richieste JSON; i file più grandi devono essere ospitati su Cloud Storage o sul web, anziché essere passati come contenuti con codifica Base64 nel JSON stesso.