Changes between Version 27 and Version 28 of DeveloperGuidelines/GIS

Timestamp:

08/21/10 16:06:09 (14 years ago)

Author:

Fran Boon

Comment:

--

DeveloperGuidelines/GIS

@@ -30 +30 @@
               zoom = None,
               projection = None,
+              add_feature = False,
+              add_feature_active = False,
               feature_queries = [],
               feature_groups = [],
@@ -58 +60 @@
     @param zoom: default Zoom level of viewport (if not provided then the default setting from the Map Service Catalogue is used)
     @param projection: EPSG code for the Projection to use (if not provided then the default setting from the Map Service Catalogue is used)
+    @param add_feature: Whether to include a DrawFeature control to allow adding a marker to the map
+    @param add_feature_active: Whether the DrawFeature control should be active by default
     @param feature_queries: Feature Queries to overlay onto the map & their options (List of Dicts):
-                [{
-                 name   : "Query",      # A string: the label for the layer
-                 query  : query,        # A gluon.sql.Rows of gis_locations
-                 active : False,        # Is the feed displayed upon load or needs ticking to load afterwards?
-                 popup_url : None,      # The URL which will be used to fill the pop-up. it will be appended by the Location ID.
-                 marker : None          # The marker_id for the icon used to display the feature (over-riding the normal process).
-                                        # [Plan: Can be a lambda to vary icon (size/colour) based on attribute levels.]
-                }]
-            @param feature_groups: Feature Groups to overlay onto the map & their options (List of Dicts):
-                [{
-                 feature_group : db.gis_feature_group.name,
-                 parent : None,         # Only display features with this parent set. ToDo: search recursively to allow all descendants
-                 filter : None,         # A query to further limit which features from the feature group are loaded
-                 active : False,        # Is the feed displayed upon load or needs ticking to load afterwards?
-                 popup_url : None,      # The URL which will be used to fill the pop-up. it will be appended by the Location ID.
-                 marker : None          # The marker_id for the icon used to display the feature (over-riding the normal process).
-                                        # [Plan: Can be a lambda to vary icon (size/colour) based on attribute levels.]
-                }]
+        [{
+         name   : "Query",      # A string: the label for the layer
+         query  : query,        #A gluon.sql.Rows of gis_locations, which can be from a simple query or a Join. Extra fields can be added for 'marker' or 'shape' (with optional 'color' & 'size')
+         active : False,        # Is the feed displayed upon load or needs ticking to load afterwards?
+         popup_url : None,      # The URL which will be used to fill the pop-up. it will be appended by the Location ID.
+         marker : None          # The marker_id for the icon used to display the feature (over-riding the normal process).
+         }]
+    @param feature_groups: Feature Groups to overlay onto the map & their options (List of Dicts):
+        [{
+         feature_group : db.gis_feature_group.name,
+         parent : None,         # Only display features with this parent set. ToDo: search recursively to allow all descendants
+         filter : None,         # A query to further limit which features from the feature group are loaded
+         active : False,        # Is the feed displayed upon load or needs ticking to load afterwards?
+         popup_url : None,      # The URL which will be used to fill the pop-up. it will be appended by the Location ID.
+         marker : None          # The marker_id for the icon used to display the feature (over-riding the normal process).
+         }]
     @param wms_browser: WMS Server's GetCapabilities & options (dict)
         {
@@ -102 +104 @@
     @param public_url: pass from model (not yet defined when Module instantiated
     """
+}}}
+
+=== Variable Markers ===
+Example:
+{{{
+query = (db.gis_location.deleted == False)
+query = query & (db.gis_location.id == db["%s_%s" % (module, resource)].location_id)
+locations = db(query).select(db.gis_location.id, db.gis_location.uuid, db.gis_location.name, db.gis_location.wkt, db.gis_location.lat, db.gis_location.lon)
+for i in range(0, len(locations)):
+    locations[i].gis_location.shape = "circle"
+    locations[i].gis_location.size = locations[i][db["%s_%s" % (module, resource)].MyIntegerField]
 }}}
 == Guidelines for Developers wishing to extend the functionality of the core GIS ==