/gmapcatcher

An offline map viewer

Primary LanguagePython

Overview

GMapCatcher is an offline maps viewer. It can display maps from many providers such as:

CloudMade, OpenStreetMap, Yahoo Maps, Bing Maps, Nokia Maps, SkyVector, Google Map.

It displays them using a custom GUI. User can view the maps while offline. GMapCatcher doesn't depend on the map's JavaScript.

GMapCatcher is written in Python 2.7 & PyGTK, can run on Linux, Windows and Mac OSX.

https://raw.githubusercontent.com/heldersepu/gmapcatcher/wiki/snapshot.gif

You can find a list of improvements and latest features in the Changelog

Download

http://gmapcatcher.googlecode.com/files/GMapCatcher-0.7.6.1.tar.gz

or

$ svn checkout http://gmapcatcher.googlecode.com/svn/trunk gmapcatcher

For Windows users, get the latest Windows installer

Usage

maps.py is a gui program used to browse google map. With the offline toggle button unchecked, it can download google map tiles automatically. Once the file downloaded, it will reside on user's hard disk and needn't to be downloaded again any more. At release 0.02, it use multi-threaded downloader and can be faster.

After version 0.04, user can force GMapCatcher to re-download old map tiles by checking "Force update". If a tile is older than 24 hours, it will be re-downloaded.

download.py is a downloader tools that can be used to download map tiles without gui. maps can use files it downloaded without configuration.

Below is an example using download.py:

$ download.py --location="Paris, France" --max-zoom=16 --min-zoom=0 --latrange=2.0 --lngrange=2.0

Files

Linux:

$HOME/.GMapCatcher/*

Windows:

%UserProfile%/.GMapCatcher/*

Dependencies

Windows users are highly recommended to download the latest Windows installer. This installer contains all required packages, works well on XP, Vista and Win 7. For a complete list of tested OS, see wiki Tested Operating Systems.

If you choose the tarball (because you have a legacy Windows like Windows 98), you must install Python 2.6, GTK+ for windows, pygtk, pygobject and pycairo yourself.

Currently GMapCatcher also depends on Python Imaging Library (PIL). For gentoo users, emerge dev-python/imaging.

<a href='Hidden comment: == Deprecated version ==

Versions before 0.046 are depreated because google changes their http://maps.google.com/maps so old versions cannot fetch correct google map version number. Users are recommended to download new version, or at least modify their "googleMaps.py":

 -p = re.compile("http://mt[0-9].google.com/mt\?.*w([0-9].[0-9][0-9])")
 +p = re.compile("http://mt[0-9].google.com/mt.*w([0-9].[0-9][0-9])")

If it doesn"t work, replace the whole fetch_version_string function in googleMaps.py by

def fetch_version_string:
	return "2.89"

For more detail, see [http://code.google.com/p/gmapcatcher/issues/detail?id=17 Issue 17] '>

Authors

pi3orama@gmail.com, HelderSepu@gmail.com