Geolokalisering av gratis besøkende med ipstack API (gjennomgang)

Siden den ydmyke begynnelsen for over 25 år siden,world wide web har utviklet seg på måter som selv de beste analytikere aldri kunne ha forutsagt. Dann det som egentlig var et verktøy for å hjelpe forskere med å dele informasjon, det har utviklet seg til et forbrukerverktøy som mange av oss rett og slett ikke kan leve uten. Det har endret mange aspekter av livene våre, og vi har stole på det, kanskje mer enn vi burde. Det har blitt så vanlig at det endrer detaljhandelen. Fra store kjeder med mur- og mørtelbutikker er de beste forhandlerne nå nettbaserte markedsplasser.

For å få suksess, trenger online forhandlere ikke barefor å være til stede på nettet, men de må også utnytte funksjonene fullt ut. En slik funksjon er geolokalisering. Denne teknologien kan gjøre det mulig for en forhandler å vite plasseringen til besøkende på nettstedet, en nyttig funksjon som lar dem vise estimerte fraktkostnader eller presentere stedsspesifikke tilbud. En av de enkleste måtene å dra nytte av geolokalisering er å bruke en dedikert API som kan mates med en IP-adresse, og som vil returnere all relevant informasjon om den adressen. De ipstack API er et slikt produkt, og vi er i ferd med å oppdagehvordan den gjør sin magi og hva den kan gjøre for deg. Vi tar en titt på verktøyets grunnleggende funksjonalitet, samt hvordan det skal brukes. Vi får se hvordan det fungerer, hvilken type dokumentasjon og support som er tilgjengelig for produktet, og se på den ganske enkle prisstrukturen.

Vi introduserer ipstack

I kjernen er ipstack et geolocation API sombruker flere sammenkoblede internettleverandører for å gi nøyaktige geografiske data. Du kaller API-en fra nettstedets kode, og den vil returnere en mengde geografiske data om nettstedets brukere. Du får selvfølgelig brukerens geografiske beliggenhet (er ikke det hovedpoenget?), Men det er ikke alt. For eksempel vil verktøyet returnere en lenke til et bilde av brukerens landsflagg eller en emoji-versjon av det. Videre vil du få informasjon om brukeren får tilgang til nettstedet ditt via en proxy. Vi vil gå nærmere inn på alt dette når vi ser nærmere på de tilgjengelige modulene.

Prosjektet, opprinnelig kalt freegeoip.netto, så lyset tilbake i 2009 som et open source-initiativ for å hjelpe utviklere. Gjennom kontinuerlig forbedring basert på tilbakemeldinger fra brukere, utviklet det seg åtte år senere til det fullverdige produktet vi ser på. I løpet av denne tiden vokste produktets brukerbase opp til over hundre tusen fornøyde kunder. Og de er ikke bare noen kunder. Giganter som Microsoft eller Samsung bruker API. Det samme er Airbnb og HubSpot.

Ipstack-API-en bruker et svært dynamisk skjemasom oppdaterer databasen flere ganger om dagen, og sikrer integriteten til de returnerte resultatene. For dette formålet har ipstack inngått et samarbeid med flere store Internett-leverandører over hele verden. Verktøyet utfører all kommunikasjon over 256-biters SSL-kryptert kanal - ved hjelp av HTTPS - for å sikre all dataoverføring. Resultatene kan returneres av API i enten XML- eller JSON-format, avhengig av dine spesifikke behov.

En av de beste delene av ipstack API ermodularitet. Ulike tilgjengelige moduler gir stadig mer data om brukerens beliggenhet. Det gir et veldig fleksibelt verktøy. Speed ​​er også en av produktets forte. Du kaller API med passende parameter (er) og får de etterspurte resultatene superraskt. For øyeblikket håndterer ipstack API mer enn to milliarder forespørsler daglig, og det svarer fortsatt nesten umiddelbart. Gjennom et samarbeid med forskjellige Internett-leverandører kan produktet dekke rundt 2 millioner lokasjoner og over to hundre tusen byer over hele verden. Den støtter også både IPv4- og IPv6-adresser.

Slik fungerer geolocation

La oss ta en kort pause før vi går lengerta en rask titt på hvordan geolokalisering ser ut. Som du antar fra ipstacks navn, har det å gjøre med IP-adresser. IP-adresser kan sammenlignes - til en viss grad - med postadresser. Hver Internett-tilkoblet enhet har en unik IP-adresse. Men disse IP-adressene tildeles ikke bare tilfeldig til alle enheter. Det er noe fornuftig i det. En del av en IP-adresse identifiserer den individuelle tilkoblede enheten, og en del av den identifiserer nettverket den er koblet til. Og nettverksdelen i seg selv er hierarkisk organisert, noe som et katalogtre. (Jeg håper ingeniørene blant leserne våre vil tilgi meg for denne overforenklingen.)

Dette ligner på en postadresse med en gatenummer, et gatenavn, en by og til slutt et land. Og akkurat som det britiske innlegget ikke har noen anelse om hvor noen USA-adresse befinner seg, vil den sende USA-bundet post til USPS som vil ta seg av rutingen av posten til riktig sted. Og akkurat som om du kan oppgi omtrent hvilken som helst postadresse i et verktøy som Google map og få den nøyaktige korresponderende plasseringen, kan du spørre om et verktøy som ipstack API med en IP-adresse for å få sin beliggenhet.

Dette har imidlertid noen begrensninger. For eksempel får du ikke den nøyaktige plasseringen fra IP-adressen. Det du får er hva Internett-leverandøren som leverer IP-adressen kan gi. Dette er ofte ikke mye mer presist enn byen eller det generelle nabolaget, selv om noen tilbydere gir mer informasjon enn andre. Hvis brukeren saksøker en VPN for å få tilgang til nettstedet ditt, er det du får fra en slik oppslag plasseringen av VPN-serveren de bruker.

Hovedfunksjoner i ipstack API

Utviklerne av ipstack API valgte å bruke enmodulær tilnærming med dette produktet. Den består av forskjellige moduler, som hver returnerer en annen type informasjon. Det er for eksempel moduler for tidssone, valuta eller til og med sikkerhet. Du velger hvilken modul du vil bruke ved å bruke passende parametere når du sender forespørselen til ipstack API.

Det er noen fordeler med denne tilnærmingen. For det første gjør det responsen enklere å håndtere. Hvis det bare var en type forespørsel som returnerte alle tilgjengelige data om en IP-adresse, vil nettstedets kode måtte analysere hele svaret for å hente all informasjon den trenger. Sending av mindre forespørsler - med mindre svar - kan også forbedre ytelsen.

La oss se nærmere på hvert av de tilgjengeligemodulen, hvordan du kan ringe dem og hvordan deres typiske respons ser ut. Det vil gi deg en ganske oversikt over hva du kan forvente av dette kraftige verktøyet.

Posisjonsmodulen

Ipstack APIs mest grunnleggende modul erStedsmodul. Den returnerer detaljer om den fysiske plasseringen til IP-adressen som er oppgitt i spørringen. Du vil få IP-adressens land, dets viktigste eller offisielle språk samt en emoji for landets flagg som du kan bruke til å tilpasse brukeropplevelsen din.

Her er et typisk svar på et spørsmål til ipstack API. Den første delen er inkludert i en hvilken som helst spørring, uavhengig av hvilken modul du etterspør:

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

De fleste av de returnerte attributtene er selvforklarende, men du har detaljert dokumentasjon på ipstacks nettsted hvis du trenger ytterligere hjelp.

Men siden vi snakker om posisjonsmodulen, la oss se på hvilken ekstra informasjon som returneres når du bruker den:

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

Som du ser er den ekstra informasjonen du fårhovedsakelig landets hovedstad, de forskjellige språkene som brukes på det stedet, en lenke til et bilde av landets flagg og unicode for landets emoji.

Valutamodulen

Valutamodulen kan brukes til å videreføreforbedre brukeropplevelsen på nettstedet. Dette gjelder spesielt et shoppingnettsted, da det vil tillate deg å vise priser i brukerens valuta. Opplysningene som er gitt inkluderer navnet og symbolet i lokal valuta samt navnet på flertall. APIen konverterer selvfølgelig ikke priser til riktig valuta, men det vil tillate deg å bruke et annet API for å konvertere prisene til riktig valuta for de besøkende. La oss se på hvordan utdataene fra valutamodulen ser ut:

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

Sikkerhetsmodulen

Sannsynligvis ikke så populær - eller nyttig - som den forrigemoduler, er sikkerhetsmodulen fremdeles interessant. Den returnerer informasjon om flere sikkerhetsaspekter ved den innkommende forbindelsen. For eksempel vil det fortelle deg om det er tilgang til nettstedet via en proxy, og i så fall hvilken proxy, eller om forespørselen kom inn via tor-nettverket. Det kan også fortelle deg at en forespørsel kommer fra en gjennomsøker enn en faktisk bruker. Denne typen informasjon kan brukes for å forhindre skraping. Modulen returnerer også trusselnivået tilknyttet IP-adressen som gis, noe som muligens muliggjør råbeskyttelse mot skadelige forespørsler. Her er en titt på det typiske svaret fra sikkerhetsmodulen:

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

Tidssone-modulen

En annen modul som kan komme til nytte forpersonliggjør besøkende på brukerne på nettstedet, er tidssone-modulen. Det gir noen ekstra detaljer om - du gjettet det - besøkende på nettstedet. Et av stedene hvor du kan bruke en slik funksjon på nettsteder som omhandler tidssensitiv informasjon. Det lar deg vise riktig tid basert på brukernes beliggenhet.

Modulen gir informasjon som GMT-forskyvning, gjeldende brukertid, tidskode og tidssoneplassering som du kan se fra denne prøvesvaren:

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

Tilkoblingsmodulen

Sist men ikke minst er tilkoblingsmodulen. Denne er ganske forenklet. Alt det returnerer er det autonome systemnummeret (AS) som er tilknyttet kildens IP-adresse samt ISP-navnet. Vel, det er faktisk navnet på AS-eieren snarere ISP. Noen organisasjoner registrerer sitt eget autonome system, som tilfellet er i eksemplet nedenfor:

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

Dette er sannsynligvis det minst nyttige av alle modulene, men noen vil synes det er nyttig for forskjellige analytiske formål.

Arbeide med ipstack API

Vi har sett på hvilken informasjon som kan værereturnert av ipstack API, er det nå på tide å se på hvordan det heter. Ipstack API tilbyr tre forskjellige typer spørsmål hver med forskjellige parametere. Det er standardoppslag, bulkoppslag og etterspørsel etter forespørsel. La oss se hvordan de er forskjellige. Dette er en fin funksjon da for eksempel masseforespørselen lar en kombinere flere forespørsler til en, og dermed redusere den totale overhead og gi raskere resultater. La oss se nærmere på hver type forespørsel.

Standard oppslag

Som du kanskje har gjettet, er Standard Lookupden mest grunnleggende. Den returnerer detaljene om en enkelt IP-adresse som du oppgir når du ringer ipstack API. Det er ganske enkelt å bruke, og det vil fungere med IPv4- eller IPv6-adresser. For å gjøre saken enda enklere, gir produktens dokumentasjon prøvekode for standardforespørselen i både PHP (cURL) og JavaScript (Jquery.ajax). Hvis nettstedet ditt er bygd ved å bruke en av disse, er det virkelig en no-brainer å bruke API. Her er et eksempel på en typisk samtale til API ved å bruke enkel HTML-kode:

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

I dette eksemplet YOUR_ACCESS_KEY vil bli erstattet av den faktiske tilgangsnøkkelen dufikk da du meldte deg på tjenesten. Du vil også inkludere den faktiske IP-adressen du vil ha informasjon om i stedet for den dummy i dette eksemplet.

Resultatene for et standardoppslag inkluderer allemoduler som standard, men ekstra parametere lar deg stille forespørselen etter dine nøyaktige behov. Alle detaljene om tilgjengelige parametere er tydelig forklart i produktdokumentasjonen. På samme måte er standardsvaret et JSON-objekt, men parametere kan endre det til et XML-format.

Bulk- og forespørselsoppslag

Med bulkoppslag kan du be om data motflere IP-adresser i en enkelt forespørsel. Akkurat som Standard oppslag kan du få data på både IPv4- og IPv6-adresser. Du kan til og med blande begge typer adresser i en enkelt forespørsel. Formatet for forespørselen er det samme som for standard oppslag, bortsett fra at du spesifiserer flere IP-adresser atskilt med kommaer.

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

Den siste typen forespørsel som tilbys av ipstackAPI er Requester Lookup. Det vil returnere informasjon om IP-adressen forespørselen kommer fra. Det er den typen forespørsel du ville ha fra et klientsideskript. For å foreta et anropsforespørsel, er alt du trenger å bruke søkeordet “sjekk” i stedet for en IP-adresse. De andre tilgjengelige forespørselsparametrene er de samme som for andre forespørselstyper.

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

Hvordan fungerer ipstack API?

Ipstack API er mer enn sannsynlig noevil du integrere deg i et sanntidsnettsted. For eksempel kan det være lurt å servere forskjellig innhold basert på klientens beliggenhet. For å oppnå det, trenger du API for å prestere raskt. Enhver forsinkelse i API-svaret vil føre til forsinkelser som viser siden til klienten, noe du mer enn sannsynligvis vil unngå. Det samme er uansett hva du bruker posisjonsdataene til. Dette er grunnen til at responstiden til verktøyet du bruker er av største viktighet. Selv om en geolocation API kan gi en mye tiltrengt funksjonalitet, kan dens manglende ytelse ha en katastrofell innvirkning.

Av disse grunnene må du velge et API medgod responstid. Vi har gjort mye av det harde arbeidet med å teste forskjellige scenarier og gjennomført tester med enkelt eller flere IP-adresser, noen med flere valgfrie parametere, noen med mindre. Vi var ganske fornøyde med resultatene og fikk en ganske jevn svartid på rundt 100 ms, uavhengig av forespørsel. Responsen var også konsekvent over tid uten tilsynelatende "rushtimer" når ytelsen ville lide, og det var også lignende uansett hvor vi lanserte forespørslene fra. Det virker som ipstack-serverne er bygget for å håndtere belastningen de får. Totalt sett virker det som om bruk av ipstack API knapt hadde noen innvirkning på nettstedets respons sett fra en brukers perspektiv.

Produktdokumentasjon og support

Det sies ofte at et produkt bare er like brasom sin dokumentasjon. Hvis det er sant, har ipstack API ingenting å frykte da dokumentasjonen er enkel å finne, bruke og forstå. Kvaliteten på dokumentasjonen gir også et mål på hvor mye en programvareutgiver bryr seg om brukerne. Her igjen er det ingenting å bekymre seg for.

Noe av det beste med dette produktetdokumentasjon er, merkelig nok, hvor lite det er. Alt passer på en enkelt, godt lagt webside som du lett finner alt du trenger. Og for å gjøre ting enda enklere, gjør en menyrute tilgang til en gitt seksjon til en lek. Dokumentasjonen dekker alt fra å bruke de forskjellige typer forespørsler til å tilpasse svaret.

I det høyst usannsynlige tilfellet når du ikke ville gjort detFinn det du trenger i dokumentasjonen, support er også tilgjengelig. Det kan ta litt tid å begynne å nå teknisk support, men når du først gjør det, svarer de ganske raskt.

Priser

Flere prisplaner er tilgjengelige foripstack API. På det laveste nivået, der gratisplanen. Som navnet tilsier, er denne gratis. Det er også noe begrenset. For det første kan du bare kjøre opptil 10 000 spørsmål per måned. Den inkluderer også stedsmodulen og tilgangen til støtte er begrenset. Det kan imidlertid være en fin måte å teste produktet og se hvordan det kan integreres i miljøet ditt.

Neste nivå er grunnleggende plan. Denne selger for $ 9,99 / måned eller $ 95,90 / år (20% rabatt) og bringer forespørselsgrensen opp til 50 000 / måned. Den lar deg også bruke valuta-, tidssone- og tilkoblingsmodulene. Videre er forbedret støtte også inkludert i planen samt forbedret sikkerhet gjennom bruk av SSL-kryptering.

Den mest populære planen er den profesjonellesom selger for $ 49,99 / måned eller $ 479,90 / år. Den gir deg alt som er inkludert i den grunnleggende planen, men øker den månedlige forespørselsgrensen til 500 000 og inkluderer også muligheten til å sende bulkforespørsler.

Øverst er den profesjonelle plussplanen. Det koster $ 99,99 / måned eller $ 959,90 / år. Den er identisk med den profesjonelle planen, men den tillater opptil 2 millioner forespørsler per måned, og det er den eneste planen som inkluderer sikkerhetsmodulen.

Hvis det ikke er nok, er det også entilpassbar virksomhetsplan som kan ordnes ved å kontakte ipstack. Den kan inneholde så mange månedlige forespørsler som du måtte trenge, i tillegg til forskjellige tilpassede løsninger basert på kundens spesifikke behov.

For å konkludere

Ipstack API er et utmerket produkt som villar deg hente så mye av dataene du kan få fra en IP-adresse raskt og enkelt. Det har fantastisk responstid, utmerket dokumentasjon og god støtte som kombinerer for å gjøre dette til en god verdi for pengene. Det at flere internettgiganter bruker det, er sannsynligvis et godt vitnesbyrd om produktets verdi.

Dette er definitivt et produkt jeg vil anbefale hvisdu ser på å utnytte dataene som kan samles for IP-adressen til den besøkende besøkende. Og siden en gratis - om enn begrenset - plan er tilgjengelig, er det ingen grunn til at du ikke minst skal prøve å prøve å se hva den kan gjøre for deg.