Package us.zuercher.gpx2map.source

The package us.zuercher.gpx2map.source provides a map source factory, abstract base classes useful when writing a new map source, and helper classes useful for downloading and converting map tiles.

See:
Description

Interface Summary

Converter	Converter is an interface describing a mechanism for converting image files or arbitrary encoding into compressed PPM files.
Downloader	Downloader is an interface describing a mechanism for downloading arbitrary files from a URL.
MapSource	MapSource represents a map source.
MapSourceDescriptor	MapSourceDescriptor describes a map source.

Class Summary

AbstractCachedMapSource	AbstractCachedMapSource is a MapSource base class that provides storage of the cache directory location.
AbstractTiledUrlMapSource	AbstractTilesUrlMapSource extends AbstractCachedMapSource to provide a MapSource base class that provides map tile downloading and stitching facilities.
JavaConverter	JavaConverter is a pure-Java implementation of Converter.
JavaDownloader	JavaDownloader is a pure-Java implementation of Downloader.
MapSourcePropertyChoice	MapPropertyChoice represents a choice for a map source property value.
MapSourcePropertyDescriptor	MapSourcePropertyDescriptor describes a map source property.
SourceFactory	SourceFactory creates MapSource implementations.

Exception Summary

IllegalMapSourcePropertyNameException	IllegalMapSourcePropertyNameException is thrown when a map source property name contains non-letter or digit characters.
IllegalMapSourcePropertyValueException	IllegalMapSourcePropertyValueException is thrown when a property value is illegal.

Package us.zuercher.gpx2map.source Description

The package us.zuercher.gpx2map.source provides a map source factory, abstract base classes useful when writing a new map source, and helper classes useful for downloading and converting map tiles.

Each map source should be contained in its own package and must contain a concrete subclass of SourceFactory with a specific name. See SourceFactory for details. See also us.zuercher.gpx2map.source.terraserver_usa for an example implementation.

The abstract base class AbstractTiledUrlMapSource should be used as the base class for new map source implementations that are based on map tiles.

Any map source that caches map data (tiles or otherwise) should extend AbstractCachedMapSource. The cache directory given to that interface is the root directory for caches maintained by all map sources. A caching map source should create a subdirectory under the cache directory using its package name (e.g. terraserver_usa). The map source may then store its cache data in any format beneath that directory.

The Terraserver USA map source, for example, creates a directory structure typeT/scaleS/zZ/xX representing the map type, scale, UTM zone, and tile X coordinate, respectively. Map tiles are stored in files named after the tile's Y coordinate. Because the Terraserver USA map source uses AbstractTiledUrlMapSource, map tiles are automatically converted to gzipped PPM files.

Author	$Author: stephan $
Version	$Id: package.html 171 2006-01-14 17:22:52Z stephan $
Copyright	Copyright (C) 2005-2005 Stephan Zuercher