Imprimir Post

Caminho Rápido – Recuperando Latitude e Longitude com Classe Utilitária C#

Resumo:

O objetivo desta publicação é ensinar como recuperar a Latitude e Longitude de um endereço inserido pelo usuário, através de uma Classe Utilitária C#, à partir da ferramenta de desenvolvimento Microsoft Visual Studio.

O guia será apresentado de maneira a minimizar a parte teórica ao essencial e elevar a parte prática até a concretização do objetivo.

Palavras-chaves:

Visual, Studio, Classe, Latitude, Longitude, C#.

Texto:

Adendo

Para realização das tarefas referentes ao objetivo do post, foram utilizados os seguintes Programas:

  • Windows 10 Pro;
  • Microsoft Visual Studio Community 2015 Ultimate (Update 3).

A única configuração realizada após a instalação dos programas acima, foi manter o Microsoft Visual Studio sendo executado como usuário Administrador do Sistema Operacional, a fim de evitar maiores problemas.

Mãos à Obra

Tela Inicial do Microsoft Visual Studio Community 2015 (Update 3):

Model em uma Aplicação ASP.NET MVC - Microsoft Visual Studio 2015 Community - Tela Inicial

Microsoft Visual Studio 2015 Community – Tela Inicial

Primeiramente deve-se criar uma aplicação, no exemplo será Console Application:

Console Application - Relembre

Tela ao criar uma aplicação do tipo Console Application:

Latitude e Longitude - Microsoft Visual Studio Community 2015 - Criação de Novo Projeto

Microsoft Visual Studio Community 2015 – Criação de Novo Projeto

Nota-se que ao criar o Projeto Console Application, o Microsoft Visual Studio se encarrega automaticamente de gerar e disponibilizar uma classe chamada Program.cs.  Por hora deve-se ignorar esta classe.

Criando a Classe Geolocation

À partir do projeto anteriormente criado, localizar e clicar com o botão direito em LinkSinergia.ConsoleApplication, em seguida selecionar Add e clicar na opção Class…:

Latitude e Longitude - Microsoft Visual Studio Community 2015 - Criação de Classe

Microsoft Visual Studio Community 2015 – Criação de Classe

Tela após clicar na opção Class…:

Latitude e Longitude - Microsoft Visual Studio Community 2015 - Janela Central

Microsoft Visual Studio Community 2015 – Janela Central

A janela central está intitulada como Add New Item – LinkSinergia.ConsoleApplication.

Contendo 3 áreas divididas na vertical e 1 área dividida na horizontal, na primeira área à esquerda nomeada como: Installed, clicar  na opção Visual C# Items. Em seguida na área central, localizar e clicar na opção: Class. Por fim, na área que representa a divisão horizontal, manter as informações de acordo com a imagem abaixo e clicar no botão Add:

Latitude e Longitude - Microsoft Visual Studio Community 2015 - Janela Central

Microsoft Visual Studio Community 2015 – Janela Central

Vale destacar as configurações:

  • Name: determina-se o nome da Classe.

Tela após clicar no botão Add:

Latitude e Longitude - Microsoft Visual Studio Community 2015 - Tela após Criação da Classe

Microsoft Visual Studio Community 2015 – Tela após Criação da Classe

Alterando a Classe Geolocation

Partindo da classe Geolocation, deve-se clicar e modificar a área da classe, alterando-a para o seguinte código:

Tela ao colar o código:

Latitude e Longitude - Microsoft Visual Studio Community 2015 - Tela após Alteração da Classe

Microsoft Visual Studio Community 2015 – Tela após Alteração da Classe

Por fim, deve-se salvar a classe Geolocation e suas alterações clicando no botão Salvar. Tela com a confirmação positiva (ver rodapé da janela) ao clicar no botão Salvar:

Latitude e Longitude - Microsoft Visual Studio Community 2015 – Tela após Salvar o Projeto

Microsoft Visual Studio Community 2015 – Tela após Salvar o Projeto

Alterando a classe Program

O próximo passo é retornar a classe Program. Na área à direita nomeada como: Solution Explorer, deve-se clicar duas vezes (2x) sobre Program.cs.

Deve-se clicar e modificar a área da classe, alterando-a para o seguinte código:

Tela ao colar o código:

Latitude e Longitude - Microsoft Visual Studio Community 2015 - Tela após Alteração da Classe

Microsoft Visual Studio Community 2015 – Tela após Alteração da Classe

Por fim, deve-se salvar a classe Program e suas alterações clicando no botão Salvar. Tela com a confirmação positiva (ver rodapé da janela) ao clicar no botão Salvar:

Latitude e Longitude - Microsoft Visual Studio Community 2015 – Tela após Salvar o Projeto

Microsoft Visual Studio Community 2015 – Tela após Salvar o Projeto

Finalizando o exemplo, resta apenas executar a Aplicação, deve-se então clicar no botão Start Debugging (F5):

Latitude e Longitude - Microsoft Visual Studio Community 2015 – Execução da Aplicação

Microsoft Visual Studio Community 2015 – Execução da Aplicação

Tela ao clicar no botão Start Debugging (F5):

Latitude e Longitude - Microsoft Visual Studio Community 2015 – Execução da Aplicação (Janela de Console)

Microsoft Visual Studio Community 2015 – Execução da Aplicação (Janela de Console)

Considerações Finais:

Esta publicação visa ensinar como recuperar a Latitude e Longitude de um endereço inserido pelo usuário, através de uma Classe Utilitária C#, à partir da ferramenta de desenvolvimento Microsoft Visual Studio.

Vale destacar que:

  • Dentro de Geolocation, WebRequest e WebResponse são classes fornecidas pelo .NET Framework onde são preparados valores de propriedades a serem enviados para URI’s, visando o retorno de acesso a recursos disponibilizados (através dos protocolos http, https, ftp entre outros).
  • No exemplo, os valores retornados do recurso, são tratados por classes XML (XmlDocument, XmlTextReader, XmlNodeList, XmlNode) através da busca de um elemento alvo (location), recebendo os dados esperados.
  • Em resumo, as classes utilizam a API do google (recurso) para recuperar a Latitude e Longitude (dados esperados), à partir do endereço inserido.
  • Vale destacar que a consulta pode ser realizada manualmente pelo próprio navegador:
Latitude e Longitude - Microsoft Visual Studio Community 2015 – Consulta Manual

Microsoft Visual Studio Community 2015 – Consulta Manual

Resultado:

Latitude e Longitude - Microsoft Visual Studio Community 2015 – Consulta Manual

Microsoft Visual Studio Community 2015 – Consulta Manual

Referências Bibliográficas:

As referências bibliográficas não se aplicam a este post.

Sobre o autor

Thiago Richard Vanicore

Thiago Richard Vanicore formou-se em análise e desenvolvimento de sistemas, possui certificação ITIL Foundation V2 e entre seus conhecimentos estão: ASP .Net (WebForms/MVC5/Web API) C#, HTML5, Html/XHtml, CSS3, JQuery, JQuey Mobile, JavaScript, Xml, Ajax, Json, Microsoft SqlServer, MySql, Firebird, Azure, Visual Studio Online, Scrum, UML, CRM, Quality Assurance, CTI (Computer Telephony Integration) MPSBR (Melhoria de Processos do Software Brasileiro).

Link permanente para este artigo: http://linksinergia.com.br/2017/02/01/caminho-rapido-recuperando-latitude-e-longitude-com-classe-utilitaria-c/