Plugins/Geolocation 2.0

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.

There is a screencast covering some of the material below.

You can use certain shortcodes to display a map of selected items on Simple Pages.


Once you have installed the Geolocation plugin, select Plugins in the top navigation of your admin. Scroll down to the Geolocation plugin and click the green Activate button. The page will reload; scroll down again and click the Configure button for the Geolocation plugin.

General Settings

  • API Key: enter your Google Maps api key here. Click through to acquire a key.
  • Default latitude and longitude of the point on which your map will center.
    • Latitude has a North/South value (sometimes noted with a N or S after the coordinates, longitude has an East/West value.
    • Use a decimal point for the degree mark if you are trying for very specific points (so 51°80 would be 51.8)
  • Default Zoom Level. 0 is the most zoomed out, 20 is very zoomed in.
  • Map Type: Roadmap, Satellite, Hybrid (roadmap overlaid on satellite) or Terrain.

Browse Map Settings

  • Number of Locations Per Page. The Map browse has pagination.
  • Auto-fit to Locations. If checked, the browse map will ignore default location and zoom settings (from aobve) and instead auto fit to the locations of the items displayed.
  • Default Radius for the items advanced search.
  • Use metric distances for radius search.

Item Map Settings


You can set the width and height for the item map - if left blank, it defaults to a width of 100% and a height of 300px.

Map Integration

  • Click the first checkbox to add a link to the items map on all items/browse pages.
  • Click the second checkbox to include an option for geolocating contribution items Note this will only work if you have the Contribution plugin installed and active.

Getting Started

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 or click the correct spot on the map. You'll be asked if you are sure you would like to change the item location. Select OK or Cancel.

To *delete a marker* click on the marker itself. You will get a dialog box asking you to confirm.

  • Don't forget to save your changes.

Finding Coordinates

If you are assigning location for an item which does not have a street address, or you want to be highly specific for the marker, you can of course zoom and click on the map. However, you can also assign a location by entering geolocation coordinates for the item.

There are a number of ways to identify geocoordinates. Sometimes a simple web search will result in the information. If using Google Maps, you can right-click on any spot on the map and select "What's Here?" and the search bar for Google Maps will reload with the coordinates for the precise location. Wikipedia lists the coordinates for some cities.

Viewing Items on the Public Map

Visitors to your Omeka 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 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.