If you're using Piwik, the open source web analytics tool, then you probably already missed a map visualization of your visitors location, which is a standard feature of all major web analytics tools. As I really like the idea of open source and decentral web analytics and also gained some experiences on map visualizations, I decided to contribute a map plugin to the Piwik community.

Download

You can download the plugin here: UserCountryMap.zip

Update: the current version of my plugin relies on features, that are not available in Piwik 0.6.4 yet, so it doesn't work now. You have to either wait for the final release of Piwik 1.0, which will be released in August 2010 and will include the map plugin by default, or checkout the current development version via svn.

Features

Interactive world map: The plugin provides a new dashboard widget showing an interactive world map. The countries are colored according to the selected data metric (like number of unique visitors). It is possible to zoom into certain regions to get a closer look at smaller countries. While moving the mouse over countries, tooltips show the exact value and its ratio.

Piwik API integration: The map is fully integrated into the new Piwik report API, so there is no limitation on the displayed data metrics.

Legend: Besides the map there is a small legend that helps to interpret the country colors. This is especially helpful, if you want to print out the map.

Fullscreen: You can set the map into fullscreen mode. This is very handy if you're working on a smaller screen.

Image export: It is possible to download the current map view as PNG image, just like the other flash-based charts in Piwik. The exported map view will be resized to 1000px width. You can even export high-resolution images by using the image export while in fullscreen mode (accessible via context menu).

Screenshot

This is how the widget looks, after zooming into Europe:

Here is an example for the new fullscreen mode (click image to enlarge):

Current progress / Roadmap

The plugin is ready and waits for the release of Piwik 1.0.
Update: Since Piwik 0.9 the map plugin is one of the core plugins that are also activated by default.

Future versions
There are some more features, which I would like to implement in the future. One is to display vistitors cities as implemented in Google Analytics. This feature needs further improvement on the GeoIP plugin, because by now Piwik does only store the visitors country but not the city. Once this features makes it into Piwik core I'll update the map plugin.

Donate

If you like the plugin, please support the developer with a small donation via paypal or flattr.

Viele Piwik-Nutzer werden sicherlich schon eine Weltkarte ihrer Besucherländer vermisst haben, die ja in so ziemlich jedem Web Analytics Tool vorhanden ist. Weil ich die Idee hinter Open Source und dezentraler Web Analytic unterstützen möchte und bereits etwas Erfahrung in Kartenvisualisierungen gesammelt habe, kam die Idee auf, ein Karten-Plugin für die Piwik Community zu entwickeln.

Download

Die Piwik-Entwickler waren so begeistert von meinem Plugin, dass es seit Piwik 1.0 als Core-Plugin mit ausgeliefert wird.

Features

Ínteraktive Weltkarte: Die Länder sind eingefärbt nach der ausgewählten Metrik (z.B: eindeutiger Besucher) . Man kann in die Karte hineinzoomen um eine besser Übersicht über kleinere Länder zu bekommen. Ein Tooltip zeigt die Detailinformationen zu jedem Land an.

Piwik API integration: Die Karte ist voll in die neue Piwik API integriert und kann somit alle in Piwik verfügbaren Metriken darstellen.

Legende: Neben der Karte gibt es eine kleine Legende, die die Bedeutung der Farben anzeigt. Praktisch wenn man sich die Karte ausdrucken möchte.

Vollbild: Für kleine Birdschirme ist die Vollbildfunktion gedacht.

Als Bild speichern: Es ist möglich die jeweilige Kartenansicht als PNG zu exportieren, genau wie bei den anderen Piwik-Diagrammen auch.

Screenshot

So sieht die Karte aus, nachdem man zu Europa gezoomt hat:

So sieht der Vollbild-Modus aus (klick aufs Bild)