Map.addGeometry Function

Format

geometryId = map_name.addGeometry(geometry_name);

Description

The Map.addGeometry function adds the vector data (points, lines, and polygons) contained in geometry_name to the Map object named map_name. The vector data will be drawn on the map in a layer on top of the base map. Points are rendered as markers while lines and polygons are drawn as lines and polygons. The vector data may be loaded from a GeoJSON file using the function Geometry.load or traced by the interviewer using the Geometry.tracePolygon or Geometry.walkPolygon functions.

Loading very large GeoJSON files can be slow and may exceed the memory of the device. In some cases it may be necessary to break up large GeoJSON files into smaller files. For example, rather than using a single file containing geometry for an entire country, create smaller files for the geometry in each district and then load only the file for the district that the interviewer is currently working in. Alternatively, rather than using geometry you can save the vector data in a custom base map.

Return Value

The function returns the identifier of the new geometry which may be used in subsequent calls to Map.removeGeometry to delete the geometry from the map.

Example

// Declare a map
Map mymap;

// Load geometry from a file
Geometry boundary;
boundary.load("boundary.geojson");

// Add geometry to the map
numeric geometryId = mymap.addGeometry(boundary);

// Show the map
mymap.show();