29 votes




### Purpose ###

Map datatype for Umbraco V7 


### Why? ###

Wish to give your content editors or grid editors easy Maps to set real world locations. 

See   https://umbraco.com/apps/terratype/  for more details

### Usage ###

1. Install Terratype framework package via Nuget



2. Install the Map Providers you would like to use





3. Create a new data type based off this the newly added Terratype property Editor. You may need to obtain any API Keys that are necessary 


4. Add this new data type to a document type


5. Create new content based off this document type


### Reference ###





### Render ###


@using Terratype;


@Html.Terratype(Options, Map, @<text>Label</text>)



### Log ###



Fixed Grid Label error




Fixed missing resource files for Bing & Leaflet

Updated to use Leaflet version 1.3.4



Complete rewrite of how providers are loaded

Amend to GMaps rendering to allow bypass of failback when first rendering or resizing


Removed Minifier dependancy



Fixed error converting old properties (https://bit.ly/2HEgf4x)

Fixed no click event for some markers in JS client library 

Fixed rendering issue in IE11 for Bing and Leaflet maps

Fixed loading Generic providers

Added distance calculation for positions using Haversine formula

Minified & bundle js files



Fixed custom icons in GMaps when rendering

Custom Position setting for map fixed when rendering



Updated markercluster for GMaps

Fixed error converting model when using ModelsBuilder

Added 3 more Google map styles

Added Javascript event library

Added AutoFit, AutoShowLabel & AutoRecenterAfterRefresh to options



Updated GMaps versions

Fixed custom icon error (ronaldbarendse)



Terratype model now includes height

Extra handling for GMaps when resize doesn't call idle event afterwards

Improved code to detect when Rendered map is being shown

Now with jQuery monitoring




All providers use .NET Framework 4.5

Added Icon to Options, to be able to render custom icons 

Fixed label issue for multiple Rendered GMaps 




Fix for when providers are missing their default values

Fixed Minor spelling mistakes

Leaflet Map Icon is now static when rendered in razor



Render error with map height and zoom in option 





Added Bing Maps

Leaflet not displaying

Switching between providers in config now smoother





Fixed option error in FireFox




@Html.Terratype() now handles dynamic values

Added Leaflet Provider

Remove labels from frontend when no label is present

Improved provider loading




Error when creating Google Maps without an API Key present




Added native Grid editor to allow terratype maps to be added/edited and rendered inside grids (With no coding required)

Added native Datum values to each Coordinate System




Fixed error with Null types in assemblies

Fixed error with map height for IE in Umbraco backend only

Added content editable Labels to maps





Error checking for providers fixed





Removed reliance on terratype map provider having to be same version as terratype




Removed hardcoded /umbraco/ references





Complete rewrite based from AngularGoogleMaps.



### Future development ###


Current Roadmap


Include stylised maps for Leaflet, using own Tile Servers (Likely to be free or paid for service depending on your data usage)


Adding an ArcGIS and CartoDB providers - likely to charge for these providers, to recupe development and cover maintance costs (My thinking is better to have working providers for money, than broken providers for free)

### Source code ###

Download the source code, it should work for Visual Studio 2013 & 2015. If you set **Terratype.TestSite** as your **Set as Startup project** this should execute the test Umbraco website, where you can test maps under different scenarios. Once running, surf to http://localhost:60389/umbraco and at the login type admin for user and password for password.


### Test Variants ###

 Is a test build just for @HotChilliLtd to test a variant of Plugin Loader

 Is a different test build just for @callumbwhyte to test another variant of Plugin Loader

If you have problems loading Terratype plugins then feel free to install these variants. is more revolutionary, and so more prone to issues, but if it works will be the code that is used going forward.

Package files

Archived files

Source code

 Download package
version 1.0.21

NuGet install instructions for Umbraco 7.0.0-7.14.0

Install-Package Terratype

Package owner

Jonathan Richards

Jonathan Richards

Jonathan has 1742 karma points

Package Compatibility

This package is compatible with the following versions as reported by community members who have downloaded this package:
Untested or doesn't work on Umbraco Cloud
Version 8.18.x (untested)

You must login before you can report on package compatibility.

Previously reported to work on versions: 7.15.x, 7.13.x, 7.12.x, 7.11.x, 7.10.x, 7.9.x, 7.8.x, 7.7.x, 7.6.x, 7.5.x

Package Information

  • Package owner: Jonathan Richards
  • Created: 07/02/2017
  • Current version 1.0.21
  • .NET version 4.5
  • License MIT
  • Downloads on Our: 12.7K
  • Downloads on NuGet: 312.3K
  • Total downloads : 325K

External resources