You are here: start » dev » gisapi

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
dev:gisapi [2008/06/23 08:46]
richard typo 		dev:gisapi [2009/07/06 20:36] (current)
Line 71: Line 71:
  
  
-==== GSoC Interfaces (Under Developement)  ==== 
  
-=== GIS key values ===+ 
 + 
 + 
 + 
 + 
 + 
 + 
 +====== GSoC Interfaces (Under Developement)  ====== 
 + 
 +The Following is implemented in /inc/lib_gis/gis_fns.inc (More information on each function can be seen there). 
 + 
 +===== GIS key values =====
  
 Key values to use when passing associative key arrays in 'shn_gis_create_*' and 'shn_gis_get_*' functions for features. Key values to use when passing associative key arrays in 'shn_gis_create_*' and 'shn_gis_get_*' functions for features.
Line 80: Line 90:
 |== Required for create      |         |                         |  | |== Required for create      |         |                         |  |
 |'f_type'          |=> [str] |point                    |[Feature type use one of ('point', 'line' 'poly')]| |'f_type'          |=> [str] |point                    |[Feature type use one of ('point', 'line' 'poly')]|
-|'f_coords'        |=> [str] |x,y,z,wkt(POINT(x y z))  |[Coordinates center point then coords in wkt(x y z) format ]|+|'f_coords'        |=> [str] |x,y,z,wkt{POINT(x y z)}  |[Coordinates center point then coords in wkt(x y z) format ]|
 |== Optional for create      |         |                         |  | |== Optional for create      |         |                         |  |
 |'f_uuid'          |=> [str] |ql5yg-1                  |[uuif of feature !!! IMPORTANT IT IS RECOMENDED THIS KEY IS NOT USED IN create fns !!!]|  |'f_uuid'          |=> [str] |ql5yg-1                  |[uuif of feature !!! IMPORTANT IT IS RECOMENDED THIS KEY IS NOT USED IN create fns !!!]| 
Line 93: Line 103:
 |'f_event_date'    |=> [str] |2008-06-15 15:05:20      |[Date of event which marker represents]| |'f_event_date'    |=> [str] |2008-06-15 15:05:20      |[Date of event which marker represents]|
 |'f_extended_data' |=> [str] |blaa blaa'               |[Any extended data associated with point (sahana specific)]| |'f_extended_data' |=> [str] |blaa blaa'               |[Any extended data associated with point (sahana specific)]|
 +|'f_url_view'      |=> [str] |                         |[A Link to view a feature/item in the owners module]|
 +|'f_url_edit'      |=> [str] |                         |[A Link to edit a feature/item in the owners module]|
 +|'f_url_delete'    |=> [str] |                         |[A Link to delete a feature/item in the owners module]|
 +
 +
 +
 +==== Code for key values ====
 +
 +  $keys = array(  
 +     'f_uuid'          => '',
 +     'f_class'         => '',
 +     'f_type'          => '',
 +     'f_projection'    => '',
 +     'f_coords'        => '',  
 +     'f_module_item'   => '',
 +     'f_name'          => '',
 +     'f_description'   => '',
 +     'f_author'        => '',
 +     'f_url'           => '',
 +     'f_address'       => '',
 +     'f_event_date'    => '',
 +     'f_extended_data' => '',
 +     'f_url_view'      => '',
 +     'f_url_edit'      => '',
 +     'f_url_delete'    => ''
 +  );
 +
 +Alternately when asking for keys you can just use
 +
 +  $keys = array('all' => '1');
 +
 +To retrieve all the fields eg:
 +
 +  $keys = array('all' => '1');
 +  shn_gis_get_features_uuid('somefeatureuuid', $keys)
 +
 +
 +===== Database interfaces =====
 +
 +==== Feature Related ====
 +
 +=== Creating a Feature ===
 +
 +  ...
 +  shn_gis_create_feature($keys_)
 +  ...
 +
 +Creates GIS feature from array of associative keys see above.
 +\\
 +
 +=== Removing a Feature ===
 +
 +  ...
 +  shn_gis_remove_feature($feature_uuid_)
 +  ...
 +
 +Removes a feature, associated metadata data and feature_to_layer refs.
 +\\
 +
 +=== Removing a Feature using an external module item as a refrence [External modules are especially likely to use this function] === 
 +
 +  ...
 +  shn_gis_remove_feature_module_item($f_module_item_) 
 +  ...
 +
 +Removes a feature, associated metadata data and feature_to_layer refs useing external module item uuid.
 +\\
 +
 +===  Modifying A Feature ===
 +
 +  ...
 +  shn_gis_modify_feature($uuid_, $keys_) 
 +  ...
 +
 +Modifys a GIS feature from array of associative keys see above.
 +\\
 +
 +=== Modifying A Feature using an external module item as a refrence [External modules are especially likely to use this function] ===
 +
 +  ...
 +  shn_gis_modify_feature_module_item($f_module_item_, $keys_)
 +  ...
 +
 +Modifys a GIS feature from array of associative keys see above (uses f_module_item_ as uuid to search for entry).
 +\\
 +
 +
 +==== Feature Gets ====
 +
 +=== By Feature UUID === 
 +
 +  ...
 +  shn_gis_get_features_uuid($uuid_, $keys_)
 +  ...
 +
 +returns features corresponding to the features uuid
 +\\
 +
 +=== By External Module Item UUID [External modules are especially likely to use this function] ===
 +
 +  ...
 +  shn_gis_get_features_item_ref($item_uuid_, $keys_)
 +  ...
 +
 +returns a multidimensional array containing all fields specified by keys of all features with a f_module_item refrerence uuid = $item_uuid.
 +\\
 +
 +=== Get All Features ===
 +
 +  ...
 +  shn_gis_get_features_all($keys_)
 +  ...
 +
 +returns a multidimensional array containing all fields specified by keys of all features.
 +\\
 +
 +=== Get Features Belonging To A Particular Feature Class ===
 +
 +  ...
 +  shn_gis_get_features_feature_class($class_uuid_, $keys_)
 +  ...
 +
 +returns a multidimensional array containing all fields specified by keys of all features in class specified by $class_uuid_.
 +\\
 +
 +=== Get Features Belonging To A Particular Layer ===
 +
 +  ...
 +  shn_gis_get_features_layer($layer_uuid_, $keys_)
 +  ...
 +
 +returns a multidimensional array containing all fields specified by keys of all features in layer specified by $layer_uuid_.
 +\\
 +
 +=== Get Features Within A Radius Of A Particular Point ===
 +
 +  ...
 +  shn_gis_get_features_in_radius($keys_, $lat_, $lon_, $radius_)
 +  ...
 +
 +Returns an array of all the features within the radius specified by $radius_ of the point specified by $lat_ and $lon_. ($keys for which fields to return)
 +\\
 +
 +=== Specific Search useng a number of values === 
 +
 +  ...
 +  shn_gis_get_features_other($keys_, $layer_, $class_, $author_name_, $date_from_, $date_to_, $feature_name_)
 +  ...
 +
 +returns a multidimensional array containing all fields specified by keys of all features using other atts as search values. To ignore any of the attributes in the search enter $att = ''  
 +\\
 +
 +
 +
 +==== Feature Class Related ====
 +
 +=== Create a New Feature Class ===
 +  ...
 +  shn_gis_create_feature_class($module_ref_, $category_, $name_, $description_, $icon_, $color_)
 +  ...
 +
 +Creates a new feature_class. \\ \\
 +
 +** NOTE: This function will be recoded in the near future to take a key entry of values such **:\\
 +
 +  ...
 +  $keys = array(
 +               'c_module_ref' => 'mod item uuid',
 +               'c_name' => 'a name',
 +               'c_description' => 'a desc',
 +               'c_icon' => 'a hard link to an icon',
 +               'c_color' => 'the color of line/poly',
 +          ); 
 +  
 +  shn_gis_create_feature_class($keys)
 +  ...
 +
 +
 +\\
 +
 +=== Remove a Feature Class ===
 +
 +  ...
 +  shn_gis_remove_feature_class($feature_class_uuid_, $options_)
 +  ...
 +
 +  * opt 1 - Fail if features exist with this feature class otherwise remove.
 +  * opt 2 - Remove feature class and set existing features with feature_class_uuid to default class.
 +  * opt 3 - Remove existing feature with this class then remove class.
 +  * default - use opt 1
 +
 +If you are building this into a module be carfull not to remove any feature classes that are registored to another module (they will have $module_ref_ set).
 +\\
 +
 +=== Modify A Feature Class ===
 +
 +  ...
 +  shn_gis_modify_feature_class($uuid_, $keys_)
 +  ...
 +
 +Modifys a Feature Class, Enter new values as key value.
 +\\
 +
 +=== Return All The Feature Classes ===
 +
 +  ...
 +  shn_gis_get_feature_class_all()
 +  ...
 +
 +Returns all feature classes in the system.
 +\\
 +
 +=== Return A Feature Class by its UUID ===
 +
 +  ...
 +  shn_gis_get_feature_class_uuid($feature_class_uuid_)
 +  ...
 +
 +Returns data about a feature class (see code for more details).
 +\\
 +
 +
 +==== Layer Related ====
 +
 +=== Create A New Layer ===
 +  ...
 +  shn_gis_create_layer($name_, $description_)
 +  ...
 +
 +Creates a new layer\\ \\
 +
 +** NOTE: This function will be recoded in the near future to take a key entry of values such **:\\
 +
 +  ...
 +  $keys = array(
 +               'l_name' => 'a name',
 +               'l_description' => 'a desc'
 +          ); 
 +  
 +  shn_gis_create_layer($keys)
 +  ...
 +
 +\\
 +
 +=== Remove A Layer ===
 +
 +  ...
 +  shn_gis_remove_layer($layer_uuid_, $options_)
 +  ...
 +
 +  * opt 1 - Fail if features exist within this layer otherwise remove.
 +  * opt 2 - Remove layer and references only.
 +  * opt 3 - Remove layer, layer references and all features that are in this layer.
 +  * default - use opt 1
 +\\
 +
 +=== Add Features To A Layer ===
 +
 +  ...
 +  shn_gis_insert_layer_features($layer_uuid_, $features_uuid_)
 +  ...
 +
 +Add tie between a number of features and a layer.
 +\\
 +
 +=== Remove Features From A Layer ===
 +
 +  ...
 +  shn_gis_remove_layer_features($layer_uuid_, $features_uuid_)
 +  ...
 +
 +Removes tie between a number of features and a layer.
 +\\
 +
 +=== Add A Feature Class To A Layer ===
 +
 +  ...
 +  shn_gis_insert_layer_feature_class($layer_uuid_, $feature_classes_uuid_)
 +  ...
 +
 +Add tie between a number of feature_classes and a layer.
 +\\
 +
 +=== Remove A Feature Class From A Layer ===
 +
 +  ...
 +  shn_gis_remove_layer_feature_class($layer_uuid_, $feature_classes_uuid_)
 +  ...
 +
 +Removes tie between a number of feature classes and a layer
 +\\
 +
 +=== Get All Layers ===
 +
 +  ...
 +  shn_gis_get_layers_all()
 +  ...
 +
 +Returns all layers as an array of arrays such:
  
 +  array(
 +        array(
 +              l_uuid' => 'a uuid',
 +             'l_name' => 'a name',
 +             'l_description' => 'a desc'
 +        ),
 +        array(
 +              l_uuid' => 'a uuid',
 +             'l_name' => 'a name',
 +             'l_description' => 'a desc'
 +        )
 +  )
 +\\
  
-=== Code for key values ===+=== Get A Layer By Its UUID ===
  
-        $keys_ = array(   +  ... 
-          'f_uuid'          => '', +  shn_gis_get_layers_uuid($layer_uuid_) 
-          'f_class'         => '', +  ...
-          'f_type'          => '', +
-          'f_projection'    => '', +
-          'f_coords'        => '',   +
-          'f_module_item'   => '', +
-          'f_name'          => '', +
-          'f_description'   => '', +
-          'f_author'        => '', +
-          'f_url'           => '', +
-          'f_address'       => '', +
-          'f_event_date'    => '', +
-          'f_extended_data' => '' +
-        );+
  
-=== Database interfaces ===+Returns a specific layer using the layers uuid a search value.
  
-**Feature Related**+  ... 
 +  shn_gis_get_layers_feature_class($feature_class_uuid_) 
 +  ...
  
-    * shn_gis_create_feature($keys_) +Returns layers that a feature class is registered to. 
-      * Creates GIS feature from array of associative keys see above. +\\
-    * shn_gis_remove_feature($feature_uuid_) +
-      * Removes a feature, associated metadata data and feature_to_layer refs. +
-    * shn_gis_modify_feature($uuid_, $keys_) +
-      * Modifys a GIS feature from array of associative keys see above. +
-    * shn_gis_modify_feature_module_item($f_module_item_, $keys_) +
-      *  Modifys a GIS feature from array of associative keys see above (uses f_module_item_ as uuid to search for entry).+
  
-**Feature Gets**+=== Return All Feature Classes In A Layer ===
  
 +  ...
 +  shn_gis_get_feature_classes_layer($layer_uuid_, $options)
 +  ...
  
-    * shn_gis_get_features_all($keys_) +      * opt 1 - Returns all class uuids registered to layer 
-      * returns a multidimensional array containing all fields specified by keys of all features. +      * opt 2 - Returns all classes uuids registered to layer as well as classes of features in that layer. 
-    * shn_gis_get_features_feature_class($class_uuid_, $keys_) +\\
-      * returns a multidimensional array containing all fields specified by keys of all features in class specified by $class_uuid_. +
-    * shn_gis_get_features_layer($layer_uuid_, $keys_) +
-      * returns a multidimensional array containing all fields specified by keys of all features in layer specified by $layer_uuid_. +
-    * shn_gis_get_features_item_ref($item_uuid_, $keys_) +
-      * returns a multidimensional array containing all fields specified by keys of all features with a f_module_item refrerence uuid = $item_uuid.+
  
 +==== Extras ====
  
-**Feature Class Related**+=== Decode A Coordinate String To Array ===
  
-    * shn_gis_create_feature_class($module_ref_, $category_, $name_, $description_, $icon_, $color_) +  ... 
-      * Creates a new feature_class. +  shn_gis_coord_decode($coords) 
-    * shn_gis_remove_feature_class($feature_class_uuid_, $options_) +  ...
-      * opt 1 - Fail if features exist with this feature class otherwise remove. +
-      * opt 2 - Remove feature class and set existing features with feature_class_uuid to default class. +
-      * opt 3 - Remove existing feature with this class then remove class. +
-      * default - use opt 1+
  
-**Layer Related**+given a coord string decodes values into 2 dim array (see doc in code for more details). 
 +\\  
  
-    * shn_gis_create_layer($name_, $description_) +=== Encode A Coordinate Array To String === 
-      * Creates a new layer +  ... 
-    * shn_gis_remove_layer($layer_uuid_, $options_) +  shn_gis_coord_encode($coords, $type) 
-      * opt 1 - Fail if features exist within this layer otherwise remove. +  ...
-      * opt 2 - Remove layer and references only. +
-      * opt 3 - Remove layer, layer references and all features that are in this layer. +
-      * default - use opt 1      +
-    * shn_gis_insert_layer_features($layer_uuid_, $features_uuid_) +
-      * Add tie between a number features and a layer. +
-    * shn_gis_remove_layer_features($layer_uuid_, $features_uuid_) +
-      * Removes tie between a number of features and a layer.+
  
-**Extras** +given 2 dim array of coords encodes string (see doc in code for more details). 
-    * shn_gis_coord_decode($coords) +\\
-      * given a coord string decodes values into 2 dim array (see doc in code for more details). +
-    * shn_gis_coord_encode($coords, $type) +
-      * given 2 dim array of coords encodes string (see doc in code for more details). +
-    * \\ +
-      * \\+
  

Trace:

Navigation
QR Code
QR Code dev:gisapi (generated for current page)