Plugins

plug_in Plugins

Specify 6 interfaces with the Google Earth and GEOLocate web services. Choose System > Plugins. It is also possible to place a Plugins button on the Task Bar by choosing Specify > Preferences > Taskbar for the Macintosh or Edit > Preferences > Taskbar for Windows and Linux, then checking the Add Plugins checkbox.

These web services can be launched by:

  • Clicking the relevant icon in the side bar and choosing a Catalog Number or Record Set.
  • Dragging and dropping a Collection Object, Locality or Collecting Event Record Set on the web service icon from within the side bar. These Records Sets must include the Locality data listed below for each service.

Plugins that can accept a Record Set display a colored outline as the Record Set is dragged within the sidebar. An arrow will display within the outline when the Record Set can be dropped onto the Plugin.

Specify is not responsible for the integrity or accuracy of any of the results of these web services. Specify is integrated with these services as a service to the community. For more information about these plugins, visit their web sites.

 

google earth Google Earth

The Google Earth Plugin is used as a means of visualizing Collection Object records from Specify in Google Earth.

The full version of Google Earth must be installed on the local machine for the Specify Google Earth integration to work, not the Beta version. Go to earth.google.com for a free download.

Specify plots locality records (or associated Collection Objects or Collecting Events) in Google Earth based on latitude and longitude data provided in the locality fields. All associated data is stored in a KML file which is launched within Google Earth upon clicking the Google Earth icon on the sidebar, or by dropping a Record Set on Google Earth from within the Plugins Sidebar.

Collection Object information is shown within the Google Earth information balloon. Specify also allows the insertion of two web service links for genus and species within the information balloon by configuring Google Earth with URL's to the web services in Specify > Preferences > Tools.

Google Earth can also be launched from within a Locality form by clicking the GoogleEarth16x16 Display in Google Earth icon.

Locality data Requirements

  • Latitude and Longitude

Google Earth is also available for use in the WorkBench

 

geolocate GEOLocate

The GEOLocate project has created software and services for translating textual locality descriptions associated with biodiversity collections data into geographic coordinates. It uses a description of a Locality, together with geography fields, such as County, State and Country, to find Latitude and Longitude coordinate values. This is referred to as georeferencing.

The Specify and GEOLocate teams have collaborated to create a GEOLocate module inside Specify.

 

Requirements for Georeferencing US localities:
Column Heading
Data Needed
Locality Name
Yes
Country
Yes
State
Yes
County

No, but will improve results.

Note: County is required when including waterbody and highway crossing in the GEOLocate search.

Latitude1

No
(this is a results column)

Longitude1
No
(this is a results column)

 

Requirements for Georeferencing localities outside of the US:

Column Heading
Data Needed
Locality Name
Yes
Country
Yes
Child Node of Country No, but will improve results.
Latitude1

No
(this is a results column)

Longitude1
No
(this is a results column)

 

Click GEOLocate button on the side bar and select either Collection Objects or Record Sets to send to the GEOLocate service. Or, drag and drop a Record Set onto GEOLocate button on the side bar.

A message will alert you to the status of the GEOLocate search requirements in regard to your records.

view Geolocate results screen

GEOLocate Requirement Status

Note: Latitude and Longitude values present in Specify records will be replaced by those found in GEOLocate if GEOLocate results are accepted.

 

Once GEOLocate has finished processing another message will either display the number of records for which GEOLocate returned results, or state that no results were found.

View GEOLocate

View GEOLocate Results

 

 

Results will display in the GEOLocate Results Chooser tool.

 

geolocate

GEOLocate

Locality Information displays the Locality Description, County, State and Country values in your current Specify record.

Correction (Green) Marker Properties include the values for the most accurate result among the GEOLocate results returned. These values are also displayed visually on a map.

GEOLocate results can be edited using either the Correction Marker Properties form or the map elements. Changes made on the map are automatically recalculated and updated in the corresponding fields on the form. Updated values in the Correction Marker Properties form are represented in the corresponding map element.

Note: As you move your mouse within the map the corresponding latituted and longitude values display in the lower right corner under the map.

Position represents the Latitude and Longitude of the GEOLocate result, visually depicted on the map as a green marker. These results can be edited.

Edit the Position using the Marker Properties form:

  1. Type new values in the Latitude and/or Longitude box.
  2. Click the Apply button to accept the changes and update the location of the green marker on the map.

Edit the Position using the map:

  1. Click on the green dot on the map and drag it to a new position. The latitude and/or longitude values on the form will automatically update.

Uncertainty Radius represents the error due to the uncertainty of the locality information provided. It is shown as a grey circle around the green point marker on the map. The Uncertainty Radius can also be edited.

Note: At this time in Specify the Uncertainty Radius values are not written in a Specify database field.

Edit the Uncertainty Radius using the Marker Properties form:

  1. Click the Uncertainty Radius button. The text box will change to accept numeric values, and a large arrow will appear on the map next to the Uncertainty Radius point.
  2. Type a new numeric value into the box and click the Apply button to accept the changed value in the GEOLocate tool and update the Uncertainty Radius on the map.

Note: If GEOLocate does not find an Uncertainty Radius, or your User Preferences are not set to include Uncertainty Radius, the text box will open ready to accept numerical values and the Apply button will become available.

Edit the Uncertainty Radius using the map:

  1. Click the Uncertainty Radius button. The box will change to accept numeric values, and a large arrow will appear on the map next to the Uncertainty Radius point.
  2. Click in the center of the arrow and drag to reset the Uncertainty Radius on the map as well as the numeric value in the form. As you move your mouse within the map the corresponding Uncertainty Radius, and latitude and longitude values display in the lower right corner under the map.

Note: If GEOLocate does not find an Uncertainty Radius the text box will open ready to accept numerical values and the Apply button will be available. You must type a value into the text box and click the Apply button before the arrow will appear on the map.

Error Polygon is a polygon that encompasses the entire area of uncertainty.

Results which include an Error Polygon will display the vertex values in the form and a red polygon on the map. Not all results include an Error Polygon. If the results do include an Error Polygon the vertex values in the form must be cleared by clicking the Clear Polygon button before the Error Polygon can be edited.

Note: At this time in Specify the Error Polygon values are not written in a Specify database field.

Edit the Error Polygon using the Marker Properties form:

  1. Click the Draw Polygon button. The box will change to accept numeric values. Type in latitude and longitude values, separated by commas.

  2. Click the Apply button to accept the values in the GEOLocate tool and draw the polygon on the map.

Edit the Error Polygon using the map:

  1. Click the Draw Polygon button. A blue circle will appear around your mouse in the map area.

  2. Left-click on the map to add a vertex point.

  3. Continue adding points until the polygon is complete.

  4. Double click on the last vertex point to finish the polygon and exit the draw polygon mode. The vertex values will be updated in the form.

OR, Right-click on the map to cancel the vertex and exit the draw polygon mode.

Note: If there are vertex values included in the Error Polygon field the values must be cleared by clicking the Clear Polygon button before new values can be entered or drawn on the map.

GEOLocate Results displays the GEOLocate results in grid form. If multiple results are returned they are numbered and sorted with the most accurate listed first. The active result is highlighted in blue on the form. Other GEOLocate results are represented by red markers on the map.

Click on either a record in the GEOLocate Results form or a red point on the map to make it the current, or active result. The fields in the Correction Marker Properties box will be filled in and the green marker will represent the current result until you manually make corrections.

  • Number represents the order of GEOLocate returns both in the form and in a corresponding point on the map.

  • Latitude represents the latitude to the hundredth degree.

  • Longitude represents the longitude to the hundredth degree.

  • Pattern, or pattern identifier, is a text description of the pattern or keyword used to determine a GEOLocate result. Single locality strings often include multiple patterns, producing multiple GEOLocate results.

  • Precision is an indication of the quality of locality information. Each GEOLocate result is given a score between 0 and 100 which represents the probability of it being a match. That score is then placed within a 'low', 'medium' and 'high' ranking to indicate precision. Results are then ordered according to their probability number, which allows results within the same rank to include the most accurate matches first.

  • Error Polygon is a polygon which encompasses the entire area of uncertainty.

  • Uncertainty represents the error due to the uncertainty of the locality information provided.

Other Map Controls

Zoom In/Out

Slide the slider down to zoom in, up to zoom out.

Click the zoom in button to zoom in, the zoom out button to zoom out.

Turn the wheel on your mouse up to zoom in, down to zoom down.

Double click to zoom in, right-click to zoom out.

 

GEOLocate Web Button

Click the geolocate web button to open the web-based version of GEOLocate in your default browser and plot the current result set on the map.

 

Other Buttons

Button Result
Help
Opens the Specify Help Window
Accept
Stores the latitude and longitude values in the appropriate cells of the record.
Skip
Ignores all results obtained for a given record, and displays the results for the next record.
Done
Accepts the currently selected row and closes the GEOLocate Results Chooser dialog.

 

The dialog will close when all the records have been displayed. Results that were accepted will be written in the Latitude 1 and Longitude 1 columns of the record.  Any data already in these columns will be overwritten.