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

Cloud Optimized GeoTIFF creation and validation plugin for rasterio

gpdvega is a bridge between GeoPandas and Altair that allows to seamlessly chart geospatial data

Xarray backend to Copernicus Sentinel-1 satellite data products

Search and download Copernicus Sentinel satellite images

Geospatial Image Processing for Python

How to use COG's (Cloud optimized GeoTIFFs) with Rasterio

Deal with Bing Maps Tiles and Pixels / WGS 84 coordinates conversions, and generate grid Shapefiles

pure-Python (Numpy optional) 3D coordinate conversions for geospace ecef enu eci

A public data repository for datasets created from TransLink GTFS data.

A Jupyter - Leaflet.js bridge

Tool to suck data from ArcGIS Server and spit it into PostgreSQL

A compilation of several single-beam bathymetry surveys of the Caribbean

Calculate & view the trajectory and live position of any earth-orbiting satellite

Global topography (referenced to sea-level) in a 10 arcminute resolution grid

LEOGPS - Satellite Navigation with GPS on Python!

Code and coordinates for Matt's 2021 xmas tree

Geocode rows in a SQLite database table

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

Daily social mapping project in November 2021. Maps made using PyGMT whenever possible.

geobeam - adds GIS capabilities to your Apache Beam and Dataflow pipelines.