Ingyenes webhely-látogatók földrajzi elhelyezkedése az ipstack API-val (áttekintés)

Alázatos kezdete óta több mint 25 évvel ezelőtt,a világháló olyan módon fejlődött, hogy még a legjobb elemzők sem tudhatták volna megjósolni. Az a forma, amely lényegében eszköz volt a kutatók információk megosztására, olyan fogyasztói eszközré vált, amelyben sokunk egyszerűen nem tud megélni. Megváltoztatta életünk számos aspektusát, és valószínűleg jobban támaszkodtunk rá, mint kellene. Annyira általános, hogy megváltoztatja a kiskereskedelmi ipart. A tégla- és habarcsüzletek nagy láncai közül a legnagyobb kiskereskedők ma már web-alapú piacok.

A sikerhez az online kiskereskedőknek nemcsak szükségük vanjelen lenni az interneten, de teljes mértékben ki kell használniuk annak funkcióit is. Az egyik ilyen jellemző a földrajzi helymeghatározás. Ez a technológia lehetővé teszi a kiskereskedő számára, hogy megismerje webhelye látogatójának helyét. Ez egy hasznos szolgáltatás, amely lehetővé teszi számukra a becsült szállítási költségek megjelenítését vagy a helyspecifikus ajánlatok bemutatását. A földrajzi helymeghatározás előnyeinek egyik legegyszerűbb módja egy dedikált API használata, amelyet egy IP-címmel lehet ellátni, és amely minden releváns információt megad a címről. A ipstack API az egyik ilyen termék, amelyet felfedezni fogunkhogyan csinálja a varázsa, és mit tud tenni az Ön számára. Megvizsgáljuk az eszköz alapvető funkcióit, valamint azt, hogyan kell használni. Látjuk, hogyan teljesít, milyen típusú dokumentáció és támogatás áll rendelkezésre a termékhez, és megnézzük annak meglehetősen egyszerű árstruktúráját.

Bemutatjuk az ipstack-et

Az ipstack lényege egy geolokációs API, amelytöbb összekapcsolt ISP-t használ a pontos földrajzi adatok biztosításához. Felhívja az API-t a saját webhelyének kódjából, és ez rengeteg földrajzi adatot szolgáltat a webhely felhasználói számára. Természetesen megkapja a felhasználó földrajzi helyzetét (nem ez a legfontosabb pont?), De ez még nem minden. Például az eszköz linket ad vissza a felhasználó országának zászlójának képéhez vagy annak hangulatjel-verziójához. Ezenkívül információkat kap arról is, hogy a felhasználó proxy segítségével fér hozzá-e az Ön webhelyéhez. Mindezt mélyebb részletekbe megyünk, amikor mélyebb részleteket vizsgálunk az elérhető modulokról.

A projekt, amelyet eredetileg freegeoip-nek hívtak.net, nyílt forráskódú kezdeményezésként szolgálta a fejlesztõket 2009-ben. A felhasználói visszajelzéseken alapuló folyamatos fejlesztés révén körülbelül nyolc évvel később teljes értékű termékré fejlődött, amelyet most megvizsgálunk. Ez idő alatt a termék felhasználói bázisa több mint százezer elégedett ügyfélen nőtt fel. És nem csak ügyfelek. Az olyan óriások, mint a Microsoft vagy a Samsung, használják az API-t. Ugyanúgy, mint az Airbnb és a HubSpot.

Az ipstack API nagyon dinamikus sémát használamely naponta többször frissíti az adatbázisát, biztosítva a visszatért eredmények integritását. Ebből a célból az ipstack világszerte számos nagy internetszolgáltatóval együttműködött. Az eszköz minden kommunikációt 256 bites SSL-titkosított csatornán hajt végre - a HTTPS használatával - az összes adatátvitel biztosításához. Az eredményeket az API visszaadhatja XML vagy JSON formátumban, az Ön igényeitől függően.

Az ipstack API egyik legjobb része azmodularitás. A különféle elérhető modulok egyre több adatot szolgáltatnak a felhasználó helyéről. Ez nagyon rugalmas eszközt jelent. A sebesség a termék egyik legfontosabb része. Felhívja az API-t a megfelelő paraméter (ek) en, és szupergyorsan megkapja a kért eredményeket. Jelenleg az ipstack API naponta több mint két milliárd kérést kezeli, és szinte azonnal válaszol. Különböző internetszolgáltatókkal folytatott partnerség révén a termék világszerte körülbelül 2 millió helyet és több mint kétszázezer várost fed le. Támogatja az IPv4 és az IPv6 címeket is.

Hogyan működik a helymeghatározás?

Mielőtt továbbmennénk, tegyünk egy rövid szünetet ésröviden áttekintheti, hogy néz ki a földrajzi helyzet. Amint az ipstack nevéből sejtette, az IP-címekkel kapcsolatos. Az IP-címeket - bizonyos mértékig - a postai címekkel lehet összehasonlítani. Minden internethez csatlakoztatott eszköz egyedi IP-címmel rendelkezik. De ezeket az IP-címeket nem csak véletlenszerűen rendelik hozzá minden eszközhöz. Van benne valamilyen értelme. Az IP-cím egy része azonosítja az egyes csatlakoztatott eszközöket, a másik része pedig azt a hálózatot, amelyhez csatlakozik. És maga a hálózati rész is hierarchikusan van felépítve, kissé olyan, mint egy számítógépes lemez könyvtárfája. (Remélem, az olvasóink mérnökei megbocsátanak nekem a túlzott egyszerűsítésért.)

Ez hasonló egy utcai postai címhezszám, utcanév, város és végül egy ország. És csakúgy, mint a brit postának nincs elképzelése arról, hogy hol található az Egyesült Államok címe, az Egyesült Államokhoz kötött leveleket küld az USPS-nek, amely gondoskodik a levelek megfelelő helyre irányításáról. És ugyanúgy, mint bármilyen postai címet megadhat egy eszközbe, mint például a Google map, és megkaphatja a pontos helyet, így egy eszközről, például az ipstack API-ról is kérhet IP-címet, hogy megkapja a helyét.

Ennek azonban vannak bizonyos korlátai. Például nem kapja meg a pontos helyet az IP-címről. Amit megkapja, az az, amit az IP-címet szolgáltató szolgáltató nyújthat. Ez gyakran nem sokkal pontosabb, mint a város vagy az általános környék, bár egyes szolgáltatók több információt szolgáltatnak, mint mások. Ezenkívül, ha a felhasználó VPN-t indít a webhely elérése érdekében, akkor az ilyen keresésből a használt VPN szerver helyét kaphatja meg.

Az ipstack API főbb jellemzői

Az ipstack API fejlesztői úgy döntöttek, hogy amoduláris megközelítés ezzel a termékkel. Különböző modulokból áll, amelyek mindegyike eltérő típusú információt szolgáltat vissza. Vannak például időzóna, pénznem vagy akár biztonság moduljai. A megfelelő paraméterek segítségével kiválaszthatja, hogy melyik modult használja a kérés elküldésekor az ipstack API-ra.

Néhány előnye van ennek a megközelítésnek. Először is megkönnyíti a válasz kezelését. Ha csak egy típusú kérés küldte vissza az összes rendelkezésre álló adatot egy IP-címről, akkor a webhely kódjának a teljes választ kell elemeznie, amellyel bármilyen információt behozhat. A kisebb kérések - kisebb válaszokkal - küldése javíthatja a teljesítményt.

Nézzük mélyebben az összes rendelkezésre álló lehetőségetmodul, hogyan lehet őket felhívni, és hogyan néz ki tipikus válaszuk. Ez meglehetősen világos áttekintést nyújt Önnek arról, hogy mire számíthat ettől a hatalmas eszköztől.

A helymodul

Az ipstack API legalapvetőbb modulja aHelymeghatározó modul. Visszaadja a lekérdezésben megadott IP-cím fizikai helyének részleteit. Megkapja az IP-cím országát, annak fő vagy hivatalos nyelvét, valamint egy hangulatjelet az ország zászlójához, amelyet felhasználhat a felhasználói élmény személyre szabásához.

Íme egy tipikus válasz az ipstack API-val kapcsolatos lekérdezésre. Az első részt minden lekérdezés tartalmazza, függetlenül a kért modultól:

ip: "142.243.254.224"
hostname: "142.243.254.224"
type: "ipv4"
continent_code: "NA"
continent_name: "North America"
country_code: "CA"
country_name: "Canada"
region_code: "QC"
region_name: "Quebec"
city: "Montreal"
zip: H2V
latitude: 45.5178
longitude: -73.6046

A visszaadott attribútumok többsége magától értetődő, de ha Önnek további segítségre van szüksége, részletes dokumentációval rendelkezik az ipstack webhelyén.

De mivel a helymeghatározó modulról beszélünk, nézzük meg, hogy milyen extra információk származnak vissza, amikor azt használjuk:

location: Object {}
geoname_id: null
capital: "Ottawa"
languages: Object {}
code: "en"
name: "English"
native: ""English""
code: "fr"
name: "French"
native: ""Français""
country_flag: "http://assets.ipstack.com/flags/ca.svg"
country_flag_emoji: "??"
country_flag_emoji_unicode: "U+1F1E8 U+1F1E6"
calling_code: "1"
is_eu: false

Mint láthatja, a kapott kiegészítő információk a következőkelsősorban az ország fővárosa, az adott helyen használt különböző nyelvek, link az ország zászlójának képéhez és az ország hangulatjelének unikódja.

A pénznem modul

A Pénznem modul tovább használhatójavítsa webhelyének felhasználói élményét. Ez különösen igaz egy bevásárló webhelyre, mivel lehetővé teszi az árak megjelenítését a felhasználó pénznemében. A megadott részletek tartalmazzák a helyi pénznem nevét és szimbólumát, valamint annak többes nevét. Az API természetesen nem konvertálja az árakat a megfelelő pénznemre, de lehetővé teszi egy másik API használatát, hogy átalakítsa árait a látogatók számára megfelelő pénznemre. Nézzük meg, hogy néz ki a pénznemmodul kimenete:

currency: Object{}
code: "CAD"
name: "Canadian Dollar"
plural: "Canadian dollars"
symbol: "CA$"
symbol_native: "$"

A biztonsági modul

Valószínűleg nem olyan népszerű vagy hasznos, mint az előzőmodulok, a biztonsági modul továbbra is érdekes. Visszaad információkat a bejövő kapcsolat több biztonsági szempontjáról. Például meg fogja mondani, hogy a webhelyhez proxyn keresztül van-e hozzáférés, és ha igen, a proxy típusa, vagy a kérés a tor-hálózaton keresztül érkezett-e. Azt is megmondhatja, hogy a kérelem egy bejárótól származik, nem pedig a tényleges felhasználótól. Az ilyen típusú információk felhasználhatók a kaparás megakadályozására. A modul visszaadja a biztosított IP-címhez kapcsolódó fenyegetési szintet is, lehetővé téve a durva védelmet a rosszindulatú kérelmekkel szemben. Íme egy pillantás a biztonsági modul tipikus válaszára:

security: Object{}
is_proxy: false
proxy_type: null
is_crawler: false
crawler_name: null
crawler_type: null
is_tor: false
threat_level: "low"
threat_types: null

Az időzóna modul

Egy másik modul, amely hasznos lehetszemélyre szabhatja webhelye látogatói felhasználói élményét az Időzóna modulban. Ez visszatér néhány további részletet a webhely látogatóiról - gondoltam rá -. Az egyik hely, ahol használhatná ezt a funkciót az időérzékeny információkkal foglalkozó webhelyeken. Ez lehetővé teszi, hogy a felhasználó helyétől függően a megfelelő időt jelenítse meg.

A modul olyan információkat szolgáltat, mint a GMT eltolás, az aktuális felhasználói idő, az időkód és az időzóna helye, amint az a mintaválaszból látható:

time_zone: Object{}
id: "America/Montreal"
current_time: "2019-07-09T12:39:22-04:00"
gmt_offset: -14400
code: "EDT"
is_daylight_saving: true

A csatlakozási modul

Utolsó, de nem utolsósorban a csatlakozási modul. Ez meglehetősen egyszerű. Csak a forrás IP-címhez rendelt autonóm rendszer (AS) számot és az ISP nevét adja vissza. Nos, valójában inkább az AS tulajdonosának neve, hanem az ISP. Egyes szervezetek regisztrálják saját autonóm rendszerüket, amint az az alábbi példában található:

connection: Object{}
asn: 395399
isp: "City of Montreal"

Ez talán a legkevésbé hasznos az összes modul közül, de néhányuk hasznos lesz különféle analitikai célokra.

Munka az ipstack API-val

Megvizsgáltuk, hogy mi lehet az információvissza az ipstack API, most itt az ideje, hogy nézd meg, hogyan hívják. Az ipstack API három különféle típusú lekérdezést kínál, amelyek mindegyike különböző paraméterekkel rendelkezik. Itt van a normál keresés, a tömeges keresés és a kérő keresés. Lássuk, hogy különböznek egymástól. Ez egy jó tulajdonság, mivel például a tömeges kérés lehetővé teszi több kérelem egyesítését egybe, ezáltal csökkentve a teljes többletet és lehetővé téve a gyorsabb eredményeket. Nézzük mélyebben az egyes típusú kéréseket.

Normál keresés

Ahogy talán már kitalálta, a szokásos keresés aza legalapvetőbb. Visszaadja az egyetlen IP-cím részleteit, amelyeket megadott, amikor meghívja az ipstack API-t. Ez nagyon egyszerűen használható, és IPv4 vagy IPv6 címekkel is használható. A dolgok még egyszerűbbé tétele érdekében a termék dokumentációja tartalmazza a szabványkérés mintájának kódját mind a PHP (cURL), mind a JavaScript (Jquery.ajax) formátumban. Ha webhelyét ezek egyikének felhasználásával készítik, akkor az API használata valóban nem bátor. Íme egy példa egy tipikus API-hívásra, egyszerű HTML kód használatával:

https://api.ipstack.com/123.123.123.123?access_key=YOUR_ACCESS_KEY

Ebben a példában YOUR_ACCESS_KEY helyébe a tényleges hozzáférési kulcs lépakkor, amikor feliratkozott a szolgáltatásra. A példa helyett a tényleges IP-címet is megadná, amelyről információt szeretne.

A szokásos keresés eredménye az összeset tartalmazzamodulok alapértelmezés szerint, de az extra paraméterek lehetővé teszik a kérés pontos igényekhez történő igazítását. A rendelkezésre álló paraméterek minden részletét világosan ismerteti a termékdokumentáció. Hasonlóképpen, az alapértelmezett válasz egy JSON objektum, de a paraméterek megváltoztathatják azt XML formátumra.

Tömeges és kérő keresések

A Tömeges keresés lehetővé teszi az adatok kérését a következővel szembentöbb IP-cím egyetlen kérésen belül. Csakúgy, mint a szokásos keresés, az IPv4 és az IPv6 címekről is adatokat kaphat. A kért címeket akár egyetlen kérésben is keverheti. A kérelem formátuma megegyezik a Normál keresés formátumával, azzal a különbséggel, hogy vesszővel elválasztott több IP-címet ad meg.

https://api.ipstack.com/123.123.123.123,124.124.124.124,125.125.125.125,
126.126.126.126?access_key=YOUR_ACCESS_KEY

Az ipstack által kínált utolsó típusú kérésAz API a Requester Lookup. Visszaadja az arra az IP-címre vonatkozó információkat, ahonnan a kérés származik. Ez egy olyan típusú kérés, amelyet futtatott az ügyféloldali szkript beküldésével. A Requester Lookup hívás kezdeményezéséhez mindössze egy IP-cím helyett a „check” kulcsszót kell használnia. A többi rendelkezésre álló kérési paraméter megegyezik a többi kéréstípusra.

https://api.ipstack.com/check?access_key=YOUR_ACCESS_KEY

Hogyan teljesíti az ipstack API?

Az ipstack API több mint valószínű, hogy valamiintegrálódna egy valós idejű webhelybe. Például érdemes különféle tartalmakat kiszolgálni az ügyfél tartózkodási helye alapján. Ennek megvalósításához szüksége van az API-ra, hogy villámgyorsan teljesítsen. Az API-válasz bármilyen késése az oldal megjelenítésének késleltetésévé válik az ügyfél számára - ez valószínűleg inkább elkerülhető. Ugyanez igaz a helymeghatározási adatokra is. Ezért a használt eszköz válaszideje rendkívül fontos. Noha a földrajzi helymeghatározási API nyújthat egy nagyon szükséges funkciót, annak elmulasztása katasztrofális következményekkel járhat.

Ezen okok miatt ki kell választania egy API-tjó válaszidő. A különféle forgatókönyvek tesztelésének sok nehéz munkáját elvégeztük, és teszteket végeztünk egyetlen vagy több IP-címmel, mások több opcionális paraméterrel, mások kevesebbtel. Nagyon elégedettek voltunk az eredményekkel, és meglehetősen következetes válaszidőt kapunk, kb. 100 ms, kéréstől függetlenül. A válasz is időben következetes volt, és nem volt látható „csúcsidő”, amikor a teljesítmény szenvedni fog, és hasonló volt, függetlenül attól, hogy honnan indítottuk a kéréseket. Úgy tűnik, hogy az ipstack szerverek úgy vannak felépítve, hogy kezeljék a kapott terhelést. Összességében úgy tűnik, hogy az ipstack API használata a felhasználó szempontjából alig gyakorolt ​​hatást a webhely válaszaira.

Termékdokumentáció és támogatás

Gyakran azt mondják, hogy egy termék csak annyira jómint annak dokumentációja. Ha ez igaz, az ipstack API-nak nincs semmi félelme, mivel a dokumentációt könnyű megtalálni, használni és megérteni. A dokumentáció minősége azt is megmutatja, mennyire érdekli a szoftverkiadó felhasználóit. Itt ismét nincs aggódni.

Az egyik legjobb dolog ebben a termékbenfurcsa módon a dokumentáció mennyire kevés. Minden megtalálható egyetlen, jól elrendezett weboldalon, ahol könnyen megtalálhatja az összes, amire szüksége van. És a dolgok még könnyebbé tétele érdekében a menüablak megkönnyíti a hozzáférést az adott szekciókhoz. A dokumentáció mindent tartalmaz, a különféle típusú kérelmek felhasználásától a válasz testreszabásáig.

Nagyon valószínűtlen esetben, ha nem tennéa dokumentációban megtalálhatja, amire szüksége van, a támogatás szintén rendelkezésre áll. A technikai támogatás kezdeti elérése eltarthat egy ideig, de ha egyszer megteszik, elég gyorsan reagálnak.

Árazás

Számos árképzési terv áll rendelkezésre aipstack API. A legalacsonyabb szinten ott a szabad terv. Amint a neve is sugallja, ez ingyenes. Ez szintén kissé korlátozott. Először csak havonta 10 000 lekérdezést futtathat. Ez csak a Helymodult tartalmazza, és a támogatáshoz való hozzáférés korlátozott. Ez azonban nagyszerű módszer a termék tesztelésére és annak integrálására a környezetbe.

A következő szint az alapterv. Ez az ár 9,99 USD / hónap vagy 95,90 USD / év (20% -os engedmény), és a kérelmek korlátja 50 000 / hó értékre növekszik. Ezenkívül lehetővé teszi a Pénznem, Időzóna és Kapcsolat modulok használatát. Ezenkívül a terv a fokozott támogatást, valamint az SSL titkosítás használatával fokozott biztonságot is tartalmaz.

A legnépszerűbb terv a szakmai tervamely 49,99 USD / hónap vagy 479,90 USD / év áron értékesít. Mindent megad, amely szerepel az alaptervben, de a havi kérelmek korlátját 500 000-re emeli, és magában foglalja a tömeges kérések teljesítésének lehetőségét is.

Tetején a professzionális plusz terv. Havi 99,99 dollár vagy 959,90 dollár / év. Ez megegyezik a szakmai tervvel, de havonta legfeljebb 2 millió kérést tesz lehetővé, és ez az egyetlen terv, amely tartalmazza a biztonsági modult.

Ha ez nem elég, akkor van egytestreszabható vállalati terv, amelyet az ipstackkel való kapcsolatfelvétel útján lehet megszervezni. Tartalmazhat annyi havi kérelmet, amennyire szüksége lehet, valamint különféle egyedi megoldásokat, az ügyfél egyedi igényei alapján.

Következtetésképpen

Az ipstack API kiváló termék, amely képeslehetővé teszi, hogy megragadjon annyi adatot, amelyet gyorsan és egyszerűen megkaphat egy IP-címről. Csodálatos válaszidővel, kiváló dokumentációval és jó támogatással rendelkezik, amelyek együttesen nagyszerű ár-érték arányt eredményeznek. Ugyanakkor az a tény, hogy több internetes óriás is használja, valószínűleg jó bizonyíték a termék értékére.

Ez határozottan egy termék, amelyet ajánlomarra törekszik, hogy kihasználja a webhely látogatói IP-címére összegyűjthető adatokat. És mivel rendelkezésre áll egy ingyenes - bár korlátozott - terv, nincs oka annak, hogy nem kellene legalább kipróbálnia, hogy megnézze, mit tehet az Ön számára.