Besplatna geolokacija posjetitelja web stranice s ipstack API-om (pregled)

Od svog skromnog početka prije više od 25 godina, svjetski se web razvijao na način koji ni najbolji analitičari nisu mogli predvidjeti. Oblikovanje onoga što je u biti bilo alat za pomoć istraživačima u razmjeni informacija, razvilo se u potrošački alat bez kojeg mnogi od nas jednostavno ne mogu živjeti. Promijenila je mnoge aspekte našeg života i na to smo se oslonili, možda i više nego što bi trebali. To je postalo toliko uobičajeno da mijenja maloprodajnu industriju. Iz velikih lanaca trgovina ciglama i minobacača, najprodavaniji su sada internetska tržišta.

Da bi bili uspješni, mrežni trgovci ne moraju biti prisutni samo na webu, već moraju u potpunosti iskoristiti i njegove značajke. Jedna takva značajka je i geolokacija. Ova tehnologija može dopustiti prodavaču da zna lokaciju posjetitelja svoje web stranice, što je korisna značajka za prikazivanje procijenjenih troškova isporuke ili predstavljanje specifičnih ponuda. Jedan od najjednostavnijih načina da iskoristite prednosti geolokacije je korištenje namjenskog API-ja koji se može hraniti s IP adresom i koji će vratiti sve relevantne informacije o toj adresi.

ipstack API jedan je takav proizvod i upravo ćemo otkriti kako to čini svoju magiju i što može učiniti za vas. Pogledat ćemo osnovne funkcionalnosti alata kao i kako ga koristiti. Vidjet ćemo kako se radi, koja je vrsta dokumentacije i podrške na raspolaganju za proizvod te ćemo pogledati njegovu prilično jednostavnu strukturu cijena.

Predstavljamo ipstack

U osnovi je ipstack geolokacijski API koji koristi više međusobno povezanih davatelja internetskih usluga za pružanje točnih geografskih podataka. Nazovite API putem koda svoje web lokacije, a on će vratiti mnoštvo geografskih podataka o korisnicima vaše web lokacije. Dobit ćete, naravno, geografski položaj korisnika (nije li to glavna točka?), Ali to nije sve. Na primjer, alat će vratiti vezu do slike korisničke zastave zemlje ili njegove emojijske verzije. Nadalje, dobit ćete informacije o tome da li korisnik pristupa vašoj web lokaciji putem proxyja. Detaljnije ćemo podrobnije objasniti sve to dok detaljnije proučimo dostupne module.

Projekt, u početku nazvan freegeoip.net, ugledao je svjetlo 2009. godine kao inicijativu otvorenog koda za pomoć programerima. Neprekidnim usavršavanjem na temelju povratnih informacija korisnika, evoluiralo je nekih osam godina kasnije u punopravni proizvod koji gledamo. Za to vrijeme, korisnička baza proizvoda narasla je na preko sto tisuća zadovoljnih kupaca. I nisu samo kupci. Divovi poput Microsofta ili Samsung koriste API. Tako su i Airbnb i HubSpot.

Ipstack API koristi izrazito dinamičnu shemu koja ažurira svoju bazu podataka više puta dnevno osiguravajući integritet vraćenih rezultata. U tu svrhu ipstack se udružio s nekoliko velikih ISP-ova širom svijeta. Alat obavlja svu komunikaciju preko 256-bitnog SSL kriptiranog kanala - pomoću HTTPS - za osiguranje svih prijenosa podataka. Rezultate može vratiti API u bilo XML ili JSON formatu, ovisno o vašim specifičnim potrebama.

Jedan od najboljih dijelova ipstack API-ja je njegova modularnost. Razni dostupni moduli vraćaju sve više podataka o korisnikovoj lokaciji. To čini vrlo fleksibilan alat. Brzina je također jedna od glavnih prednosti proizvoda. Nazovite API s odgovarajućim parametrima i brzo dobijete tražene rezultate. Trenutno ipstack API svakodnevno obrađuje više od dvije milijarde zahtjeva, a još uvijek reagira gotovo odmah. Kroz partnerstvo s različitim davateljima internetskih usluga proizvod može obuhvatiti oko 2 milijuna lokacija i više od dvjesto tisuća gradova širom svijeta. Također podržava i IPv4 i IPv6 adrese.

Kako funkcionira Geolocation

Prije nego što nastavimo dalje, nakratko zastajmo i brzo pogledamo kako izgleda geolokacija. Kao što nagađate iz imena ipstacka, to ima veze s IP adresama. IP adrese mogu se u određenoj mjeri usporediti s poštanskim adresama. Svaki uređaj povezan s Internetom ima jedinstvenu IP adresu. Ali ove IP adrese nisu samo nasumično dodijeljene svakom uređaju. Ima neki smisao u tome. Dio IP adrese identificira pojedinačno spojeni uređaj, a dio identificira mrežu na koju je spojen. I sam mrežni dio je hijerarhijski organiziran, pomalo nalik stablu direktorija računalnih diskova. (Nadam se da će mi inženjeri među našim čitateljima oprostiti ovo previše pojednostavljenja.)

To je slično poštanskoj adresi s brojem ulice, nazivom ulice, gradom i, na kraju, državom. I baš kao što britanska pošta nema pojma gdje se nalazi bilo koja američka adresa, ona će USPS-u poslati poštu u USPS koja će se pobrinuti za usmjeravanje maila na pravo mjesto. I baš kao što biste mogli unijeti gotovo bilo koju poštansku adresu u alat poput Google karte i dobiti točnu odgovarajuće lokacije, možete potražiti alat poput ipstack API-ja s IP adresom da biste dobili njegovu lokaciju.

To ipak ima određena ograničenja. Na primjer, nećete dobiti točnu lokaciju s IP adrese. Dobit ćete sve što pruža pružatelj internetskih usluga koji isporučuje IP adresu. To često nije mnogo preciznije od grada ili općenito susjedstva, iako neki davatelji usluga vraćaju više informacija od drugih. Ako korisnik tuži VPN da pristupi vašoj web lokaciji, ono što biste dobili od takve pretrage je lokacija VPN poslužitelja koji koristi.

Glavne značajke API-ja za ipstack

Programeri ipstack API-a odlučili su koristiti modularni pristup s ovim proizvodom. Sastoji se od različitih modula koji svaki vraćaju različitu vrstu informacija. Na primjer, postoje moduli vremenske zone, valuta ili čak sigurnost. Možete odabrati koji modul koristiti pomoću odgovarajućih parametara prilikom slanja zahtjeva u ipstack API.

Nekoliko je prednosti ovog pristupa. Prvo, olakšava se odgovor. Ako je postojala samo jedna vrsta zahtjeva koji vraća sve dostupne podatke o IP adresi, kôd vaše web stranice morao je procijeniti cijeli odgovor da bi preuzeo sve potrebne informacije. Također, slanje manjih zahtjeva - s manjim brojem odgovora - može poboljšati performanse.

Pogledajmo detaljnije svaki od dostupnih modula, kako ih nazvati i kako izgleda njihov tipičan odgovor. To će vam pružiti prilično jasan pregled onoga što možete očekivati ​​od ovog moćnog alata.

Lokacijski modul

Najosnovniji modul ipstack API-ja je Location Module. Vraća detalje o fizičkoj lokaciji IP adrese navedene u upitu. Dobit ćete zemlju adrese IP-a, njegov glavni ili službeni jezik, kao i emojiju za zastavicu zemlje koji možete koristiti za personaliziranje korisničkog iskustva.

Evo tipičnog odgovora na upit API-ja za ipstack. Prvi dio je uključen u bilo koji upit, neovisno o traženom modulu:

ip: "142.243.254.224" naziv računala: "142.243.254.224" vrsta: "ipv4" continent_code: "NA" continent_name: "Sjeverna Amerika" country_code: "CA" naziv zemlje: "Kanada" region_code: "QC" region_name: "Quebec" grad: "Montreal" zip: H2V. zemljopisna širina: 45.5178. dužina: -73.6046

Većina vraćenih atributa ne objašnjava samo sebe, ali ih imate detaljnu dokumentaciju na web mjestu ipstacka trebate li daljnju pomoć

No, budući da govorimo o lokacijskom modulu, pogledajmo što se dodatne informacije vraćaju kada ga upotrebljavamo:

lokacija: Objekt {} geoname_id: null capital: "Ottawa" jezici: Objekt {} kôd: "en" ime: "Engleski" maternji: "" Engleski "" kôd: "fr" naziv: "Francuski" maternji: "" Français "" country_flag: " http://assets.ipstack.com/flags/ca.svg" country_flag_emoji: "??" country_flag_emoji_unicode: "U + 1F1E8 U + 1F1E6" call_code: "1" is_eu: false

Kao što vidite, dodatne informacije koje dobivate uglavnom su glavni grad države, različiti jezici u uporabi na toj lokaciji, veza do slike zastave zemlje i unicode oznake zemlje emotikona.

Valutni modul

Modul Valuta može se koristiti za daljnje poboljšanje korisničkog iskustva vaše web stranice. To se posebno odnosi na web mjesto za kupovinu jer će vam omogućiti prikazivanje cijena u valuti vašeg korisnika. Navedeni detalji uključuju naziv i simbol lokalne valute kao i množinski naziv. API naravno neće pretvoriti cijene u odgovarajuću valutu, ali će vam omogućiti da pomoću drugog API-ja pretvorite cijene u pravu valutu za svoje posjetitelje. Pogledajmo kako izgleda izlaz iz valutnog modula:

valuta: Objekt {} kôd: "CAD" naziv: "Kanadski dolar" množina: "Kanadski dolari" simbol: "CA $" simbol_nativa: "$"

Sigurnosni modul

Vjerojatno nije toliko popularan ili koristan kao prethodni moduli, sigurnosni modul je i dalje zanimljiv. Vraća podatke o nekoliko sigurnosnih aspekata dolazne veze. Primjerice, reći će vam je li web mjestu dostupno putem proxyja i, ako je to, vrsta proxyja ili je li zahtjev došao preko tor mreže. Također vam može reći da je zahtjev više od alata za indeksiranje, a ne od stvarnog korisnika. Ova vrsta informacija može se upotrijebiti za sprječavanje struganja. Modul također vraća razinu prijetnje povezanu s danom IP adresom, potencijalno omogućavajući grubu zaštitu od zlonamjernih zahtjeva. Evo tipičnog odgovora iz sigurnosnog modula:

sigurnost: Objekt {} is_proxy: lažni proxy_type: null is_crawler: false false crawler_name: null crawler_type: null is_tor: false prijetnja_level: "low" prijetnja_types: null

Modul vremenske zone

Drugi modul koji može biti koristan za personaliziranje korisničkog iskustva posjetitelja vaše web stranice je modul Time Zone. Vraća neke dodatne detalje o - pogodili ste - posjetiteljima vaše web stranice. Jedno od mjesta gdje biste mogli koristiti takvu značajku na web lokacijama koje se bave vremenski osjetljivim informacijama. Omogućuje vam prikazivanje ispravnog vremena na temelju lokacije vaših korisnika.

Modul pruža informacije poput pomaka GMT, trenutnog vremena korisnika, vremenskog koda i lokacije vremenske zone kao što možete vidjeti iz ovog uzorka odgovora:

time_zone: Objekt {} id: "Amerika / Montreal" current_time: "2019-07-09T12: 39: 22-04: 00" gmt_offset: -14400 kod: "EDT" is_daylight_saving: true

Priključni modul

Posljednje, ali ne najmanje bitno, je modul za povezivanje. Ova je prilično jednostavna. Sve što vraća je broj autonomnog sustava (AS) povezan s izvornom IP adresom kao i imenom ISP-a. Pa, zapravo je ime vlasnika AS-a, a ne davatelja internetskih usluga. Neke organizacije registriraju vlastiti autonomni sustav, kao što je to slučaj u primjeru u nastavku:

veza: Objekt {} asn: 395399 isp: "Grad Montreal"

Ovo je vjerojatno najmanje korisno od svih modula, ali neki će ga smatrati korisnim u razne analitičke svrhe.

Rad s API-jem za ipstack

Pogledali smo koje podatke može vratiti API ipstack, sada je vrijeme da se pogleda kako se zovu. API ipstack nudi tri različite vrste upita, svaki s različitim parametrima. Postoje Standardni Lookup, Bulk Lookup i Potraga Potražitelja. Pogledajmo kako se razlikuju. Ovo je lijepa značajka jer, na primjer, skupni zahtjev omogućuje kombiniranje nekoliko zahtjeva u jedan, čime se smanjuje ukupni trošak i omogućuju brži rezultati. Pogledajmo dublje svaku vrstu zahtjeva.

Standardna potraga

Kao što ste možda i nagađali, Standardna pretraga je najosnovnija. Vraća detalje o jednoj IP adresi koju navedete kada zovete ipstack API. Prilično je jednostavan za korištenje i radit će s bilo IPv4 ili IPv6 adresama. Da stvar bude još lakša, dokumentacija proizvoda sadrži uzorak koda za standardni zahtjev i u PHP-u (cURL) i u JavaScript-u (Jquery.ajax). Ako je vaša web stranica napravljena pomoću bilo kojeg od sljedećeg, korištenje API-ja doista nije jednostavno. Evo primjera uobičajenog poziva u API pomoću jednostavnog HTML koda:

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

U ovom primjeru YOUR_ACCESS_KEY zamijenio bi stvarnim pristupnim ključem koji ste dobili kad ste se prijavili za uslugu. U ovaj ćete primjer uključiti i stvarnu IP adresu o kojoj želite informacije, a ne lutku.

Rezultati za standardni pregled uključuju sve module prema zadanim postavkama, ali dodatni parametri omogućuju vam prilagođavanje zahtjeva točno vašim potrebama. Svi detalji o dostupnim parametrima jasno su obrazloženi u dokumentaciji proizvoda. Isto tako, zadani odgovor je JSON objekt, ali parametri ga mogu promijeniti u XML format.

Skupni i potražni zahtjevi

Skupni pregled omogućuje vam da u jednom zahtjevu zatražite podatke protiv više IP adresa. Baš poput Standardnog pretraživanja, možete dobiti podatke i na IPv4 i IPv6 adresama. Možete čak kombinirati obje vrste adresa u jednom zahtjevu. Format zahtjeva isti je kao u Standardnom pretraživanju, osim što odredite više IP adresa odvojenih zarezima.

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

Posljednja vrsta zahtjeva koju nudi ipstack API je Potraga zahtjeva. Vratit će podatke o IP adresi s koje dolazi zahtjev. To je vrsta zahtjeva koji biste pokrenuli pomoću skripte na strani klijenta. Da biste uputili poziv za traženje zahtjeva, sve što trebate je koristiti ključnu riječ "ček" umjesto IP adrese. Ostali dostupni parametri zahtjeva isti su kao i za ostale vrste zahtjeva.

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

Kako funkcionira ipstack API?

API ipstack više je nego vjerovatno nešto što biste integrirali u web mjesto u stvarnom vremenu. Na primjer, možda želite poslužiti različit sadržaj na temelju lokacije klijenta. Da biste to postigli, treba vam API za brzu izvedbu. Svako kašnjenje u odgovoru API-ja pretvorit će se u kašnjenja na prikazivanju stranice klijentu, što biste više vjerojatno vjerovali. Isto je bez obzira za što koristite podatke o lokaciji. To je razlog zašto je vrijeme odziva alata koji koristite od najveće važnosti. Iako API za geolokaciju može pružiti prijeko potrebnu funkcionalnost, njegovo neuspjeh u izvođenju može imati katastrofalan utjecaj.

Iz tih razloga trebate odabrati API s dobrim vremenom odziva. Učinili smo velik dio napornog testiranja različitih scenarija i izveli testove s jednom ili više IP adresa, neki s više opcionalnih parametara, neki s manje. Bili smo prilično zadovoljni rezultatima i dobili smo prilično dosljedno vrijeme odziva od oko 100 ms, bez obzira na zahtjev. Odgovor je također bio dosljedan tijekom vremena, bez očiglednih sati „žurbe“ kada bi izvedba patila, a bilo je i slično bez obzira odakle smo pokrenuli zahtjeve. Čini se kao da su ipstack serveri izgrađeni za podnošenje opterećenja koje dobivaju. Sve u svemu, čini se da je upotreba API-ja ipstack jedva išta utjecala na odgovor web stranice promatran iz perspektive korisnika.

Dokumentacija proizvoda i podrška

Često se kaže da je proizvod dobar samo koliko i njegova dokumentacija. Ako je to istina, ipstack API se nema čega bojati dokumentacija lako je pronaći, koristiti i razumjeti. Kvaliteta dokumentacije također mjeri mjerilo koliko izdavača softvera brine o svojim korisnicima. Ovdje se opet ne treba brinuti.

Jedna od najboljih stvari u vezi s tim dokumentaciju proizvoda je, začudo, koliko ih je malo. Sve se uklapa u jednu, dobro uređenu web stranicu, na kojoj ćete lako pronaći sve što vam treba. Da bi stvar bila još lakša, okno s izbornikom olakšava pristup bilo kojem dijelu odjeljku. Dokumentacija pokriva sve, od korištenja različitih vrsta zahtjeva, do prilagođavanja odgovora.

U vrlo malo vjerovatnom slučaju kada u dokumentaciji ne biste pronašli ono što vam treba, podrška je također dostupna. Može potrajati neko vrijeme dok prvo ne stignete do tehničke podrške, ali nakon što to učinite, oni reagiraju prilično brzo.

cijena

Nekoliko planovi cijena dostupni su za ipstack API. Na najnižoj razini, postoji besplatni plan. Kao što mu ime govori, ovaj je besplatan. Također je pomalo ograničen. Za početak možete pokrenuti do 10 000 upita mjesečno. Također uključuje samo Lokacijski modul i pristup podršci je ograničen. Međutim, može biti izvrstan način testiranja proizvoda i vidljivosti kako se on može integrirati u vaše okruženje.

Sljedeća je razina osnovni plan. Ovaj se prodaje za 9,99 USD mjesečno ili 95,90 USD godišnje (20% popusta) i donosi ograničenje zahtjeva do 50 000 mjesečno. Također vam omogućuje korištenje modula Valuta, Vremenska zona i Spajanje. Nadalje, poboljšana podrška je također uključena u plan, kao i poboljšana sigurnost korištenjem SSL enkripcije.

Najpopularniji plan je onaj profesionalni koji se prodaje za 49,99 USD mjesečno ili 479,90 USD godišnje. Omogućuje vam sve što je uključeno u osnovni plan, ali mjesečno povećava ograničenje zahtjeva na 500 000, a također uključuje i mogućnost skupnih zahtjeva.

Na vrhu je profesionalni plus plan. Košta 99,99 dolara mjesečno ili 959,90 dolara godišnje. Identičan je profesionalnom planu, ali dopušta do 2 milijuna zahtjeva mjesečno i jedini je plan da uključuje sigurnosni modul.

Ako to nije dovoljno, postoji i prilagodljivi plan poduzeća koji se može organizirati kontaktiranjem ipstacka. Može uključivati ​​onoliko mjesečnih zahtjeva koliko vam je potrebno, kao i razna prilagođena rješenja koja se temelje na specifičnim potrebama klijenta.

U zaključku

ipstack API je izvrstan proizvod koji će vam omogućiti da brzo i jednostavno prikupite što više podataka koje možete dobiti s IP adrese. Ima nevjerojatno vrijeme odziva, odličnu dokumentaciju i dobru podršku koji kombiniraju kako bi ovo postiglo veliku vrijednost za novac. Također, sama činjenica da ga koriste neki internetski divovi vjerojatno je dobar dokaz vrijednosti proizvoda.

Ovo je definitivno proizvod koji bih vam preporučio ako tražite iskorištavanje podataka koji se mogu prikupiti za IP adresu posjetitelja vaše web lokacije. A budući da je dostupan besplatan - iako ograničen - plan, nema razloga zašto ga barem ne biste pokušavali vidjeti sami što može učiniti za vas.