Advanced Search Options Help
GeoFUSE Advanced Search Options are designed for use by GIS professionals who wish
to specify exact search criteria to query the GeoEye Image Catalog and receive results
in industry-standard formats such as Esri® Shapefile,
KMZ, KML, comma separated values (CSV) and HTML. The functionality in Advanced Search
Options provides users with the ability to search the GeoEye Image Catalog by uploading
files (Esri® Shapefiles, Google Earth™ KML and KMZ files)
to automatically load the geometry of a specific area of interest
(AOI). Additional search options allow a user to query the GeoEye Image catalog
by manually entering their desired geometry, i.e., to search by buffered coordinate
point, bounding box, buffered coordinate point list and polygon point list.
If this help documentation does not answer your questions, additional assistance can be obtained by sending an e-mail
to GeoFUSE Support.
The following is a step-by-step tutorial for using GeoFUSE Advanced Search Options.
Advanced Search Options Home Page
Search By Uploading a File
A user can generate geometries to search the catalog by uploading your own files.
The Advanced Search application allows users to upload complex search geometries
contained in Esri®
Shapefiles, KML files and GML files.
These files must be placed in a compressed archive with the .zip extension. The
application will only accept one zip archive at a time but each zip file can contain
many shapefiles, kml files, and gml files in any combination.
Start the Upload File process by clicking the link “By Uploading File” on the Advanced
Search Options home page.
The following Advanced Search Options file upload page will open:
The server places some limitations on the complexity of geometries that are uploaded
to the server. Any zip archive that is uploaded can contain up to a maximum of 500
features. So, for example a user could upload a zip archive with 500 files, each
containing one geometry, one file containing 500 geometries, or anything in between.
Feature geometries are not valid if their area encompasses more than 50,000 square kilometers
and each feature can have no more than 200 vertices. Also, be aware that geometries
containing more than 31 vertices may be converted to a bounding box and therefore
the intricacies of very complex geometries will not be retained but the resulting
bounding box geometry will still encompass the same area represented by the complex
Click browse and navigate to a compressed folder that contains one or more of these
file types: KML, KMZ, GML, zipped Esri®
Note: At anytime you can return to the previous page or the Advanced Search Options
home page by clicking one of the links under the instructions.
Back to Top
Search by Geometry Query
From the Advanced Search Options home page select Search Type "By Geometry Query".
There are four options for entering coordinate strings: By Buffered Point, By Bounding
Box, By a Point Coordinate List, and By a Polygon Coordinate list. In all cases
Latitude and Longitude values can be entered in decimal degrees or degree minute
second format, and in the case of degree minute second the following formats are
Back to Top
-30 27 30.123
-30° 27' 30.1230"
Search by Buffered Point Coordinate
The first option for searching by geometry is a coordinate point with a buffer radius.
The latitude and longitude values will create a center point from which a buffered
square will be created as the search geometry. For example, a buffer of 2.5 kilometers
will create square search geometry with an area of 25 square kilometers. The minimum
buffer radius is 2.5 kilometers. Since search geometries greater than 50,000 square
kilometers are not allowed the maximum buffer has been set to 111 kilometers. Once
values have been entered for the three fields click the “Process Point Buffer” button.
Back to Top
Search by Bounding Box Coordinates
In the bounding box search dialog, enter latitudes for the northernmost and southernmost
points in your area of interest along with longitudes for the easternmost and westernmost
points. When all four values have been entered, click the “Process Bounding Box”
Back to Top
Search by Point Coordinate List
This option is similar to searching “By Buffered Point Coordinate” but this option
allows you to enter many pairs of longitude, latitude values. Separate longitude
and latitude values with a comma ( , ) and separate each pair with a return or newline.
Do not use spaces. Once at least one Longitude, Latitude pair has been entered,
click the “Process Point List” button.
Back to Top
Search by Polygon Coordinate List
The polygon coordinate list and a series of longitude, latitude coordinate pairs
that represent the vertices of a polygon or linear ring. All polygon coordinate
lists must start and end with the same coordinate pair in order to ‘close’ the polygon.
Enter the list of coordinate pairs with longitude, latitude values separated by
a comma ( , ) and each pair separated by a return or newline. Once the polygon coordinate
list has been entered click the “Process Polygon Points” button.
Back to Top
Interacting with Catalog Search Results
The result page is the same for all processing types including uploading a file
or searching by any geometry string. The results page has two sections. On the top
are the attribute filters and on the bottom is the search geometries table. The
workflow for interacting with results is to adjust the attribute filter settings
and then click the links in the results table to download or explore the footprints
that were found in the area of interest and that match the attribute filter settings.
Each row in the results table represents a geometry that was extracted from one
of the uploaded file or was entered in a coordinate string.
Back to Top
Following is a diagram of the screen layout of the Catalog Search Results include
callouts detailing the screen elements.
Back to Top
- Date Controls
Use the date controls to set the start and end date range. You must click
a day on the calendar to close the calendar date control. Only footprints that were
captured within this date range will be returned.
- Cloud Cover Control
Set the maximum allowable cloud cover percentage either by entering a value
directly in the text box or using the slider to set the value. Only footprints that
have a cloud cover percentage less than or equal to the value in the text box will
- Resolution and Collection Vehicle Selection
Select the desired collection resolution: All Resolutions, Half-Meter, or One-Meter.
You can select GeoEye-1 or IKONOS for one-meter imagery, GEoEye-1 for half-meter imagery or Any.
Selecting "Any" will return imagery from both of GeoEye's
high resolution satellite imagery sources. Selecting a particular collection
vehicle will return imagery only from the selected collection vehicle.
- Collection Elevation Angle Range
Use the collection elevation angle range slider bars to specify a particular elevation angle range.
- Stereo and Sensor Mode
Selecting the Yes box under Stereo will result in a search that will return only stereo imagery in the results set.
Results can be further narrowed by selecting a sensor mode.
Clicking the link that says “Permalink” will link to the GeoFUSE online maps
application where it will show footprint results for the area of interest in that
row. The filter settings will be applied to the maps application.
- Shapefile - Download Esri® Shapefile
Click the SHP link will download the footprint results for the given area of
interest in Esri® Shapefile format in a .zip file that
will contain the area of interest geometry, the matching footprint geometries and
a map document that symbolizes these features. The footprint shapefile will only
contain features that match the attribute filters.
- Google Earth™ KML - Download Google Earth™ Document
Clicking the KML link will download a zipped Google Earth™ KML file(KMZ)containing
footprints that match the area of interest geometry and attribute filters. This
KMZ file resembles the KMZ results that are generated by the GeoFUSE Earth application.
- Comma Separated Values (CSV) - Download Comma Separated Values
Clicking CSV will download a file with a list of footprint results and their
attributes separated by commas. The footprints listed in this file will match the
area of interest and attribute filter settings.
- Formatted HTML - Download/Open HTML Document
Clicking the HTML link will open a new browser window with an HTML formatted
report showing an overview map and a list of the footprints matching the area of
interest and attribute filter settings.