GoogleApi

API do Google

Integrações perfeitas da API do Google.
Google Maps, lugares, estradas, pesquisa e tradução.

Sinta-se à vontade para contribuir, lançar perguntas e relatar problemas. Geralmente respondo rápido (24-48 horas).
Você precisa de suporte para uma estrutura .Net adicional?, me avise.

Novidade: Versão 5.0.0 com Routes Api (direções e matriz), Ariel View Api e Address Validation Api.

---

Usando a Biblioteca

A biblioteca pode ser consumida, usando as implementações de face individuais ou injetando dependência nas APIs individuais.
Cada implementação de API consiste em uma solicitação e uma resposta. A solicitação possui propriedades que refletem os parâmetros suportados e a resposta representa o modelo de objeto para o json retornado.

Alguns outros membros notáveis.

 var uri = request . GetUri ( ) ; // Gets the full request uri, including query parameters.
var params = request . GetQUeryStringParameters ( ) ; // Gets a list of all the added parameters. 

response . RawJson // The raw json returned by Google.
response . RawQueryString // The querystring sent to Google when invoking the request. 

Fachada

Cada API possui uma operação genérica de fachada para executar a solicitação e retornar a resposta.
O exemplo abaixo simplesmente preenche uma solicitação, invoca a operação de fachada e recebe a resposta em troca.

 TRequest request = new TRequest ( ) ;
TResponse response = await { Api } . [ { SubGroup } ] . { Action } . QueryAsync < TRequest , TResponse > ( request ) ;

Veja abaixo uma lista completa de APIs e ações suportadas.

Injeção de Dependência

Se for preferível injetar as APIs como dependências, registre os serviços durante a inicialização, conforme mostrado abaixo.

services
    . AddGoogleApiClients ( ) ;

Em seguida, injete as APIs individuais nos construtores conforme necessário

 public class MyClass
{
    private Api api ;
    
    public MyClass ( Api api )
    {
        this . api = api
    }
}

Veja abaixo uma lista completa de APIs e ações suportadas.

Procurador

Se um WebProxy for necessário, defina a propriedade estática HttpClientFactory.Proxy antes de registrar as dependências do GoogleApi ou usar o Façade.

---

APIs suportadas

As seguintes APIs são suportadas.

Google Mapas

• Direções ( GoogleMaps.Directions )
• Matriz de distância ( GoogleMaps.DistanceMatrix )
• Elevação ( GoogleMaps.Elevation )
• Geocódigo
  • Lugar ( GoogleMaps.Geocode.PlaceGeocode )
  • Endereço ( GoogleMaps.Geocode.AddressGeocode )
  • Localização (reversa) ( GoogleMaps.Geocode.LocationGeocode )
  • Código adicional ( GoogleMaps.Geocode.PlusCodeGeocode )
• Geolocalização ( GoogleMaps.Geolocation )
• Estradas
  • Estradas mais próximas ( GoogleMaps.Roads.NearestRoads )
  • Ajustar às estradas ( GoogleMaps.Roads.SnapToRoad )
  • Limites de velocidade ( GoogleMaps.Roads.SpeedLimits )
• Fuso horário
• Vista da rua
• Mapas estáticos
• Rotas
  • RouteDirections ( GoogleMaps.Routes.Directions )
  • RouteMatrix ( GoogleMaps.Routes.Matrix )
• Validação de endereço ( GoogleMaps.AddressValidation )
• Vista aérea ( beta )
  • Obter vídeo ( GoogleMaps.AerialView.GetVideo )
  • Renderizar vídeo ( GoogleMaps.AerialView.RenderVideo )

Google Locais

• Pesquisa de lugar
  • Encontrar ( GooglePlaces.Search.FindSearch )
  • Perto de ( GooglePlaces.Search.NearBySearch )
  • Texto ( GooglePlaces.Search.TextSearch )
• Detalhes do lugar ( GooglePlaces.Details )
• Fotos do lugar ( GooglePlaces.Photos )
• Preenchimento automático de local ( GooglePlaces.AutoComplete )
• Preenchimento automático de consulta ( GooglePlaces.QueryAutoComplete )

Pesquisa Google

• Web ( GoogleSearch.WebSearch )
• Imagem ( GoogleSearch.ImageSearch )
• Vídeo
  • Canais ( GoogleSearch.VideoSearch.Channels )
  • Listas de reprodução ( GoogleSearch.VideoSearch.Playlists )
  • Vídeos ( GoogleSearch.VideoSearch.Vidoes )

Google Tradutor

• Detectar ( GoogleTranslate.Detect )
• Idiomas ( GoogleTranslate.Languages )
• Traduzir ( GoogleTranslate.Translate )

Funções do Google

• MesclarPolyLine
• EncodePolyLine
• DecodificarPolyLine

---

Executando conjunto de testes

Executar o conjunto de testes é simples.

O projeto de teste armazena configurações relacionadas à sua assinatura do Google (gratuita ou paga) em application.default.json .
Mais importante ainda, o ApiKey , usado para identificar a assinatura do Google.

{ 
  "ApiKey" : " " ,
  "SearchEngineId" : " " ,
}

Mais informações sobre como gerar uma chave podem ser encontradas aqui: https://console.developers.google.com/

---