Successfully reported this slideshow.
We use your LinkedIn profile and activity data to personalize ads and to show you more relevant ads. You can change your ad preferences anytime.

Using SharePoint's Geolocation Field - SPSUK 2014

3,533 views

Published on

My slide deck introducing the Geolocation Field in SharePoint 2013 and SharePoint Online.

Published in: Technology
  • Be the first to comment

  • Be the first to like this

Using SharePoint's Geolocation Field - SPSUK 2014

  1. 1. Using SharePoint’s Geolocation Field Mark Stokes – SharePoint Saturday UK 2014
  2. 2. Mark Stokes [MVP]  Red Plane  Microsoft Partner in North West UK  www.redplane.co.uk  @FlyRedPlane  Office 365, SharePoint, Azure, nopCommerce, Windows 8 Apps, Windows Phone Apps, iOS Apps, .Net  mark.stokes@redplane.co.uk  @MarkStokes  Interests: Travel, Technology, Photography, Raspberry Pi, Snowboarding, Wakeboaring, Running, Tough Mudder, My Dog - Hugo
  3. 3. Agenda  What is the Geolocation Field?  Adding Geolocation Field  Bing Maps License  Creating a Map view  Geolocation field example scenarios
  4. 4. What is the Geolocation Field?  SharePoint 2013 introduced a new field type named Geolocation that enables you to annotate SharePoint lists with location information.  In columns of type Geolocation, you can enter location information as a pair of latitude and longitude coordinates in decimal degrees or retrieve the coordinates of the user’s current location from the browser if it implements the W3C Geolocation API.  In the list, SharePoint 2013 displays the location on a map powered by Bing Maps.  A new view named Map View displays the list items as pushpins on a Bing Maps Ajax control V7 with the list items as cards on the left pane.  Together, the Geolocation field and the Map View enable you to give a spatial context to any information by integrating data from SharePoint into a mapping experience, and let your users engage in new ways in your web and mobile apps and solutions.
  5. 5. SP2013 On-Premises – Pre-Requisites  An MSI package named SQLSysClrTypes.msi must be installed on every SharePoint front-end web server to view the geolocation field value or data in a list.  This package installs components that implement the new geometry, geography, and hierarchy ID types in SQL Server 2008.  By default, this file is installed for SharePoint Online. However, it is not for an on-premises deployment of SharePoint Server 2013.  You must be a member of the Farm Administrators group to perform this operation.  http://msdn.microsoft.com/en-us/library/office/jj163135(v=office.15).aspx
  6. 6. Enabling the Geolocation Field  Bing Maps License Key - https://www.bingmapsportal.com  To set the Bing Maps key at the farm level using Windows PowerShell  Set-SPBingMapsKey –BingKey "<Enter a valid Bing Maps key>”  When you use Windows PowerShell, the Bing Maps key can be set only at the farm level. If you want to set the Bing Maps key at the web level, you can set the key programmatically.
  7. 7. Enabling the Geolocation Field  To set the Bing Maps key at the web level using custom code (C#) class Program { static void Main(string[] args) { SetBingMapsKey(); Console.WriteLine("Bing Maps set successfully"); } static private void SetBingMapsKey() { ClientContext context = new ClientContext("<Site Url>"); Web web = context.Web; web.AllProperties["BING_MAPS_KEY"] = "<Valid Bing Maps Key>” web.Update(); context.ExecuteQuery(); } }
  8. 8. Enabling the Geolocation Field  To set the Bing Maps key at the web level using custom code (JavaScript) function SetBingKey() { clientContext = new SP.ClientContext([Relative Web Address]); var web = clientContext.get_web(); var webProperties = web.get_allProperties(); webProperties.set_item("BING_MAPS_KEY", “[Enter Bing Maps Key here]”); web.update(); clientContext.load(web); clientContext.executeQueryAsync(function (sender, args) { alert("You have successfully entered BING map key on "+ web.get_title() + " site”); }, function (sender, args) { alert("Error: ” + args.get_message()); }); }
  9. 9. Map View  A Map View is a SharePoint view that displays a map (with data obtained from the Bing Maps service), using longitude and latitude entries from the Geolocation field type.  When the Geolocation field type is available on the SharePoint list, a map view can be created wither programmatically or from the SharePoint UI.  In the list, SharePoint 2013 displays the location on a map powered by Bing Maps.  In additions, a new view type named Map View displays the list items as pushpins on a Bing Maps Ajax control V7 with the list items as card on the left pane.
  10. 10. Map View  A map view provides three colors of pushpins, each of which provides a difference user experience. A pushpin on the map has the same color as the pushpin of the matching item in the left pane.  Orange Indicates that the Geolocation field for the item is mapped with the Bing Maps services.  Grey Indicates that the Geolocation field for the item is empty. The item cannot be mapped with Bing Maps services, so no pushpin for this item appears on the map.  Blue When a user hovers over a list item, the pushpin color changes from orange to blue. Both the pushpin in the left pane and the matching pushpin on the map change color
  11. 11. Create a Map View Programmatically class Program { static void Main(string[] args) { CreateMapView (); Console.WriteLine("A map view is created successfully"); } private static void CreateMapView() { // Replace <Site URL> and <List Title> with valid values. ClientContext context = new ClientContext("<Site Url>"); List oList = context.Web.Lists.GetByTitle("<List Title>"); ViewCreationInformation viewCreationinfo = new ViewCreationInformation(); // Replace <View Name> with the name you want for your map view. viewCreationinfo.Title = "<View Name>"; viewCreationinfo.ViewTypeKind = ViewType.Html; View oView = oList.Views.Add(viewCreationinfo); oView.JSLink = "mapviewtemplate.js"; oView.Update(); context.ExecuteQuery(); } }
  12. 12. Extending the Geoloaction field in a Content Query Webpart  Shows how to show the Map in a Content Query Web Part  Gives some good examples on changing the format of the Map View, such as zoom level http://pafederwitz.wordpress.com/2014/08/19/using-cqwp-to-display-sharepoint- geolocation-field/
  13. 13. Geolocation field example scenarios  Councils - Pot Hole reporting  Construction company / Oil rig – Health and Safety reporting  Logistics – vehicle tracking  Customer location heat maps  Statistical Reporting  Photo location Tagging  Office Locations  Power BI?
  14. 14. Power Map  Excel Formulas:  Lattitude: =MID(F2,FIND(" ",F2,10), FIND(")",F2) - FIND(" ",F2,10))  Longitude: =MID(F2,8,FIND(" ",F2,10)-8)
  15. 15. Geolocation “niggly” bits  Field is not indexed by search  Cannot “paste” list data into Quick Edit mode  Bing Maps only  You have to pay for a Bing Maps license
  16. 16. Links  Integrating location and map functionality in SharePoint 2013  http://msdn.microsoft.com/en-us/library/office/jj163135(v=office.15).aspx  Create a map view for the Geolocation field in SharePoint 2013  http://msdn.microsoft.com/en-us/library/office/jj656773(v=office.15).aspx  Getting started with the new Geolocation field in SharePoint 2013  http://zimmergren.net/technical/sp-2013-getting-started-with-the-new-geolocation-field-in-sharepoint-2013  Add a GeoLocation Field to SharePoint Online using PowerShell  http://sharepointryan.com/2013/08/12/add-a-geolocation-field-to-sharepoint-online-using-powershell/  Geolocation field in SharePoint 2013  http://www.sharepoint2013.me/Blog/Post/146/Geolocation-field-in-SharePoint-2013  Using Content Query Web Part to display SharePoint Geolocation Field  http://pafederwitz.wordpress.com/2014/08/19/using-cqwp-to-display-sharepoint-geolocation-field/
  17. 17. Thank You to Our Sponsors!

×