Connettore Google Geocode

Integrazione con l'API Geocode di Google

Introduzione

La geocodifica è il processo di conversione degli indirizzi, che gli utenti possono utilizzare per posizionare i marcatori su una mappa o per posizionare la mappa. Allo stesso modo, la geocodifica inversa è il processo di conversione delle coordinate geografiche in un indirizzo leggibile dall'uomo. L'obiettivo di questo connettore è integrare l'API Geocode di Google con Tulip utilizzando i connettori HTTP e fornire ai nostri clienti un connettore Geocode pronto all'uso che possa essere importato nella loro istanza.

Scopo

1. Verranno evidenziate diverse funzioni del connettore HTTP che possono essere costruite effettuando chiamate HTTP agli endpoint dell'API Geocode di Google per ottenere informazioni dettagliate su un indirizzo, ottenendo le sue coordinate che possono essere sfruttate per vari casi d'uso. Utilizziamo la geocodifica inversa passando le coordinate e ottenendo tutte le informazioni sull'indirizzo e mostrando come applicare filtri a queste chiamate API.
2. Inoltre, utilizzeremo l'API Distance Matrix di Google per mostrare come si possono ottenere informazioni sulla distanza e sulla durata del viaggio tra due indirizzi o coordinate ottenute tramite l'API Geocoding come spiegato sopra.

Documento API

1. Documentazione dell'API di Google Geocode
2. Documentazione dell'API Google Distance Matrix

Prerequisiti

1. Creare un account sulla Console cloud di Google e configurare la chiave API per Google Geocode. Ulteriori informazioni sono disponibili nei documenti API di Google.
2. La chiave API generata sarà utilizzata come parametro di query in tutte le funzioni del connettore per Geocode e Distance Matrix. Gli utenti devono assicurarsi di avere le loro chiavi API passate tramite l'estrattore di input di Tulip o digitate in tutte le funzioni del connettore.

Dettagli della connessione a Tulip

Le seguenti informazioni devono essere configurate sui connettori di Tulip.

1. In esecuzione su: Host del connettore cloud
2. Host: maps.googleapis.com
3. Porta: 443
4. TLS:Sì
5. Non è necessaria l'autenticazione: La chiave API per ogni chiamata è sufficiente.

Funzioni del connettore

Ottenere informazioni sull'indirizzo

Scopo

1. Gli utenti possono passare una query di ricerca come indirizzo di input e Tulip recupererà tutte le informazioni importanti sull'indirizzo specifico e le sue coordinate equivalenti di latitudine e longitudine, che possono essere ulteriormente utilizzate come marcatori sulle mappe o per altri casi d'uso.
2. Le informazioni estratte da Geocode possono essere utilizzate all'interno delle applicazioni Tulip, delle tabelle Tulip o delle variabili Tulip che vengono convogliate in altre funzioni del connettore che fanno parte di Geocode Connector.

Punto finale

1. Chiamata HTTP GET all'endpoint -https://maps.googleapis.com:443/maps/api/geocode/json

Input richiesti

I parametri di query da passare sono i seguenti

1. Chiave API
2. Indirizzo - Indirizzo per la query di ricerca

Estrattore di output richiesto

1. Indirizzo completo: Indirizzo completo formattato restituito da Google.
2. Latitudine: Coordinate utilizzate per i marcatori sulla mappa o utilizzate per il passaggio nella matrice di distanza API.
3. Longitudine : Coordinate utilizzate per i marcatori sulla mappa o utilizzate per il passaggio nella matrice di distanza API.
4. Tipo di località : Indicatore del tipo di località cercata

Ottenere informazioni sull'indirizzo con la Regione

Scopo

1. Questa funzione è simile a quella descritta in precedenza, con la possibilità di passare un parametro di query aggiuntivo nella funzione connettore. Spesso un indirizzo si trova in più Paesi e, per ottenere il risultato desiderato, l'utente può passare il codice del Paese nel parametro Regione della funzione connettore per assicurarsi che i risultati restituiti provengano dal Paese di interesse.
2. La regione è uno dei parametri di query che gli utenti possono utilizzare per filtrare i risultati, ma Google offre molti altri parametri di query che possono essere utilizzati per effettuare queste chiamate all'API Geocode. Maggiori informazioni al riguardo si possono trovare nei documenti dell'API.

Endpoint e intestazioni

1. Chiamata HTTP GET all'endpointhttps://maps.googleapis.com:443/maps/api/geocode/json

Input richiesti

I parametri di query da passare sono i seguenti

1. Chiave API
2. Indirizzo - Indirizzo per la query di ricerca
3. Regione - Paese di interesse

Estrattori di output richiesti

1. Indirizzo completo: Indirizzo completo formattato restituito da Google.
2. Latitudine: Coordinate utilizzate per i marcatori sulla mappa o utilizzate per il passaggio nella matrice di distanza API.
3. Longitudine : Coordinate utilizzate per i marcatori sulla mappa o utilizzate per il passaggio nella matrice di distanza API.
4. Tipo di località : Indicatore del tipo di località ricercata

Geocodifica inversa

Scopo

1. La geocodifica inversa è il processo di conversione delle coordinate geografiche in un indirizzo leggibile dall'uomo.
2. Questa funzione del connettore prende le coordinate come input e restituisce un indirizzo leggibile dall'uomo e tutti gli altri dettagli, come i vari componenti dell'indirizzo, restituiti dall'API.

Endpoint e intestazioni

1. Chiamata HTTP GET all'endpointhttps://maps.googleapis.com:443/maps/api/geocode/json

Input richiesti

I parametri di query da passare sono i seguenti

1. Chiave API
2. LatitudineLongitudine: Gli utenti devono inserire le coordinate separate da una virgola.

Estrattori di output richiesti

1. Indirizzo completo: Indirizzo completo formattato restituito da Google.
2. Tipo di località: Indicatore del tipo di località ricercata

Geocodifica inversa con filtri

Scopo

1. Questa funzione connettore viene utilizzata esattamente come quella citata in precedenza, ma Geocode API restituisce più righe di risultati per le coordinate passate per una località. Questa funzione mostra come sfruttare i vari parametri di interrogazione offerti dall'API per filtrare i risultati in base a quelli di interesse.

Punto finale e intestazioni

1. Chiamata HTTP GET all'endpointhttps://maps.googleapis.com:443/maps/api/geocode/json

Input richiesti

I parametri di query da passare sono i seguenti

1. Chiave API
2. LatitudineLongitudine: Gli utenti devono inserire le coordinate separate da una virgola.
3. Tipo di località: Un parametro di query per indicare che l'API restituisce risultati per indirizzi precisi o approssimativi.
4. Tipo di risultato: Un parametro di query per indicare i risultati necessari per un indirizzo stradale, una struttura o altre opzioni disponibili nei documenti API.

Estrattori di output richiesti

1. Indirizzo completo: Indirizzo completo formattato restituito da Google.
2. Tipo di località: Indicatore del tipo di località ricercata

Ottenere Distanza e durata

Scopo

1. Questa funzione effettua una chiamata HTTP all'API Distance Matrix che fornisce la distanza e la durata del viaggio per una matrice di origini e destinazioni. L'API restituisce informazioni basate sul percorso consigliato tra i punti di partenza e di arrivo, calcolato dall'API di Google Maps.
2. Sfruttando gli indirizzi completi o le coordinate restituite dall'API geocode per ottenere la distanza e il tempo di viaggio tra due punti.

Endpoint e intestazioni

1. Chiamata HTTP GET all'endpointhttps://maps.googleapis.com:443//maps/api/distancematrix/json.

Input richiesti

I parametri di query da passare sono i seguenti

1. Chiave API
2. Origine - Indirizzo di partenza/Coordinate
3. Destinazione - Indirizzo finale/Coordinate
4. Unità - L'impostazione predefinita è metrica, ma è possibile passare anche quella imperiale.

Uscite richieste

1. Distanza : Distanza tra 2 indirizzi di input
2. Durata: tempo di percorrenza tra 2 indirizzi di input.

Ottenere Distanza e Durata con i parametri

Scopo

1. Questa funzione viene utilizzata esattamente nello stesso modo della funzione connettore precedentemente descritta, ma per ottenere i risultati si passano parametri di interrogazione aggiuntivi.
2. La guida è la modalità di trasporto predefinita quando l'API Distance Matrix restituisce il risultato della durata e della distanza tra due località. Se esiste un caso d'uso per ottenere i risultati utilizzando modalità di trasporto diverse, come treno, metropolitana o a piedi, si possono sfruttare i parametri di query aggiuntivi di Google per ottenere i dati desiderati.

Endpoint e intestazioni

1. Chiamata HTTP GET all'endpointhttps://maps.googleapis.com:443//maps/api/distancematrix/json

Input richiesti

I parametri di query da passare sono i seguenti

1. Chiave API
2. Origine - Indirizzo di partenza/Coordinate
3. Destinazione - Indirizzo finale/Coordinate
4. Unità di misura - L'impostazione predefinita è metrica, ma è possibile passare anche quella imperiale.
5. Modalità di viaggio: Per specificare una modalità diversa da quella predefinita di guida.
6. Modalità di transito: Una modalità di viaggio secondaria all'interno della modalità principale. (Ferrovia/Subway sotto Transit)

Uscite richieste

1. Distanza: distanza tra 2 indirizzi di input
2. Durata: tempo di percorrenza tra 2 indirizzi di input.