MENU
    Google Geocode Connector
    • 03 Nov 2023
    • 5 Elolvasandó percek
    • Közreműködők

    Google Geocode Connector


    Cikk összefoglaló

    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ő.

    Hasznos volt ez a cikk?