ThinkGeo Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Map Suite Web for WebAPI ======

<div msgbox>
**Note:** If you are using Map Suite 9.0 or previous versions of Map Suite product, please go to [[map_suite_webapi_edition|MapSuite 9.0 Wiki]]. The current page is for Map Suite 10.0 and future versions. It has different assemblies, licensing strategy and ways of distribution, and more. although the majority of previously built code should work without modification assuming the new namespaces are added.  For guidance on upgrading your existing code to Map Suite 10, please check out [[map_suite_10_upgrade_guide|MapSuite 10 Upgrade Guide]]. </div>

Map Suite Web for WebAPI allows you to easily build REST based web services to do the server side rendering, querying and geometric functions in your HTML5/Javascript application utilizing any JavaScript mapping client library (Leaflet, OpenLayers3 & KendoUI).

===== Getting Started =====

It's very easy to get started. You can start from getting the samples from GitHub, or start from creating a new application in your Visual Studio. GitHub samples run properly in MonoDevelop on Linux as well. Please have a quick look at the following short videos.  

\\
\\
<div play medialist>
[[media:map_suite_web_for_webapi_quickstart|{{mapsuite10:webapi:run_github_sample_on_windows.png?180x99|Map Suite Web for WebAPI Quickstart On Windows}}]]
\\
Run GitHub Sample on Windows (2'30")
</div>


<div play medialist>
[[media:map_suite_web_for_webapi_linux_quickstart|{{mapsuite10:webapi:run_github_sample_on_windows.png?180x99|Map SuiteWeb for WebAPI Quickstart on Linux}}]]
\\
Run GitHub Sample on Linux (3'06")
</div>


<div play medialist>
[[media:map_suite_web_for_webapi_hello_world|{{mapsuite10:webapi:Run_HelloWorld_Sample_on_Windows.png?180x99|Map Suite Web for WebAPI Hello World}}]]
\\
Hello World on Windows (3'09")
</div>


<div dokuteaser>
> [[Map Suite Web For WebAPI Quick Start Guide|Quick Start Guide]]
Helps you get started building your first application with the Map Suite Web for WebAPI.  
</div>


===== Product Guides & Appendices=====


<div dokuteaser>
> [[Map Suite Data Format Guide|Data Format Guide]]
Walks the various GIS data format that are supported in the map control. It also list any caveats related to the use of that format in your mapping application.
</div>

<div dokuteaser>
> [[Map Suite Style Guide New|Style Guide]]
Explains how to use styles to beautifully represent your GIS mapping data. It includes an overview of styles, a detailed explanation of the various styles that ship with Map Suite, as well as a step by step guide of creating your own custom styles.  
</div>

<div dokuteaser>
> [[Map Suite Serialization Guide|Serialization Guide]]
Explains how to use our custom serialization class to render your Map Suite objects to XML, or other format etc. This allows your GIS application to easily save things such as Layers, Styles, or even whole maps to XML to be recalled at a later time. 
</div>


<div dokuteaser>
> [[Map Suite Web For WebAPI Installation Guide|Installation Guide]]
Walks you through installing the map control on your system and creating a simple GIS application. 
</div>

<div dokuteaser>
> [[map_suite_deployment_license_guide_for_web|Deployment Guide]]
Walks you through deploying your GIS software using the map control into a production environment.
</div>

<div dokuteaser>
> [[map_suite_mono_environment_setup_guide_on_linux|Linux Development Guide]]
Walks you through deploying your GIS software using the map control into a production environment.
</div>

<div dokuteaser>
> [[map_suite_dependencies|Dependencies Guide]]
Introduces the dependencies Map Suite Web for WebAPI needs with their features, versions and source websites.
</div>

<div dokuteaser>
> [[Map Suite Performance Guide|Performance Guide]]
Walks you through various ways you can increase performance in your .Net GIS application.
</div>

<div dokuteaser>
> [[Map Suite Web For WebAPI Azure Deployment Guide |Azure Deployment Guide (Coming Soon)]]
Walks you through deploying your project using the map control into a windows azure cloud service and register the map control.
</div>

<div dokuteaser>
> [[Map Suite SQLite|SQLite Guide]]
Walks you through using SQLite as a storage format.
</div>

<div dokuteaser>
> [[map_suite_license_guide#thinkgeomapsuite_for_web_webforms_mvc_webapi|License Guide]]
Introduces what licenses are needed / how the license would work for debugging/deploying the Map Suite products
</div>


<div dokuteaser>
> [[map_suite_10_upgrade_guide|Upgrade Guide]]
Introduces how to upgrade to Map Suite 10.0 from Map Suite 9.0 or previous version.
</div>

<div dokuteaser>
> [[map_suite_platform_coverage|Coverage Guide]]
Show Map Suite features coverage of different product and different platfoms 
</div>

===== Learning Samples =====
<div #learningsampleall>
<div #learningsampleleft>
[[http://wiki.thinkgeo.com/wiki/map_suite_web_for_webapi_all_samples|{{webapiedition:screenshot:learning_samples_all.png?270x150|Learn More}}]]
</div>
<div #learningsampleright>
<div #learningdesc>
Browse the demo applications to see the power of Map Suite Web for WebAPI and how it can be utilized to build professional grade mapping applications using both the Leaflet and OpenLayers JavaScript mapping libraries.
</div>
<div #learningmore>[[http://wiki.thinkgeo.com/wiki/map_suite_web_for_webapi_all_samples|Explore and Study "All Learning Sample" now →]]</div>
<div #learningmore>[[http://wiki.thinkgeo.com/wiki/map_suite_all_samples|Explore and Study "All Samples Across all the Products" now →]]</div>
</div>
</div>
<div newline></div>
<div items>
<div medialist gallery>
[[https://github.com/ThinkGeo/GettingStartedSample-ForWebApi|{{webapiedition:screenshot:GettingStarted_Desktop_202px.png|Getting Started}}]]
<div gallery_title>Getting Started</div>
<div desc>[[https://github.com/ThinkGeo/GettingStartedSample-ForWebApi|All of the chapters of the Map Suite Developer Manual in one place so you can easily search for a topic.]]</div>
</div>
<div medialist gallery>
[[https://github.com/ThinkGeo/OverlaysSample-ForWebApi|{{webapiedition:screenshot:Overlays_WebAPI_202px.png|Overlays}}]]
<div gallery_title>Overlays</div>
<div desc>[[https://github.com/ThinkGeo/OverlaysSample-ForWebApi|Discover how to use Overlays to build up your map or add existing basemaps to your application.]]</div>
</div>
<div medialist gallery>
[[https://github.com/ThinkGeo/LayersSample-ForWebApi|{{webapiedition:screenshot:Layers_202px.png|Layers}}]]
<div gallery_title>Layers</div>
<div desc>[[https://github.com/ThinkGeo/LayersSample-ForWebApi|Explore all the different types of layers and data formats you can use to build up your map.]]</div>
</div>
<div medialist gallery>
[[https://github.com/ThinkGeo/BasicStylingSample-ForWebApi|{{webapiedition:screenshot:styles_desktop_202px.png|Styles}}]]
<div gallery_title>Styles</div>
<div desc>[[https://github.com/ThinkGeo/BasicStylingSample-ForWebApi|Learn how to apply basic styles to render your vector data layers.]]</div>
</div>
<div medialist gallery>
[[https://github.com/ThinkGeo/VisualizationSample-ForWebApi|{{webapiedition:screenshot:visualization_desktop_202px.png|Visualizing}}]]
<div gallery_title>Visualizing</div>
<div desc>[[https://github.com/ThinkGeo/VisualizationSample-ForWebApi|Learn about the styles you can use with Map Suite to visualize your data.]]</div>
</div>
<div medialist gallery>
[[https://github.com/ThinkGeo/LabelingSample-ForWebApi|{{webapiedition:screenshot:labelstyling_desktop_202px.png|Labeling}}]]
<div gallery_title>Labeling</div>
<div desc>[[https://github.com/ThinkGeo/LabelingSample-ForWebApi|Explore different techniques for labeling your features.]]</div>
</div>
<div medialist gallery>
[[https://github.com/ThinkGeo/MarkerAndPopupSample-ForWebApi|{{webapiedition:screenshot:markersandpopups_desktop_202px.png|Markers & Pop Ups}}]]
<div gallery_title>Markers & Pop Ups</div>
<div desc>[[https://github.com/ThinkGeo/MarkerAndPopupSample-ForWebApi|Explore how to make your maps more interactive by using Markers and Pop Ups]]</div>
</div>
<div medialist gallery>
[[https://github.com/ThinkGeo/DrawingAndEditingSample-ForWebApi|{{webapiedition:screenshot:draweditfeatures_desktop_202px.png|Drawing & Editing}}]]
<div gallery_title>Drawing & Editing</div>
<div desc>[[https://github.com/ThinkGeo/DrawingAndEditingSample-ForWebApi|Learn how to draw new features or edit existing features on the map.]]</div>
</div>

<div medialist gallery>
[[https://github.com/ThinkGeo/QueryToolsSample-ForWebApi|{{webapiedition:screenshot:querying_desktop_202px.png|Getting Started}}]]
<div gallery_title>Querying</div>
<div desc>[[https://github.com/ThinkGeo/QueryToolsSample-ForWebApi|Learn about all the different ways you can query your data.]]</div>
</div>

<div medialist gallery>
[[https://github.com/ThinkGeo/ProjectionSample-ForWebApi|{{webapiedition:screenshot:projection_desktop_202px.png|Projection}}]]
<div gallery_title>Projection</div>
<div desc>[[https://github.com/ThinkGeo/ProjectionSample-ForWebApi|Learn about Map Projection and how to apply it your data.]]</div>
</div>

<div medialist gallery>
[[https://github.com/ThinkGeo/GeometricFunctionsSample-ForWebApi|{{webapiedition:screenshot:geofunctions_desktop_202px.png|Geometric Functions}}]]
<div gallery_title>Geometric Functions</div>
<div desc>[[https://github.com/ThinkGeo/GeometricFunctionsSample-ForWebApi|Explore the different ways to manipulate features using geometric functions.]]</div>
</div>

<div medialist gallery>
[[https://github.com/ThinkGeo/AdornmentsSample-ForWebApi|{{webapiedition:screenshot:Adornments_webapiedtion_202px.png|Adornments}}]]
<div gallery_title>Adornments</div>
<div desc>[[https://github.com/ThinkGeo/AdornmentsSample-ForWebApi|Learn how to add legends, scale bars, north arrows and many more adornments to your map.]]</div>
</div>

<div medialist gallery>
[[https://github.com/ThinkGeo/TopologyValidationSample-ForWebApi|{{webapiedition:screenshot:topology_desktop_202px.png|Topology}}]]
<div gallery_title>Topology</div>
<div desc>[[https://github.com/ThinkGeo/TopologyValidationSample-ForWebApi|Explore the topology rules and how to apply it to your data.]]</div>
</div>


<div medialist gallery>
[[https://github.com/ThinkGeo/PrintingSample-ForWebApi|{{webapiedition:screenshot:printing_desktop_202px.png|Printing}}]]
<div gallery_title>Printing</div>
<div desc>[[https://github.com/ThinkGeo/PrintingSample-ForWebApi|Learn how to implement printing capabilities into your application.]]</div>
</div>


<div medialist gallery>
[[http://wiki.thinkgeo.com/wiki/map_suite_web_for_webapi_project_templates|{{webapiedition:codesamples:Map Suite Web Edition Project Templates SiteSelection.png|Project Templates}}]]
<div gallery_title>Project Templates</div>
<div desc>[[http://wiki.thinkgeo.com/wiki/map_suite_web_for_webapi_project_templates|Explore these project templates which combine several different concepts to make real world applications]]</div>
</div>
</div>
<div newline></div>
<div newline></div>

===== Package =====
==== Standard  ====
Standard version contains all packages that Map Suite supported on this platform which should meet most user's requirements.

 [[map_suite_web_for_webapi_package_coverage|Compare with Barebone]]

==== Barebone ====
Barebone version is intended for experienced Map Suite developers who require fine grain control over their dependencies.  All other developer please use the Standard Edition.

 [[map_suite_web_for_webapi_package_coverage|Compare with Standard]]

=====API Documentation=====

  * [[map_suite_web_for_webapi_api|ThinkGeo.MapSuite.WebApi]]<div>The Map Suite Web for WebAPI API documentation covers the ThinkGeo.MapSuite.WebApi namespace which resides in the ThinkGeo.MapSuite.WebApi.dll assembly. It contains all of the Map Suite Web for WebAPI specific classes such as the map control itself, Overlays, and supported map classes.</div>



===== Change Logs =====

  * [[Map Suite Web for WebApi Release Change Log|API Change Log]]<div>The Map Suite Web for WebAPI change log details the changes made to the product for each major release cycle.</div>

  * [[Map Suite Web for WebAPI Features Bug Fixes Change Log|Features & Bug Fixes Change Log]]<div>This change log details the new features and bug fixes applied to the product for each major release cycle.</div>


===== Videos =====

> **Map Suite Web for WebAPI Sample App Walkthrough Video Series**

Step through the Map Suite Web for WebAPI sample applications and see how they're put together. We'll demonstrate how to use each app, then take you through every part of the source code and show you how it works.\\ 

**Tip**: //You'll want to select "Fullscreen" to properly read the source code.//


<div play medialist>
[[webapiedition:Introduction to the Web API Edition|{{webapiedition:screenshot:GettingStarted_Desktop.png?180x99|Screenshot}}]]
\\
Getting Started
</div>

<div play medialist>
[[webapiedition:Introduction to the Web API Edition Overlays|{{webapiedition:screenshot:Overlays_WebAPI_202px.png?180x99|Screenshot}}]]
\\
Overlays
</div>

<div play medialist>
[[webapiedition:Introduction to the Web API Edition Layers|{{webapiedition:screenshot:Layers_202px.png?180x99|Screenshot}}]]
\\
Layers
</div>

<div play medialist>
[[webapiedition:Introduction to the Web API Edition Styles|{{webapiedition:screenshot:styles_desktop_202px.png?180x99|Screenshot}}]]
\\
Styles
</div>

<div play medialist>
[[webapiedition:Introduction to the WebAPI Edition Visualizing Data|{{webapiedition:screenshot:Visualization_Desktop.png?180x99|Screenshot}}]]
\\
Visualizing Data
</div>

<div play medialist>
[[webapiedition:Introduction to the Web API Edition Labeling|{{webapiedition:screenshot:LabelStyling_Desktop.png?180x99|Screenshot}}]]
\\
Labeling
</div>

<div play medialist>
[[webapiedition:Introduction to the Web API Edition Markers and Pop Ups|{{webapiedition:screenshot:markersandpopups_desktop_202px.png?180x99|Screenshot}}]]
\\
Markers & Pop Ups
</div>

<div play medialist>
[[webapiedition:Introduction to the Web API Edition Drawing Editing|{{webapiedition:screenshot:DrawEditFeatures_Desktop.png?180x99|Screenshot}}]]
\\
Drawing & Editing
</div>

<div play medialist>
[[webapiedition:Introduction to the Web API Edition Querying|{{webapiedition:screenshot:querying_desktop_202px.png?180x99|Screenshot}}]]
\\
Querying
</div>

<div play medialist>
[[webapiedition:Introduction to the Web API Edition Projection|{{webapiedition:screenshot:projection_desktop_202px.png?180x99|Screenshot}}]]
\\
Projection
</div>

<div play medialist>
[[webapiedition:Introduction to the Web API Edition Geometric Functions|{{webapiedition:screenshot:GeoFunctions_Desktop.png?180x99|Screenshot}}]]
\\
Geometric Functions
</div>

<div play medialist>
[[webapiedition:Introduction to the Web API Edition Project Templates|{{webapiedition:codesamples:Map Suite Web Edition Project Templates SiteSelection.png?180x99|Screenshot}}]]
\\
Project Templates
</div>

<div play medialist>
[[webapiedition:WebAPI Webinar November 19, 2015|{{webapiedition:screenshot:video.png?180x99|Screenshot}}]]
\\
WebAPI Webinar November 19, 2015
</div>

<div play medialist>
[[webapiedition:Introduction to the Web API Edition Adornments|{{:no_screenshot_202px.jpg?180x99|Screenshot}}]]
\\
Adornments
</div>

<div play medialist>
[[webapiedition:Introduction to the Web API Edition Topology|{{webapiedition:screenshot:topology_desktop_202px.png|Screenshot}}]]
\\
Topology
</div>

<div play medialist>
[[webapiedition:Introduction to the Web API Edition Printing|{{webapiedition:screenshot:printing_desktop_202px.png|Screenshot}}]]
\\
Printing
</div>

<div newline/>
> **Extending Map Suite Video Series**

{{page>map_suit_extending_map_suite_video_series}}
===== Screenshots =====
Screen Shots of the Map Suite Web for WebAPI on different types of devices.

> ** Traditional Browsers **
<div>
<div medialist imagewithremaker autofit_height>
{{webapiedition:screenshot:GettingStarted_Desktop.png?180|Getting Started with Map}} 
\\
//Getting Started with Map//
</div>

<div medialist imagewithremaker autofit_height>
{{webapiedition:screenshot:Visualization_Desktop.png?180|Visualization}} 
\\
//Visualization//
</div>

<div medialist imagewithremaker autofit_height>
{{webapiedition:screenshot:LabelStyling_Desktop.png?180|LabelStyling}} 
\\
//LabelStyling//
</div>

<div medialist imagewithremaker autofit_height>
{{webapiedition:screenshot:GeoFunctions_Desktop.png?180|GeoFunctions}} 
\\
//GeoFunctions//
</div>

<div medialist imagewithremaker autofit_height>
{{webapiedition:screenshot:DrawEditFeatures_Desktop.png?180|DrawEditFeatures}} 
\\
//DrawEditFeatures//
</div>

<div medialist imagewithremaker autofit_height>
{{webapiedition:screenshot:SiteSelection_Desktop.png?180|SiteSelection}} 
\\
//SiteSelection//
</div>

<div medialist imagewithremaker autofit_height>
{{webapiedition:screenshot:Visualization-weather_Desktop.png?180|Visualization-weather}} 
\\
//Visualization-weather//
</div>
</div>

<div newline></div>
<div newline></div>
> **Tablets**
<div>
<div medialist imagewithremaker autofit_height>
{{webapiedition:screenshot:GettingStarted_IPad.png?180|GettingStarted}} 
\\
//GettingStarted//
</div>

<div medialist imagewithremaker autofit_height>
{{webapiedition:screenshot:Visualization_IPad.png?180|Visualization}} 
\\
//Visualization//
</div>

<div medialist imagewithremaker autofit_height>
{{webapiedition:screenshot:LabelStyling_IPad.png?180|LabelStyling}} 
\\
//LabelStyling//
</div>

<div medialist imagewithremaker autofit_height>
{{webapiedition:screenshot:GeoFunctions_IPad.png?180|GeoFunctions}} 
\\
//GeoFunctions//
</div>

<div medialist imagewithremaker autofit_height>
{{webapiedition:screenshot:DrawEditFeatures_IPad.png?180|DrawEditFeatures}} 
\\
//DrawEditFeatures//
</div>

<div medialist imagewithremaker autofit_height>
{{webapiedition:screenshot:SiteSelection_IPad.png?180|SiteSelection}} 
\\
//SiteSelection//
</div>

<div medialist imagewithremaker autofit_height>
{{webapiedition:screenshot:Visualization-weather_IPad.png?180|Visualization-weather}} 
\\
//Visualization-weather//
</div>
</div>

<div newline></div>
<div newline></div>
> **Phones** 
<div>
<div medialist imagewithremaker autofit_height>
{{webapiedition:screenshot:GettingStarted_IPhone.png?90x184|GettingStarted}} 
\\
//GettingStarted//
</div>

<div medialist imagewithremaker autofit_height>
{{webapiedition:screenshot:Visualization_IPhone.png?90x184|Visualization}} 
\\
//Visualization//
</div>

<div medialist imagewithremaker autofit_height>
{{webapiedition:screenshot:LabelStyling_IPhone.png?90x184|LabelStyling}} 
\\
//LabelStyling//
</div>

<div medialist imagewithremaker autofit_height>
{{webapiedition:screenshot:GeoFunctions_IPhone.png?90x184|GeoFunctions}} 
\\
//GeoFunctions//
</div>

<div medialist imagewithremaker autofit_height>
{{webapiedition:screenshot:DrawEditFeatures_IPhone.png?90x184|DrawEditFeatures}} 
\\
//DrawEditFeatures//
</div>

<div medialist imagewithremaker autofit_height>
{{webapiedition:screenshot:SiteSelection_IPhone.png?90x184|SiteSelection}} 
\\
//SiteSelection//
</div>

<div medialist imagewithremaker autofit_height>
{{webapiedition:screenshot:Visualization-weather_IPhone.png?90x184|Visualization-weather}} 
\\
//Visualization-weather//
</div>
</div>
<div newline></div>
<div newline></div>


===== Frequently Asked Questions =====
    * [[Map Suite Web For WebAPI FAQ General Questions|General Questions]] <div>All the frequently asked questions about Map Suite Web for WebAPI.</div>
    * [[Map Suite Web For License FAQ General Questions|License Questions]] <div>All the frequently asked questions about Map Suite Web for License.</div>




===== Help & Support Guides =====
{{page>help_support_guides}}
User Tools

Site Tools

Page Tools
