geometryId = map_name.addGeometry(geometry_name);
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.
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.
// 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();