User Tools

Site Tools


Map Suite Web for WebApi Installation Guide

Welcome to Map Suite™ from ThinkGeo, a complete family of GIS software development kits that will help you build cutting-edge mapping and spatially aware applications. Using Map Suite's intuitive APIs, programmers who write code in C# or VB.NET can create professional-grade Geographic Information Systems (GIS) software featuring interactive maps, spatial analysis, geoprocessing and location, and much more. Even developers inexperienced with GIS can add fully-functional maps to their projects in just moments.

In this article, we will discuss how to install Map Suite on your computer and prepare your development environment for creating Map Suite-powered projects.

System Requirements

  • Microsoft Windows 7 or newer, or Microsoft Windows Server 2012 or newer
  • Visual Studio or Visual Studio Community, 2012 or newer
  • .NET Framework 4.5 or higher
  • 1.2 GHz Intel® Core™ processor or better recommended
  • 2 GB RAM or more recommended
  • C#, Visual Basic .NET, and other .NET-compatible languages are supported for development

Environment Preparation

Install .NET Framework 4.5

Map Suite requires the Microsoft .NET Framework 4.5 or newer.

Install Visual Studio or Visual Studio Community

To develop an application with any Map Suite control or component, you will need one of the following development environments:

Begin Your Development

Launch the ThinkGeo Product Center application to explore the exciting world of Map Suite GIS. Each Map Suite edition ships with code samples, kick-start templates, videos and more to help you start developing your first application quickly!

Next, we recommend that you take a look at our ThinkGeo Product Center article to learn how to develop your application around the Product Center application.

Setup Mono runtime and MonoDevelop IDE

The Map Suite Mono environment setup guide on Linux will guide you through a process of setting up a Mono environment for Map Suite WebAPI and Map Suite WebForms. The guide supports Map Suite and higher.

The purpose of this guide is to help you quickly setup a Map Suite WebAPI or Map Suite WebForms environment on Linux.

Map Suite controls are created with Microsoft .Net Frameworks. These controls depend on the Mono runtime and MonoDevelop IDE. The following steps will guide you to setup a Mono environment on Linux.

Setup Mono runtime and MonoDevelop IDE

For Winforms:

  • Prepare a clean Ubuntu environment with version 16.04.01 LTS.
  • Press Ctrl + Alt + T to open a terminal window.
  • Install the MonoDevelop IDE as it is recommended to develop on Linux. Run the following command to install Mono Develop on your computer.
  sudo apt-get install monodevelop
  • Type monodevelop in the terminal to open MonoDevelop or you can click on the left top corner of task bar to search MonoDevelop and run it. You can open the Visual Studio solution file via MonoDevelop.

WebAPI / WebForms:

  • Follow the above steps, then proceed to the next step.
  • Add the Mono Project GPG signin key and the package repository to your system (if you don’t use sudo, be sure to switch to root). Please issue the following commands line by line:
sudo apt-key adv --keyserver hkp:// --recv-keys 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF 
echo "deb wheezy main" | sudo tee /etc/apt/sources.list.d/mono-xamarin.list
sudo apt-get update
  • Then, install the specific version of MonoDevelop that gives you a working ASP.NET add-in:
sudo apt-get install monodevelop=
  • To host the ASP.Net debug sample, install XSP4.
sudo apt-get install mono-xsp4
  • Install the mono environment. Issue the following commands line by line, depending on network this step may take a few minutes.
sudo apt-get install mono-devel
sudo apt-get install mono-complete
sudo apt-get install referenceassemblies-pcl

Notice: Please enter Y when asked to continue. *

  • Run monodevelop command in terminal to open MonoDevelop, or you can click on left top corner of task bar to search MonoDevelop and run it. You can open Visual Studio solution file via MonoDevelop.

Migrate Map Suite Web Projects from Windows to Linux

We can create a WebForms project in MonoDevelop and install the NuGet packages. However, there are a couple of necessary steps:

  1. We cannot drag and drop to add a control to the design page as MonoDevelop does not have a designer. We need to write aspx code manually.
  2. The map control needs the ScriptManager class in System.Web.Extensions assembly, but it is not referenced by default. We need to add it manually.

The WebAPI and WebForms projects created in Visual Studio on Windows cannot run on Linux with MonoDevelop directly. The following steps show how to migrate them to MonoDevelop.

  1. Create a WebAPI or WebForms project with Visual Studio and copy the solution to Linux. Open the solution with MonoDevelop.
  2. After the project is created in Visual Studio, the project will rely on two NuGet packages by default. < * Microsoft.CodeDom.Providers.DotNetCompilerPlatform > and < * Microsoft.Net.Compilers >

These two packages are not supported on Linux. You need to uninstall them.

  • Open the Packages solution folder.
  • Right-Click on the package that you want to uninstall and click on remove.(See figure 1.)

Figure 1. Uninstall the package that you want.

  • In Web.config of this project, you need to remove the xml element named system.codedom. Usually it will be found on the bottom of Web.config.
  • After making these changes, press F5 to start the WebAPI project.
map_suite_web_for_webapi_installation_guide.txt · Last modified: 2017/03/23 06:08 by marklee