This Enonic XP application contains a Google Maps part that you may add to your Enonic XP site.
- Supports multiple locations in a single map
- Each location may have its own marker icon and info window
- Supports multiple maps (parts) on the same page
- Responsive design where the map scales according to available width
- Map area may have one of four aspect ratios
- Screen reader compatible markup
- Fullscreen toggle button has been enabled by default
- Scrolling/swiping zoom controls are disabled, so users don't get stuck inside the map
- Several color themes are available, including more elaborate ones from snazzymaps.com
There are three options:
- First option is to open the Enonic XP Application Admin Tool. In here select "Install" and find this app in the Market list of available apps.
- Second alternative is to simply download the app JAR file and move it to the XP installation's
$XP_HOME/deploy
folder. - Or you can build this app with gradle. First, download the zip file of this repo. Unpack it locally. In the terminal, from the root of the project, type
./gradlew build
. On Windows, just typegradlew build
. Next, move the JAR file frombuild/libs
to your$XP_HOME/deploy
directory. The Google Maps app will now be available to add to your websites through the Content Manager admin tool in Enonic XP.
If you are upgrading to a newer version of this app, make sure to remove the old version's JAR file from the $XP_HOME/deploy
directory.
The standard usage limits for Google Maps is 25,000 map loads per 24 hours for 90 consecutive days. If this limit is exceeded, you may enable pay-as-you-go billing to unlock higher quotas.
While strictly not required for Google Maps to run, Google strongly recommends that you create an API key so you can perform tracking and analysis, as well as unlock additional quotas if you surpass the usage limit. Once you have obtained an API key, it may be entered in this app's App config when editing your site.
- Visit Google Maps and search for your location (address, location name, etc.)
- Right-click inside the map on the location that you want the GPS coordinates to point to
- In the context menu that appears, choose "What's here?"
- A pop-up window appears that should include two decimal numbers separated by a comma, e.g.
59.909195, 10.742339
. These are your coordinates. If you like, you may click on the numbers and Google Maps will put them in the search field so you may easily copy them to the clipboard. - When creating your Google Maps part in Page Edit, these GPS coordinates may be typed/pasted into any "GPS coordinates" field.
Make sure to hit Apply, then Save Draft. The preview area should then reload and the map should appear. It this does not help, try refreshing the browser window/tab.
Version | XP version |
---|---|
2.0.0 | 7.0.0 |
1.2.0 | 6.7.0 |
1.1.0 | 6.7.0 |
1.0.1 | 6.4.0 |
1.0.0 | 6.4.0 |
- Compatibility with Enonic XP 7
- Each location may now have its own custom marker icon image
- Added map type setting (road, sattelite, hybrid, terrain)
- More reliable map loading behavior
- Application icon for Enonic XP version 6.7 and later
- Fixed bug when placing a part on a page with multiple regions
- First release