Esta página foi traduzida pela API Cloud Translation.
Switch to English

Como usar o APIs Explorer

Neste guia de início rápido, detalhamos os seguintes processos:

  • criação de um bucket do Cloud Storage
  • upload da imagem para o Cloud Storage e como torná-la pública
  • solicitação para a Vision API com essa imagem

Essas etapas devem demorar cerca de 5 minutos para serem concluídas. É possível armazenar gratuitamente até 5 GB de dados no Cloud Storage e fazer até 1.000 solicitações de recursos para a API Vision por mês, sem custo nenhum.

Antes de começar

Se você ainda não tiver feito isso, configure seu projeto e crie um bucket do Google Cloud Storage, conforme explicado abaixo.

Criar o projeto

  1. Faça login na sua conta do Google Cloud. Se você começou a usar o Google Cloud agora, crie uma conta para avaliar o desempenho de nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.
  2. No Console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

    Acessar o seletor de projetos

  3. Verifique se o faturamento está ativado para seu projeto na nuvem. Saiba como confirmar se o faturamento está ativado para o projeto.

  4. Ative a API Cloud Vision.

    Ative a API

Criar um bucket do Cloud Storage

  1. No Console do Cloud, acesse a página Navegador do Cloud Storage.

    Acessar o navegador

  2. Clique em Criar bucket.
  3. Na página Criar um bucket, insira as informações do seu bucket. Para ir à próxima etapa, clique em Continuar.
    • Em Nomear o bucket, insira um nome exclusivo. Não inclua informações confidenciais no nome do bucket já que o namespace dele é global e visível para o público.
    • Em Escolha um local para armazenar seus dados, faça o seguinte:
      • Selecione uma opção de Tipo de local.
      • Escolha uma opção de Local.
    • Em Escolha uma classe de armazenamento padrão para seus dados, selecione o seguinte: Standard.
    • Em Escolha como controlar o acesso a objetos, selecione uma opção de Controle de acesso.
    • Em Configurações avançadas (opcional), especifique um método de criptografia, uma política de retenção ou rótulos de bucket.
  4. Clique em Criar.

Fazer uma solicitação ao serviço da API Cloud Vision

  1. Download demo-img.jpg. Talvez seja necessário clicar com o botão direito do mouse no link.

  2. Abra o navegador do Console do Cloud Storage.

  3. Selecione o intervalo que você criou na seção anterior.

  4. Clique em Enviar arquivos e selecione o arquivo demo-img.jpg para fazer upload da sua máquina local ao bucket do Cloud Storage.

    Este é o arquivo de imagem que você acabou de enviar:
    mulheres andando de bicicleta na imagem de Jacarta
    Crédito da imagem: Rohiim Ariful em Unsplash.

  5. Depois que o arquivo for carregado e listado no Cloud Storage Browser, compartilhe a imagem publicamente.

  6. Preencha o modelo interativo do API Explorer, abaixo, substituindo cloud-samples-data/vision no campo image.source.imageUri pelo nome do bucket do Cloud Storage em que você fez upload do arquivo demo-img.jpg. O corpo da solicitação deve ser semelhante ao seguinte:

    {
      "requests": [
        {
          "features": [
            {
              "type": "LABEL_DETECTION"
            }
          ],
          "image": {
            "source": {
              "imageUri": "gs://cloud-samples-data/vision/demo-img.jpg"
            }
          }
        }
      ]
    }

  7. Clique em Executar para enviar a solicitação ao serviço. A resposta JSON é mostrada acima.

Parabéns! Você fez sua primeira solicitação images.annotate ao serviço da API Cloud Vision.

Limpar

Para evitar cobranças desnecessárias do Google Cloud Platform, use o Console do Cloud para excluir seu bucket do Cloud Storage (e seu projeto) se você não precisar deles.

A seguir