Click here to Skip to main content
15,350,716 members
Articles / Web Development / HTML
Posted 27 Jun 2006


225 bookmarked

Tracert Map: View the IP network path on a map

Rate me:
Please Sign up or sign in to vote.
4.93/5 (63 votes)
4 Jul 2006CPOL7 min read
This utility geo-locates the IP addresses on the path of a network packet in an IP network and displays them on a map.

Screenshot of the application


The tracert tool displays the various IP Addresses in the route of a network packet as it travels to a destination IP address from a source. An article which describes how tracert works and which also presents a C# component to implement tracert functionality in your projects can be found here. In the tool presented in this article, I combine the tracert component, technology to geo-locate based on IP address from, and the Virtual Earth API to map the locations of various IP addresses that fall in the route of a network packet when it travels to a user provided destination IP address. Since the tracert component is covered thoroughly in the other article, let's start by looking at geo-location and the MSN Virtual Earth API.

Geo-Location Using IP Address

Many web applications use IP address to find the geographical location of the web site visitors. It has uses from catering relevant advertisements to customizing the behavior of a web site. Geo-location using IP address is normally done by using databases. There are two different options available: and MaxMind. has exposed its data through a web service. The access to the web service is free; however, the data is not very accurate. MaxMind offers both commercial solutions as well as free solutions. The free solutions, also called the lite versions, are not highly accurate, but the commercial products are extremely accurate. The code presented in this article has been written to work with both MaxMind's database as well as's web service. The default is to use You can change the default by setting the NodeInfo.LocationService property.

//Use Maxmind's Getloaction
NodeInfo.LocationService = new Maxmind.NodeInfoLookupService(); 
//Use's Geolocation
NodeInfo.LocationService = new HostIP.NodeInfoLookupService();

The LocationService property is of the type INodeInfoLocationService which makes it easy to provide custom lookup services. In a later version, the class name of the object to create can come from the configuration file. The INodeInfoLocationService is quite simple, with just one method named Lookup.

bool Lookup(IPAddress address, NodeInfo nodeInfo);        

The Lookup function takes an IP address, and populates a NodeInfo object, which stores the latitude, longitude, city, region, and the country name.

The web site exposes its API through HTTP GET at the URL: For example, you can get the location of the IP address using the following URL:  

The response is returned as XML. The XML gives the latitude, longitude, city, state, and country. In the parser implemented in this article, the HTTP GET request is issued through the XMLDocument.Load method.

XmlDocument doc = new XmlDocument();
doc.Load(String.Format("{0}", address));    

The individual elements are extracted using XPath queries. For example, the country name is extracted using the following query:

node = doc.SelectSingleNode("//hostip:countryName", manager);

if (node != null)
   nodeInfo.Country = node.InnerText;

One element of detail to understand here is how namespaces works with XPath. The argument manager, passed to the SelectSingleNode method, is of type XmlNamespaceManager. The namespace prefixes are indicated using the following code:

XmlNamespaceManager manager = new XmlNamespaceManager(doc.NameTable);
manager.AddNamespace("gml", "");
manager.AddNamespace("hostip", "");

The latitude, longitude, city, and the state are extracted in a similar fashion using XPaths.

The MaxMind lookup service is much simpler. MaxMind provides the source code of the library that can read its databases. The code can be downloaded from here. The Maxmind.NodeInfoLookupService uses the LookupService class provided by MaxMind. I have only made minor changes to MaxMind's code and most of MaxMind's code is retained as it is. Here is the code for the wrapper around MaxMind's code.

LookupService svc = new LookupService(Path.Combine(
Location loc = svc.getLocation(address);

if (loc != null)
  nodeInfo.Region = loc.region;
  nodeInfo.Longitude = loc.longitude;


You need to download and extract the GeoCity Lite database from The compressed archive of the database is available here. The GeoLiteCity.dat must be placed in the same directory as the executable.

This was a brief description of the geo-location code. Now, let's examine how the Virtual Earth API is used in the code.

Using the Virtual Earth API

You can get the same mapping feature in your web applications as using the Virtual earth API. The Virtual Earth API is JavaScript code, and can be loaded in web pages by including a script:


Once the script is loaded, you can use Javascript classes available in the API. A comprehensive API reference is available here. Also, checkout the interactive SDK tutorial available at the same URL. To display the Virtual Earth map in your web page, you need to designate a <div> element where you want the map image to appear:

<div id="mapContainer"></div>

Next, you will use some JavaScript to load the map into the designated element:

map = new VEMap("mapContainer");

Notice that so far I have only talked about Virtual earth API as a web based API. Since Tracert Map is a Windows application, the question arises: how can we use Virtual Earth in a Windows application? The answer is simple: host Internet Explorer in the desktop application. Luckily, the .NET Framework 2.0 provides the WebBrowser control. We need to create an HTML page where we can place all the HTML, JavaScript, and CSS and load this page into the hosted web browser. An HTML page named tracert.htm needs to be placed in the directory of the executable, so as to make the following code work:


The code shown till now is sufficient to display the map, but we need to control the map from C# code. The JavaScript code in the web page also needs to invoke the C# code. Luckily, the WebBrowser control has a property called ObjectForScripting for this purpose. This property can be assigned any object, the only catch is that the class needs to be marked with the COMVisible attribute.

[ComVisible(true)] //So that scripts can access the methods
public partial class TracertMapForm : Form    

A public method in the class declared as public void MapLoaded() can be accessed from JavaScript using the window.external.MapLoaded() statement. This is how JavaScript can use C# code, but how about C# code invoking JavaScript? This can be done by using the InvokeScript function. For example, the code: mapBrowser.Document.InvokeScript("OnStartTrace"); invokes the JavaScript function OnStartTrace declared as: function OnStartTrace. Now that we know how two way communication between the script and the C# code can be achieved, let's look at the details of the Virtual Earth API.

We will be using the Virtual Earth API to mark nodes on the map. This is called a pushpin in the Virtual Earth terminology. In order to do that, we need the latitude and the longitude of the node which was obtained by the geolocation service. To display the pushpin, we also need the URL of the image which will be used as the pushpin. Images of numbers circled in red can obtained at the following URL:, where XX can be replaced by a number. For example, the URL is the image representation of number 10 enclosed in a red circle. To represent the nth node as a pushpin in the map, we use the URL:{n}.gif where {n} is replaced by the actual number. Another, interesting feature of a pushpin is that when the mouse hovers over the pushpin, it shows a popup as shown in the screenshot below.

Screen shot of popup

The IP address is displayed in the bold text as the title of the popup, and the DNS name in lighter text as the body of the popup. The Virtual Earth API takes care of displaying the popup. All we need to do is to specify the popup title and the body when creating the pushpin:

var location = new VELatLong(nodeInfo.Latitude, nodeInfo.Longitude);
var imageURL = "" + hopNo + ".gif";
var pushpin = new VEPushpin(hopNo, 
                       location, //pushpin latitude and longitude
                       imageURL, //pushpin image
                       nodeInfo.Address, //Pushpin title
                       nodeInfo.HostName //Pushpin body

The final aspect of the Virtual Earth API which is used in the tool is that of polylines. As seen in the first screenshot, the nodes on the map are connected through a blue line. This can be created by using the VEPolyline JavaScript object. The code to create a transparent blue polyline through an array of latitude and longitude pairs, named nodes, is shown below:

var poly = new VEPolyline("route", nodes);
poly.SetColor(new VEColor(0, 0, 255, 0.5));

Final Words

I have described briefly how the tool works and its various elements. The tool is still under development, and there are lots of features that need to be added. Please note that the pushpins may not represent the locations accurately. This is because the as well as the MaxMind lite databases are not highly accurate. The site allows you to correct its database, and I recommend you to correct the database and further improve the excellent and free GeoIP database.


This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


About the Author

Rama Krishna Vavilala
United States United States
No Biography provided

Comments and Discussions

Generaltraceroute map is not working Pin
MemberHUSSNAIN TOUFIQ23-Oct-10 2:33 
GeneralRe: traceroute map is not working Pin
bradgagne13-Jun-11 8:05
Memberbradgagne13-Jun-11 8:05 
GeneralRe: traceroute map is not working Pin
tbryce31116-Feb-12 15:26
Membertbryce31116-Feb-12 15:26 
GeneralRe: traceroute map is not working Pin
sw1tchmx15-Dec-12 19:51
Membersw1tchmx15-Dec-12 19:51 
GeneralRe: traceroute map is not working Pin
d0sgh0st8-Feb-18 18:22
Memberd0sgh0st8-Feb-18 18:22 
Questionhow to block particular ipaddress in this application Pin
boarder3059-Mar-10 21:58
Memberboarder3059-Mar-10 21:58 
GeneralTracertMAP compiles and works but I am not seeing numbered pushpins on the route Pin
spicture2-Jan-10 6:49
Memberspicture2-Jan-10 6:49 
Questionbing version Pin
easy742-Nov-09 1:05
Membereasy742-Nov-09 1:05 
JokeComment Pin
amgadhs21-Feb-09 23:08
Memberamgadhs21-Feb-09 23:08 
The developers of Visual TraceRoute must hate you very much for this article.

Amgad Suliman
My Blog: Code Hill

GeneralExcellent.. Very good Pin
Mahin Gupta2-Nov-08 20:54
MemberMahin Gupta2-Nov-08 20:54 
General'VEMap' is undefined Pin
Mahin Gupta17-Oct-08 4:40
MemberMahin Gupta17-Oct-08 4:40 
AnswerRe: 'VEMap' is undefined Pin
kesitter18-Oct-08 6:55
Memberkesitter18-Oct-08 6:55 
AnswerRe: 'VEMap' is undefined Pin
Mahin Gupta2-Nov-08 20:49
MemberMahin Gupta2-Nov-08 20:49 
GeneralRe: 'VEMap' is undefined Pin
Member 459217825-Jan-09 11:53
MemberMember 459217825-Jan-09 11:53 
GeneralRe: 'VEMap' is undefined Pin
Oskar Austegard14-May-09 16:45
MemberOskar Austegard14-May-09 16:45 
QuestionVisual Studio Version? Pin
kingoli1238-Jan-08 5:12
Memberkingoli1238-Jan-08 5:12 
AnswerRe: Visual Studio Version? Pin
Alan Hastings29-Apr-08 0:53
MemberAlan Hastings29-Apr-08 0:53 
Generalsmall enhancement Pin
willemijns22-Nov-07 1:43
Memberwillemijns22-Nov-07 1:43 
GeneralHI! Pin
HankiDesign6-Jul-07 8:33
MemberHankiDesign6-Jul-07 8:33 
QuestionHow do I call javascript functions from my c# code? Pin
chance@crwmail.com17-May-07 7:52
Memberchance@crwmail.com17-May-07 7:52 
AnswerRe: How do I call javascript functions from my c# code? Pin
Craig Eddy30-May-07 10:34
MemberCraig Eddy30-May-07 10:34 
GeneralIp to latitude and longitude Pin
sajanpoooo9-May-07 23:55
Membersajanpoooo9-May-07 23:55 
GeneralUnable to Open your Project Pin
ToothRobber212-Jan-07 9:46
MemberToothRobber212-Jan-07 9:46 
GeneralRe: Unable to Open your Project Pin
kingoli12315-Oct-07 5:40
Memberkingoli12315-Oct-07 5:40 
GeneralRe: Unable to Open your Project Pin
ToothRobber215-Oct-07 10:49
MemberToothRobber215-Oct-07 10:49 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.