MAP::CloudMadeMapSource Class Reference

A map source using map tile servers at CloudMade (cloudmade.com). More...

#include <MAP/CloudMadeMapSource.h>

Inheritance diagram for MAP::CloudMadeMapSource:

List of all members.

Public Member Functions
	CloudMadeMapSource (int style)
int	getTileSize () const
int	getMagnificationMin () const
int	getMagnificationMax () const
int	getStyle () const
void	setStyle (int style)
void	getTileUrl (char *buffer, MapTileCoordinate tileXY)
MapTileCoordinate	lonLatToTile (LonLat lonlat, MagnificationType magnification)
PixelCoordinate	lonLatToPixel (LonLat lonlat, MagnificationType magnification)
LonLat	tileCenterToLonLat (const int tileSize, const MapTileCoordinate &tile, const double offsetX, const double offsetY)
void	requestTile (IMapSourceListener *listener, const MapTileCoordinate tileXY)
void	requestJobComplete (IMapSourceListener *listener)
void	clearQueue ()
int	getTileCount ()
void	finishedDownloading (Downloader *downloader, MAHandle data)
void	downloadCancelled (Downloader *downloader)
void	error (Downloader *downloader, int code)
virtual void	notifyProgress (Downloader *downloader, int downloadedBytes, int totalBytes)
virtual bool	outOfMemory (Downloader *downloader)
Static Public Attributes
static const char *	ApiKey

---

Detailed Description

A map source using map tile servers at CloudMade (cloudmade.com).

CloudMade requires the developer to register to get an API key. See http://www.cloudmade.com for more details.

---

Constructor & Destructor Documentation

MAP::CloudMadeMapSource::CloudMadeMapSource

(

int

style

)

[inline]

---

Member Function Documentation

int MAP::CloudMadeMapSource::getTileSize

(

)

const [inline, virtual]

Returns tile size in pixels.

Implements MAP::MapSource.

int MAP::CloudMadeMapSource::getMagnificationMin

(

)

const [inline, virtual]

Returns minimum magnification

Implements MAP::MapSource.

int MAP::CloudMadeMapSource::getMagnificationMax

(

)

const [inline, virtual]

Returns maximum magnification

Implements MAP::MapSource.

int MAP::CloudMadeMapSource::getStyle

(

)

const [inline]

Returns style setting for the CloudMade map source.

void MAP::CloudMadeMapSource::setStyle

(

int

style

)

[inline]

Sets style setting for the CloudMade map source. Refer to CloudMade documentation for more information.

void MAP::CloudMadeMapSource::getTileUrl	(	char *	buffer,
		MapTileCoordinate	tileXY
	)		[virtual]

Creates a URL for the specified tile coordinate.

Implements MAP::MapSource.

MapTileCoordinate MAP::CloudMadeMapSource::lonLatToTile	(	LonLat	lonlat,
		MagnificationType	magnification
	)		[virtual]

Converts a LonLat coordinate to a tile coordinate.

Implements MAP::MapSource.

PixelCoordinate MAP::CloudMadeMapSource::lonLatToPixel	(	LonLat	lonlat,
		MagnificationType	magnification
	)		[virtual]

Converts a LonLat coordinate to a global pixel coordinate.

Implements MAP::MapSource.

LonLat MAP::CloudMadeMapSource::tileCenterToLonLat	(	const int	tileSize,
		const MapTileCoordinate &	tile,
		const double	offsetX,
		const double	offsetY
	)		[virtual]

Convert tile center plus pixel offset to LonLat.

Implements MAP::MapSource.

void MAP::MapSource::requestTile	(	IMapSourceListener *	listener,
		const MapTileCoordinate	tileXY
	)		[inherited]

Returns all tiles required to cover specified rectangle around centerpoint.

void MAP::MapSource::requestJobComplete

(

IMapSourceListener *

listener

)

[inherited]

void MAP::MapSource::clearQueue

(

)

[inherited]

Clears any queued requests

int MAP::MapSource::getTileCount

(

)

[inline, inherited]

void MAP::MapSource::finishedDownloading	(	Downloader *	downloader,
		MAHandle	data
	)		[virtual, inherited]

Called when all data has been downloaded.

Parameters:

downloader	A pointer to the downloader sending this event.
data	MAHandle to the binary data resource with the downloaded data. It is the responsibility of the application to free the data handle once it is not needed (use maDestroyObject() for this). In case a handle was supplied to beginDownloading() the data parameter will refer to that handle.

Implements MAUtil::DownloadListener.

void MAP::MapSource::downloadCancelled

(

Downloader *

downloader

)

[virtual, inherited]

Called if the download has been cancelled.

Parameters:

downloader

A pointer to the downloader sending this event.

Implements MAUtil::DownloadListener.

void MAP::MapSource::error	(	Downloader *	downloader,
		int	code
	)		[virtual, inherited]

Called if an error occured.

Parameters:

downloader	A pointer to the downloader sending this event.
code	The error code describing the error. See CONNERR .

Implements MAUtil::DownloadListener.

virtual void MAUtil::DownloadListener::notifyProgress	(	Downloader *	downloader,
		int	downloadedBytes,
		int	totalBytes
	)		[virtual, inherited]

Called when some data has been downloaded to notify about the progress of the download.

Parameters:

downloader	A pointer to the downloader sending this event.
downloadedBytes	The amount of bytes downloaded.
totalBytes	The amount of bytes to be downloaded. Zero means that the total content length is unknown.

virtual bool MAUtil::DownloadListener::outOfMemory

(

Downloader *

downloader

)

[virtual, inherited]

Called if the Downloader runs out of memory. Try to free some resource memory. If you managed to free some, return true to make the Downloader try again. If you can't free any more, return false to make the Downloader fail with CONNERR_DOWNLOADER_OOM. The default implementation does nothing and returns false. Note: This feature is not yet implemented, outOfMemory() is never called by download framework.

---

Member Data Documentation

const char* MAP::CloudMadeMapSource::ApiKey [static]

API key for use in calls to CloudMade tile servers. See cloudmade.com for more details.