A Python tool to display geolocation information in the traceroute.

Last update: Jan 08, 2023

Overview

IP2Trace Python

IP2Trace Python is a Python tool allowing user to get IP address information such as country, region, city, latitude, longitude, zip code, time zone, ISP, domain name, connection type, area code, weather, mobile network, elevation, usage type from traceroute probes IP address.

Note: This tool requires Python 2.7, or Python 3.5 or later.

Installation

You can install this tool by using pip in Windows or Linux. To install this tool in Windows and Linux, just type pip install IP2Trace in your console and IP2Trace will be installed in your machine.

Note: This tool require IP2Location library to work with. If pip did not install the dependency for you, you can manually install it by using pip install IP2Location.

Usage

Usage: ip2tracepy -p [IP ADDRESS/HOSTNAME] -d [IP2LOCATION BIN DATA PATH] [OPTIONS]
   or: ip2tracepy [IP ADDRESS/HOSTNAME] -d [IP2LOCATION BIN DATA PATH] [OPTIONS]

  -p, --ip
  Specify an IP address or hostname.
  The -p/--ip can be omitted if the IP address or hostname is defined in the first parameter.

  -d, --database
  Specify the path of IP2Location BIN database file. You can download the latest free IP2Location BIN database from https://lite.ip2location.com.
  If the database filename is specified but without the path, ip2tracepy will search the database file in /usr/share/ip2location/ for Linux or C:\Users\(your_Windows_username)\Documents\ for Windows.

  -t, --ttl
  Set the max number of hops. (Default: 30)

  -o, --output
  Set the desired IP2Location BIN database columns to output with.
  Available columns are: country_code, country_name, region_name, city_name, isp, latitude, longitude, domain, zip_code, time_zone, net_speed, idd_code, area_code, weather_station_code, weather_station_name, mcc, mnc, mobile_brand, elevation, usage_type, address_type, category.
  
  -a, --all
  Print all the column(s) available based on the BIN file used.

  -h, -?, --help
  Display this guide.

  -v, --version
  Print the version of the IP2Location version.

Example

Traceroute an IP address.

ip2tracepy 8.8.8.8 -d /usr/share/ip2location/DB3.BIN -a

Example output:

IP2Location Geolocation Traceroute (ip2trace) Version 3.1.1
Copyright (c) 2021 IP2Location.com [MIT License]
https://www.ip2location.com/free/traceroute-application

Traceroute to dns.google ( 8.8.8.8 )

 1  37.123.114.1  0.3853ms ["GB","United Kingdom of Great Britain and Northern Ireland","England","London"]
 2  10.10.32.132  0.4084ms ["-","-","-","-"]
 3  10.10.32.17  0.2673ms ["-","-","-","-"]
 4  212.78.92.2  0.5546ms ["GB","United Kingdom of Great Britain and Northern Ireland","England","London"]
 5  98.158.181.98  1.8706ms ["US","United States of America","New York","New York City"]
 6  195.66.236.125  0.5715ms ["GB","United Kingdom of Great Britain and Northern Ireland","England","London"]
 7  108.170.246.129  0.5193ms ["US","United States of America","California","Mountain View"]
 8  108.170.232.97  0.4749ms ["US","United States of America","California","Mountain View"]
 9  8.8.8.8  0.5693ms ["US","United States of America","California","Mountain View"]

Traceroute by hostname

ip2tracepy google.com -d /usr/share/ip2location/DB3.BIN -a

Example output:

IP2Location Geolocation Traceroute (ip2trace) Version 3.1.1
Copyright (c) 2021 IP2Location.com [MIT License]
https://www.ip2location.com/free/traceroute-application

Traceroute to dns.google ( 8.8.8.8 )

 1  37.123.114.1  0.3529ms ["GB","United Kingdom of Great Britain and Northern Ireland","England","London"]
 2  10.10.32.131  0.3686ms ["-","-","-","-"]
 3  10.10.32.17  0.2663ms ["-","-","-","-"]
 4  212.78.92.2  19.7358ms ["GB","United Kingdom of Great Britain and Northern Ireland","England","London"]
 5  98.158.181.98  9.2373ms ["US","United States of America","New York","New York City"]
 6  195.66.236.125  0.5388ms ["GB","United Kingdom of Great Britain and Northern Ireland","England","London"]
 7  108.170.246.161  1.6131ms ["US","United States of America","California","Mountain View"]
 8  172.253.65.211  1.2376ms ["US","United States of America","California","Mountain View"]
 9  216.58.213.14  0.5167ms ["US","United States of America","California","Mountain View"]

Download IP2Location Databases

Download free IP2Location LITE databases at https://lite.ip2location.com
For more accurate commercial database, please refer to https://www.ip2location.com

One you have obtained your download token, you can download the the database using wget as below:

wget "https://www.ip2location.com/download?token={DOWNLOAD_TOKEN}&file={DATABASE_CODE}"

Support

Email: [email protected] URL: https://www.ip2location.com

Comments

socket.herror: [Errno 1] Unknown host

[[email protected] ]# ip2trace -p 116.122.36.54 -d IP-COUNTRY-REGION-CITY-ISP.BIN -t 30                               
Traceback (most recent call last):
  File "/usr/local/bin/ip2trace", line 11, in <module>
    load_entry_point('IP2Trace==2.1.7', 'console_scripts', 'ip2trace')()
  File "/usr/local/lib/python3.6/site-packages/ip2trace.py", line 482, in main
    traceroute(destination_server, database, max_hops, output, all)
  File "/usr/local/lib/python3.6/site-packages/ip2trace.py", line 148, in traceroute
    t = Traceroute(destination_server, database, ttl, output, all)
  File "/usr/local/lib/python3.6/site-packages/ip2trace.py", line 174, in __init__
    self.destination_domain_name = ip_to_domain_name(destination_server)
  File "/usr/local/lib/python3.6/site-packages/ip2trace.py", line 97, in ip_to_domain_name
    return socket.gethostbyaddr(hostname)
socket.herror: [Errno 1] Unknown host
[[email protected] ]#

opened by CNMan 1

Invalid sintax

I receive:

$ python ip2trace.py 
  File "ip2trace.py", line 140
    print(" {}  ".format(self.ttl), end="")
                                       ^
SyntaxError: invalid syntax

Thank you, Riccardo

opened by canonex 1

Releases(3.1.3)

3.1.3(Jul 1, 2022)

Improve the performance.
Source code(tar.gz)
Source code(zip)
3.1.2(Mar 2, 2022)

Change default path for non-Windows system.
Source code(tar.gz)
Source code(zip)
3.1.1(Dec 8, 2021)

Minor fix and readme update.
Source code(tar.gz)
Source code(zip)
3.1.0(Dec 8, 2021)

Minor fix.
Source code(tar.gz)
Source code(zip)
3.0.0(Nov 8, 2021)
Fixed #2 .

Updated command name to avoid conflict issue.

Source code(tar.gz)
Source code(zip)
2.1.7(Oct 15, 2021)

Minor change.
Source code(tar.gz)
Source code(zip)
2.1.6(Oct 7, 2021)

Minor Improvements.
Source code(tar.gz)
Source code(zip)
2.1.5(Aug 25, 2021)

Minor fix.
Source code(tar.gz)
Source code(zip)
2.1.4(Apr 12, 2021)

Fixed typo.
Source code(tar.gz)
Source code(zip)
2.1.3(Apr 12, 2021)
Minor improvements.

Revised and improved the error messages displayed.

Added a new option to customize the result output.

Added sample BIN database.

Source code(tar.gz)
Source code(zip)
2.1.1(Mar 26, 2021)

Source code(tar.gz)
Source code(zip)
2.1.0(Mar 24, 2021)
Support Python 2.7.

Change the way the tool is being called.

Source code(tar.gz)
Source code(zip)
1.0.0(Jan 27, 2021)

First Release.
Source code(tar.gz)
Source code(zip)

A Python tool to display geolocation information in the traceroute.

Related tags

Overview

IP2Trace Python

Installation

Usage

Example

Download IP2Location Databases

Support

You might also like...

Python bindings and utilities for GeoJSON

Geocoding library for Python.

Python Data. Leaflet.js Maps.

Python tools for geographic data

Python interface to PROJ (cartographic projections and coordinate transformations library)

Python bindings and utilities for GeoJSON

Documentation and samples for ArcGIS API for Python

PySAL: Python Spatial Analysis Library Meta-Package

Simple, concise geographical visualization in Python

Comments

socket.herror: [Errno 1] Unknown host

Invalid sintax

Releases(3.1.3)

3.1.3(Jul 1, 2022)

3.1.2(Mar 2, 2022)

3.1.1(Dec 8, 2021)

3.1.0(Dec 8, 2021)

3.0.0(Nov 8, 2021)

2.1.7(Oct 15, 2021)

2.1.6(Oct 7, 2021)

2.1.5(Aug 25, 2021)

2.1.4(Apr 12, 2021)

2.1.3(Apr 12, 2021)

2.1.1(Mar 26, 2021)

2.1.0(Mar 24, 2021)

1.0.0(Jan 27, 2021)

Owner

IP2Location

QLUSTER is a relative orbit design tool for formation flying satellite missions and space rendezvous scenarios

Focal Statistics

A service to auto provision devices in Aruba Central based on the Geo-IP location

Digital Earth Australia notebooks and tools repository

Search and download Copernicus Sentinel satellite images

Processing and interpolating spatial data with a twist of machine learning

Python bindings and utilities for GeoJSON

Python 台灣行政區地圖 (2021)

Map Ookla server locations as a Kernel Density Estimation (KDE) geographic map plot.

ArcGIS Python Toolbox for WhiteboxTools

GeoIP Legacy Python API

A part of HyRiver software stack for handling geospatial data manipulations

glTF to 3d Tiles Converter. Convert glTF model to Glb, b3dm or 3d tiles format.

Google Maps keeps old satellite imagery around for a while – this tool collects what's available for a user-specified region in the form of a GIF.

Starlite-tile38 - Showcase using Tile38 via pyle38 in a Starlite application

Platform for building statistical models of cities and regions

Django model field that can hold a geoposition, and corresponding widget

Cloud Optimized GeoTIFF creation and validation plugin for rasterio

Python script to locate mobile number

Record railway train route profile with GNSS tools