NoPublic, bureaucrat, administrator
4,913
edits
Changes
Created page with "==How To Import Geospatial Data==__NOEDITSECTION__ <p>Various windows in IMSMA allow you to import geospatial data from external source files. These external source files can..."
==How To Import Geospatial Data==__NOEDITSECTION__
<p>Various windows in IMSMA allow you to import geospatial data from external source files. These external source files can be either Excel spreadsheets (with a .xls or .xlsx file extension), or shapefiles (with a .shp file extension).</p>
<p>To import geospatial data:</p>
<ol>
<li>Click the [[Image:EditReportIcon.png | Import Points]] button.</li>
:The Open window displays.
<li>From the Open window:</li>
<ol type="a">
<li>Navigate to the directory where the file that you would like to import is located.</li>
<li>Select the file name.</li>
<li>Click the '''Open''' button.</li>
:The geospatial data from the spreadsheet is appended to any existing data in the Points or Polygons table.
</ol>
</ol>
{{note|You must follow certain business rules to create and format the source file from which you wish to import data:
* For an Excel spreadsheet, follow the [[Geospatial Data#Excel Import Business Rules | Excel Import Business Rules]].
* For a shapefile, follow the [[Geospatial Data#Shapefile Import Business Rules | Shapefile Import Business Rules]].}}
===Excel Import Business Rules===__NOEDITSECTION__
<p>To import geospatial data from an Excel spreadsheet, the file must be created according to the following business rules:</p>
<ol>
<li>The columns in the spreadsheet must be in a certain order from left to right.</li>
</ol>
{| class="wikitable" width="600"
|-
| align="center" colspan="2" | '''Geospatial Data Spreadsheet'''
|-
| width="150pt" | '''Column'''
| width="450pt" | '''Description'''
|-
| align="center" | Point Number || The point number for the point. The point identified as point 1 will be imported as a starting point; all other points will be imported as a turning point.
|-
| align="center" | Longitude || The longitude of the point in WGS84 format. The import process currently only supports WGS84 format.
|-
| align="center" | Latitude || The latitude of the point in WGS84 format. The import process currently only supports WGS84 format.
|}
<ol start="2">
<li>The first row of the spreadsheet should not contain data because it is ignored by the import process. You should use the first row of the spreadsheet for column headings.</li>
</ol>
[[Image:SampleSpreadsheetWithGeospatialData.png||300px|''Sample Spreadsheet with Geospatial Data'']]
<div align="left">
''Sample Spreadsheet with Geospatial Data''
</div>
<ol start="3">
<li>If you would like to import geospatial data for multiple shapes, keep the points for each shape together in the spreadsheet and begin each new shape with point number 1. The example shown below illustrates a spreadsheet which defines two polylines. The first polyline contains five points; the second polyline contains three points.</li>
</ol>
[[Image:SampleSpreadsheetWithDataForTwoPolylines.png||600px|''Sample Spreadsheet with Data For Two Polylines]]
<div align="left">
''Sample Spreadsheet With Data For Two Polylines''
</div>
<ol start="4">
<li>The Point ID cannot be NULL, and must be unique across all points in the Excel spreadsheet and existing points in the Points table and Polygon/Polyline points table at the geospatial widget of the target object.</li>
<li>The Point Type must be valid.</li>
<li>When a Poly ID is provided, the coordinate data is a polygon/polyline point. Otherwise, the coordinate data is considered a single point.</li>
<li>The PointNo cannot be NULL for any polygon/polyline points. If the PointNo is NULL and the coordinate is a single point, the PointNo will be set to 1.</li>
<li>If the Bearing, Distance, and FrPointID are not ''NULL'', the Xcoord and Ycoord values will be disregarded/voided.</li>
<li>The Bearing value must be in the range of -360 to +360.</li>
<li>The Xcoord and Ycoord values must conform to the coordinate reference format selected at the geospatial widget. Available coordinate formats are: ''dd'', ''dd:mm'', ''dd:mm:ss'', ''X/Y'', and ''MGRS''.</li>
<li>The selected coordinate reference system at the geospatial widget is the coordinate system for the coordinate data in the Excel input file. Please note that the ProjName column in the Excel input file is purely for manual reference and not used in the Point Editor Excel Import function.</li>
<li>The Excel input file must conform to the Excel template provided by the GICHD.</li>
</ol>
{{NavBox HowTo Enter Data}}
<p>Various windows in IMSMA allow you to import geospatial data from external source files. These external source files can be either Excel spreadsheets (with a .xls or .xlsx file extension), or shapefiles (with a .shp file extension).</p>
<p>To import geospatial data:</p>
<ol>
<li>Click the [[Image:EditReportIcon.png | Import Points]] button.</li>
:The Open window displays.
<li>From the Open window:</li>
<ol type="a">
<li>Navigate to the directory where the file that you would like to import is located.</li>
<li>Select the file name.</li>
<li>Click the '''Open''' button.</li>
:The geospatial data from the spreadsheet is appended to any existing data in the Points or Polygons table.
</ol>
</ol>
{{note|You must follow certain business rules to create and format the source file from which you wish to import data:
* For an Excel spreadsheet, follow the [[Geospatial Data#Excel Import Business Rules | Excel Import Business Rules]].
* For a shapefile, follow the [[Geospatial Data#Shapefile Import Business Rules | Shapefile Import Business Rules]].}}
===Excel Import Business Rules===__NOEDITSECTION__
<p>To import geospatial data from an Excel spreadsheet, the file must be created according to the following business rules:</p>
<ol>
<li>The columns in the spreadsheet must be in a certain order from left to right.</li>
</ol>
{| class="wikitable" width="600"
|-
| align="center" colspan="2" | '''Geospatial Data Spreadsheet'''
|-
| width="150pt" | '''Column'''
| width="450pt" | '''Description'''
|-
| align="center" | Point Number || The point number for the point. The point identified as point 1 will be imported as a starting point; all other points will be imported as a turning point.
|-
| align="center" | Longitude || The longitude of the point in WGS84 format. The import process currently only supports WGS84 format.
|-
| align="center" | Latitude || The latitude of the point in WGS84 format. The import process currently only supports WGS84 format.
|}
<ol start="2">
<li>The first row of the spreadsheet should not contain data because it is ignored by the import process. You should use the first row of the spreadsheet for column headings.</li>
</ol>
[[Image:SampleSpreadsheetWithGeospatialData.png||300px|''Sample Spreadsheet with Geospatial Data'']]
<div align="left">
''Sample Spreadsheet with Geospatial Data''
</div>
<ol start="3">
<li>If you would like to import geospatial data for multiple shapes, keep the points for each shape together in the spreadsheet and begin each new shape with point number 1. The example shown below illustrates a spreadsheet which defines two polylines. The first polyline contains five points; the second polyline contains three points.</li>
</ol>
[[Image:SampleSpreadsheetWithDataForTwoPolylines.png||600px|''Sample Spreadsheet with Data For Two Polylines]]
<div align="left">
''Sample Spreadsheet With Data For Two Polylines''
</div>
<ol start="4">
<li>The Point ID cannot be NULL, and must be unique across all points in the Excel spreadsheet and existing points in the Points table and Polygon/Polyline points table at the geospatial widget of the target object.</li>
<li>The Point Type must be valid.</li>
<li>When a Poly ID is provided, the coordinate data is a polygon/polyline point. Otherwise, the coordinate data is considered a single point.</li>
<li>The PointNo cannot be NULL for any polygon/polyline points. If the PointNo is NULL and the coordinate is a single point, the PointNo will be set to 1.</li>
<li>If the Bearing, Distance, and FrPointID are not ''NULL'', the Xcoord and Ycoord values will be disregarded/voided.</li>
<li>The Bearing value must be in the range of -360 to +360.</li>
<li>The Xcoord and Ycoord values must conform to the coordinate reference format selected at the geospatial widget. Available coordinate formats are: ''dd'', ''dd:mm'', ''dd:mm:ss'', ''X/Y'', and ''MGRS''.</li>
<li>The selected coordinate reference system at the geospatial widget is the coordinate system for the coordinate data in the Excel input file. Please note that the ProjName column in the Excel input file is purely for manual reference and not used in the Point Editor Excel Import function.</li>
<li>The Excel input file must conform to the Excel template provided by the GICHD.</li>
</ol>
{{NavBox HowTo Enter Data}}
