Conector do Google Geocode

Integração com a API Geocode do Google

Introdução

Geocodificação é o processo de conversão de endereços, que os usuários podem usar para colocar marcadores em um mapa ou posicionar o mapa. Da mesma forma, a geocodificação reversa é o processo de conversão de coordenadas geográficas em um endereço legível por humanos. O objetivo desse conector é integrar a API de geocodificação do Google com a Tulip usando conectores HTTP e fornecer aos nossos clientes um conector de geocodificação pronto para uso que possa ser importado para sua instância.

Objetivo

1. Vamos destacar diferentes funções do conector HTTP que podem ser criadas por meio de chamadas HTTP para os pontos de extremidade da API Geocode do Google para obter informações detalhadas sobre um endereço, obtendo suas coordenadas que podem ser aproveitadas para vários casos de uso. Usar a geocodificação reversa passando as coordenadas e obtendo todas as informações sobre o endereço, além de mostrar como aplicar filtros nessas chamadas de API.
2. Além disso, usaremos a API Distance Matrix do Google para mostrar como é possível obter informações sobre a distância e a duração da viagem entre dois endereços ou coordenadas obtidas por meio da API Geocoding, conforme explicado acima.

Documento da API

1. Documentação da API do Google Geocode
2. Documentação da API do Google Distance Matrix

Pré-requisitos

1. Crie uma conta no console de nuvem do Google e configure a chave de API para o Google Geocode. Mais informações podem ser encontradas nos documentos da API do Google.
2. A chave de API gerada será usada como parâmetro de consulta em todas as funções do conector para Geocode & Distance Matrix. Os usuários precisam se certificar de que suas chaves de API sejam passadas pelo extrator de entrada da Tulip ou digitadas em todas as funções do conector.

Detalhes da conexão da Tulip

As informações a seguir precisariam ser configuradas nos conectores da Tulip.

1. Executando em: host do conector de nuvem
2. Host: maps.googleapis.com
3. Porta:443
4. TLS:Sim
5. Não é necessária autenticação: A chave da API para cada chamada será suficiente.

Funções do conector

Obtenção de informações de endereço

Objetivo

1. Os usuários podem passar uma consulta de pesquisa como um endereço de entrada e a Tulip buscará todas as informações importantes sobre o endereço específico e suas coordenadas de latitude e longitude equivalentes, que podem ser usadas como marcadores em mapas ou para outros casos de uso.
2. As informações extraídas do Geocode podem então ser usadas em aplicativos Tulip, tabelas Tulip ou variáveis Tulip, que serão canalizadas para outras funções de conector que fazem parte do Geocode Connector.

Ponto final

1. Chamada HTTP GET para o ponto de extremidade -https://maps.googleapis.com:443/maps/api/geocode/json

Entrada obrigatória

A seguir estão os parâmetros de consulta que devem ser passados

1. Chave da API
2. Address - Endereço para a consulta de pesquisa

Extrator de saída obrigatório

1. Endereço completo: Endereço completo formatado retornado pelo Google.
2. Latitude: Coordenadas usadas para marcadores no mapa ou usadas para passar na API de matriz de distância.
3. Longitude: Coordenadas usadas para marcadores no mapa ou usadas ao passar na API de matriz de distância.
4. Location Type (Tipo de local) : Indicador do tipo de local pesquisado

Obtenção de informações de endereço com Region

Finalidade

1. Essa função é semelhante à descrita acima, com a opção de passar um parâmetro de consulta adicional na função de conector. Muitas vezes, um endereço pode estar em vários países e, para obter o resultado desejado, os usuários podem passar o código do país no parâmetro region da função do conector para garantir que os resultados retornados sejam do país de interesse.
2. Como a região é um dos parâmetros de consulta que os usuários podem usar para filtrar os resultados, o Google oferece muitos outros parâmetros de consulta que podem ser usados para fazer essas chamadas para a API Geocode. Mais informações sobre isso podem ser encontradas nos documentos da API.

Ponto de extremidade e cabeçalhos

1. Chamada HTTP GET para o ponto de extremidadehttps://maps.googleapis.com:443/maps/api/geocode/json

Entrada obrigatória

A seguir estão os parâmetros de consulta que devem ser passados

1. Chave da API
2. Address (Endereço) - Endereço para a consulta de pesquisa
3. Região - País de interesse

Extratores de saída obrigatórios

1. Endereço completo: Endereço completo formatado retornado pelo Google.
2. Latitude: Coordenadas usadas para marcadores no mapa ou usadas para passar na API de matriz de distância.
3. Longitude: Coordenadas usadas para marcadores no mapa ou usadas ao passar na API de matriz de distância.
4. Location Type (Tipo de local) : Indicador do tipo de local pesquisado

Geocodificação reversa

Objetivo

1. A geocodificação reversa é o processo de conversão de coordenadas geográficas em um endereço legível por humanos.
2. Essa função de conector tomaria as coordenadas como entrada e retornaria um endereço legível por humanos e todos os outros detalhes, como vários componentes de endereço, que são retornados pela API.

Ponto de extremidade e cabeçalhos

1. Chamada HTTP GET para o ponto de extremidadehttps://maps.googleapis.com:443/maps/api/geocode/json

Entrada necessária

A seguir estão os parâmetros de consulta que devem ser passados

1. Chave da API
2. LatitudeLongitude: Os usuários precisam passar as coordenadas separadas por vírgula.

Extratores de saída obrigatórios

1. Endereço completo: Endereço completo formatado retornado pelo Google.
2. Location Type (Tipo de local): Indicador do tipo de local pesquisado

Geocodificação reversa com filtros

Objetivo

1. Essa função de conector é usada exatamente como a mencionada acima, mas a API Geocode retorna várias linhas de resultados para as coordenadas passadas para um local. Essa função mostra como aproveitar vários parâmetros de consulta oferecidos pela API para filtrar os resultados de acordo com o que for de interesse

Ponto de extremidade e cabeçalhos

1. Chamada HTTP GET para o endpointhttps://maps.googleapis.com:443/maps/api/geocode/json

Entrada obrigatória

A seguir estão os parâmetros de consulta que devem ser passados

1. Chave da API
2. LatitudeLongitude: Os usuários precisam passar as coordenadas separadas por vírgula.
3. Location Type (Tipo de local): Um parâmetro de consulta para indicar que a API retorna resultados para endereços precisos ou aproximados.
4. Result Type (Tipo de resultado): Um parâmetro de consulta para indicar os resultados necessários para um endereço de rua, estabelecimento entre outras opções que estão disponíveis nos documentos da API.

Extratores de saída necessários

1. Endereço completo: Endereço completo formatado retornado pelo Google.
2. Location Type (Tipo de local) : Indicador do tipo de local pesquisado

Obtenção de distância e duração

Objetivo

1. Esta função faz uma chamada HTTP para a API Distance Matrix que fornece a distância e o tempo de viagem para uma matriz de origens e destinos. A API retorna informações com base na rota recomendada entre os pontos inicial e final, conforme calculado pela API do Google Maps
2. Aproveitando os endereços completos ou as coordenadas retornadas pela API de geocódigo para obter a distância e o tempo de viagem entre dois pontos.

Ponto final e cabeçalhos

1. Chamada HTTP GET para o endpointhttps://maps.googleapis.com:443//maps/api/distancematrix/json

Entradas necessárias

A seguir estão os parâmetros de consulta que devem ser passados

1. Chave da API
2. Origem - Endereço/ coordenadas iniciais
3. Destino - Endereço/coordenadas finais
4. Units (Unidades) - O padrão é métrico, mas o imperial pode ser passado.

Saídas necessárias

1. Distance (Distância): distância entre 2 endereços de entrada
2. Duração: Tempo gasto para viajar entre 2 endereços de entrada.

Obtenção de distância e duração com parâmetros

Objetivo

1. Essa função é usada exatamente da mesma maneira que a função de conector descrita anteriormente, mas estamos passando parâmetros de consulta adicionais para obter os resultados.
2. Dirigir é um modo de transporte padrão quando a API Distance Matrix retorna o resultado de duração e distância entre dois locais. Se houver um caso de uso para obter os resultados usando diferentes modos de transporte, como trem, metrô ou caminhada, poderemos aproveitar os parâmetros de consulta adicionais do Google para obter os dados desejados.

Ponto de extremidade e cabeçalhos

1. Chamada HTTP GET para o endpointhttps://maps.googleapis.com:443//maps/api/distancematrix/json

Entradas necessárias

A seguir estão os parâmetros de consulta que devem ser passados

1. Chave da API
2. Origem - Endereço/ coordenadas iniciais
3. Destino - Endereço/coordenadas finais
4. Unidades - O padrão é métrico, mas o imperial pode ser passado.
5. Modo de viagem: Para especificar um modo diferente do modo padrão que é dirigir
6. Modo de trânsito: Um submodo de viagem dentro do modo principal. (Trem/metrô em Trânsito)

Saídas necessárias

1. Distance (Distância): Distância entre 2 endereços de entrada
2. Duration (Duração): tempo gasto para viajar entre 2 endereços de entrada.