Darmowa geolokalizacja odwiedzających witrynę za pomocą ipstack API (Recenzja)

Od swoich skromnych początków ponad 25 lat temu światowa sieć ewoluowała w sposób, którego nawet najlepsi analitycy nie byliby w stanie przewidzieć. Z tego, co zasadniczo było narzędziem pomagającym naukowcom w dzieleniu się informacjami, przekształciło się w narzędzie konsumenckie, bez którego wielu z nas po prostu nie może żyć. Zmienił wiele aspektów naszego życia i zaczęliśmy na nim polegać, być może bardziej niż powinniśmy. Stało się tak powszechne, że zmienia branżę retail. Od dużych sieci sklepów stacjonarnych, najlepsi detaliści są teraz platformami internetowymi.

Aby odnieść sukces, sprzedawcy internetowi muszą nie tylko być obecni w sieci, ale także w pełni wykorzystywać jej funkcje. Jedną z takich funkcji jest geolokalizacja. Ta technologia może umożliwić sprzedawcy detalicznemu poznanie lokalizacji odwiedzającego jego witrynę, co jest przydatną funkcją, która pozwala mu wyświetlać szacunkowe koszty wysyłki lub przedstawiać oferty specyficzne dla lokalizacji. Jednym z najłatwiejszych sposobów czerpania korzyści z geolokalizacji jest użycie dedykowanego interfejsu API, który może być zasilany adresem IP i który zwróci wszelkie istotne informacje o tym adresie.

ten ipstack API jest jednym z takich produktów i wkrótce odkryjemy, jak działa magicznie i co może dla Ciebie zrobić. Przyjrzymy się podstawowej funkcjonalności narzędzia oraz sposobom korzystania z niego. Zobaczymy, jak działa, jaki rodzaj dokumentacji i wsparcia jest dostępny dla produktu i przyjrzymy się jego dość prostej strukturze cenowej.

Przedstawiamy ipstack

U podstaw ipstack jest API geolokalizacji, które wykorzystuje wielu połączonych ze sobą dostawców usług internetowych w celu dostarczania dokładnych danych geograficznych. Wywołujesz API z kodu swojej witryny, a on zwróci mnóstwo danych geograficznych o użytkownikach Twojej witryny. Otrzymasz oczywiście lokalizację geograficzną użytkownika (czy nie o to chodzi?), ale to nie wszystko. Na przykład narzędzie zwróci link do obrazu flagi kraju użytkownika lub jej wersji emoji. Ponadto otrzymasz informacje o tym, czy użytkownik uzyskuje dostęp do Twojej witryny za pośrednictwem serwera proxy. Omówimy to wszystko dokładniej, gdy przyjrzymy się dokładniej dostępnym modułom.

Projekt, początkowo nazywany freegeoip.net, ujrzał światło dzienne w 2009 roku jako inicjatywa open source mająca na celu pomoc programistom. Dzięki ciągłemu doskonaleniu opartemu na opiniach użytkowników, około osiem lat później ewoluował w pełnoprawny produkt, na który patrzymy. W tym czasie baza użytkowników produktu rozrosła się do ponad stu tysięcy zadowolonych klientów. I to nie są zwykli klienci. Giganci tacy jak Microsoft czy Samsung korzystają z API. Podobnie Airbnb i HubSpot.

API ipstack wykorzystuje bardzo dynamiczny schemat, który aktualizuje swoją bazę danych wiele razy dziennie, zapewniając integralność zwracanych wyników. W tym celu ipstack nawiązał współpracę z kilkoma dużymi dostawcami usług internetowych na całym świecie. Narzędzie wykonuje całą komunikację za pośrednictwem 256-bitowego kanału szyfrowanego SSL — przy użyciu protokołu HTTPS — w celu zabezpieczenia wszystkich transferów danych. Wyniki mogą być zwracane przez interfejs API w formacie XML lub JSON, w zależności od konkretnych potrzeb.

Jedną z najlepszych części ipstack API jest jego modułowość. Różne dostępne moduły zwracają coraz więcej danych o lokalizacji użytkownika. To sprawia, że ​​jest to bardzo elastyczne narzędzie. Szybkość jest również jedną z mocnych stron produktu. Wywołujesz API z odpowiednim parametrem (parametrami) i bardzo szybko otrzymujesz żądane wyniki. Obecnie ipstack API obsługuje ponad dwa miliardy żądań dziennie i nadal odpowiada niemal natychmiast. Dzięki partnerstwu z różnymi dostawcami usług internetowych produkt może obejmować około 2 miliony lokalizacji i ponad dwieście tysięcy miast na całym świecie. Obsługuje również adresy IPv4 i IPv6.

Jak działa geolokalizacja

Zanim przejdziemy dalej, zatrzymajmy się na chwilę i przyjrzyjmy się, jak wygląda geolokalizacja. Jak można się domyślić po nazwie ipstack, ma to związek z adresami IP. Adresy IP można porównać – do pewnego stopnia – z adresami pocztowymi. Każde urządzenie podłączone do Internetu ma unikalny adres IP. Ale te adresy IP nie są losowo przypisywane do każdego urządzenia. Jest w tym jakiś sens. Część adresu IP identyfikuje indywidualne podłączone urządzenie, a część identyfikuje sieć, do której jest podłączone. A sama część sieciowa jest zorganizowana hierarchicznie, podobnie jak drzewo katalogów dysku komputera. (Mam nadzieję, że inżynierowie wśród naszych czytelników wybaczą mi to uproszczenie.)

Jest to podobne do adresu pocztowego z numerem ulicy, nazwą ulicy, miastem i ewentualnie krajem. I tak jak brytyjska poczta nie ma pojęcia, gdzie znajduje się jakikolwiek adres w USA, wysyła pocztę kierowaną do USA do USPS, która zajmie się skierowaniem poczty we właściwe miejsce. I tak jak można wpisać dowolny adres pocztowy w narzędziu takim jak mapa Google i uzyskać dokładny odpowiednią lokalizację, możesz wysłać zapytanie do narzędzia, takiego jak API ipstack, za pomocą adresu IP, aby uzyskać jego lokalizację.

Ma to jednak pewne ograniczenia. Na przykład nie uzyskasz dokładnej lokalizacji z adresu IP. Otrzymasz wszystko, co może zapewnić dostawca usług internetowych dostarczający adres IP. Często nie jest to dużo dokładniejsze niż w przypadku miasta lub okolicy, chociaż niektórzy dostawcy zwracają więcej informacji niż inni. Ponadto, jeśli użytkownik pozywa VPN, aby uzyskać dostęp do Twojej witryny, to, co otrzymasz z takiego wyszukiwania, to lokalizacja serwera VPN, z którego korzysta.

Główne cechy API ipstack

Twórcy ipstack API zdecydowali się zastosować w tym produkcie podejście modułowe. Składa się z różnych modułów, z których każdy zwraca inny rodzaj informacji. Istnieją na przykład moduły strefy czasowej, waluty, a nawet zabezpieczeń. Wybierasz, jakiego modułu chcesz użyć, używając odpowiednich parametrów podczas wysyłania żądania do ipstack API.

Takie podejście ma kilka zalet. Po pierwsze, ułatwia obsługę odpowiedzi. Gdyby istniał tylko jeden typ żądania zwracający wszystkie dostępne dane o adresie IP, kod Twojej witryny musiałby przeanalizować całą odpowiedź, aby pobrać potrzebne informacje. Ponadto wysyłanie mniejszych żądań — z mniejszymi odpowiedziami — może poprawić wydajność.

Przyjrzyjmy się bliżej każdemu z dostępnych modułów, jak je wywoływać i jak wygląda ich typowa odpowiedź. To da ci dość jasny obraz tego, czego możesz oczekiwać od tego potężnego narzędzia.

Moduł lokalizacji

Najbardziej podstawowym modułem ipstack API jest moduł lokalizacji. Zwraca szczegóły dotyczące fizycznej lokalizacji adresu IP podanego w zapytaniu. Otrzymasz kraj adresu IP, jego główny lub oficjalny język, a także emotikon dla flagi kraju, którego możesz użyć do spersonalizowania doświadczenia użytkownika.

Oto typowa odpowiedź na zapytanie do ipstack API. Pierwsza część jest dołączana do dowolnego zapytania, niezależnie od żądanego modułu:

ip: „142.243.254.224” nazwa hosta: „142.243.254.224” typ: „ipv4” kod_kontynentu: "NA" nazwa_kontynentu: "Ameryka Północna" kod_kraju: "CA" nazwa_kraju: "Kanada" kod_regionu: "QC" nazwa_regionu: "Quebec" miasto: "Montreal" zamek błyskawiczny: H2V. szerokość geograficzna: 45,5178. długość geograficzna: -73,6046

Większość zwracanych atrybutów nie wymaga wyjaśnień, ale masz szczegółowa dokumentacja na stronie ipstack jeśli potrzebujesz dalszej pomocy.

Ale skoro mówimy o module lokalizacji, przyjrzyjmy się, jakie dodatkowe informacje są zwracane podczas jego używania:

location: Object {} geoname_id: null Capital: "Ottawa" Języki: Object {} code: "en" name: "Angielski" rodzimy: ""Angielski"" code: "fr" Name: "Francuskim" rodzimym: ""Français "" flaga państwa: " http://assets.ipstack.com/flags/ca.svg" country_flag_emoji: "???" country_flag_emoji_unicode: "U+1F1E8 U+1F1E6" call_code: "1" is_eu: false

Jak widać, dodatkowe informacje, które otrzymujesz, to głównie stolica kraju, różne języki w użyciu w tej lokalizacji, link do obrazu flagi kraju i kodu Unicode kraju emoji.

Moduł walutowy

Moduł Waluta może być wykorzystany do dalszej poprawy komfortu korzystania z witryny. Dotyczy to w szczególności witryny zakupów, ponieważ umożliwia wyświetlanie cen w walucie użytkownika. Podane informacje obejmują nazwę i symbol waluty lokalnej, a także jej nazwę w liczbie mnogiej. Interfejs API oczywiście nie przeliczy cen na właściwą walutę, ale pozwoli Ci użyć innego interfejsu API do przeliczenia cen na odpowiednią walutę dla odwiedzających. Przyjrzyjmy się, jak wygląda wyjście z modułu walutowego:

waluta: Kod obiektu{}: „CAD” nazwa: „Dolar kanadyjski” liczba mnoga: „Dolary kanadyjskie” symbol: „CA$” symbol_native: „$”

Moduł bezpieczeństwa

Prawdopodobnie nie tak popularny – lub użyteczny – jak poprzednie moduły, moduł bezpieczeństwa jest nadal interesujący. Zwraca informacje o kilku aspektach bezpieczeństwa przychodzącego połączenia. Na przykład poinformuje Cię, czy dostęp do witryny odbywa się za pośrednictwem serwera proxy, a jeśli tak, typu serwera proxy lub czy żądanie przyszło przez sieć tor. Może również informować, że żądanie pochodzi od robota, a nie od rzeczywistego użytkownika. Tego typu informacje można wykorzystać do zapobiegania skrobaniu. Moduł zwraca również poziom zagrożenia związany z podanym adresem IP, potencjalnie umożliwiając surową ochronę przed złośliwymi żądaniami. Oto typowa odpowiedź modułu bezpieczeństwa:

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

Moduł strefy czasowej

Kolejnym modułem, który może się przydać do personalizacji doświadczeń użytkowników Twojej witryny, jest moduł Strefa czasowa. Zwraca dodatkowe informacje na temat — zgadłeś — odwiedzających witrynę. Jedno z miejsc, w których można skorzystać z takiej funkcji w witrynach zajmujących się informacjami wrażliwymi na czas. Pozwala wyświetlać prawidłowy czas na podstawie lokalizacji użytkowników.

Moduł dostarcza informacje, takie jak przesunięcie GMT, aktualny czas użytkownika, kod czasowy i lokalizacja strefy czasowej, jak widać w tej przykładowej odpowiedzi:

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

Moduł połączeniowy

Ostatni, ale nie mniej ważny jest moduł połączeniowy. Ten jest dość uproszczony. Zwraca tylko numer systemu autonomicznego (AS) powiązany ze źródłowym adresem IP, a także nazwą dostawcy usług internetowych. Cóż, to właściwie nazwa właściciela AS, a nie ISP. Niektóre organizacje rejestrują swój własny system autonomiczny, tak jak w poniższym przykładzie:

połączenie: Object{} asn: 395399 isp: "Miasto Montreal"

Jest to prawdopodobnie najmniej przydatny ze wszystkich modułów, ale niektórzy uznają go za przydatny do różnych celów analitycznych.

Praca z API ipstack

Przyjrzeliśmy się, jakie informacje może zwrócić interfejs API ipstack, teraz nadszedł czas, aby przyjrzeć się, jak to się nazywa. API ipstack oferuje trzy różne typy zapytań, z których każdy ma inne parametry. Dostępne jest wyszukiwanie standardowe, wyszukiwanie zbiorcze i wyszukiwanie żądającego. Zobaczmy, jak się różnią. Jest to fajna funkcja, ponieważ na przykład żądanie zbiorcze pozwala połączyć kilka żądań w jedno, zmniejszając w ten sposób całkowity narzut i umożliwiając szybsze wyniki. Przyjrzyjmy się dokładniej każdemu rodzajowi prośby.

Wyszukiwanie standardowe

Jak można się domyślić, wyszukiwanie standardowe jest najbardziej podstawowe. Zwraca szczegóły dotyczące pojedynczego adresu IP, który podajesz podczas wywoływania interfejsu API ipstack. Jest dość prosty w użyciu i będzie działał z adresami IPv4 lub IPv6. Aby jeszcze bardziej ułatwić sprawę, dokumentacja produktu zawiera przykładowy kod dla standardowego żądania zarówno w PHP (cURL), jak i JavaScript (Jquery.ajax). Jeśli Twoja witryna jest zbudowana przy użyciu jednego z tych sposobów, korzystanie z interfejsu API jest naprawdę proste. Oto przykład typowego wywołania API przy użyciu prostego kodu HTML:

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

W tym przykładzie TWÓJ_KLUCZ DOSTĘPOWY zostanie zastąpiony przez rzeczywisty klucz dostępu, który otrzymałeś podczas rejestracji w usłudze. Powinieneś również podać rzeczywisty adres IP, o którym chcesz uzyskać informacje, a nie fałszywy adres w tym przykładzie.

Wyniki standardowego wyszukiwania domyślnie obejmują wszystkie moduły, ale dodatkowe parametry pozwalają dostosować żądanie do własnych potrzeb. Wszystkie szczegóły dotyczące dostępnych parametrów są jasno wyjaśnione w dokumentacji produktu. Podobnie domyślną odpowiedzią jest obiekt JSON, ale parametry mogą zmienić to na format XML.

Wyszukiwania zbiorcze i żądające

Wyszukiwanie zbiorcze umożliwia żądanie danych z wielu adresów IP w ramach jednego żądania. Podobnie jak w przypadku wyszukiwania standardowego, możesz uzyskać dane zarówno z adresów IPv4, jak i IPv6. Możesz nawet mieszać oba typy adresów w jednym żądaniu. Format żądania jest taki sam jak w przypadku wyszukiwania standardowego, z wyjątkiem tego, że określasz wiele adresów IP oddzielonych przecinkami.

https://api.ipstack.com/123.123.123.123,124.124.124.124,125.125.125.125, 126.126.126.126?access_key=TWÓJ_KLUCZ_DOSTĘPU

Ostatnim typem żądania oferowanym przez interfejs API ipstack jest wyszukiwanie żądającego. Zwróci informację o adresie IP, z którego nadchodzi żądanie. Jest to typ żądania, który można uruchomić za pomocą skryptu po stronie klienta. Aby wykonać wywołanie Requester Lookup, wystarczy użyć słowa kluczowego „check” zamiast adresu IP. Pozostałe dostępne parametry żądania są takie same jak w przypadku innych typów żądań.

https://api.ipstack.com/check? access_key=TWÓJ_KLUCZ_DOSTĘPU

Jak działa interfejs API ipstack?

Interfejs API ipstack jest najprawdopodobniej czymś, co można zintegrować z witryną czasu rzeczywistego. Na przykład możesz chcieć wyświetlać różne treści w zależności od lokalizacji klienta. Aby to osiągnąć, potrzebujesz API, które będzie działać niesamowicie szybko. Każde opóźnienie w odpowiedzi API przełoży się na opóźnienia w wyświetlaniu strony Twojemu klientowi, czego najprawdopodobniej chcesz uniknąć. To samo dotyczy bez względu na to, do czego używasz danych o lokalizacji. Właśnie dlatego czas odpowiedzi narzędzia, z którego korzystasz, ma ogromne znaczenie. Chociaż API geolokalizacji może zapewnić bardzo potrzebną funkcjonalność, jego niewykonanie może mieć katastrofalne skutki.

Z tych powodów musisz wybrać interfejs API z dobrym czasem odpowiedzi. Wykonaliśmy dużo ciężkiej pracy polegającej na testowaniu różnych scenariuszy i przeprowadziliśmy testy z jednym lub wieloma adresami IP, niektóre z bardziej opcjonalnymi parametrami, inne z mniejszą liczbą. Byliśmy bardzo zadowoleni z wyników i uzyskaliśmy dość stały czas odpowiedzi wynoszący około 100 ms, niezależnie od żądania. Reakcja była również spójna z biegiem czasu, bez widocznych „godzin szczytu”, kiedy ucierpiałaby wydajność, a także była podobna bez względu na to, skąd wysyłaliśmy żądania. Wygląda na to, że serwery ipstack są zbudowane, aby poradzić sobie z obciążeniem, jakie otrzymują. Ogólnie rzecz biorąc, wygląda na to, że korzystanie z interfejsu API ipstack nie miało prawie żadnego wpływu na reakcję witryny widzianą z perspektywy użytkownika.

Dokumentacja produktu i wsparcie

Często mówi się, że produkt jest tak dobry, jak jego dokumentacja. Jeśli to prawda, ipstack API nie ma się czego obawiać, ponieważ jego dokumentacja jest łatwy do znalezienia, użycia i zrozumienia. Jakość dokumentacji jest również miarą tego, jak bardzo wydawca oprogramowania dba o swoich użytkowników. Tutaj znowu nie ma się czym martwić.

Jedna z najlepszych rzeczy w tym dokumentacja produktu jest, co dziwne, jak mało jest. Wszystko mieści się na jednej, dobrze rozplanowanej stronie internetowej, na której z łatwością znajdziesz wszystko, czego potrzebujesz. Aby było jeszcze łatwiej, panel menu sprawia, że ​​dostęp do dowolnej sekcji jest dziecinnie prosty. Dokumentacja obejmuje wszystko, od używania różnych typów żądań po dostosowywanie odpowiedzi.

W bardzo mało prawdopodobnym przypadku, gdy nie znajdziesz tego, czego potrzebujesz w dokumentacji, dostępne jest również wsparcie. Początkowo kontakt z pomocą techniczną może zająć trochę czasu, ale gdy już to zrobisz, odpowiedzą dość szybko.

cennik

Kilka plany cenowe są dostępne dla API ipstack. Na najniższym poziomie jest darmowy plan. Jak sama nazwa wskazuje, ten jest bezpłatny. Jest też nieco ograniczony. Na początek możesz uruchomić maksymalnie 10 000 zapytań miesięcznie. Obejmuje również tylko moduł lokalizacji, a dostęp do wsparcia jest ograniczony. Może to być jednak świetny sposób na przetestowanie produktu i sprawdzenie, jak może zintegrować się z Twoim środowiskiem.

Następny poziom to plan podstawowy. Ten sprzedaje się za 9,99 USD miesięcznie lub 95,90 USD rocznie (zniżka 20%) i zwiększa limit żądań do 50 000 miesięcznie. Umożliwia również korzystanie z modułów Waluta, Strefa czasowa i Połączenie. Ponadto plan obejmuje również ulepszone wsparcie, a także zwiększone bezpieczeństwo dzięki zastosowaniu szyfrowania SSL.

Najpopularniejszym planem jest plan profesjonalny, który kosztuje 49,99 USD miesięcznie lub 479,90 USD rocznie. Daje Ci wszystko, co jest zawarte w podstawowym planie, ale zwiększa miesięczny limit żądań do 500 000, a także umożliwia wykonywanie żądań zbiorczych.

Na szczycie znajduje się plan Professional Plus. Kosztuje 99,99 USD miesięcznie lub 959,90 USD rocznie. Jest identyczny z planem profesjonalnym, ale umożliwia do 2 milionów żądań miesięcznie i jest jedynym planem, który obejmuje moduł bezpieczeństwa.

Jeśli to nie wystarczy, istnieje również konfigurowalny plan korporacyjny, który można zorganizować, kontaktując się z ipstack. Może zawierać tyle żądań miesięcznych, ile możesz potrzebować, a także różne niestandardowe rozwiązania oparte na konkretnych potrzebach klienta.

Na zakończenie

ten ipstack API to doskonały produkt, który pozwoli Ci szybko i łatwo pobrać jak najwięcej danych z adresu IP. Ma niesamowity czas reakcji, doskonałą dokumentację i dobre wsparcie, co sprawia, że ​​jest to świetny stosunek jakości do ceny. Również sam fakt, że korzysta z niego kilku internetowych gigantów, jest prawdopodobnie dobrym świadectwem wartości produktu.

Jest to zdecydowanie produkt, który polecam, jeśli chcesz wykorzystać dane, które można zebrać dla adresu IP odwiedzającego Twoją witrynę. A ponieważ dostępny jest bezpłatny – choć ograniczony – plan, nie ma powodu, dla którego nie powinieneś przynajmniej spróbować, aby przekonać się, co może dla Ciebie zrobić.