Konektor Google Geocode

Integracja z Google Geocode API

Wprowadzenie

Geokodowanie to proces przekształcania adresów, których użytkownicy mogą używać do umieszczania znaczników na mapie lub pozycjonowania mapy. Podobnie, odwrotne geokodowanie jest procesem przekształcania współrzędnych geograficznych w adres czytelny dla człowieka. Celem tego konektora jest integracja Google Geocode API z Tulip za pomocą konektorów HTTP i zapewnienie naszym klientom gotowego konektora Geocode, który można zaimportować do ich instancji.

Cel

1. Zamierzamy podkreślić różne funkcje konektorów HTTP, które można zbudować, wykonując wywołania HTTP do punktów końcowych Google Geocode API w celu uzyskania szczegółowych informacji o adresie, uzyskując jego współrzędne, które można wykorzystać w różnych przypadkach użycia. Korzystanie z odwrotnego geokodowania poprzez przekazywanie współrzędnych i uzyskiwanie wszystkich informacji o adresie wraz z pokazaniem, jak zastosować filtry do tych wywołań API.
2. Dodatkowo użyjemy interfejsu API Google Distance Matrix, aby pokazać, w jaki sposób można uzyskać informacje o odległości i czasie trwania podróży między 2 adresami lub współrzędnymi uzyskanymi za pośrednictwem interfejsu API Geocoding, jak wyjaśniono powyżej.

Dokumentacja API

1. Dokumentacja Google Geocode API
2. Dokumentacja interfejsu API Google Distance Matrix

Wymagania wstępne

1. Utwórz konto w Google Cloud Console i skonfiguruj klucz API dla Google Geocode. Więcej informacji można znaleźć w dokumentacji API Google.
2. Wygenerowany klucz API będzie używany jako parametr zapytania we wszystkich funkcjach łącznika dla Geocode i Distance Matrix. Użytkownicy muszą upewnić się, że ich klucze API zostały przekazane przez ekstraktor danych wejściowych Tulip lub wpisane we wszystkich funkcjach łącznika.

Szczegóły połączenia Tulip

W konektorach Tulip należy skonfigurować następujące informacje.

1. Uruchomione na: Host łącznika w chmurze
2. Host: maps.googleapis.com
3. Port:443
4. TLS:Tak
5. Uwierzytelnianie nie jest wymagane: Wystarczy klucz API dla każdego połączenia.

Funkcje konektora

Pobieranie informacji o adresie

Cel

1. Użytkownicy mogą przekazać zapytanie wyszukiwania jako adres wejściowy, a Tulip pobierze wszystkie ważne informacje o konkretnym adresie i jego odpowiednikach współrzędnych szerokości i długości geograficznej, które mogą być dalej używane jako znaczniki na mapach lub w innych przypadkach użycia.
2. Informacje pobierane z Geocode mogą być następnie dalej wykorzystywane w aplikacjach Tulip, tabelach Tulip lub zmiennych Tulip, które będą przesyłane do innych funkcji konektora, które są częścią Geocode Connector.

Punkt końcowy

1. Wywołanie HTTP GET do punktu końcowego -https://maps.googleapis.com:443/maps/api/geocode/json

Wymagane dane wejściowe

Poniżej znajdują się parametry zapytania, które należy przekazać

1. Klucz API
2. Adres - adres dla zapytania wyszukiwania

Wymagane dane wyjściowe Extractor

1. Pełny adres: Sformatowany pełny adres zwrócony przez Google.
2. Szerokość geograficzna: Współrzędne używane dla znaczników na mapie lub używane przez przekazywanie w interfejsie API macierzy odległości.
3. Długość geograficzna: Współrzędne używane dla znaczników na mapie lub używane przez przekazywanie w interfejsie API macierzy odległości.
4. Typ lokalizacji : Wskaźnik rodzaju wyszukiwanej lokalizacji

Pobieranie informacji o adresie z regionem

Cel

1. Ta funkcja jest podobna do opisanej powyżej z możliwością przekazania dodatkowego parametru zapytania w funkcji łącznika. Często zdarza się, że adres znajduje się w wielu krajach i aby uzyskać pożądany wynik, użytkownicy mogą przekazać kod kraju w parametrze regionu funkcji łącznika, aby upewnić się, że zwrócone wyniki pochodzą z kraju zainteresowania.
2. Region jest jednym z parametrów zapytań, które użytkownicy mogą wykorzystać do filtrowania wyników, jednak Google oferuje wiele innych parametrów zapytań, które można wykorzystać podczas wykonywania tych połączeń z Geocode API. Więcej informacji na ten temat można znaleźć w dokumentacji API.

Punkt końcowy i nagłówki

1. Wywołanie HTTP GET do punktu końcowegohttps://maps.googleapis.com:443/maps/api/geocode/json

Wymagane dane wejściowe

Poniżej znajdują się parametry zapytania, które należy przekazać

1. Klucz API
2. Adres - adres dla zapytania wyszukiwania
3. Region - kraj zainteresowania

Wymagane ekstraktory danych wyjściowych

1. Pełny adres: Sformatowany pełny adres zwrócony przez Google.
2. Szerokość geograficzna: Współrzędne używane dla znaczników na mapie lub używane przez przekazywanie w interfejsie API macierzy odległości.
3. Długość geograficzna: Współrzędne używane dla znaczników na mapie lub używane przez przekazywanie w interfejsie API macierzy odległości.
4. Typ lokalizacji : Wskaźnik rodzaju wyszukiwanej lokalizacji

Odwrotne geokodowanie

Cel

1. Odwrotne geokodowanie to proces przekształcania współrzędnych geograficznych w adres czytelny dla człowieka.
2. Ta funkcja łącznika przyjmuje współrzędne jako dane wejściowe i zwraca adres czytelny dla człowieka oraz wszystkie inne szczegóły, takie jak różne składniki adresu zwracane przez interfejs API.

Punkt końcowy i nagłówki

1. Wywołanie HTTP GET do punktu końcowegohttps://maps.googleapis.com:443/maps/api/geocode/json

Wymagane dane wejściowe

Poniżej przedstawiono parametry zapytania, które należy przekazać

1. Klucz API
2. LatitudeLongitude: Użytkownicy muszą przekazać współrzędne oddzielone przecinkami.

Wymagane ekstraktory danych wyjściowych

1. Full Address: Sformatowany pełny adres zwrócony przez Google.
2. Typ lokalizacji : Wskaźnik rodzaju wyszukiwanej lokalizacji.

Odwrotne geokodowanie z filtrami

Cel

1. Ta funkcja łącznika jest używana dokładnie tak, jak ta wspomniana powyżej, jednak Geocode API zwraca wiele wierszy wyników dla współrzędnych przekazanych dla lokalizacji. Ta funkcja pokazuje, jak wykorzystać różne parametry zapytania oferowane przez API do filtrowania wyników do tego, który jest interesujący.

Punkt końcowy i nagłówki

1. Wywołanie HTTP GET do punktu końcowegohttps://maps.googleapis.com:443/maps/api/geocode/json

Wymagane dane wejściowe

Poniżej przedstawiono parametry zapytania, które należy przekazać

1. Klucz API
2. LatitudeLongitude: Użytkownicy muszą przekazać współrzędne oddzielone przecinkami.
3. Location Type: Parametr zapytania wskazujący API zwraca wyniki dla dokładnych adresów lub przybliżonych.
4. Result Type : Parametr zapytania wskazujący potrzebne wyniki dla adresu ulicy, siedziby lub innych opcji dostępnych w dokumentacji API.

Wymagane ekstraktory danych wyjściowych

1. Pełny adres: Sformatowany pełny adres zwrócony przez Google.
2. Typ lokalizacji : Wskaźnik rodzaju wyszukiwanej lokalizacji.

Pobieranie odległości i czasu trwania

Cel

1. Ta funkcja wykonuje wywołanie HTTP do interfejsu API Distance Matrix, który zapewnia odległość i czas podróży dla macierzy punktów początkowych i docelowych. Interfejs API zwraca informacje w oparciu o zalecaną trasę między punktem początkowym i końcowym, obliczoną przez interfejs API Map Google
2. Wykorzystanie pełnych adresów lub współrzędnych zwróconych przez API geocode w celu uzyskania odległości i czasu podróży między 2 punktami.

Punkt końcowy i nagłówki

1. Wywołanie HTTP GET do punktu końcowegohttps://maps.googleapis.com:443//maps/api/distancematrix/json

Wymagane dane wejściowe

Poniżej przedstawiono parametry zapytania, które należy przekazać

1. Klucz API
2. Pochodzenie - adres początkowy/współrzędne
3. Miejsce docelowe - adres końcowy/współrzędne
4. Jednostki - Domyślnie metryczne, ale można podać imperialne.

Wymagane dane wyjściowe

1. Odległość: odległość między 2 adresami wejściowymi
2. Czas trwania: Czas podróży między 2 adresami wejściowymi.

Pobieranie odległości i czasu trwania z parametrami

Cel

1. Ta funkcja jest używana dokładnie w taki sam sposób, jak wcześniej opisana funkcja łącznika, jednak przekazujemy dodatkowe parametry zapytania, aby uzyskać wyniki.
2. Jazda samochodem jest domyślnym środkiem transportu, gdy Distance Matrix API zwraca czas trwania i odległość między 2 lokalizacjami. Jeśli istnieje przypadek użycia do uzyskania wyników przy użyciu różnych środków transportu, takich jak kolej, metro lub pieszo, możemy wykorzystać dodatkowe parametry zapytania Google, aby uzyskać pożądane dane.

Punkt końcowy i nagłówki

1. Wywołanie HTTP GET do punktu końcowegohttps://maps.googleapis.com:443//maps/api/distancematrix/json

Wymagane dane wejściowe

Poniżej znajdują się parametry zapytania, które należy przekazać

1. Klucz API
2. Pochodzenie - adres początkowy/współrzędne
3. Miejsce docelowe - adres końcowy/współrzędne
4. Jednostki - domyślnie metryczne, ale można podać imperialne.
5. Tryb podróży: Określenie innego trybu niż domyślny tryb jazdy.
6. Tryb tranzytowy: Podrzędny tryb podróży w ramach trybu nadrzędnego. (Kolej/podmiejska w ramach tranzytu)

Wymagane dane wyjściowe

1. Odległość: odległość między 2 adresami wejściowymi
2. Czas trwania: Czas podróży między 2 adresami wejściowymi.