This plugin is available for accounts with Silver, Gold, and Platinum plans.
The Geolocation plugin allows you to pin items in your database to a Google map. Items are geolocated individually with related metadata and collectively on a central map.
Once you have downloaded the Geolocation plugin, select Plugins in the top navigation of your admin. Activate your plugin and select Configure.
On the configuration page, you will find the follow options::
- API Key: enter your GoogleMaps API key here. To get a key, click the “Get a Key” button on the GoogleMaps APIs webpage.
- Default latitude: set the center point of the map’s latitude (North/South value), in degrees. Using numbers after the decimal point will pinpoint the location more precisely.
- Default longitude: set the center point of the map’s longitude (East/West), in degrees. Using numbers after the decimal point will pinpoint the location more precisely. Default latitude and longitude of the point on which your map will center.
- Default Zoom Level: Use a whole number of 0 of greater. 0 is the most zoomed out. A value of 15 will result in a map showing roughly one square mile
- Map Type: Roadmap, Satellite, Hybrid (roadmap overlaid on satellite) or Terrain.
- Number of Locations Per Page: The browsable map has pagination; set the number of items per map page with a whole number.
- Auto-fit to Locations: If checked, the browse map will ignore default location and zoom settings designated in General Settings and instead auto fit to the locations of the items displayed (on that page)
- Default Radius: for the Search By Address function in the advanced items search.
- A checkbox to Use metric distances for radius search, rather than miles.
- Width for Item Map: set in percent, defaults to 100% if left blank.
- Height for Item Map: set in pixels defaults to 300px if left blank.
- Add link to map on Items/Browse navigation: click to make active.
- Add map to contribution form: click to make active. Note that this will only work if you have the Contribution plugin installed and active.
Be sure to save your changes when you’re done.
Note: As of 2017, Google has begun to require API keys for their mapping products. If you find your map is no longer working, please obtain a key and enter into your Geolocation configuration panel. If you are starting a new project, we recommend implementing an API key from the start. You can obtain an API key by visiting https://developers.google.com/maps/web/ and clicking the Get a Key button. This key should then be added to the API Key field on the Geolocation configuration page.
After you have activated and configured the Geolocation plugin, it is time to geolocate some items.
When adding or editing an item (admin/item/edit and admin/item/add pages), you will find a new Map tab. When adding metadata for an item, click on the Map tab to add a location.
Enter the address of the item you wish to geolocate. A marker automatically maps the selected address.
OR, click directly on the map to place the item you wish to geolocate. A marker automatically maps the selected site.
To change the location of an item, type in the new address. You’ll be asked if you are sure you would like to change the item location. Select OK or Cancel.
Don’t forget to save your changes.
Viewing Items on the Public Map
Visitors to your Omeka.net site may use a map to browse through all of your geolocated items.
When configuring the plugin, if you selected “Add Link to Map on Items/Browse Navigation,” a “Browse Map” link will be added automatically to the secondary navigation on the items/browse page.
From this view, visitors may browse all mapped items, browse by tag, search for items, and browse the map.
They may also locate a mapped item by clicking on the items listed in the right column of the map.
Browse and Search Items on Admin Map
A Map tab appears in the left navigation bar located on the left side of the Dashboard. Clicking on the Map tab takes you to a map that displays all items geolocated in your Omeka.net site–public and not public.
From this view, you may also search mapped items using the item advanced search. Search results appear directly on the map.