====== ThinkGeo UI Web for WebAPI ======
**Note:** This page is for ThinkGeo UI WebAPI V12 and above, we highly suggest you to upgrade to this version if you are on an old one. Here is a quick guide how to do it: [[thinkgeo_12_upgrade_guide|Updating to ThinkGeo 12]]. Version 12 supports both .NET Core and .NET Framework, the old versions support .NET Framework only. Here are the wikis for the old version: [[https://wiki.thinkgeo.com/wiki/map_suite_webapi_web_edition|Version 10 WebAPI]] and [[https://wiki.thinkgeo.com/wiki/map_suite_webapi_web_edition| Version 9 WebAPI]].
ThinkGeo 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 =====
>[[https://gitlab.com/thinkgeo/public/thinkgeo-web-maps|Quick Start Guide]] Helps you get you up to speed with integrating the ThinkGeo Web for WebAPI map control into your GIS software.
===== Product Guides =====
>[[ThinkGeo Web for WebAPI Installation Guide|Installation]] Walks you through installing the ThinkGeo UI control on your system and creating a simple GIS application.
> [[thinkgeo_license_guide#thinkgeo_web_winforms_webapi|License]] Introduces what licenses are needed and how licensing works for debugging and deploying projects using ThinkGeo UI.
>[[thinkgeo_dependencies|Dependencies]] Introduces the dependencies required by ThinkGeo Web for WebAPI, along with their features, versions and source websites.
>[[thinkgeo_runtime_license_guide_for_webapi|Deployment]] Walks you through deploying your ThinkGeo UI project to your user base.
>[[ThinkGeo Data Format Guide|Data Format]] Lists the various GIS data formats that are supported by the ThinkGeo UI map control, as well as any caveats to be aware of with certain formats.
> [[thinkgeo_12_upgrade_guide|Upgrading]] Describes how to upgrade to ThinkGeo UI 12 from previous versions of ThinkGeo UI or ThinkGeo Map Suite.
>[[ThinkGeo Style Guide|Style]] Explains how to use ThinkGeo UI's style system to beautifully represent your GIS mapping data. The guide includes an overview of styles, a detailed explanation of the various styles that ship with ThinkGeo, as well as a step-by-step guide to creating your own custom styles.
>[[ThinkGeo Serialization Guide|Serialization]] Explains how to use our custom serialization class to render your ThinkGeo 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.
>[[ThinkGeo Performance Guide|Performance]] Walks you through various ways you can increase performance in your .NET mapping application.
> [[thinkgeo_platform_coverage|Platform Coverage]] Shows which ThinkGeo UI controls run on which platforms (Windows, Linux, MacOS, etc).
===== Code Samples ===== ** All the samples are available on NuGet via the link below. **
[[thinkgeo_web_for_webapi_all_samples|Samples]]
===== Package ===== ===== API Documentation ===== * [[12.0/thinkgeo.ui.webapi|ThinkGeo.UI.WebAPI]]
This document covers the ''ThinkGeo.UI.WebAPI'' namespace which resides in the ThinkGeo.UI.WebAPI.dll assembly. It includes the map control itself, Overlays, and supported map classes. It also covers all the types in ''ThinkGeo.Core'' which is the key dependency of ThinkGeo UI WebAPI.
===== Change Logs ===== * [[thinkgeo_12_change_log|Major Changes in ThinkGeo UI 12]]
Details the major changes made in ThinkGeo UI 12 as compared to ThinkGeo UI 10 and earlier.
===== Frequently Asked Questions===== * **Can I use this Control in a WebAPI, WinForms or UWP application?** * **WebAPI:** Yes. This control is natively written in WebAPI so an WebAPI application is best for it. * **WinForms:** Yes. Microsoft provides an easy way to use a WebAPI component in a WinForms application, which keeps all the features in WebAPI and perfectly fits in a WinForms application. [[https://blog.thinkgeo.com/2019/05/23/using-the-thinkgeo-ui-control-for-webapi-in-your-winforms-app|Check out our how-to article]] for more details. * **UWP:** No, this component is not compatible with UWP applications. * **Do I have control over how the map looks and fits into my application**?
Yes, absolutely. ThinkGeo UI Web for WebAPI is a user control, so you can easily integrate it into your application just like any other user control from the toolbox. We expose a large amount of APIs that allow you to customize every aspect of the map and the user interface so that they fit in with the look and feel of your application.
* **What other software is required to work with ThinkGeo UI for WebAPI?**
You'll need either Microsoft Visual Studio 2019 or Visual Studio Code.
* **What type of map data does ThinkGeo UI for WebAPI Support?**
ThinkGeo UI for WebAPI comes with native support for the most popular vector and raster file formats. Check out our [[thinkgeo data format guide|Data Formats Guide]] for details.
* **How big of a learning curve is there to using ThinkGeo UI for WebAPI?**
ThinkGeo UI controls are designed to be easy to understand and easy to use. While mapping and GIS controls typically have a larger learning curve than other, simpler controls like grids or charts, we feel ThinkGeo has taken the complexity out of mapping and allows you to develop your application in days or weeks instead of months.
* **Where do I go if I need help with ThinkGeo UI for WebAPI?**
We have a very active [[https://community.thinkgeo.com|Developer Community discussion forum]], a large number of "How Do I?" sample applications with source code in C#, and we also offer professional services if you need to talk with a developer one-on-one.
* **How do I create/update/delete features on the map?**
The ThinkGeo UI for WebAPI provides specific methods that allow you to create, update and delete map features. Just follow the processes outlined in [[http://wiki.thinkgeo.com/wiki/_media/mapsuite10/webapi/the_logical_diagram.pdf|this diagram]].
===== Help & Support Guides ===== * [[Map Suite Support Options|Support Options]]
This article outlines various support options available through ThinkGeo. It explains the various methods and recommendations of which options work best depending on your issue.
* [[Map Suite Support Ticket Guide|Support Ticket Guide]]
This guide explains how to create a support ticket using the ThinkGeo customer portal. The guide also covers recommendation on when to use a support tickets versus other forms of support.
* [[Map Suite Discussion Forum Guide|Discussion Forum Guide]]
This guide explains how to create a constructive discussion forum post. It outlines the best practices in posting to ensure that your GIS questions get answered quickly and accurately.
* [[Map Suite Sending Data to Support|Sending Data to Support]]
This guide details the various ways of sending data to our support staff.
* [[map_suite_via_nuget|NuGet Guide]]
We provide our products via packages on NuGet. This will allow references to our products to be added and updated easily. We have three different types of packages on NuGet, feature packages, dependency packages, and product packages, which will be explained in detail below. Each of these packages will also have two different build branches, production and development.
* [[Map Suite Release Cycle Guide|Release Cycle Guide]]
This guide explains the process and rations behind ThinkGeo release schedule. It outlines release dates, version information, and various aspects related to publicly releasing ThinkGeo software.