Google Geocode Connector

Integration mit der Geocode API von Google

Einführung

Geokodierung ist der Prozess der Konvertierung von Adressen, die Benutzer verwenden können, um Markierungen auf einer Karte zu platzieren oder die Karte zu positionieren. Das Ziel dieses Konnektors ist es, die Geocode API von Google mit Hilfe von HTTP-Konnektoren in Tulip zu integrieren und unseren Kunden einen sofort einsetzbaren Geocode-Konnektor zu bieten, der in ihre Instanz importiert werden kann.

Zweck

1. Wir werden verschiedene HTTP-Connector-Funktionen hervorheben, die durch HTTP-Aufrufe an die Geocode API-Endpunkte von Google erstellt werden können, um detaillierte Informationen über eine Adresse abzurufen und ihre Koordinaten zu erhalten, die für verschiedene Anwendungsfälle genutzt werden können. Wir verwenden die umgekehrte Geokodierung, indem wir die Koordinaten übergeben und alle Informationen über die Adresse abrufen, und zeigen, wie man Filter auf diese API-Aufrufe anwendet.
2. Darüber hinaus werden wir die Entfernungsmatrix-API von Google verwenden, um zu zeigen, wie man Informationen über die Entfernung und die Reisedauer zwischen zwei Adressen oder Koordinaten abrufen kann, die wie oben beschrieben über die Geokodierungs-API erhalten wurden.

API-Dokument

1. Google Geocode API-Dokumentation
2. Google Entfernungsmatrix-API-Dokumentation

Voraussetzungen

1. Erstellen Sie ein Konto in der Cloud Console von Google und konfigurieren Sie den API-Schlüssel für Google Geocode. Weitere Informationen finden Sie in den API-Dokumenten von Google.
2. Der generierte API-Schlüssel wird als Abfrageparameter in allen Connector-Funktionen für Geocode & Distance Matrix verwendet. Die Benutzer müssen sicherstellen, dass sie ihre API-Schlüssel entweder über den Input-Extraktor von Tulip übergeben oder in allen Konnektor-Funktionen eingegeben haben.

Tulip-Verbindungsdetails

Die folgenden Informationen müssen in den Tulip-Konnektoren konfiguriert werden.

1. Läuft auf: Cloud Connector Host
2. Rechner: maps.googleapis.com
3. Anschluss:443
4. TLS:Ja
5. Keine Authentifizierung erforderlich: API-Schlüssel für jeden Aufruf ist ausreichend.

Connector-Funktionen

Abrufen von Adressinformationen

Zweck

1. Benutzer können eine Suchanfrage als Eingabeadresse übergeben und Tulip holt alle wichtigen Informationen über die spezifische Adresse und die entsprechenden Längen- und Breitengrad-Koordinaten, die als Markierungen auf Karten oder für andere Anwendungsfälle weiter verwendet werden können.
2. Die von Geocode abgerufenen Informationen können dann entweder in Tulip-Anwendungen, Tulip-Tabellen oder Tulip-Variablen weiterverwendet werden, die dann in andere Connector-Funktionen, die Teil von Geocode Connector sind, geleitet werden.

Endpunkt

1. HTTP GET-Aufruf an den Endpunkt -https://maps.googleapis.com:443/maps/api/geocode/json

Erforderliche Eingabe

Im Folgenden sind die Abfrageparameter aufgeführt, die übergeben werden müssen

1. API-Schlüssel
2. Adresse - Adresse für die Suchanfrage

Erforderliche Ausgabe Extraktor

1. Vollständige Adresse: Formatierte vollständige Adresse, die von Google zurückgegeben wird.
2. Breitengrad: Koordinaten, die für Markierungen auf der Karte oder bei der Weitergabe in der Entfernungsmatrix-API verwendet werden.
3. Längengrad: Koordinaten, die für Markierungen auf der Karte oder für die Übergabe in der Entfernungsmatrix-API verwendet werden.
4. Ortstyp : Indikator für die Art des gesuchten Ortes

Abrufen von Adressinformationen mit Region

Zweck

1. Diese Funktion ähnelt der oben beschriebenen mit der Option, einen zusätzlichen Abfrageparameter in der Konnektorfunktion zu übergeben. Oftmals liegt eine Adresse in mehreren Ländern. Um das gewünschte Ergebnis zu erhalten, kann der Benutzer den Ländercode im Parameter Region der Konnektorfunktion übergeben, um sicherzustellen, dass die Ergebnisse aus dem gewünschten Land stammen.
2. Da die Region einer der Abfrageparameter ist, können Benutzer die Ergebnisse filtern. Google bietet jedoch viele andere Abfrageparameter an, die bei diesen Aufrufen der Geocode API verwendet werden können. Weitere Informationen dazu finden Sie in den API-Dokumenten.

Endpunkt & Kopfzeilen

1. HTTP GET-Aufruf an den Endpunkthttps://maps.googleapis.com:443/maps/api/geocode/json

Erforderliche Eingabe

Die folgenden Abfrageparameter sind zu übergeben

1. API-Schlüssel
2. Adresse - Adresse für die Suchanfrage
3. Region - Land von Interesse

Erforderliche Output-Extraktoren

1. Vollständige Adresse: Formatierte vollständige Adresse, die von Google zurückgegeben wird.
2. Breitengrad: Koordinaten, die für Markierungen auf der Karte oder bei der Weitergabe in der Entfernungsmatrix-API verwendet werden.
3. Längengrad: Koordinaten, die für Markierungen auf der Karte oder für die Übergabe in der Entfernungsmatrix-API verwendet werden.
4. Ortstyp : Indikator für die Art des gesuchten Ortes

Umgekehrte Geokodierung

Zweck

1. Bei der umgekehrten Geokodierung werden geografische Koordinaten in eine von Menschen lesbare Adresse umgewandelt.
2. Diese Konnektorfunktion nimmt die Koordinaten als Eingabe und gibt eine menschenlesbare Adresse und alle anderen Details wie verschiedene Adresskomponenten zurück, die von der API zurückgegeben werden.

Endpunkt & Kopfzeilen

1. HTTP GET-Aufruf an den Endpunkthttps://maps.googleapis.com:443/maps/api/geocode/json

Erforderliche Eingabe

Die folgenden Abfrageparameter sind zu übergeben

1. API-Schlüssel
2. BreitengradLängengrad: Die Benutzer müssen die Koordinaten durch Komma getrennt eingeben.

Erforderliche Ausgabe-Extraktoren

1. Vollständige Adresse: Formatierte vollständige Adresse, die von Google zurückgegeben wird.
2. Ortstyp: Indikator für die Art des gesuchten Ortes

Umgekehrte Geokodierung mit Filtern

Zweck

1. Diese Konnektorfunktion wird genau wie die oben genannte verwendet, jedoch gibt die Geocode API mehrere Ergebniszeilen für die für einen Ort übergebenen Koordinaten zurück. Diese Funktion zeigt, wie verschiedene Abfrageparameter, die von der API angeboten werden, genutzt werden können, um die Ergebnisse nach denjenigen zu filtern, die von Interesse sind

Endpunkt & Kopfzeilen

1. HTTP GET-Aufruf an den Endpunkthttps://maps.googleapis.com:443/maps/api/geocode/json

Erforderliche Eingabe

Die folgenden Abfrageparameter sind zu übergeben

1. API-Schlüssel
2. BreitengradLängengrad: Die Benutzer müssen die Koordinaten durch Komma getrennt eingeben.
3. Standort-Typ: Ein Abfrageparameter, der angibt, ob die API Ergebnisse für genaue oder ungefähre Adressen liefert.
4. Ergebnistyp: Ein Abfrageparameter, der angibt, ob die Ergebnisse für eine Straßenadresse, eine Einrichtung oder andere Optionen benötigt werden, die in den API-Dokumenten verfügbar sind.

Erforderliche Ausgabeextraktoren

1. Vollständige Adresse: Formatierte vollständige Adresse, die von Google zurückgegeben wird.
2. Ortstyp: Indikator für die Art des gesuchten Ortes

Entfernung & Dauer ermitteln

Zweck

1. Diese Funktion führt einen HTTP-Aufruf an die Entfernungsmatrix-API aus, die Entfernungs- und Zeitangaben für eine Matrix von Ausgangs- und Zielorten liefert. Die API gibt Informationen zurück, die auf der von der Google Maps-API berechneten empfohlenen Route zwischen Start- und Zielpunkt basieren.
2. Nutzung entweder der vollständigen Adressen oder der von der Geocode-API zurückgegebenen Koordinaten, um die Entfernung und die Zeit zwischen zwei Punkten zu ermitteln.

Endpunkt & Kopfzeilen

1. HTTP GET-Aufruf an den Endpunkthttps://maps.googleapis.com:443//maps/api/distancematrix/json

Erforderliche Eingaben

Die folgenden Abfrageparameter sind zu übergeben

1. API-Schlüssel
2. Herkunft - Startadresse/Koordinaten
3. Ziel - Endadresse/Koordinaten
4. Einheiten - Standard ist metrisch, aber es können auch imperiale Einheiten angegeben werden.

Erforderliche Ausgaben

1. Entfernung : Entfernung zwischen 2 Eingabeadressen
2. Dauer: Zeit, die für die Strecke zwischen 2 Eingabeadressen benötigt wird.

Entfernung und Dauer mit Parametern ermitteln

Zweck

1. Diese Funktion wird genauso verwendet wie die zuvor beschriebene Verbindungsfunktion, allerdings werden zusätzliche Abfrageparameter übergeben, um die Ergebnisse zu erhalten.
2. Das Autofahren ist die Standard-Verkehrsart, wenn die Distance Matrix API die Dauer und die Entfernung zwischen zwei Orten liefert. Wenn es einen Anwendungsfall gibt, bei dem die Ergebnisse mit anderen Verkehrsmitteln wie Bahn, U-Bahn oder zu Fuß abgerufen werden sollen, können wir die zusätzlichen Abfrageparameter von Google nutzen, um die gewünschten Daten zu erhalten.

Endpunkt & Kopfzeilen

1. HTTP GET-Aufruf an den Endpunkthttps://maps.googleapis.com:443//maps/api/distancematrix/json

Erforderliche Eingaben

Im Folgenden sind die Abfrageparameter aufgeführt, die übergeben werden müssen

1. API-Schlüssel
2. Herkunft - Startadresse/Koordinaten
3. Ziel - Endadresse/Koordinaten
4. Einheiten - Standard ist metrisch, aber es können auch imperiale Einheiten übergeben werden.
5. Reisemodus: Zur Angabe eines anderen Modus als der Standardmodus "Fahren".
6. Transit-Modus: Ein untergeordneter Reisemodus innerhalb des übergeordneten Modus. (Bahn/Subway unter Transit)

Erforderliche Ausgaben

1. Entfernung: Entfernung zwischen 2 Eingabeadressen
2. Dauer: Zeit für die Fahrt zwischen 2 Eingabeadressen.