= The Situation Mapping User Guide =
Visit the GIS Mapping homepage at http://127.0.0.1:8000/eden/gis/index

== Map Settings ==
Default settings for all users can be set from the '''Map Service Catalogue''':
 * http://127.0.0.1:8000/eden/gis/config/1/update

If a user wishes their own settings, then they can be set via their '''Personal Data''' (on the user's menu) & then select the '''Map Settings''' tab.

 * [wiki:ConfigurationGuidelines#MappingOptions]
== Locations ==
=== Create a new Location: ===
http://127.0.0.1:8000/eden/gis/location/create

 1. Type in the '''Specific Name''' of the Location in the "Name" Field.
 2. Select the Type of Feature that your Location is from the "Feature Class" drop-down menu (the feature class determines the Marker).
 3. Select a Parent Location based on your '''Specific Location'''.
 4. Select a Marker for the Map based on your Location. - NOTE: SELECTION OF A MARKER WILL OVER-RIDE THE FEATURE CLASS MARKER ON THE MAP
 5. Select a Feature Type (Point, Line, or Polygon.)
 6. Enter in either the Well-Known Text for Line and Polygon or Latitude and Longitude for Point (Lat. and Long. will be in decimal degrees.)
  * NB Latitude is North/South, Longitude is East/West.
 7. Select "Save"

==== Conversion Tool Help ====
 1. Select the conversion tool
 2. Select either the "in GPS Format" tab or the "in Deg Min Sec Format" tab and enter in information.
  * GPS Format is 18° 32.5' (That would be entered "18" deg "32.5" min)
  * Deg Min Sec Format is 18° 32' 10" (That would be entered DD "18" MM "32" SS "10")
 3. Select "Calculate"
 4. Last, Select "Fill in xxx" (Choose either Lat. or Long.)
  * NB Latitude is North/South, Longitude is East/West.
 5. Repeat steps 1-4 again 

==== !AutoLocation Help ====
Some resources support detecting the location of the user automatically using HTML5's !GeoLocation feature (only available in newer browsers, such as Firefox 3.5 & Chrome).

If it doesn't get a good result (e.g. displays where you used to live or work rather then your current location) then you can improve the accuracy by updating the databases of !WiFi signals mapped to locations. If you move and take your wireless router with you, these services may not have the up-to-date information and will still associate your !WiFi signal with your old address. If you are experiencing this problem and need to update your location, please update both the [https://services.google.com/fb/forms/wifibugs/ Google] & [http://www.skyhookwireless.com/howitworks/submit_ap.php Skyhook Wireless] databases.

=== To edit a Location: ===
http://127.0.0.1:8000/eden/gis/location/

 1. Find the Location your wanting to edit (Either by searching or sorting by the attribute.)
 2. Click on the feature number.
 3. Edit in the box above.
 4. Select "Save"

=== Markers ===
http://127.0.0.1:8000/eden/gis/marker/

 * A Marker is the image used to represent a location on the map.

=== Locations ===
==== Locations (Features) ====
http://127.0.0.1:8000/eden/gis/location/

 * A Location (or 'Feature' in GIS terminology) can be a point (Lat/Lon), Line or Polygon (WKT)
 * This can be referenced from other tables such as:
  * /pr/person/presence
 * If there is a marker assigned directly to a Feature then that is how the Feature will show up on the map.

==== Feature Layers ====
http://127.0.0.1:8000/eden/gis/feature_layer

 * Feature Layers are used to provide Layers on the Map & Feeds for export/view by other systems
 * They are formed from a database query

==== Feature Classes ====
http://127.0.0.1:8000/eden/gis/feature_class

NB These are currently Deprecated - will come back in some form!

 * A Feature Class is a collection of Features of the same type
  * Share a comon Marker (unless over-ridden at the Feature level)
   * If no marker defined then the system default marker is used
  * Can be grouped together into Feature Groups
  * Link to a common resource for URLs & extra fields to pull into Map popups

=== Symbology sets ===
''tbc''
 * Symbology sets can be used to provide a set of Icons for Feature Classes based  on deployment requirements, e.g. US FEMA

=== Feeds ===
 * http://test.sahanafoundation.org/eden/gis/location?location.lat__gt=33&location.lat__lt=35&location.lon_gt=70.5&location.lon__lt=72.5
  * all locations +/- 1 degree from Peshawar
 * http://test.sahanafoundation.org/eden/hms/hospital?hospital.postcode__like=7%,8%,9%
 * http://test.sahanafoundation.org/eden/hms/hospital?hospital.postcode__unlike=7%
 * http://test.sahanafoundation.org/eden/hms/hospital?hospital.available_beds__gt=10
 * http://test.sahanafoundation.org/eden/hms/hospital?services.burn=True
 * http://test.sahanafoundation.org/eden/pr/person?identity.value__like=%XY%
 * http://test.sahanafoundation.org/eden/pr/person?address.location_id=1,3,65,2
 * http://test.sahanafoundation.org/eden/pr/person?address.location_id__ne=1,3,65,2
 * http://test.sahanafoundation.org/eden/pr/person?presence.presence_condition=99&presence.closed=False
 * http://127.0.0.1:8000/eden/gis/location.kml?parent_=UK (all Locations whose direct parent is 'UK')
 * http://127.0.0.1:8000/eden/gis/location.kml?marker=Water_Supply_Infrastructure_Theme_S1 (use the file {{{gis_marker.image.Water_Supply_Infrastructure_Theme_S1.png}}} as the marker )

=== Data ===
 * [wiki:UserGuidelinesGISData]

----
UserGuidelines