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

Documentation and samples for ArcGIS API for Python

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

prettymaps - A minimal Python library to draw customized maps from OpenStreetMap data.

Read and write rasters in parallel using Rasterio and Dask

Constraint-based geometry sketcher for blender

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

Spectral decomposition for characterizing long-range interaction profiles in Hi-C maps

Tile Map Service and OGC Tiles API for QGIS Server

A python package that extends Google Earth Engine.

Using SQLAlchemy with spatial databases

iNaturalist observations along hiking trails

Use Mapbox GL JS to visualize data in a Python Jupyter notebook

A package to fetch sentinel 2 Satellite data from Google.

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

Automatización de procesos geográficos con Python sobre Esri ArcGIS y QGIS.

Geospatial Image Processing for Python

ESMAC diags - Earth System Model Aerosol-Cloud Diagnostics Package

When traveling in the backcountry during winter time, updating yourself on current and recent weather data is important to understand likely avalanche danger.

Raster processing benchmarks for Python and R packages

iNaturalist observations along hiking trails