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

A utility to search, download and process Landsat 8 satellite imagery

peartree: A library for converting transit data into a directed graph for sketch network analysis.

Manipulation and analysis of geometric objects

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

Obtain a GNSS position fix from an 11-millisecond raw GNSS signal snapshot

GeoNode is an open source platform that facilitates the creation, sharing, and collaborative use of geospatial data.

Rasterio reads and writes geospatial raster datasets

A Python interface between Earth Engine and xarray

Focal Statistics

This is a simple python code to get IP address and its location using python

ProjPicker (projection picker) is a Python module that allows the user to select all coordinate reference systems (CRSs)

Construct and use map tile grids in different projection.

scalable analysis of images and time series

ESMAC diags - Earth System Model Aerosol-Cloud Diagnostics Package

iNaturalist observations along hiking trails

Geospatial Image Processing for Python

A Python tool to display geolocation information in the traceroute.

Xarray backend to Copernicus Sentinel-1 satellite data products

A trivia questions about Europe

a Geolocator made in python