Shape File Import

What is a Shape File?

Shape files were introduced by ESRI (Environmental Systems Research Institute) as a way to package up not only data (like what is contained in a CSV file imported into SpatialKey) but also geographic information (beyond a single point of latitude and longitude).  This geographic information is visualized within SpatialKey as polygons that can be used for filtering.

Please see the Shapefile wiki at Wikipedia for more information.

Where do Shape Files come from?

Shape Files are typically exported from a system that they were originially set up within for use in other systems.  If your organization has an existing geo-spatial system it may have the capabilitiy of producing these files that can be then loaded into SpatialKey.  Within SpatialKey the loaded data will be available as a dataset for use in filtering and visualizing of the geographic features.

What is required to load Shape Files into SpatialKey?

Shape Files are actually a collection of files containing the extended data and geographic (feature) information.  A detailed explanation of the various files that make up a Shape File can be found on the Shapefile wiki.  In order to successfully import Shape File data into SpatialKey the following criteria must be met:

  1. Only Shape Files containing Points and Polygons (not LineStrings) may be imported into SpatialKey at this time.  LineString will be added in a future release.
  2. The individual files should be contained within a Zip file.
  3. The total size of the Zip file should not exceed 50 megabytes in size.
  4. One of each of the following file types must be present within the Zip file (required files):
    1. .shp - the shape format file (contains the geographic (feature) data)
    2. .shx - the shape index file
    3. .dbf - the attribute (extended data) file
  5. Other Shape File types may be present as well (may or may not be used by SpatialKey depending on type and purpose) within the Zip file.

Other Shape File Notes as they Pertain to SpatialKey

  1. If the .prj (spatial projection file) is not present SpatialKey will assume that the geographic data is already in latitude/longitude format (SRID 4326).  If the .prj file is present then the data will be properly adapted from the provided State/Plane projection.
  2. If after loading your Shape File data the geographic features are not showing in the correct locations, check to ensure that a .prj projection file was included within the Zip file uploaded and that the well-known-text within the file is correct.
  3. Shape File data can be extremely detailed in its geographic fidelity.  In some cases a single geographic feature can contain hundreds of thousands of individual points.  When creating reports against large datasets and filtering with features containing thousands of points performance of the system can degrade.  This effects not only the user’s report that is requesting the data but also anyone that may be using that database at the same time.  The SpatialKey team has put in a great amount of work to providing an easy to use and performant implementation of feature (polygon) filtering but there are still limitations that must be managed.  To assist in making the application as performant as possible, geographic features containing more than 30 points will have a polygon simplification routine run against them reducing the total number of points within the polygon at import time.  This process may cause a slight loss of fidelity but in most cases is not statistically significant to data results.  If you have any concerns or issues with polygon simplification causing incorrect data results please contact us using our contact page or from within the application using the help system.
Contact our support team

With SpatialKey, intensive mapping projects that used to take two days can now be done in a few hours

Vaughn Jensen, Executive Vice President, Willis Re