Imagens compatíveis

Formatos de arquivo

A API do Cloud Vision é compatível com os seguintes tipos de imagem:

  • JPEG
  • PNG8
  • PNG24
  • GIF
  • GIF animado (primeiro quadro apenas)
  • BMP
  • WEBP
  • RAW
  • ICO
  • PDF
  • TIFF

Observe que alguns desses formatos de imagem têm perdas (por exemplo, JPEG). A redução do tamanho do arquivo para esses formatos "com perdas" pode resultar em uma degradação da qualidade da imagem e, portanto, da precisão da API do Vision.

Dimensionamento da imagem

Para permitir uma detecção precisa da imagem na API do Cloud Vision, geralmente as imagens precisam ter, no mínimo, 640 x 480 pixels (cerca de 300.000 pixels). Os detalhes completos para os diferentes tipos de solicitações de recursos da API do Vision estão abaixo:

Funcionalidade da API do Vision Tamanho recomendado* Observações
FACE_DETECTION 1.600 x 1.200 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 1.024 x 768 O OCR requer mais resolução para detectar os caracteres
SAFE_SEARCH_DETECTION 640 x 480

Esses tamanhos recomendados diferem de acordo com o recurso que está sendo detectado. Por exemplo, solicitações FACE_DETECTION normalmente exigem tamanhos de imagem maiores porque os recursos que estão sendo detectados (rostos) são menores do que a própria imagem. Solicitações LABEL_DETECTION, por outro lado, geralmente avaliam uma imagem inteira.

Na prática, o tamanho padrão de 640 x 480 pixels funciona bem na maioria dos casos. Tamanhos maiores do que esse podem não ganhar muito em precisão e ainda diminuir consideravelmente a capacidade. Sempre que possível, processe previamente as imagens para reduzir o tamanho delas a esses padrões mínimos.

Tamanho do arquivo

Os arquivos de imagem enviados para a API do Cloud Vision não podem exceder 20 MB. Reduzir o tamanho do arquivo pode melhorar significativamente o rendimento. No entanto, tenha cuidado para não reduzir a qualidade da imagem no processo. Observe que a API do Vision impõe um limite de tamanho de solicitação JSON de 10 MB. Arquivos maiores precisam ser hospedados no Cloud Storage ou na Web, em vez de ser transmitidos como conteúdo codificado em base64 no próprio JSON.

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Documentação da API Cloud Vision
Precisa de ajuda? Acesse nossa página de suporte.