Google Geocode Connector

Intégration avec l'API Geocode de Google

Introduction

Le géocodage est le processus de conversion des adresses, que les utilisateurs peuvent utiliser pour placer des marqueurs sur une carte, ou positionner la carte. L'objectif de ce connecteur est d'intégrer l'API de géocodage de Google avec Tulip en utilisant des connecteurs HTTP et de fournir à nos clients un connecteur de géocodage prêt à l'emploi qui peut être importé dans leur instance.

Objectif

1. Nous allons mettre en évidence les différentes fonctions du connecteur HTTP qui peuvent être construites en faisant des appels HTTP aux points d'extrémité de l'API Geocode de Google pour obtenir des informations détaillées sur une adresse, en obtenant ses coordonnées qui peuvent être exploitées pour différents cas d'utilisation. Utiliser le géocodage inversé en passant les coordonnées et en obtenant toutes les informations sur l'adresse, tout en montrant comment appliquer des filtres sur ces appels API.
2. En outre, nous allons utiliser l'API Distance Matrix de Google pour montrer comment on peut obtenir des informations sur la distance et la durée du voyage entre deux adresses ou coordonnées obtenues via l'API de géocodage comme expliqué ci-dessus.

Doc API

1. Documentation de l'API Google Geocode
2. Documentation de l'API Google Distance Matrix

Conditions préalables

1. Créez un compte sur Google Cloud Console et configurez la clé API pour Google Geocode. Plus d'informations peuvent être trouvées dans la documentation API de Google.
2. La clé API générée sera utilisée comme paramètre de requête dans toutes les fonctions du connecteur pour Geocode et Distance Matrix. Les utilisateurs doivent s'assurer que leur clé API est transmise via l'extracteur d'entrée de Tulip ou qu'elle est saisie dans toutes les fonctions du connecteur.

Détails de la connexion Tulip

Les informations suivantes doivent être configurées sur les connecteurs de Tulip.

1. Exécution sur : Cloud Connector Host
2. Hôte : maps.googleapis.com
3. Port:443
4. TLS:Oui
5. Aucune authentification n'est nécessaire : La clé API pour chaque appel suffit.

Fonctions du connecteur

Obtenir des informations sur l'adresse

Objectif

1. Les utilisateurs peuvent passer une requête de recherche comme adresse d'entrée et Tulip récupérera toutes les informations importantes sur l'adresse spécifique et ses coordonnées équivalentes de latitude et de longitude qui peuvent être utilisées comme marqueurs sur des cartes ou pour d'autres cas d'utilisation que l'on pourrait avoir.
2. Les informations extraites de Geocode peuvent ensuite être utilisées dans les applications Tulip, les tables Tulip ou les variables Tulip qui seront acheminées vers d'autres fonctions du connecteur qui font partie de Geocode Connector.

Point final

1. Appel HTTP GET au point de terminaison -https://maps.googleapis.com:443/maps/api/geocode/json

Données requises

Les paramètres de requête suivants doivent être transmis

1. Clé API
2. Adresse - Adresse pour la requête de recherche

Sortie requise Extracteur

1. Adresse complète : Adresse complète formatée renvoyée par Google.
2. Latitude : Coordonnées utilisées pour les marqueurs sur la carte ou utilisées en passant dans l'API de la matrice de distance.
3. Longitude : Coordonnées utilisées pour les marqueurs sur la carte ou utilisées en passant dans la matrice de distance API.
4. Type de lieu : Indicateur du type de lieu recherché.

Obtention d'informations sur l'adresse avec la région

Objectif

1. Cette fonction est similaire à celle décrite ci-dessus, avec la possibilité de passer un paramètre de requête supplémentaire dans la fonction de connexion. Souvent, une adresse se trouve dans plusieurs pays et pour obtenir le résultat souhaité, les utilisateurs peuvent passer le code du pays dans le paramètre région de la fonction connecteur afin de s'assurer que les résultats renvoyés proviennent bien du pays concerné.
2. La région est l'un des paramètres de requête que les utilisateurs peuvent utiliser pour filtrer les résultats, mais Google propose de nombreux autres paramètres de requête qui peuvent être utilisés pour effectuer ces appels à l'API Geocode. Vous trouverez plus d'informations à ce sujet dans la documentation de l'API.

Point de terminaison et en-têtes

1. Appel HTTP GET au point de terminaisonhttps://maps.googleapis.com:443/maps/api/geocode/json

Données requises

Les paramètres de requête à transmettre sont les suivants

1. Clé API
2. Adresse - Adresse pour la recherche
3. Région - Pays d'intérêt

Extracteurs de sortie requis

1. Adresse complète : Adresse complète formatée renvoyée par Google.
2. Latitude : Coordonnées utilisées pour les marqueurs sur la carte ou utilisées en passant dans l'API de la matrice de distance.
3. Longitude : Coordonnées utilisées pour les marqueurs sur la carte ou utilisées en passant dans la matrice de distance API.
4. Type de lieu : Indicateur du type de lieu recherché.

Géocodage inversé

Objectif

1. Le géocodage inverse est le processus de conversion des coordonnées géographiques en une adresse lisible par l'homme.
2. Cette fonction de connecteur prend les coordonnées en entrée et renvoie une adresse lisible par l'homme et tous les autres détails tels que les divers composants de l'adresse renvoyée par l'API.

Point final et en-têtes

1. Appel HTTP GET au point de terminaisonhttps://maps.googleapis.com:443/maps/api/geocode/json

Données requises

Les paramètres de requête à transmettre sont les suivants

1. Clé API
2. LatitudeLongitude : Les utilisateurs doivent fournir les coordonnées séparées par une virgule.

Extracteurs de sortie requis

1. Adresse complète : Adresse complète formatée renvoyée par Google.
2. Type de lieu : Indicateur du type de lieu recherché.

Géocodage inversé avec filtres

Objectif

1. Cette fonction de connecteur est utilisée exactement comme celle mentionnée ci-dessus, mais l'API Geocode renvoie plusieurs lignes de résultats pour les coordonnées transmises pour un lieu. Cette fonction montre comment exploiter les différents paramètres de requête proposés par l'API pour filtrer les résultats en fonction de l'intérêt qu'ils présentent.

Point final et en-têtes

1. Appel HTTP GET au point de terminaisonhttps://maps.googleapis.com:443/maps/api/geocode/json

Données requises

Les paramètres de requête à transmettre sont les suivants

1. Clé API
2. LatitudeLongitude : Les utilisateurs doivent indiquer les coordonnées séparées par une virgule.
3. Type d'emplacement : Paramètre de requête indiquant si l'API renvoie des résultats pour des adresses précises ou approximatives.
4. Type de résultat : Un paramètre de requête pour indiquer les résultats nécessaires soit pour une adresse de rue, soit pour un établissement parmi d'autres options disponibles dans la documentation de l'API.

Extracteurs de sortie requis

1. Adresse complète : Adresse complète formatée renvoyée par Google.
2. Type de lieu : Indicateur du type de lieu recherché.

Obtenir la distance et la durée

Objectif

1. Cette fonction lance un appel HTTP à l'API Distance Matrix qui fournit la distance et la durée du trajet pour une matrice d'origines et de destinations. L'API renvoie des informations basées sur l'itinéraire recommandé entre les points de départ et d'arrivée, tel qu'il est calculé par l'API Google Maps
2. L'utilisation des adresses complètes ou des coordonnées renvoyées par l'API Geocode permet d'obtenir la distance et la durée du trajet entre deux points.

Point d'arrivée et en-têtes

1. Appel HTTP GET au point de terminaisonhttps://maps.googleapis.com:443//maps/api/distancematrix/json

Données requises

Les paramètres de requête à transmettre sont les suivants

1. Clé API
2. Origine - Adresse/coordonnées de départ
3. Destination - Adresse/coordonnées de fin
4. Unités - La valeur par défaut est le système métrique, mais le système impérial peut être transmis.

Résultats requis

1. Distance : Distance entre 2 adresses d'entrée
2. Durée : temps nécessaire pour parcourir la distance entre deux adresses d'entrée.

Obtenir la distance et la durée avec des paramètres

Objectif

1. Cette fonction est utilisée exactement de la même manière que la fonction de connexion décrite précédemment, mais nous transmettons des paramètres de requête supplémentaires pour obtenir les résultats.
2. La conduite est le mode de transport par défaut lorsque l'API Distance Matrix renvoie le résultat de la durée et de la distance entre deux lieux. S'il existe un cas d'utilisation pour obtenir les résultats en utilisant différents modes de transport comme le train, le métro ou la marche, nous pourrions utiliser les paramètres de requête supplémentaires de Google pour obtenir les données souhaitées.

Point de terminaison et en-têtes

1. Appel HTTP GET au point de terminaisonhttps://maps.googleapis.com:443//maps/api/distancematrix/json

Données requises

Les paramètres de requête à transmettre sont les suivants

1. Clé API
2. Origine - Adresse/coordonnées de départ
3. Destination - Adresse/coordonnées de fin
4. Unités - La valeur par défaut est le système métrique, mais le système impérial peut être transmis.
5. Mode de déplacement : Pour spécifier un autre mode que le mode par défaut, à savoir la conduite.
6. Mode de transit : Un sous-mode de voyage dans le mode parent. (Rail/métro sous Transit)

Sorties requises

1. Distance : Distance entre 2 adresses d'entrée
2. Durée : Temps nécessaire pour voyager entre 2 adresses d'entrée.