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

Simulation and Parameter Estimation in Geophysics

python toolbox for visualizing geographical data and making maps

Imperial Valley Geomorphology Map

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

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

Constraint-based geometry sketcher for blender

A toolbox for processing earth observation data with Python.

An API built to format given addresses using Python and Flask.

This program analizes films database with adresses, and creates a folium map with closest films to the coordinates

Get-countries-info - A python code that fetches data of any country

Creates 3D geometries from 2D vector graphics, for use in geodynamic models

iNaturalist observations along hiking trails

Python script that can be used to generate latitude/longitude coordinates for GOES-16 full-disk extent.

This repository contains the scripts to derivate the ENU and ECEF coordinates from the longitude, latitude, and altitude values encoded in the NAD83 coordinates.

Script that allows to download data with satellite's orbit height and create CSV with their change in time.

Example of animated maps in matplotlib + geopandas using entire time series of congressional district maps from UCLA archive. rendered, interactive version below

Summary statistics of geospatial raster datasets based on vector geometries.

Helping data scientists better understand their datasets and models in text classification. With love from ServiceNow.

🌐 Local tile server for viewing geospatial raster files with ipyleaflet or folium

:earth_asia: Python Geocoder