This service exists to resolve IPs to country codes/names.
|
+ fast and simple
+ updated daily
+ has information on over 3,500,000,000 IPs
» read instructions below


==== News:

2009-01-09
|
+ Core is redesigned and rebuilt from scratch.
  Databases are no longer in use, seems they were too bulky to operate.
  New solution features RAM-based indexed binary search.
  Update process has been reduced from over 60 minutes to under 10 seconds.
  This makes GeoLoc accurate within 2 hours after new data is published by Webnet77.com,
  instead of 17 hours as it was until yesterday.

2009-01-07
|
+ Starting 1 a.m. GMT something is really wrong.
  Out of 96 database update threads 34 crash during 31 hours' period.
  It means extreme overload generated by those other websites.
  Results in presumably over 30% incorrect answers by GeoLoc.

2008-11-22 (since)
|
+ Server shows some strain from time to time. Not related to amount of requests, however.
  There are 80-90 other websites hosted virtually on the same machine as this service,
  they probably start getting more and more visitors - which results in shared overload.
  Sorry for the inconvenience.

2008-09-13
|
+ Added load distribution (4 parallel databases)
  If flooding takes place again, we will add automated blacklisting.
  This is public service after all.

2008-09-12
|
+ Server overwhelmed by some mad script from 62.210.107.40 (France)
  150,000 requests/day from a single IP is a bit too many.
  Anyone responsible for this - please revise your loops.
  Everyone - consider caching retrieved results for at least one day.
  'Cookie' your clients wherever possible, IP data changes slowly enough to be updated just once a day.
  If you feel like killing your server with thousands of IPs per second,
  download a csv from <http://software77.net/geo-ip>


==== Accepted inputs:

http://geoloc.daiguo.com/?ip=XXX.XXX.XXX.XXX
|
+ standard IPv4 from 0.0.0.0 to 255.255.255.255
+ e.g. we take your IP:
    |
    + URL looks like this:  http://geoloc.daiguo.com/?ip=38.107.191.92
    + resulting string is:  1;US;USA;United States


http://geoloc.daiguo.com/?dec=XXXXXXXXXX
|
+ decimal number from 0 to 4294967295 (MAX_INT)
+ faster than ?ip= option, less server-side processing
+ to convert IPv4 to decimal you only need to know this:
    |
    + (IPv4) A.B.C.D == A*256^3 + B*256^2 + C*256 + D (decimal)
    + e.g.   5.6.7.8 == 5*256^3 + 6*256^2 + 7*256 + 8
                     == 5*16777216 + 6*65536 + 7*256 + 8
                     == 83886080 + 393216 + 1792 + 8
                     == 84281096


http://geoloc.daiguo.com/?self
|
+ processes caller's IP
+ faster than ?dec= option but limited to one purpose - give info about yourself


Caution
Some clients (e.g. ASP) may have issues while trying to open a file over HTTP.
In that case a slash / is obligatory.


==== Possible outputs:

0;;;WRONG INPUT
|
+ your request has not been processed due to invalid syntax
    |
    + e.g. bad IPv4 like 300.400.abc.256
    + e.g. bad decimal like 2a3b4c or bigger than MAX_INT


1;CD;COD;COUNTRY
|
+ contains two-letter (ISO 3166) and three-letter country codes, and a full country name
+ country name may be multi-word and contain spaces
+ e.g. we take your IP:
    |
    + URL looks like this:  http://geoloc.daiguo.com/?ip=38.107.191.92
    + resulting string is:  1;US;USA;United States


2;;;UNKOWN
|
+ given ip/dec not found in database or not yet physically assigned to any country


The first digit indicates status so you don't have to always parse the whole string.
Output is always semicolon delimited text/plain - you can pass it to any type of application.


==== License:

This service is provided FREE under the terms of the GNU GPLv3, 29 June 2007
<http://www.gnu.org/copyleft/gpl.html>

This means the service is provided "as is".
There is NO WARRANTY WHATSOEVER for the service.
Use at your own risk.


==== Notes:

This service uses IP to Country Database maintained by Webnet77.com
<http://Webnet77.com/contact.html>
<http://software77.net/geo-ip>

You may contact the author of this service at <geoloc at daiguo dot com>


==== Statistics: (2010-09-07 06:11 GMT/UTC)

63,384,015 requests processed since 2008-03-14
44,984 yesterday
48,829 last week's daily average
69,860 overall daily average


==== GeoLoc ==== (c)2008-2010 ==== daiguo.com ====