Using SharePoint's Geolocation Field - SPSUK 2014
Download as PPTX, PDF1 like3,795 views
The document discusses using the geolocation field in SharePoint to annotate lists with location data. It describes how the geolocation field stores latitude and longitude coordinates and can display locations on a Bing Maps view. It provides instructions for enabling the geolocation field, creating a map view, and examples of using geolocation data, such as for asset tracking or photo tagging.
![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](https://image.slidesharecdn.com/spsuk14-geolocationfield-141202125746-conversion-gate01/85/Using-SharePoint-s-Geolocation-Field-SPSUK-2014-2-320.jpg)
![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();
}
}](https://image.slidesharecdn.com/spsuk14-geolocationfield-141202125746-conversion-gate01/85/Using-SharePoint-s-Geolocation-Field-SPSUK-2014-7-320.jpg)
![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());
});
}](https://image.slidesharecdn.com/spsuk14-geolocationfield-141202125746-conversion-gate01/85/Using-SharePoint-s-Geolocation-Field-SPSUK-2014-8-320.jpg)
![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();
}
}](https://image.slidesharecdn.com/spsuk14-geolocationfield-141202125746-conversion-gate01/85/Using-SharePoint-s-Geolocation-Field-SPSUK-2014-11-320.jpg)
Using SharePoint's Geolocation Field - SPSUK 2014
- 1. Using SharePoint’s Geolocation Field Mark Stokes – SharePoint Saturday UK 2014
- 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. Agenda What is the Geolocation Field? Adding Geolocation Field Bing Maps License Creating a Map view Geolocation field example scenarios
- 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. 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. 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. 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. 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. 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. 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. 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. 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. 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. Power Map Excel Formulas: Lattitude: =MID(F2,FIND(" ",F2,10), FIND(")",F2) - FIND(" ",F2,10)) Longitude: =MID(F2,8,FIND(" ",F2,10)-8)
- 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. 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. Thank You to Our Sponsors!