https://github.com/kianmeng/webservice-geoipify

The Perl helper library for ipify's Geolocation API, https://geo.ipify.org and https://ipify.org.
https://github.com/kianmeng/webservice-geoipify

api cpan geoip ipify ipv4 ipv6

Last synced: 3 months ago
JSON representation

The Perl helper library for ipify's Geolocation API, https://geo.ipify.org and https://ipify.org.

• Host: GitHub
• URL: https://github.com/kianmeng/webservice-geoipify
• Owner: kianmeng
• License: other
• Created: 2019-02-06T15:10:47.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2019-05-07T13:44:59.000Z (about 6 years ago)
• Last Synced: 2025-02-05T09:26:46.694Z (4 months ago)
• Topics: api, cpan, geoip, ipify, ipv4, ipv6
• Language: Perl
• Homepage:
• Size: 20.5 KB
• Stars: 0
• Watchers: 3
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: Changes
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

        
[![Cpan license](https://img.shields.io/cpan/l/WebService-GeoIPify.svg)](https://metacpan.org/release/WebService-GeoIPify)

[![Cpan version](https://img.shields.io/cpan/v/WebService-GeoIPify.svg)](https://metacpan.org/release/WebService-GeoIPify)

# NAME

WebService::GeoIPify - Perl library for ipify's Geolocation API,

https://geo.ipify.org and https://ipify.org.

# SYNOPSIS

    use WebService::GeoIPify;

    my $geoipify = WebService::GeoIPify->new(api_key => '1xxxxxxxxxxxxxxxxxxxxxxxxxxxxx32');

    print $geoipify->lookup('8.8.8.8');

# DESCRIPTION

WebService::GeoIPify is a Perl library for obtaining Geolocation information on

IPv4 address.

# DEVELOPMENT

Source repository at [https://github.com/kianmeng/webservice-geoipify](https://github.com/kianmeng/webservice-geoipify).

How to contribute? Follow through the [CONTRIBUTING.md](https://github.com/kianmeng/webservice-geoipify/blob/master/CONTRIBUTING.md) document to setup your development environment.

# METHODS

## new($api\_key)

Construct a new WebService::GeoIPify instance.

    my $geoipify = WebService::GeoIPify->new(api_key => '1xxxxxxxxxxxxxxxxxxxxxxxxxxxxx32');

### api\_key

Compulsory. The API access key used to make request through web service.

### api\_url

The default base URL for API calls.

### api\_ipify\_url

The default base URL for ipify API calls to obtain the client public IP.

## lookup($ip\_address)

Query and get an IP address information. Only accept IPv4 public address.

    my $geoipify = WebService::GeoIPify->new(api_key => '1xxxxxxxxxxxxxxxxxxxxxxxxxxxxx32');

    print $geoipify->lookup('8.8.8.8');

## check()

Look up the public IP address of the client which made the web service call.

    my $geoipify = WebService::GeoIPify->new(api_key => '1xxxxxxxxxxxxxxxxxxxxxxxxxxxxx32');

    print $geoipify->check();

# AUTHOR

Kian Meng, Ang 

# COPYRIGHT AND LICENSE

This software is Copyright (c) 2019 Kian Meng, Ang.

This is free software, licensed under:

    The Artistic License 2.0 (GPL Compatible)