Using GeoIP in Python

Discussion in 'Python' started by pradeep, Jun 21, 2012.

  1. pradeep

    pradeep Team Leader

    Apr 4, 2005
    Likes Received:
    Trophy Points:
    Kolkata, India
    Home Page:
    Geolocation software/services are used to find the actual geographic location of an IP address, the geographic information may be accurate till city/ZIP code level. Maxmind's GeoIP is one such provider of IP address geographic information, they have both free and paid data subscriptions which can be downloaded and used as required, it is also one of most popular amongst developers as it provides APIs in a variety of languages.

    The GeoIP databases are provided in two major varieties, the GeoIP Country and GeoIP City, providing upto country level & city level information respectively. These are paid, but Lite versions of both are available for free, which we'll be using in the demo codes to follow.

    Installing the Python library

    Various versions of the GeoIP open source C Python library is available at, download the latest stable version and unpack it. Pygeoip is a pure Python library, you can check it out at, but here we'll be looking at the C Python library from Maxmind.
    Issue the following commands from shell as root:
    python build
    python install
    If you have not encountered any errors, the library is installed fine, and we are good to go. In case there was any error, make sure the development code for Python is present in your system.

    If you get this error, like I faced, " cannot open shared object No such file or directory", then add /usr/local/lib to /etc/ and the following command:

    run /sbin/ldconfig /etc/
    Now, we'll need to download the free version of GeoIP Country & City binary databases from here:

    Download and unpack it to a location of your choice, if possible copy it to the following standard location:


    Implementing in Python code

    We'll implement, a piece of code to try using both City & Country database. Please follow the comments in the code.

    import GeoIP
    ## basic usage
    geo =
    print "==Using GeoIP=="
    print geo.country_code_by_addr("")
    print geo.country_code_by_name("")
    ## using the in memory cache
    ## GeoIP provides the following flags GeoIP.GEOIP_STANDARD, GeoIP.GEOIP_MEMORY_CACHE & GeoIP.GEOIP_INDEX_CACHE
    ## I prefer to use the GeoIP.GEOIP_MEMORY_CACHE
    geo = | GeoIP.GEOIP_CHECK_CACHE)
    print "==Using GeoIP Memory Cache=="
    print geo.country_code_by_addr("")
    print geo.country_code_by_name("")
    ## using the City database
    geo ="/usr/local/share/GeoIP/GeoIPCity.dat",GeoIP.GEOIP_STANDARD)
    print "==Using GeoIP City database=="
    record = geo.record_by_addr("")
    if record != None:
        print record['country_code']
        print record['country_code3']
        print record['country_name']
        print record['city']
        print record['region']
        print record['region_name']
        print record['postal_code']
        print record['latitude']
        print record['longitude']
        print record['area_code']
        print record['time_zone']
        print record['metro_code']


    GEOIP_MEMORY_CACHE flag uses more memory but provides better performance, it is best suited for batch processing of IP addresses inside a script, the GEOIP_CHECK_CACHE flag if combined with GEOIP_MEMORY_CACHE forces a reload of the database if the database file is modified. The GEOIP_INDEX_CACHE caches the frequently used regions, thereby provides better performance than GEOIP_STANDARD.

Share This Page

  1. This site uses cookies to help personalise content, tailor your experience and to keep you logged in if you register.
    By continuing to use this site, you are consenting to our use of cookies.
    Dismiss Notice