MapTap Client API

This API allows any program to use MapTap Atlas to draw a map on a PalmOS device. It requires that MapTap Atlas version 2.0 or higher already be installed on the PDA, together with whatever data layers are appropriate. The API is free to use, but MapTap Atlas still must be licensed.

To use this API, include maptapClient.c in your project, and include maptapClient.h into the source file for the functions that call MapTap.

Specific calls in the API are documented in maptapClient.h. But here's the sequence in a nutshell:

if (MaptapAtlasPresent()) {
	MaptapSetTitle("my cool map");
	MapTapDefineMap(-122., 48., 10000000., MaptapUSA);
	MapTapLaunchAtlas('strt');
}

This will cause MapTap Atlas to show a US map centered on Seattle, at a scale of 1:10000000, with a Mercator projection.

'strt' is the creator code of the calling app; substitute your own creator code. You don't have to set a title.

Possible enhancements, depending on requests:

specify the layers drawn on the map.
specify the map projection.
pass user points/labels to be plotted.
draw a raster map under the map.

A sample calling app, and the API source code, are available at http://www.mobilegeographics.com/maptapClient/.

MapTap Atlas is available at http://www.mobilegeographics.com/maptap/.

The files:

maptapClient.h (include in each file that calls MapTap)
maptapClient.c (include once in each project that uses MapTap)
the two MapTap Client C files, plus a README file, are available at maptapClient.sit and maptapClient.zip.
a sample calling program, mapCaller.prc. Source is also available: available at mapcaller.sit and mapcaller.zip. MapCaller.prc was built on a Mac running Codewarrior 8.

Mobile Geographics LLC <webmaster@mobilegeographics.com>

Last modified: Thu Sep 4 08:48:42 PDT 2003