Our.Umbraco.GMaps - Google Maps for Umbraco
![Our.Umbraco.GMaps Logo](https://raw.githubusercontent.com/ArnoldV/Our.Umbraco.GMaps/master/icon.png)
Basic Google Maps with autocomplete property editor for Umbraco 8+ including property value converter.
![Our.Umbraco.GMaps - Release](https://github.com/ArnoldV/Our.Umbraco.GMaps/actions/workflows/release.yml/badge.svg)
Package |
NuGet |
Our.Umbraco.GMaps |
![NuGet downloads](https://img.shields.io/nuget/dt/Our.Umbraco.GMaps.svg) |
Our.Umbraco.GMaps.Core |
![NuGet downloads](https://img.shields.io/nuget/dt/Our.Umbraco.GMaps.Core.svg) |
For Umbraco 8 or 9, use version 2.1.3
Change Log Summary
- 3.0.0: Removed support for Umbraco 8 & 9, allowing us to cleanup the codebase. Now a Razor Class Library.
- 2.1.3: Better support for installation on Umbraco 11.
- 2.1.0: Breaking change -
MapConfig.Zoom
is now an int
as it should be (was a string
).
- 2.0.7: Added ability to re-center the map via Editor Actions and can now directly input a set of coordinates.
Features
- Multi-targeting Umbraco 10+
- Search for address using autocomplete and place marker
- Enter coordinates in place marker
- Click on exact location on map to place marker
- Drag marker around
- Set default location & zoomlevel on Data Type settings
- Zoomlevel is saved on the property to use the same zoomlevel on your website
- Centerpoint is saved on the property to use the same centerpoint on your website different than the marker.
- MapType is saved on the property to use the same maptype on your website
- Use your SnazzyMaps API key to set mapstyles
Install
Use NuGet to install Our.Umbraco.GMaps:
Install-Package Our.Umbraco.GMaps
Configuration
You can configure the API Key along with other settings directly in AppSettings as per below:
Add the following to your appsettings.json file or equivalent settings provider (Azure KeyVault, Environment, etc.):
"GoogleMaps": {
"ApiKey": "",
"DefaultLocation": "",
"ZoomLevel": 17
}
These settings can be overridden by configuring the relevant properties of the Data Type prevalues.
Demo site Umbraco Backoffice Login Details
Username: admin@admin.com
Password: Password123
Special thanks and big #H5YR
Special thanks to:
- ronaldbarendse for all his contributions to this project
- prjseal for the Visual Studio project setup and included demo-site
- robertjf for making the Umbraco 9 version a reality, and continuously accepting and testing PR's and setting up release automation #h5yr
Google maps icons created by Freepik - Flaticon