com.nutiteq
Class MapComponent

java.lang.Object
  com.nutiteq.BaseMapComponent
      com.nutiteq.BasicMapComponent
          com.nutiteq.MapComponent

All Implemented Interfaces:

com.nutiteq.maps.MapTilesRequestor, com.nutiteq.net.DownloadHandler, DisplayUpdater, com.nutiteq.ui.Pannable

public class MapComponent
extends BasicMapComponent
implements com.nutiteq.maps.MapTilesRequestor

An extension for BasicMapComponent initialized with basic default values.

Default caching strategy for currently supported features:

• 128 * 1024 bytes memory cache for map tiles and icons used in KML
• A record store cache for KML icons and map tiles. Record store name prefix is "ML_NETWORK_CACHE", and cache is spread over 5 stores with size of 64 * 1024 bytes.

Field Summary

Fields inherited from class com.nutiteq.BasicMapComponent

FINGER_CLICK_TOLERANCE, STYLUS_CLICK_TOLERANCE

Constructor Summary

MapComponent(java.lang.String licenseKey, javax.microedition.midlet.MIDlet midlet, int width, int height, WgsPoint middlePoint, int zoom)
Constructor for map display object.

MapComponent(java.lang.String licenseKey, java.lang.String vendor, java.lang.String appname, int width, int height, WgsPoint middlePoint, int zoom)
Constructor for map display object.

Method Summary

void	enableDownloadCounter() Enable network traffic counter using default implementation ( NutiteqDownloadCounter).
void	enableDownloadDisplay() Enable network traffic overlay using default implementation for painting ( NutiteqDownloadDisplay).
void	showDefaultCursor() Show default cursor (red cross) on screen.
void	showDefaultOnScreenZoomControls() Show default zoom controls with +/- in upper left corner.
void	showZoomLevelIndicator(boolean showInicator) Show map zoom scale after zoom action.
void	startMapping() Initialize needed resources for mapping and start internal threads.

Methods inherited from class com.nutiteq.BasicMapComponent

addKmlService, addLine, addLines, addOnMapElements, addOnMapElements, addPlace, addPlaces, addPlaces, addPolygon, addPolygons, defineControlKey, enqueue, enqueueDownload, focusOnPlace, getAdditionalInfo, getAllRequiredTiles, getBoundingBox, getCenterPoint, getDownloadCounter, getErrorListener, getHeight, getInternalMiddlePoint, getKmlPlaces, getKmlServices, getLibraryLog, getMap, getMapListener, getMapPosition, getMiddlePoint, getOnMapElementListener, getPlaceListener, getRequiredTile, getScreenLeft, getScreenTop, getZoom, getZoomRange, getWidth, getVisiblePlaces, keyPressed, keyReleased, keyRepeated, looseFocusOnDrag, loosePlaceFocus, moveMap, moveMap, paint, paintAt, panMap, pointerDragged, pointerPressed, pointerReleased, removeAllPlaces, removeKmlService, removeLine, removeLines, removeLocationSource, removeOnMapElements, removePlace, removePlaces, removePolygon, removePolygons, removeZoomDelay, repaint, repaint, replacePlaces, requiresMoreTiles, resize, setBoundingBox, setControlKeysHandler, setCursor, setDownloadCounter, setDownloadDisplay, setDownloadStreamOpener, setErrorListener, setFileSystem, setLicense, setLocationSource, setMap, setMapListener, setMiddlePoint, setMiddlePoint, setMiddlePoint, setNetworkCache, setOnMapElementListener, setOnScreenZoomControls, setPanningStrategy, setPlaceListener, setScreenBounds, setScreenCenter, setScreenPosition, setSize, setZoom, setZoomLevelIndicator, setTileSearchStrategy, setTouchClickTolerance, stopMapping, zoomIn, zoomLevelIndicatorCheck, zoomOut, tileRetrieved, updateTile

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.nutiteq.maps.MapTilesRequestor

getAllRequiredTiles, getRequiredTile, requiresMoreTiles, tileRetrieved, updateTile

Constructor Detail

MapComponent

public MapComponent(java.lang.String licenseKey,
                    java.lang.String vendor,
                    java.lang.String appname,
                    int width,
                    int height,
                    WgsPoint middlePoint,
                    int zoom)

Constructor for map display object. Defines available paint area (width, height), middle point for map display at start (defined in WGS84), and zoom level at start.

Parameters:

licenseKey - License key issued by Nutiteq LLC

vendor - Vendor name used by library for license check

appname - Application name used by library for license check

width - map view width

height - map view height

middlePoint - middle point at start (defined in WGS84)

zoom - zoom level at start

MapComponent

public MapComponent(java.lang.String licenseKey,
                    javax.microedition.midlet.MIDlet midlet,
                    int width,
                    int height,
                    WgsPoint middlePoint,
                    int zoom)

Constructor for map display object. Defines available paint area (width, height), middle point for map display at start (defined in WGS84), and zoom level at start.

Parameters:

licenseKey - License key issued by Nutiteq LLC

midlet - MIDlet class for the application. Used by library for reading midlet name and vendor from jad for license verification.

width - map view width

height - map view height

middlePoint - middle point at start (defined in WGS84)

zoom - zoom level at start

Method Detail

startMapping

public void startMapping()

Initialize needed resources for mapping and start internal threads. This is a required step for application

Overrides:

startMapping in class BasicMapComponent

showZoomLevelIndicator

public void showZoomLevelIndicator(boolean showInicator)

Show map zoom scale after zoom action. For default no zoom indicator is shown. This method overwrites values set in BasicMapComponent.setZoomLevelIndicator(com.nutiteq.ui.ZoomIndicator) with DefaultZoomIndicator (when showIndicator is true) or with null (no indicator is used).

Parameters:

showInicator - should the zoom indicator be shown

enableDownloadCounter

public void enableDownloadCounter()

Enable network traffic counter using default implementation ( NutiteqDownloadCounter).

enableDownloadDisplay

public void enableDownloadDisplay()

Enable network traffic overlay using default implementation for painting ( NutiteqDownloadDisplay).

showDefaultOnScreenZoomControls

public void showDefaultOnScreenZoomControls()

Show default zoom controls with +/- in upper left corner. Use default library implementation OnScreenZoomControls with image '/images/m-l-controlls.png' from library resources.

showDefaultCursor

public void showDefaultCursor()

Show default cursor (red cross) on screen.

Note: without setting cursor here or with BasicMapComponent.setCursor(com.nutiteq.ui.Cursor) places/map can't be clicked on handsets without touch screen.