Formatos de ficheiros
A API Vision suporta os seguintes tipos de imagens:
- JPEG
- PNG8
- PNG24
- GIF
- GIF animado (apenas o primeiro frame)
- BMP
- WEBP
- RAW
- ICO
- TIFF
Tenha em atenção que alguns destes formatos de imagem são "com perdas" (por exemplo, JPEG). A redução dos tamanhos dos ficheiros para formatos com perdas pode resultar numa degradação da qualidade da imagem e, por conseguinte, da precisão da API Vision.
Dimensionamento de imagens
Para permitir uma deteção precisa de imagens na API Vision, as imagens devem ter, geralmente, um mínimo de 640 x 480 píxeis (cerca de 300 mil píxeis). Os detalhes completos dos diferentes tipos de pedidos de funcionalidades da API Vision são apresentados abaixo:
| Funcionalidade da API Vision | Tamanho recomendado * | Notas |
|---|---|---|
| FACE_DETECTION | 1600 x 1200 | A distância entre os olhos é o mais 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 | O OCR requer uma resolução mais elevada para detetar carateres |
| SAFE_SEARCH_DETECTION | 640 x 480 |
Estes tamanhos recomendados diferem consoante a funcionalidade detetada. Por exemplo, os pedidos de FACE_DETECTION requerem geralmente tamanhos de imagem maiores porque as funcionalidades detetadas (rostos) são mais pequenas do que a própria imagem.
Por outro lado, os pedidos LABEL_DETECTION avaliam geralmente uma imagem completa.
Na prática, um tamanho padrão de 640 x 480 píxeis funciona bem na maioria dos casos. Os tamanhos superiores a este podem não ganhar muito em precisão, ao mesmo tempo que diminuem significativamente o débito. Sempre que possível, pré-processe as imagens para reduzir o respetivo tamanho a estes padrões mínimos.
Tamanho do ficheiro
Os ficheiros de imagem enviados para a API Vision não devem exceder 20 MB. Os ficheiros com mais de 20 MB geram um erro. A Vision API não redimensiona ficheiros deste tamanho. A redução do tamanho do ficheiro pode melhorar significativamente o débito; no entanto, tenha cuidado para não reduzir a qualidade da imagem no processo. Tenha em atenção que a API Vision impõe um limite de tamanho de pedido JSON de 10 MB. Os ficheiros maiores devem ser alojados no Cloud Storage ou na Web, em vez de serem transmitidos como conteúdo codificado em base64 no próprio JSON.