Conector Google Geocode

Integración con la API Geocode de Google

Introducción

Geocodificación es el proceso de convertir direcciones , que los usuarios pueden utilizar para colocar marcadores en un mapa, o posicionar el mapa. El objetivo de este conector es integrar la API de geocodificación de Google con Tulip mediante conectores HTTP y proporcionar a nuestros clientes un conector de geocodificación listo para usar que pueda importarse a su instancia.

Propósito

1. Vamos a destacar diferentes funciones de conectores HTTP que se pueden construir haciendo llamadas HTTP a los puntos finales de la API Geocode de Google para obtener información detallada acerca de una dirección, obteniendo sus coordenadas que podrían ser aprovechadas para diversos casos de uso. Utilizaremos la geocodificación inversa pasando las coordenadas y obteniendo toda la información sobre la dirección, además de mostrar cómo aplicar filtros a estas llamadas a la API.
2. Además, vamos a utilizar la API de Matriz de Distancia de Google para mostrar cómo se puede obtener información sobre la distancia y la duración del viaje entre 2 direcciones o coordenadas obtenidas a través de la API de Geocodificación como se explicó anteriormente.

Documentación API

1. Documentación de la API Google Geocode
2. Documentación de la API Matriz de distancias de Google

Requisitos previos

1. Crea una cuenta en la consola en la nube de Google y configura la clave API para Google Geocode. Puedes encontrar más información en los documentos de la API de Google.
2. La clave API generada se utilizará como parámetro de consulta en todas las funciones del conector para Geocode y Matriz de distancias. Los usuarios deben asegurarse de que sus claves de API se pasan a través del extractor de entrada de Tulip o se escriben en todas las funciones del conector.

Detalles de conexión de Tulip

La siguiente información debe ser configurada en los conectores de Tulip.

1. Ejecutando en: Cloud Connector Host
2. Host : maps.googleapis.com
3. Puerto:443
4. TLS:Sí
5. No se necesita autenticación: La clave API para cada llamada será suficiente.

Funciones del conector

Obtener información de dirección

Propósito

1. Los usuarios pueden pasar una consulta de búsqueda como una dirección de entrada y Tulip obtendrá toda la información importante acerca de la dirección específica y su equivalente Latitud y Longitud coordenadas que pueden ser utilizados como marcadores en los mapas o para otros casos de uso que uno pueda tener.
2. La información que se extrae de Geocode puede ser utilizada en aplicaciones Tulip, tablas Tulip o variables Tulip que se canalizarán a otras funciones de conexión que forman parte de Geocode Connector.

Punto final

1. Llamada HTTP GET al punto final -https://maps.googleapis.com:443/maps/api/geocode/json

Entrada requerida

Los siguientes son los parámetros de consulta que se deben pasar

1. Clave API
2. Dirección - Dirección para la consulta de búsqueda

Salida requerida Extractor

1. Dirección completa: Dirección completa formateada devuelta por Google.
2. Latitud: Coordenadas utilizadas para los marcadores en el mapa o utilizadas al pasar en la API de matriz de distancia.
3. Longitud : Coordenadas utilizadas para los marcadores en el mapa o utilizadas en la API de matriz de distancias.
4. Tipo de ubicación : Indicador del tipo de ubicación buscado.

Obtención de información de direcciones con la región

Propósito

1. Esta función es similar a la descrita anteriormente con la opción de pasar un parámetro de consulta adicional en la función del conector. Muchas veces una dirección se encuentra en varios países y, para obtener el resultado deseado, los usuarios pueden introducir el código de país en el parámetro de región de la función de conexión para asegurarse de que los resultados devueltos son del país de interés.
2. Aunque la región es uno de los parámetros de consulta que los usuarios pueden utilizar para filtrar los resultados, Google ofrece muchos otros parámetros de consulta que pueden utilizarse para realizar estas llamadas a Geocode API. Encontrará más información al respecto en la documentación de la API.

Endpoint y cabeceras

1. Llamada HTTP GET al punto finalhttps://maps.googleapis.com:443/maps/api/geocode/json

Entrada requerida

Los siguientes son los parámetros de consulta que deben pasarse

1. Clave API
2. Dirección - Dirección para la consulta de búsqueda
3. Región - País de interés

Extractores de salida requeridos

1. Dirección completa: Dirección completa formateada devuelta por Google.
2. Latitud: Coordenadas utilizadas para los marcadores en el mapa o utilizadas al pasar en la API de matriz de distancia.
3. Longitud : Coordenadas utilizadas para los marcadores en el mapa o utilizadas en la API de matriz de distancias.
4. Tipo de ubicación : Indicador del tipo de ubicación buscado.

Geocodificación inversa

Propósito

1. La geocodificación inversa es el proceso de convertir coordenadas geográficas en una dirección legible por el ser humano.
2. Esta función del conector toma las coordenadas como entrada y devuelve una dirección legible por el ser humano y todos los demás detalles, como los distintos componentes de la dirección, que devuelve la API.

Punto final y cabeceras

1. Llamada HTTP GET al punto finalhttps://maps.googleapis.com:443/maps/api/geocode/json

Entrada requerida

A continuación se indican los parámetros de consulta que deben introducirse

1. Clave API
2. LatitudLongitud: Los usuarios deben introducir las coordenadas separadas por comas.

Extractores de salida obligatorios

1. Dirección completa: Dirección completa formateada devuelta por Google.
2. Tipo de ubicación : Indicador del tipo de ubicación buscado

Geocodificación inversa con filtros

Propósito

1. Esta función de conexión se utiliza exactamente igual que la mencionada anteriormente, aunque Geocode API devuelve varias filas de resultados para las coordenadas pasadas para una ubicación. Esta función muestra cómo aprovechar los distintos parámetros de consulta que ofrece la API para filtrar los resultados en función de lo que interese.

Punto final y cabeceras

1. Llamada HTTP GET al punto finalhttps://maps.googleapis.com:443/maps/api/geocode/json

Entrada requerida

Los parámetros de consulta que deben introducirse son los siguientes

1. Clave API
2. LatitudLongitud: Los usuarios deben introducir las coordenadas separadas por comas.
3. Tipo de ubicación: Un parámetro de consulta para indicar que la API devuelve resultados para direcciones precisas o aproximadas.
4. Tipo de resultado : Un parámetro de consulta para indicar los resultados necesarios para una dirección de calle, establecimiento entre otras opciones que están disponibles en los documentos de la API.

Extractores de salida requeridos

1. Dirección completa: Dirección completa formateada devuelta por Google.
2. Tipo de ubicación : Indicador del tipo de ubicación buscado.

Obtención de distancia y duración

Propósito

1. Esta función realiza una llamada HTTP a la API de matrices de distancia que proporciona la distancia y la duración del viaje para una matriz de orígenes y destinos. La API devuelve información basada en la ruta recomendada entre los puntos inicial y final, calculada por la API de Google Maps.
2. Aprovechando las direcciones completas o las coordenadas devueltas por la API de geocodificación para obtener la distancia y el tiempo de viaje entre dos puntos.

Punto final y cabeceras

1. Llamada HTTP GET al punto finalhttps://maps.googleapis.com:443//maps/api/distancematrix/json

Datos necesarios

A continuación se indican los parámetros de consulta que deben introducirse

1. Clave API
2. Origen - Dirección/Coordenadas iniciales
3. Destino - Dirección/coordenadas finales
4. Unidades - Por defecto es el sistema métrico, pero puede introducirse el sistema imperial.

Salidas requeridas

1. Distancia : Distancia entre 2 direcciones de entrada
2. Duración : Tiempo que se tarda en recorrer el trayecto entre dos direcciones.

Obtener Distancia y Duración con parámetros

Propósito

1. Esta función se utiliza exactamente de la misma manera que la función de conector descrita anteriormente, sin embargo, estamos pasando parámetros de consulta adicionales para obtener los resultados.
2. Conducir es el modo de transporte por defecto cuando la API de la Matriz de Distancias devuelve el resultado de la duración y la distancia entre 2 ubicaciones. Si hay un caso de uso para obtener los resultados utilizando diferentes modos de transporte como tren, metro o a pie, podríamos aprovechar los parámetros de consulta adicionales de Google para obtener los datos deseados.

Endpoint y cabeceras

1. Llamada HTTP GET al punto finalhttps://maps.googleapis.com:443//maps/api/distancematrix/json

Entradas necesarias

A continuación se indican los parámetros de consulta que deben introducirse

1. Clave API
2. Origen - Dirección/Coordenadas iniciales
3. Destino - Dirección/coordenadas finales
4. Unidades - Por defecto es el sistema métrico, pero se puede introducir el sistema imperial.
5. Modo de viaje: Para especificar un modo diferente al modo por defecto que es la conducción
6. Modo de tránsito: Un submodo de viaje dentro del modo padre. (Ferrocarril/Subterráneo en Tránsito)

Salidas requeridas

1. Distancia : Distancia entre 2 direcciones de entrada
2. Duración : Tiempo de viaje entre 2 direcciones.