# Plugins **URL:** \ **Category:** Specify 6 Documentation\ **Tags:** Specify-6\ **Created:** [March 17, 2022, 4:36pm UTC](https://speciforum.org/t/plugins/207 "2022-03-17T16:36:19Z")\ **Posts on this page:** 1\ **Page:** 1
**Author:** ![Grant](https://yyz1.discourse-cdn.com/flex029/user_avatar/speciforum.org/grant/32/4255_2.png) [@Grant](https://speciforum.org/u/Grant)\ **Post date:** [March 17, 2022, 4:36pm UTC](https://speciforum.org/t/plugins/207/1 "2022-03-17T16:36:19Z")
## ![plug_in](https://canada1.discourse-cdn.com/flex029/uploads/specifysoftware/original/2X/6/648c92e8b411662216343a2b7654754592e63497.png) 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](https://canada1.discourse-cdn.com/flex029/uploads/specifysoftware/original/2X/8/81263c348c2f313f51141b649ec691ea45459bb7.png) 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](https://canada1.discourse-cdn.com/flex029/uploads/specifysoftware/original/2X/a/a6edd85ee53d1044aee9e08276d43d5bf9906c44.png) Display in Google Earth icon. > > Locality data Requirements > > - Latitude and Longitude > > Google Earth is also available for use in the WorkBench   ### **![geolocate](https://canada1.discourse-cdn.com/flex029/uploads/specifysoftware/original/2X/4/45dbff737e6cff6f3736f396e24a1c9a2b09fb01.png) 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](https://canada1.discourse-cdn.com/flex029/uploads/specifysoftware/original/2X/3/39fb22607feb33b4c89b67f2b43b62d7b14b964f.png) 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](https://canada1.discourse-cdn.com/flex029/uploads/specifysoftware/original/2X/3/39fb22607feb33b4c89b67f2b43b62d7b14b964f.png) 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](https://canada1.discourse-cdn.com/flex029/uploads/specifysoftware/original/2X/b/b648eca6e5817f996d5ef67fdaf3daddc5cd8804.png) > > 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](https://canada1.discourse-cdn.com/flex029/uploads/specifysoftware/original/2X/f/faf7c35448f6248020ce5c07f75fb497cf7bdd50.png) > > > > View GEOLocate Results > > > >   > >   > > Results will display in the GEOLocate Results Chooser tool. > >   > > ![geolocate](https://canada1.discourse-cdn.com/flex029/uploads/specifysoftware/original/2X/8/88766315010eea2451aa2e0cee494e540773c5ec.png) > > 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. > > > 3. 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. > > > 3. Left-click on the map to add a vertex point. > > > 4. > > > 5. Continue adding points until the polygon is complete. > > > 6. > > > 7. 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](https://canada1.discourse-cdn.com/flex029/uploads/specifysoftware/original/2X/0/07320760f3d8b38c4d373da117218a1b871f766f.png) button to zoom in, the ![zoom out](https://canada1.discourse-cdn.com/flex029/uploads/specifysoftware/original/2X/5/5180e5f6239e21f8ab6d9a0e0177b843ea52476a.png) 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 Butto** n > > Click the ![geolocate web](https://canada1.discourse-cdn.com/flex029/uploads/specifysoftware/original/2X/d/db203a6136c1c1e1a994475aeb8c442d4c90c420.png) 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. > >