Version 54 (modified by 14 years ago) ( diff ) | ,
---|
Table of Contents
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:
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.
Projections
There is inbuilt support for only 2 Projections: 4326 (WGS84 Lat/Lon) & 900913 ('Google' Spherical Mercator).
Support for more can be added via http://127.0.0.1:8000/eden/gis/projection.
These use Proj4js definitions in /static/scripts/gis/proj4js/lib/defs
If a definition doesn't yet exist for your Projection then you can download one from SpatialReference.org.
- Download the proj4js format & save as EPSGXXXX.js
Reference:
ToDo:
- Download these automatically (they have an easy to access URL)
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 should 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
- Type in the Specific Name of the Location in the "Name" Field.
- Select the Type of Feature that your Location is from the "Feature Class" drop-down menu (the feature class determines the Marker).
- Select a Parent Location based on your Specific Location.
- 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
- Select a Feature Type (Point, Line, or Polygon.)
- 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.
- Select "Save"
Conversion Tool Help
- Select the conversion tool
- 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")
- Select "Calculate"
- Last, Select "Fill in xxx" (Choose either Lat. or Long.)
- NB Latitude is North/South, Longitude is East/West.
- 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 Google & Skyhook Wireless databases.
To edit a Location:
http://127.0.0.1:8000/eden/gis/location/
- Find the Location your wanting to edit (Either by searching or sorting by the attribute.)
- Click on the feature number.
- Edit in the box above.
- 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
- Share a comon Marker (unless over-ridden at the Feature level)
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 )