[[TOC]] = Location & GIS User Guidelines = The GIS Mapping homepage is at http://127.0.0.1:8000/eden/gis/index This provides an embedded map with links to view a fullscreen map, add/edit Locations &, for users with the MapAdmin role, add/edit the layers on the map (Service Catalogue). == 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 (Features) == http://127.0.0.1:8000/eden/gis/location/ * A Location (or 'Feature' in GIS terminology) represents a physical location. * It can be a point (!Lat/Lon), Line or !Area/Polygon (WKT) * This can be referenced from other records such as: * Sites * /pr/person/presence (the current location of a person) === Location Types === ==== Administrative Locations ==== * Example: * Countries * Provinces * Districts * Cities * Towns * Villages ==== Sites ==== * Example: * Offices * Warehouses * Shelters * Hospitals * Sites can have: * Staff assigned to them * Inventory Functionality * The Location name would typically be the name of the Building * Multiple sites can share a single location, eg. A single building (location) could house multiple offices for different organisations. * Where a Site has multiple Buildings, then these can be represented via a Location Group ==== Miscellaneous Locations ==== * Example: * The location of wells * The location of food distributions (middle of a field, corner of 2 streets) * The location of a damaged bridge * The location of a stranded person === 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. == 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://test.sahanafoundation.org/eden/gis/location?parent_=Pakistan (all Locations whose direct parent is 'Pakistan') * 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