1. Visão geral
A Google Cloud Vision API permite que os desenvolvedores integrem facilmente recursos de detecção de visão nos aplicativos, incluindo rotulagem de imagens, detecção facial e de pontos de referência, reconhecimento óptico de caracteres (OCR) e marcação de conteúdo explícito.
Neste codelab, você se concentrará no uso da API Vision com o C#. Você vai aprender a executar a detecção de texto, de pontos de referência e de reconhecimento facial.
O que você vai aprender
- Como usar o Cloud Shell
- Como ativar a API Google Cloud Vision
- Como autenticar solicitações de API
- Como instalar a biblioteca de cliente da API Vision para C#
- Como realizar a detecção de rótulos
- Como executar a Detecção de texto
- Como executar a detecção de pontos de referência
- Como realizar a detecção facial
O que é necessário
Pesquisa
Como você vai usar este tutorial?
Como você classificaria sua experiência com C#?
Como você classificaria sua experiência com o uso dos serviços do Google Cloud Platform?
2. Configuração e requisitos
Configuração de ambiente autoguiada
- Faça login no Console do Google Cloud e crie um novo projeto ou reutilize um existente. Crie uma conta do Gmail ou do Google Workspace, se ainda não tiver uma.
- O Nome do projeto é o nome de exibição para os participantes do projeto. É uma string de caracteres não usada pelas APIs do Google e pode ser atualizada quando você quiser.
- O ID do projeto precisa ser exclusivo em todos os projetos do Google Cloud e não pode ser mudado após a definição. O console do Cloud gera automaticamente uma string exclusiva. Em geral, não importa o que seja. Na maioria dos codelabs, é necessário fazer referência ao ID do projeto, normalmente identificado como
PROJECT_ID. Se você não gostar do ID gerado, crie outro aleatório. Se preferir, teste o seu e confira se ele está disponível. Ele não pode ser mudado após essa etapa e permanece durante o projeto. - Para sua informação, há um terceiro valor, um Número do projeto, que algumas APIs usam. Saiba mais sobre esses três valores na documentação.
- Em seguida, ative o faturamento no console do Cloud para usar os recursos/APIs do Cloud. A execução deste codelab não vai ser muito cara, se tiver algum custo. Para encerrar os recursos e evitar cobranças além deste tutorial, exclua os recursos criados ou exclua o projeto. Novos usuários do Google Cloud estão qualificados para o programa de US$ 300 de avaliação sem custos.
Inicie o Cloud Shell
Embora o Google Cloud e o Spanner possam ser operados remotamente do seu laptop, neste codelab usaremos o Google Cloud Shell, um ambiente de linha de comando executado no Cloud.
Ativar o Cloud Shell
- No Console do Cloud, clique em Ativar o Cloud Shell
.
Se você estiver iniciando o Cloud Shell pela primeira vez, verá uma tela intermediária com a descrição dele. Se aparecer uma tela intermediária, clique em Continuar.
Leva apenas alguns instantes para provisionar e se conectar ao Cloud Shell.
Essa máquina virtual tem todas as ferramentas de desenvolvimento necessárias. Ela oferece um diretório principal persistente de 5 GB, além de ser executada no Google Cloud. Isso aprimora o desempenho e a autenticação da rede. Grande parte do trabalho neste codelab, se não todo, pode ser feito em um navegador.
Depois de se conectar ao Cloud Shell, você verá sua autenticação e o projeto estará configurado com o ID do seu projeto.
- Execute o seguinte comando no Cloud Shell para confirmar se a conta está autenticada:
gcloud auth list
Resposta ao comando
Credentialed Accounts
ACTIVE ACCOUNT
* <my_account>@<my_domain.com>
To set the active account, run:
$ gcloud config set account `ACCOUNT`
- Execute o seguinte comando no Cloud Shell para confirmar que o comando gcloud sabe sobre seu projeto:
gcloud config list project
Resposta ao comando
[core] project = <PROJECT_ID>
Se o projeto não estiver configurado, configure-o usando este comando:
gcloud config set project <PROJECT_ID>
Resposta ao comando
Updated property [core/project].
3. Ativar a API Vision
Antes de começar a usar a API Vision, você precisa ativá-la. No Cloud Shell, é possível ativar a API com o seguinte comando:
gcloud services enable vision.googleapis.com
4. Instalar a biblioteca de cliente da API Google Cloud Vision para C#
Primeiro, crie um aplicativo simples de console em C# para executar exemplos da API Vision:
dotnet new console -n VisionApiDemo
Você verá o aplicativo criado e as dependências resolvidas:
The template "Console Application" was created successfully.
Processing post-creation actions...
...
Restore succeeded.
Em seguida, navegue até a pasta VisionApiDemo:
cd VisionApiDemo/
Adicione o pacote NuGet Google.Cloud.Vision.V1 ao projeto:
dotnet add package Google.Cloud.Vision.V1
info : Adding PackageReference for package 'Google.Cloud.Vision.V1' into project '/home/atameldev/VisionApiDemo/VisionApiDemo.csproj'.
log : Restoring packages for /home/atameldev/VisionApiDemo/VisionApiDemo.csproj...
...
info : PackageReference for package 'Google.Cloud.Vision.V1' version '1.2.0' added to file '/home/atameldev/VisionApiDemo/VisionApiDemo.csproj'.
Agora você já pode usar a API Vision.
5. Realizar detecção de marcadores
Um dos recursos básicos da API Vision é identificar objetos ou entidades em uma imagem, conhecido como anotação de rótulo. A detecção de rótulos identifica objetos gerais, locais, atividades, espécies de animais, produtos e muito mais. A API Vision usa uma imagem de entrada e retorna os rótulos mais prováveis que se aplicam a essa imagem. Ela retorna os principais rótulos correspondentes junto com uma pontuação de confiança de uma correspondência com a imagem.
Neste exemplo, você vai fazer a detecção de rótulos na imagem de uma cena de rua em Xangai. Abra o editor de código no canto superior direito do Cloud Shell:
Navegue até o arquivo Program.cs dentro da pasta VisionApiDemo e substitua o código pelo seguinte:
using Google.Cloud.Vision.V1;
using System;
namespace VisionApiDemo
{
class Program
{
static void Main(string[] args)
{
var client = ImageAnnotatorClient.Create();
var image = Image.FromUri("gs://cloud-samples-data/vision/using_curl/shanghai.jpeg");
var labels = client.DetectLabels(image);
Console.WriteLine("Labels (and confidence score):");
Console.WriteLine(new String('=', 30));
foreach (var label in labels)
{
Console.WriteLine($"{label.Description} ({(int)(label.Score * 100)}%)");
}
}
}
}
Reserve alguns minutos para estudar o código e ver como a biblioteca C# da API Vision é usada para realizar a detecção de rótulos.
No Cloud Shell, execute o app:
dotnet run
Você verá esta resposta:
Labels (and confidence score):
==============================
Wheel (97%)
Tire (97%)
Photograph (94%)
Bicycle (94%)
Motor vehicle (89%)
Infrastructure (89%)
Vehicle (86%)
Mode of transport (84%)
Bicycle wheel (83%)
Asphalt (81%)
Resumo
Nesta etapa, você conseguiu realizar a detecção de rótulos em uma imagem de uma cena de rua na China e exibir os rótulos mais prováveis associados a essa imagem. Leia mais sobre a detecção de marcadores.
6. Realizar detecção de texto
O reconhecimento óptico de caracteres é feito com a detecção de texto da API Vision. Ele detecta e extrai o texto de uma imagem com suporte para vários idiomas. Também é possível fazer a identificação automática de idioma.
Neste exemplo, você vai fazer a detecção de texto na imagem de uma tela de atualização de software do sistema.
Navegue até o arquivo Program.cs dentro da pasta VisionApiDemo e substitua o código pelo seguinte:
using Google.Cloud.Vision.V1;
using System;
namespace VisionApiDemo
{
class Program
{
static void Main(string[] args)
{
var client = ImageAnnotatorClient.Create();
var image = Image.FromUri("gs://cloud-samples-data/vision/text/screen.jpg");
var response = client.DetectText(image);
foreach (var annotation in response)
{
if (annotation.Description != null)
{
Console.WriteLine(annotation.Description);
}
}
}
}
}
Reserve alguns minutos para estudar o código e entender como a biblioteca C# da API Vision é usada para realizar a detecção de texto.
No Cloud Shell, execute o app:
dotnet run
Você verá esta resposta:
System Software Update
Back
Preparing to install...
After preparation is complete, the PS4 will automatically restart and the update file will be
installed.
37%
gus class
System
Software
Update
Back
Preparing
to
install
...
After
preparation
is
complete
,
the
PS4
will
automatically
restart
and
the
update
file
will
be
installed
.
37
%
gus
class
Resumo
Nesta etapa, você realizou a detecção de texto em uma imagem de uma Otter Crossing e imprimiu o texto reconhecido a partir da imagem. Saiba mais sobre a Detecção de texto.
7. Realizar detecção de pontos de referência
A detecção de pontos de referência da API Vision detecta estruturas famosas, naturais e construídas pelo homem em uma imagem.
Neste exemplo, você fará a detecção de pontos de referência em uma imagem da Torre Eiffel.
Navegue até o arquivo Program.cs dentro da pasta VisionApiDemo e substitua o código pelo seguinte:
using Google.Cloud.Vision.V1;
using System;
namespace VisionApiDemo
{
class Program
{
static void Main(string[] args)
{
var client = ImageAnnotatorClient.Create();
var image = Image.FromUri("gs://cloud-samples-data/vision/eiffel_tower.jpg");
var response = client.DetectLandmarks(image);
foreach (var annotation in response)
{
if (annotation.Description != null)
{
Console.WriteLine(annotation.Description);
}
}
}
}
}
Reserve alguns minutos para estudar o código e entender como a biblioteca C# da API Vision é usada para realizar a detecção de pontos de referência.
No Cloud Shell, execute o app:
dotnet run
Você verá esta resposta:
Eiffel Tower
Resumo
Nesta etapa, você conseguiu detectar pontos de referência na imagem da Torre Eiffel. Leia mais sobre a detecção de pontos de referência.
8. Realizar detecção facial de emoção
A detecção facial detecta vários rostos em uma imagem, além dos principais atributos faciais associados, como estado emocional ou uso de chapéus.
Neste exemplo, você detectará a probabilidade do estado emocional de quatro diferentes probabilidades emocionais, incluindo: alegria, raiva, tristeza e surpresa.
Navegue até o arquivo Program.cs dentro da pasta VisionApiDemo e substitua o código pelo seguinte:
using Google.Cloud.Vision.V1;
using System;
namespace VisionApiDemo
{
class Program
{
static void Main(string[] args)
{
var client = ImageAnnotatorClient.Create();
var image = Image.FromUri("gs://cloud-samples-data/vision/face/face_no_surprise.jpg");
var response = client.DetectFaces(image);
foreach (var annotation in response)
{
Console.WriteLine($"Picture: {image}");
Console.WriteLine($" Surprise: {annotation.SurpriseLikelihood}");
}
}
}
}
Reserve alguns minutos para estudar o código e entender como a biblioteca C# da API Vision é usada para detectar rostos de emoções.
Execute o app.
dotnet run
Você verá a seguinte saída para nosso exemplo de face_no_surprise:
Picture: { "source": { "imageUri": "gs://cloud-samples-data/vision/face/face_no_surprise.jpg" } }
Surprise: Likely
Resumo
Nessa etapa, você conseguiu realizar a detecção facial de emoções. Saiba mais sobre Detecção facial.
9. Parabéns!
Você aprendeu a usar a API Vision com C# para realizar detecção diferente em imagens.
Limpar
Para evitar a cobrança na sua conta do Google Cloud Platform pelo uso de recursos neste guia de início rápido, siga estas etapas:
- Acesse o console do Cloud Platform.
- Selecione o projeto que você quer encerrar e clique em "Excluir". Na parte superior: isso programa a exclusão do projeto.
Saiba mais
- API Google Cloud Vision: https://cloud.google.com/vision/docs/
- C#/.NET no Google Cloud Platform: https://cloud.google.com/dotnet/
- Cliente Google Cloud .NET: https://googlecloudplatform.github.io/google-cloud-dotnet
Licença
Este conteúdo está sob a licença Atribuição 2.0 Genérica da Creative Commons.