Google Geocode Connector

Integráció a Google Geocode API-val

Bevezetés

A geokódolás a címek átalakításának folyamata , amelyet a felhasználók arra használhatnak, hogy jelöléseket helyezzenek el egy térképen, vagy pozícionálják a térképet. Hasonlóképpen, a fordított geokódolás a földrajzi koordináták ember által olvasható címekké való átalakításának folyamata.Ennek a csatlakozónak a célja, hogy a Google Geocode API-ját a Tulipba integrálja HTTP csatlakozók segítségével, és ügyfeleinknek egy kész Geocode csatlakozót biztosít, amelyet be lehet importálni a példányukba.

Cél

1. Különböző HTTP-csatlakozó funkciókat fogunk kiemelni, amelyek a Google Geocode API végpontjainak HTTP-hívásával építhetők ki, hogy részletes információkat kapjunk egy címről, és megkapjuk a koordinátáit, amelyeket különböző felhasználási esetekben lehet felhasználni. A fordított geokódolás használata a koordináták átadásával és a címre vonatkozó összes információ megszerzésével, valamint annak bemutatásával, hogyan alkalmazhatunk szűrőket ezekre az API-hívásokra.
2. Emellett a Google távolsági mátrix API-ját fogjuk használni annak bemutatására, hogyan lehet információt szerezni a távolságról és az utazás időtartamáról 2 cím vagy a geokódolási API-n keresztül kapott koordináták között a fentiek szerint.

API-dokumentum

1. Google Geokódoló API dokumentáció
2. Google távolsági mátrix API dokumentáció

Előfeltételek

1. Hozzon létre egy fiókot a Google felhő konzolján és konfigurálja az API-kulcsot a Google Geocode számára. További információ a Google API dokumentációjában található.
2. A generált API-kulcsot a Geocode & Distance Matrix összes csatlakozófunkciójában lekérdezési paraméterként fogja használni. A felhasználóknak gondoskodniuk kell arról, hogy az API-kulcsot vagy a Tulip bemeneti kivonatolóján keresztül adják át, vagy minden csatlakozófüggvényben begépeljék.

Tulip kapcsolat részletei

A Tulip csatlakozókon a következő információkat kell beállítani.

1. Futtatás: Cloud Connector Host
2. Host: maps.googleapis.com
3. Port:443
4. TLS:Igen
5. Nincs szükség hitelesítésre: API-kulcs minden egyes híváshoz elegendő.

Csatlakozó funkciók

Címadatok lekérdezése

Cél

1. A felhasználók átadhatnak egy keresési lekérdezést, mint bemeneti címet, és a Tulip lekérdezi az összes fontos információt az adott címről és az azzal egyenértékű szélességi és hosszúsági koordinátákról, amelyeket a továbbiakban térképeken vagy más felhasználási esetekben jelölőként lehet használni.
2. A Geocode-ból származó információk ezután felhasználhatók a Tulip alkalmazásokban, Tulip táblázatokban vagy Tulip változókban, amelyeket a Geocode Connector részét képező egyéb csatlakozó funkciókba továbbítanak.

Végpont

1. HTTP GET hívás a végponthoz -https://maps.googleapis.com:443/maps/api/geocode/json

Szükséges bemenet

A következő lekérdezési paramétereket kell átadni

1. API-kulcs
2. Address - A keresési lekérdezés címe

Kötelező kimenet Extractor

1. Teljes cím: A Google által visszaküldött formázott teljes cím.
2. Szélesség: A térképen lévő jelölésekhez használt koordináták vagy a távolságmátrix API-ban történő átadáskor használt koordináták.
3. Hosszúság: A térképen lévő jelölésekhez használt koordináták vagy a távolságmátrix API-ban történő átadással használt koordináták.
4. Helyszíntípus : A keresett helyszín típusának mutatója

Címadatok lekérdezése a régióval

Cél

1. Ez a funkció hasonló a fent leírtakhoz, azzal a lehetőséggel, hogy a csatlakozófüggvényben egy további lekérdezési paramétert is átadhatunk. Sokszor előfordul, hogy egy cím több országban is található, és a kívánt eredmény elérése érdekében a felhasználók átadhatják az országkódot a csatlakozófüggvény régió paraméterében, hogy biztosítsák, hogy a visszaküldött eredmények a kívánt országból származnak.
2. A régió az egyik lekérdezési paraméter, amelyet a felhasználók felhasználhatnak az eredmények szűrésére, azonban a Google számos más lekérdezési paramétert is kínál, amelyek felhasználhatók a Geocode API-hoz intézett hívások során. Erről bővebb információ az API dokumentációjában található.

Végpont és fejlécek

1. HTTP GET hívás ahttps://maps.googleapis.com:443/maps/api/geocode/json végpontra.

Kötelező bemenet

A következő lekérdezési paramétereket kell átadni

1. API-kulcs
2. Address - A keresési lekérdezés címe
3. Régió - Az érdeklődő ország

Kötelező kimeneti kivonatolók

1. Teljes cím: A Google által visszaküldött formázott teljes cím.
2. Szélességi fok: A térképen lévő jelölésekhez használt koordináták vagy a távolságmátrix API-ban történő átadáshoz használt koordináták.
3. Hosszúság : A térképen lévő jelölésekhez használt koordináták vagy a távolságmátrix API-ban történő átadással használt koordináták.
4. Helyszíntípus : A keresett helyszín típusának mutatója

Fordított geokódolás

Cél

1. A fordított geokódolás a földrajzi koordináták ember által olvasható címekké történő átalakítása.
2. Ez a csatlakozófunkció a koordinátákat veszi be, és az API által visszaküldött, ember által olvasható címet és minden egyéb részletet, például a különböző címösszetevőket adja vissza.

Végpont és fejlécek

1. HTTP GET hívás ahttps://maps.googleapis.com:443/maps/api/geocode/json végpontra.

Szükséges bemenet

A következő lekérdezési paramétereket kell átadni

1. API-kulcs
2. SzélességHosszúság: A felhasználóknak a koordinátákat vesszővel elválasztva kell megadniuk.

Szükséges kimeneti kivonatok

1. Teljes cím: A Google által visszaküldött formázott teljes cím.
2. Helyszíntípus : A keresett helyszín típusának mutatója

Fordított geokódolás szűrőkkel

Cél

1. Ezt a csatlakozó funkciót pontosan úgy kell használni, mint a fent említettet, azonban a Geocode API több sornyi eredményt ad vissza a helyhez átadott koordinátákhoz. Ez a funkció bemutatja, hogyan lehet kihasználni az API által kínált különböző lekérdezési paramétereket az eredmények szűrésére az érdeklődésre számot tartó eredményekre.

Végpont és fejlécek

1. HTTP GET hívás ahttps://maps.googleapis.com:443/maps/api/geocode/json végpontra.

Kötelező bemenet

A következő lekérdezési paramétereket kell átadni

1. API-kulcs
2. SzélességHosszúság: A felhasználóknak a koordinátákat vesszővel elválasztva kell megadniuk.
3. Helyszíntípus: Egy lekérdezési paraméter, amely jelzi, hogy az API pontos vagy hozzávetőleges címek esetén adja vissza az eredményeket.
4. Eredménytípus : Egy lekérdezési paraméter, amely az API dokumentációban elérhető egyéb opciók közül az utcai címre vagy telephelyre vonatkozó eredményekre vonatkozó eredményeket jelzi.

Kötelező kimeneti kivonatolók

1. Teljes cím: A Google által visszaküldött teljes cím formázva.
2. Helyszín típusa : A keresett helyszín típusának mutatója

Távolság és időtartam megadása

Cél

1. Ez a funkció HTTP-hívást indít a távolsági mátrix API-hoz, amely a kiindulási és célállomások mátrixának utazási távolságát és idejét adja meg. Az API a Google Maps API által kiszámított, a kezdő- és végpontok közötti ajánlott útvonal alapján adja vissza az információkat.
2. A geocode api által visszaküldött teljes címek vagy koordináták felhasználásával megkapja a 2 pont közötti utazási távolságot és időt.

Végpont és fejlécek

1. HTTP GET hívás ahttps://maps.googleapis.com:443//maps/api/distancematrix/json végpontra.

Szükséges bemenetek

A következő lekérdezési paramétereket kell átadni

1. API-kulcs
2. Eredet - kezdőcím/koordináták
3. Célállomás - Végcím/koordináták
4. Units (mértékegységek) - alapértelmezett a metrikus, de átadható a birodalmi mértékegység is.

Szükséges kimenetek

1. Távolság: 2 bemeneti cím közötti távolság.
2. Időtartam : A 2 bemeneti cím közötti utazás ideje.

Távolság és időtartam lekérdezése paraméterekkel

Cél

1. Ezt a függvényt pontosan ugyanúgy használjuk, mint a korábban leírt csatlakozó függvényt, azonban további lekérdezési paramétereket adunk meg az eredményekhez.
2. A vezetés az alapértelmezett közlekedési mód, amikor a távolsági mátrix API visszaadja a 2 hely közötti időtartam és távolság eredményét. Ha van olyan felhasználási eset, amikor az eredményeket különböző közlekedési módok, például vasút, metró vagy gyaloglás használatával kapjuk meg, akkor a Google további lekérdezési paramétereit használhatjuk a kívánt adatok megszerzéséhez.

Végpont és fejlécek

1. HTTP GET hívás ahttps://maps.googleapis.com:443//maps/api/distancematrix/json végponthoz.

Szükséges bemenetek

A következő lekérdezési paramétereket kell átadni

1. API-kulcs
2. Eredet - kezdőcím/koordináták
3. Célállomás - Végcím/koordináták
4. Units (mértékegységek) - alapértelmezett a metrikus, de átadható a birodalmi mértékegység is.
5. Utazási mód: A vezetés alapértelmezett módjától eltérő mód megadása.
6. Átutazási mód: Az utazási mód egy almódja a főmódon belül. (Vasút/aluljáró a Tranzit alatt)

Szükséges kimenetek

1. Távolság: távolság 2 bemeneti cím között.
2. Időtartam : A 2 bemeneti cím közötti utazáshoz szükséges idő.