This section describes how to create data source objects for:

ESRI Shapefile

When you create a Shapefile format data source the shapefiles can be loaded with or without the tiling mechanism. When using tiling, the data is loaded in a background thread.

Loading a Shapefile Using Tiling

To load a shapefile using tiling, use the following code:

IlvTiledShapeDataSource tiledSource = new IlvTiledShapeDataSource(shpFileName,true);

If the shape file does not have a tiling index file, you can create the index file as follows:

IlvShapeFileTiler tiler = new IlvShapeFileTiler(shpFileName, shxFileName, indexFileName, tileWidth, tileHeight);
while(tiler.getNextFeature() != null) {
  tiler.addInfo();
}
tiler.close();

The resulting index file, which is used in the reader, can be set with a call to:

tiledSource.setIdxFilename(idxFileName);

Loading a Shapefile Without Using Tiling

To load a shapefile without using tiling, use the following code:

IlvShapeDataSource shpDataSource = new IlvShapeDataSource(shpFileName, true); 

MID/MIF

To create a MID/MIF data source, use the following code:

IlvMapDataSource source = new IlvMIDMIFDataSource(fileName);
source.setManager(getView().getManager());     

TIGER/Line

To create a TIGER/Line data source, use the following code:

IlvTigerDataSource source = new IlvTigerDataSource(fileName);
source.setManager(getView().getManager());

source.setCFCCCodeList(CFCCCodes);

DXF (AutoCAD) Files

The DXF format (Drawing Interchange Format) is the interchange format for AutoCAD. This format supports vector graphics (polygons, arcs, lines, points...) and layers.

Limitations

Reading DXF

To create a DXF data source, use the following code:

IlvDXFDataSource source = new IlvDXFDataSource("C:/maps/DXF/maps.dxf");
source.setManager(getView().getManager());

You must then setup the transformation you want to use to read DXF.

If you want to transform the DXF extent into the latitude/longitude range provided:

source.setDestinationBounds(lonMinRad,latMinRad,lonMaxRad,latMaxRad);

or

If you want to use a more complex transformation (such as reprojection):

IlvMathTransform mathTransform =.../create mathematical transformation
   source.setInternalTransformation(mathTransform);

An example of how to create a complex transformation is given in the Map Builder demonstration, through use of the DXFControlModel class.

KML or KMZ

KML is an XML-based numerical map format containing both vectorial and raster information. KML is published by Google, for use in their Google Earth© Product.

KML files can refer to other files, either locally or through a network link URL. KMZ is a zipped file containing a single doc.xml entry and a set of auxiliary files, such as images or icons.

To create a KML data source, use the following code:

IlvKMLDataSource source = new IlvKMLDataSource("C:/maps/KML/places.kmz");
source.setManager(getView().getManager());

SVG Files

Limitations

The maps SVG reader ignores the following SVG elements:

The graphic styles in the resulting map are renderedto look as close as possible to the original version. However, the styles created are limited to the data available for styling such an object.

Reading SVG

To create a SVG data source, use the following code:

IlvSVGDataSource source = new IlvSVGDataSource("C:/maps/SVG/maps.svg");
source.setManager(getView().getManager());

You then need to setup the transformation you want to use to read SVG. To transform the SVG extent into the latitude/longitude range provided, call:

source.setDestinationBounds(lonMinRad,latMinRad,lonMaxRad,latMaxRad);

To use a more complex transformations such as reprojection, call:

IlvMathTransform mathTransform = //create mathematical transformation
source.setInternalTransformation(mathTransform);