User Manual

About GeoCommons and GeoIQ

GeoIQ is a geospatial data management, visualization and analysis platform providing collaborative, browser-based data analysis tools for use by both technical and non-technical users. With GeoIQ you can quickly and intuitively make intelligent, data-driven decisions with no cumbersome training. See http://www.geoiq.com/products for a full listing of the GeoIQ suite of location data visualization and analysis products.

The GeoIQ platform powers the growing GeoCommons community of over 25,000 members actively creating and sharing hundreds of thousands of datasets and maps across the world. With GeoCommons, anyone can contribute and share open data, easily build shareable maps and collaborate with others.

We are dedicated to assisting you through any trouble you experience, as well as helping you increase user productivity and satisfaction. Please visit our public forms. For GeoIQ Enterprise customers, a more comprehensive support plan is available.

Creating an Account

Click on the Sign Up button located in the upper right corner of the Homepage: and follow the instructions to create a new account..

Getting Started: Make a Map in Under 5 Minutes

Making a map in GeoCommons can be quick and easy. You can choose to upload your own data or search through the more than one hundred thousand point, line or polygon datasets already in GeoCommons. You can search from the Homepage or right from the map. You can upload data in as a shapefile, spreadsheet or KML. If you have basic data (state names or addresses) with no geographic information you can just join your spreadsheet to an already existing boundary file in GeoCommons or create latitude and longitude coordinates using our geocoder. You can also import any geographic data through a web URL.

Once you have found or uploaded the data you wish to map, simply click on the Make a Map button which can be found on the Homepage or from any dataset. If you are already on the map, click the Add to Map button. You can make your own cartographic choices including the basemap, style and color options and label your map or just leave those decisions to us. Either way, GeoCommons will guide you through the fast and intuitive process we like to call the Happy Path. GeoCommons also has some great analysis tools available for everyone on a limited basis; merge maps, run a correlation, aggregate points into polygons and more. With the many analysis options at your fingertips, you can create the maps you want in just a few clicks.

Finally you can save your map and share it with others both within and outside of the GeoCommons Community. You can also download Shapefiles, Spreadsheets, and KML files of your data, regardless of the format in which it was uploaded. Want to check out maps created by other users? Just search for maps and even download them as a KML. With GeoIQ Enterprise you can also have access to increased analysis capabilities, advanced sharing and more privacy options.

GeoCommons users are limited to two analyses running at the same time and up to ten per day. For additional analysis capabilities, contact

Watch how you can make a map from upload to finish in less than two minutes here

Managing Data User Manual

GeoCommons has a browser-based application for finding, organizing, and sharing geodata in common formats. Designed to both host and store geospatial data, GeoCommons enables you to:

Store and organize disparate data from all ends of your organization in one central location.

Increase data efficiency with easy-to-use open standards through our browser-based application that allows both technical and non-technical users to find, create and share datasets rapidly in a variety of formats that work in both traditional geographic information systems (GIS) and newer GeoWeb workflows.

With your web browser, GeoCommons makes it easy to find and add different data layers to your map, add your own data to these maps and combine the different data layers together to map multiple themes at the same time. For example, you could make a map to show how population density and home prices are related. It is this kind of multivariate thematic map that really allows you to explore data and uncover new insights.

Types of Data Supported

GeoCommons is designed to provide easy sharing and conversion of your data with others. The platform supports many popular formats from geospatial as well as enterprises and the web. Using GeoCommons, you can upload data and GeoCommons will automatically convert and store them in our highly scalable data store and provide access to download in numerous formats, or access via our programming interface.

Description of Data Types

Shapefile: A complete shapefile is a set of files that contains geospatial vector data, created using ESRI software applications. This file type is commonly used for GIS software. Shapefiles are used to define point, polyline, and polygon files that are spatially referenced.

A shapefile is comprised of multiple .files/extensions. The required files for use with GeoCommons are:

*.shp - the file that stores the feature geometry

*.shx - the file that stores the index of the feature geometry

*.dbf - the dBASE, or database, file that stores the attribute information of features

*.prj – the file that stores the projection used (only required if using projection other than WGS 1984)

Spreadsheet or CSV: CSV is a type of data format in which each piece of data is separated by a comma. This is a popular format for transferring data from one application to another because most database systems are able to import and export comma-delimited data.

Data pulled from a database and represented in comma-delimited format looks something like the following:

Lastname, Firstname, Age, Sex, Location, Latitude, Longitude
Adams, Jane, 46, female, New York, 40.46, 73.54
Doe, John, 32, male, California, 38.16, 121.56

Each column’s value is separated by a comma from the next column’s value and each row starts a new line.

KML: KML is an XML-based language for managing the display of geographic data in an Earth browser such as Google Earth, Google Maps, Google Maps for mobile, and NASA WorldWind.

Click here for a tutorial on uploading KML files.

GeoRSS: GeoRSS is an emerging standard for encoding location as part of an RSS feed. GeoCommons currently supports GeoRSS-W3C, GeoRSS-Simple, and limited GeoRSS-GML.

Text Documents for GeoParsing (GeoIQ Enterprise only): Using MetaCarta’s technology, geographic references contained in a document are identified and made useable as a data layer. Text documents can be uploaded as .txt files or as a URL link.

WMS: - Web Map Service. A geographic image server through which map images can be added to the map.

TILES: - Map Tiles. A specification for a tiled image layer where each tile is referenced according to it's place on the earth.

Importing

The GeoCommons platform supports import of shapefiles (SHP), comma separated values (CSV), Keyhole Markup Language (KML), and GeoRSS. Text documents for GeoParsing supported for GeoIQ Enterprise only.

Exporting

The GeoCommons platform supports export of many popular data formats: Shapefile, CSV, KML, GeoRSS Atom, Spatialite, and JSON.

Finding Data

GeoCommons enables you to search and browse within your own appliance or across multiple appliances through a federated search.

Type a keyword or phrase into the search bar on the GeoCommons Homepage. You can improve your search experience by adding qualifiers to the search menu for data by source, location, time period, or title keywords. The results page will display datasets (layers), maps and analysis that match your keywords in their title and/or tags.

Sort By

This feature allows you to arrange your search results by relevance, age and name. Your initial search results will automatically be sorted based upon relevance to the search term or terms. GeoCommons will display the results that it believes best fit your search criteria. Your results can also be sorted by date of upload. Simply, click the Newest First button to sort your search results to display the most recently uploaded layers. Select the Oldest First button to show the opposite. Your results can also be placed in alphabetical order by selecting the Name – A to Z or the Name – Z to A buttons. This will place your results in alphabetical order based upon the title of the data layer.

Search Another Server (GeoIQ Enterprise only )

This section to the right of your search results will list all available servers that can be searched. Searching for the same keyword or phrase is as simple as clicking on the desired server. You will be met on the following screen with your search results from that particular server.

Browse

The browser function makes use of our topical and locational vocabulary and enables the user to browse the repository by category. These broad categories break up the thousands of datasets available through GeoCommons so you can quickly find the data you want. From the Homepage, click the Upload Data button and then click the category link from the list. You can select either the main category or any of the subcategories.

Groups

GeoCommons now has a groups functionality, which allows you to decide the GeoCommons users you would like to have access to your data or maps and give edit permissions to groups to work collaboratively on projects.

To create a group, click on the dropdown under your user name and click on Manage Groups.

This will take you to a page where you can create and manage your groups. Click on the Add A New Group link and you will be prompted to give the name of your new group.

Once your group is created you can add members by clicking on the Manage link and then clicking on the green Add a New User button. You can search through all users on GeoCommons to add.

Now that your group has been created you can give special permissions to this group on both datasets and maps such as the ability to see a private dataset or the ability to edit a map. You can read more about permissions here.

Groups are limited to 5 groups per user and 5 people per group. For additional capabilities, contact

Working with a Dataset

Every dataset description page contains a preview map of the data which will visually show whether the dataset contains points,polygons, or lines and what part of the world the data describe. It will also give you an idea of how many features are in the dataset however the exact number of features can be found to the right of the dataset description.

Once you’ve found data of interest, you can select from the following options, all of which can be accessed from either the search results page or the details page of the dataset:

Visualize data by clicking the Make a Map button. You will be linked to the Mapping application, and the data is automatically loaded into the Layers Palette.

Download the data as a spreadsheet (CSV), shapefile, or a KML file.

Analyze Data by clicking on the Analyze

Save a copy to My Layers by clicking the Edit a Copy button.

From the details page you can also take a look at the data behind any dataset by clicking on the “Edit Data” for your dataset or the Show Data button, if it’s someone else’s dataset. Here you can sort data or create filters. If you are working with your own dataset, you can edit any of the cells or delete a feature/row.

See how to navigate the dataset description page here

Downloading Data

As stated above, you can download from the search results page or the details page. Simply select which of the three supported file types you prefer; CSV, SHP or KML.

You will be prompted to select a location to which the data will download. If downloading a SHP, GeoCommons automatically compresses the file into a zipped format in order to make it as fast as possible. All you must do from here is unzip the file, and it is ready for your personal use.

Uploading Files from your Computer

GeoCommons has been updated to include some great new features like batch upload, international geocoder, and a pending layers page. All of these new features work to streamline the management of your data layers.

Maximum File Sizes

GeoCommons allows anyone to upload files up to 20 megabytes (MB) in size. You can keep as many public datasets as you want for free. In addition, you can now save up to a total of 20 MB of private data that is only accessible to yourself or groups as you choose.

Adding Files

When uploading files from your computer select the Upload Data button found on the GeoCommons homepage. Use this function to upload:

After clicking on the Upload Data button, the batch upload screen will appear. This is a new function to GeoCommons that allows users to upload multiple files at the same time including several shapefiles at the same time. These files will be saved to a page titled Your Pending Layers.

When uploading a shapefile you must include the .shp , .shx , .dbf file extensions. Also, .prj and excel .shp files can be included in the batch being uploaded. The batch upload process will merge all files into one data layer.

To get started, click the Add File button, and select which files are to be uploaded. The upload process will begin automatically.

As each selected file is being loaded a status bar will show the progress of each file. When the file is finished uploading, the status bar will display a complete message.

Your Pending Layers

After all files have been uploaded click the next button to continue with the upload process. The next page is the Your Pending Layers page; this contains all data layers that have not completed the upload process.

Please note that when the entire upload process is completed for a layer, that file will be moved from Your Pending Layers to the Your Layers page.

Locate Data

Clicking the Next Step button for the desired dataset will begin the Locate process. There are three options to choose from when locating the data layer:

Depending on the content provided with the data layer, select the most appropriate option.

Use the existing Geographic data in the file you uploaded: Select this option when the data layer already has geographic data associated with it. For example, when uploading KML and shapefiles, geographic location data is already present, and there is no need to geocode or join with a boundary dataset.

Please note that if the data layer does not have any geographic data associated with it, this option will not be available.

Geocode based on an address or place name: The GeoCommons geocoder is a powerful tool that allows you to obtain Latitude and Longitude coordinates from an address or place name. By integrating it into the upload process, GeoCommons streamlines the geocoding/upload process, and has eliminated the need for secondary geocoders. Select this option when your data layer contains address or place name information.

Join with a boundary dataset: This option allows users to merge a personal data layer with an existing boundary dataset in GeoCommons, for example: joining a CSV file with boundary (polygon) file. Use this option when the data layer contains locational data such as a state/country name etc. that matches the same data in the existing boundary file. For example, if the data layer contains state level data in the United States, the layer can be joined to a boundary file by joining the state names together.

Using Existing Geographic Data in the File You Uploaded

Select this option if your data layer contains geographic data. GeoCommons will automatically analyze the geographic data and create an official dataset. Upon the successful creation of the dataset, you will be taken to the details page. From here select the Edit button to begin the description process.

During the editing process users contribute important background information associated with the dataset. This is an essential part of the uploading process.

Please see the Describing Your Data portion of this manual for more information regarding this process.

Geocode Based on an Address or Place Name

Choose this option when your data layer contains address information such as street addresses or place names. This option is predominately used when uploading a CSV file. After selecting this option users will be taken through the geocoding process.

Please note that there is a 5,000 row limit for geocoding.

It is here that users define the locational information, and obtain the latitude and longitude coordinates for each point. The resulting layer and map will be a point based layer created from the lat/long coordinates.

The next step in the geocoding process is to geolocate your data. After selecting the Geocode based on an address or place name option, you will be directed to the locate page as seen below. The geocoder will automatically detect column titles that it recognizes as address information or place names. Titles such as city, state, address, etc. are examples of column titles that the geocoder will recognize. If you believe that GeoCommons has detected the appropriate columns, click the Continue button to start the geocoder. GeoCommons will obtain the latitude and longitude coordinates and bring you to the review screen.

You also have the option to define the columns that you wish to use in the geocoding process. Click the Select different columns link to choose exactly which columns are used to locate your data. The next page will list each column title as an attribute. You can then select the format of each attribute by selecting the edit button in the Data Format column. After clicking the edit button, three tabs will appear to the right; those tabs are titled Address, Geographic, and Standard. Select the proper format from these tabs for each of your attributes.

The Default Country feature helps in accurately locating your points. If all of your data is contained within a single country, please make note of that using the drop box. If the dataset spans multiple countries or you are uncertain, select the Entire World option, and GeoCommons will do its best to locate each point given the information provided.

Sometimes parsing issues may arise and GeoCommons allows the user to resolve those issues easily. If the attributes provided are not correct click on the Fix Parsing button at the bottom of the page. This will show all columns in your dataset. Simply click on the column that you want to be your header row and then click Continue. Now the column you chose will be seen as the attributes available. From here you can continue with the geocoding process.

Once you have selected all of the appropriate options, click the Continue button to retrieve the coordinates from your specifications. Upon successful geocoding, you will be brought to the review screen.

GeoCommons will offer a summary of the geocoding results, noting the exact number of geocode matches made, and will also add new attributes to the dataset including Precision and Score columns titled geo_precision and geo_score, respectively.

Precision: This column shows the geographic level at which the data was geocoded. Range has the finest level of granularity (the house number was interpolated). Street is the second finest level, the street name was matched and the start of the segment number closest to the house number is where the point was placed. If the Precision is Zip code, City, or State the row was geocoded to the center of the geographic area.

Score: (Geo-confidence score) An estimate of how likely the location assigned by the geocoder corresponds to the place you intended. 0.0 – 1.0 scale. 0 zero being the least confident, 1 being very confident.

If the results are not as you expected you can return to the locate page by clicking on the Back button. You can also resolve any errors and resubmit the changes to the Locate step. In the example above, the state of Oklahoma was spelled wrong and therefore not geocoded correctly. The row for Oklahoma appears in the Error box. You can correct the spelling by double clicking the cell. When you have finished, new options will appear on the bottom of the errors box. Click Save & Resubmit and Oklahoma will then be properly geocoded. You will see the changes reflected in the Precision and Score columns and the row for Oklahoma will no longer be in the errors box. You can also choose to delete unwanted rows or columns or edit any other cells if desired. Now, if everything looks to be geocoded properly, click the Continue button.

On the next page you will be brought to the description page; this is where you enter important metadata regarding your dataset, including title, tags, description, source, etc.

Please make note in the dataset description that the FortiusOne Geocoder was used to process the data in the How was this data processed section. Please see the Describing Your Data portion of this manual for more information regarding this.

Join With a Boundary Dataset

Choose this option when merging a personal data layer with an existing boundary file. This allows users to join a CSV file with boundary (polygon) files through common names or identifiers found within both datasets.

To get started select the Join with a boundary dataset option; this will take you to the geolocate page where you will search for an existing boundary file within GeoCommons to join with your layer.

To find the appropriate dataset, search or browse GeoCommons. On the geolocate page there is a search bar where you can enter a key word or term. You can also browse the GeoCommons library by selecting from the categories listed on the left side of the screen.

When you have found a data layer with which you wish to join, click the Select button to continue the joining process.

On the next page you will select which attributes you wish to join by; there are two boxes which contain all attribute titles from your data layer and the selected layer. Your data’s attributes will appear in the box on the left, while the selected layer’s will appear in the box on the right. Scroll through each box and find the layers that contain matching information.

To aid in selecting the proper attributes, the Attribute Preview function shows a brief sample of the attribute data.

As you can see in the example above, the two layers were joined by state name. A brief summary of the join results can be found under the Continue button. In this case 51 of 54 features matched exactly and were joined.

Please note that the attribute data needs to match exactly for the join to be made; the join process is case sensitive.

Users can view the complete description of the dataset by clicking on the link: Open the complete description and stats in another window.

When you are satisfied by the results of your join, click the Continue button to move on to the review screen. Here you can view the results of the Geo Join. As always, click the Expand View button to view all of the results.

If the results are not as you expected you can return to the locate page by clicking on the Back button. The results page allows you to address errors in your data and resubmit if needed. In the example above, the state of Oklahoma was spelled wrong and therefore not joined correctly. You can correct the spelling by double clicking the cell. When you have finished, click Save Changes and your data will be resubmitted. You can also choose to delete unwanted rows or columns or edit any other cells if desired.

Now if everything looks to be joined properly, click on the Continue button to Describe your data layer. During this process users contribute important background information associated with the dataset. This is an essential part of the uploading process.

Please see the Describing Your Data portion of this manual for more information regarding this process.

Batch Upload

To upload more than one layer, simply choose all of the files you want when Adding Data in your upload process.

Once all of the layers are complete they will be moved to your pending layers page and from there you can then finish each one in the normal fashion. If you are uploading shapefiles with the excel metadata file, the dataset description page will be automatically filled out making the batch upload even faster.

Reupload a Dataset

Any completed dataset can be updated by reuploading the file or files with changes. For example if you have previously uploaded a CSV with a the locations of something and there have been some changes, you can simply reupload the new CSV and the dataset will automatically replace the previous dataset with the changes without having to repeat the metadata process. Simply click on the reupload link on the Dataset’s page. You then upload your new file. If you need to change any of the metadata click on the edit link as you would any other time.

Formats Supported

GeoCommons currently supports RSS and ATOM formats for linking to a dataset that is available through a web URL.

KML/KMZ: KML is an XML-based language for managing the display of geographic data in an Earth browser such as Google Earth, Google Maps, Google Maps for mobile, and NASA WorldWind. KML files are very often distributed in KMZ files, which are zipped files with a .kmz extension.

_Click here for a tutorial on uploading KML files.

GeoRSS: GeoRSS is an emerging standard for encoding location as part of an RSS feed. GeoCommons currently supports GeoRSS-W3C, GeoRSS-Simple, and limited GeoRSS- GML.

Text Documents for GeoParsing (GeoIQ Enterprise Only ): Using MetaCarta’s technology, geographic references contained in a document are identified and made useable as a data layer. Text documents can be uploaded as .txt files or as an URL link.

WMS: - Web Map Service. A geographic image server through which map images can be added to the map. The URL should ideally be linking towards the GetCapabilities request. For example http://wms.example.com/wms.cgi?service=WMS&version=1.1.0&request=GetCapabilities

TILES: - Map Tiles. A specification for a tiled image layer where each tile is reference according to it's place on the earth. This must have {X} {Y} and {Z} somewhere in the link. For example: http://tiles.example.com/awesomeLayer/{Z}/{X}/{Y}.png or http://tiles.example.com/awesomelayer/tile?x={X}&y={Y}&z={Z}

Linking to a Webpage

Creating a link to your desired webpage is simple. Starting in the Store, Organize and Share your GeoData section of the GeoCommons homepage, select the Link to Data option. On the following page:

  1. Paste your desired URL in the first box.
  2. Select the file format from the second drop box.
  3. Select an external database source to load from drop box (if appropriate).
  4. Click the Upload button.

After completing these steps, click the Continue button. GeoCommons will automatically poll your URL for geographic data. On successful detection of features, you will be taken to the Locate screen where you will continue with the uploading process, ending with describing your data.

Uploading Map Tiles

To upload map tiles, begin from the homepage and click Upload Data. Next click Add a URL Link from the web. In the Upload page, type or paste the URL for the tile layer, making sure that it contains placeholders for the X, Y, and Z so that GeoCommons knows which tiles to pull back based on zoom level.

For instance, the Yahoo tile provider looks like this -> http://us.maps3.yimg.com/aerial.maps.yimg.com/tile?v=1.7&t=a&x={X}&y={Y}&z={Z} Simply use {X}, {Y}, and {X} as placeholders where appropriate. The Yahoo link above would be pasted into the "Enter a URL box" exactly as it appears. You can use the exiting GeoCache datasets for reference. In the case the the tiles are in reverse order, you will need to have a {-Y}.

In the Format box, select the drop down Map Tile URL. Click Continue.

In the Dataset Description page you will be asked to describe your data including Setting Zoom levels, credits, Setting Projection of tile layers.

_ Please see the Describing Your Data portion of this manual for more information on describing your data. Note that the Attribute section will be different for tiles. This will be described in the next section_

Under the Attributes and Descriptions tab you will provide important information that will tell GeoCommons how to present your tile on the map.

It is important to make sure that the basemap you use matches the projection of your tiles. Most basemaps in GeoCommons are Spherical Mercator (900913) (Greenland will appear big) however if you use you use the basemap OSM GeoCashe (4326) (Greenland appears squished) with a 900913 tile, your geometry will not match.

Describing Your Data

Entering Metadata

Metadata is essentially “data about data.” Metadata (sometimes written 'meta data') is used to facilitate the understanding, characteristics, and management usage of data. Within GeoCommons, this includes a description of the dataset, when it was originally published, the source, citation URL, metadata URL, contact information of user who uploaded the data, and descriptions of the attributes.

The importance of Metadata:

Protects investment in data:
Sets the stage for data re-use and update
Mitigates the effect of staff turnover and individual memory loss
Provides documentation of data sources and quality

Helps the user to understand the data:
Provides consistency in terminology
Focuses on key elements of data
Helps the user to determine the data’s fitness for use
Facilitates data transfer and interpretation by new users

Enables discovery:
Provides flexibility in searching to support interdisciplinary usage

Limits liability:
It can prevent data from being used inappropriately or provides protection if the data is inappropriately used.

Evidence of prudent data stewardship:
An organization that takes the time to create and maintain quality metadata will also most likely develop quality, clean data.

Reduces workload associated with questions about data:
Many of users’ basic questions can be answered through the metadata.

Titling Data

We have established a general guideline for naming your datasets. We suggest including the following information in the title and keeping them separated by commas: Description, Location, Time Period Covered.

Here is an example of a bad title and a good title for the same dataset:
BAD: Last year’s income data
GOOD: Average Household Income, Maryland – Block Level, 2000

It is important to create accurate titles so that both you and other users can enjoy easy searching and browsing of the data repository.

Tagging

Tagging allows you to link basic keywords and terms to a dataset. These tags will be picked up by the search and the browsing capabilities within GeoCommons. This is another step that will help users quickly and easily find the data that they need.

We advise tagging your dataset with one of the categories and/or subcategories listed in the Browse section on the Data Upload page. Be sure to select the Save button after making any changes in order to save them.

Note that the area under the tagging bar is populated with possibly relevant tags that you can click to add.

Where Did You Find This Data

Here you should link the source of you dataset, the citation URL and the metadata URL if available. This is very important in insuring that data can be verified and properly cited by other users. The information provided should insure that another user could see exactly where the data was found.

How Was This Data Processed

If your data layer went through a geocoding process to obtain geographic coordinates, please make note of what geocoder was used in this section. You can also add a link to the geocoder as well as a brief description on the geocoding process.

Once you have completed the description process, select the Save button. Your new dataset will be moved from Your Pending Layers to Your Layers with all of the saved information. From here you can visualize all of your data layers in the Mapping application of GeoCommons.

Attributes and Descriptions

This is where you will describe and manage the attributes in your dataset. You will be asked for the attribute name and a description of the attribute. The column header will be the default attribute name but it can be changed to something more descriptive or appropriate if needed.

For the description you should include a full explanation of the data for each attribute and if necessary describe how the data were created. You should also specify the unit of measurement of appropriate. For example, if you have an attribute that provides the square mileage for the areas in your dataset, you should state so in the box provided.

If you have an attribute that contains non numerical categories you have the option of categorizing them. For example, if you have a dataset that rates different schools as very good, good, satisfactory, and below average, you can check off the Categorize option to the bottom right of the attribute description. The categories will be displayed in the statistics of the attribute.

If you want to delete an attribute that is not needed simply hold you cursor over the attribute and a Delete button will appear to the right. You also have the option of sorting the order in whih the attributes will appear on the dataset description page. Click on the Sort tab to the upper right of the top attribute and you will be able to drag attributes to the desired location. Simply click on the Edit tab to return to the edit mode of the attribute section.

Who May Access this Data

Here you can decide the level of privacy you want for your dataset. You can choose who you want to edit, access and find your dataset including granting access to any groups you may be part of.

If you are part of any groups, you may specify privacy setting for each groups so that for example, one group may edit your dataset while another can only find and access it.

For GeoCommons users private data is limited to 20MB and 10 private maps. For additional privacy capabilities, contact

Editing Data

You can edit the title, description, metadata, and attributes of any dataset by clicking the Edit button under the title of your own datasets or the Edit a Copy button under the title of others’ datasets.

If you need to edit the actual data, you can make your changes and use the reupload process without the need to re-enter the metadata.

HTML in Datasets

When you create a dataset, you can include an attribute for clickable links that will show up in the info box on your map. To do this, you will need to add a new column in your spreadsheet. Then you can populate the cells with your links for websites or images. Below are two examples of how your spreadsheet would look to properly upload the data. The first is for a website, www.google.com. The second is for an image of the Google logo.

Now just upload your dataset and create a map. When you click on a feature on the map, either a clickable link or an image will show up.

GeoIQ Sanitized HTML from Dataset Output

About GeoIQ sanitization

GeoIQ filters output for dataset feature attributes to reduce the risks of vulnerability exploits.

GeoIQ filters HTML tags from dataset feature attributes and only allows for a set whitelist of HTML commands to remain in the displayed output. The following HTML tags and attributes are permitted to be used:

Permitted Tags       Permitted Attributes      
a href, title
img src, title, alt, height, width
em
b
i
pre
u

Example:

The "a" tag, href and title attributes are allowed, and all other attributes will be removed from output.

<a href="http://www.google.com" title="Google" script="alert('hi');">test a tag</a>

will result in the following being displayed:

<a href="http://www.google.com" title="Google">test a tag</a>

Where does GeoIQ cleanse HTML output?

GeoIQ sanitization works in the following areas of GeoIQ:

GeoIQ sanitization only cleanses the data when it is displayed from the GeoIQ system. The user's actual data remains as is, meaning, in the same state as when they uploaded the data to GeoIQ.