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.
====== ThinkGeo Cloud Colors ======
ThinkGeo Cloud Colors provides some ways to generate families of colors based on the input color. Check out [[https://vectormapsamples.thinkgeo.com/#GenerateColorThemes|Generate Color Themes]] for a quick look.


===== RESTful APIs =====
//**Try it Online**//
  *  Check out [[thinkgeo_cloud_quick_start_guide|Quick Start Guide]] and get an APIKey for free for 60 days. 
  * Visit our [[https://cloud.thinkgeo.com/help/|ThinkGeo Cloud API Explorer]], click the "Authorize" button at the top and enter your client credentials. You are then free to play with all the APIs online. 
  *  For all the APIs, check out [[https://cloud.thinkgeo.com/help/#/Colors|ThinkGeo Cloud Colors APIs]] and hit //**Try it Out**// button inside each API to start. 
There are two kinds of APIs provided by ThinkGeo Cloud Colors Utility that provide different color generation algorithms.

==== Generate Colors Based On A Specific Color ====

<code html>
HTTP GET 
https://cloud.thinkgeo.com/api/v1/color/scheme/{algorithm}/{inputColor}/{numberOfColors}?inFormat={inFormat}&outFormat={outFormat}&apiKey={apiKey}
</code>

//**URL Parameters**//
  * <html><span style="color:#a6e3ff;font-weight:bold;font-style:italic;">algorithm</span></html>: The algorithm, supported values are:
    * <html><span style="color:#a6e3ff;font-style:italic;">analogous</span>: <span style="color:#ce9178">Get a family of colors based on three analogous hues.</span></html>
    * <html><span style="color:#a6e3ff;font-style:italic;">complementary</span>: <span style="color:#ce9178">Get a family of colors based on two complementary hues.</span></html>
    * <html><span style="color:#a6e3ff;font-style:italic;">contrasting</span>: <span style="color:#ce9178">Get a family of colors based on two contrasting hues.</span></html>
    * <html><span style="color:#a6e3ff;font-style:italic;">sequential</span>: <span style="color:#ce9178">Get a family of colors with the same hue and sequential variances in lightness and saturation.</span></html>
    * <html><span style="color:#a6e3ff;font-style:italic;">qualitative</span>: <span style="color:#ce9178">Get a family of colors with qualitative variances in hue, but similar lightness and saturation.</span></html>
    * <html><span style="color:#a6e3ff;font-style:italic;">tetrad</span>: <span style="color:#ce9178">Get a family of colors based on a harmonious tetrad of hues.</span></html>
    * <html><span style="color:#a6e3ff;font-style:italic;">triad</span>: <span style="color:#ce9178">Get a family of colors based on a harmonious triad of hues.</span></html>
  * <html><span style="color:#a6e3ff;font-weight:bold;font-style:italic;">inputColor</span></html>: A base color, for different algorithms:
    * <html><span style="color:#a6e3ff;font-style:italic;">analogous</span>: <span style="color:#ce9178">Two analogous hues will be found for you.</span></html>
    * <html><span style="color:#a6e3ff;font-style:italic;">complementary</span>: <span style="color:#ce9178">A complementary hue will be found for you.</span></html>
    * <html><span style="color:#a6e3ff;font-style:italic;">contrasting</span>: <span style="color:#ce9178">A contrasting hue will be found for you.</span></html>
    * <html><span style="color:#a6e3ff;font-style:italic;">sequential</span>: <span style="color:#ce9178">It's the color on which you want to base the color collection.</span></html>
    * <html><span style="color:#a6e3ff;font-style:italic;">qualitative</span>: <span style="color:#ce9178">It's the color on which you want to base the color collection.</span></html>
    * <html><span style="color:#a6e3ff;font-style:italic;">tetrad</span>: <span style="color:#ce9178">Three harmonious hues will be found for you.</span></html>
    * <html><span style="color:#a6e3ff;font-style:italic;">triad</span>: <span style="color:#ce9178">It's the color on which you want to base the colors collections.</span></html>
  * <html><span style="color:#a6e3ff;font-weight:bold;font-style:italic;">numberOfColors</span></html>: The total number of colors you want to be returned, for different algorithms:
    * <html><span style="color:#a6e3ff;font-style:italic;">analogous</span>: <span style="color:#ce9178">The value must be between 3 and 54.</span></html>
    * <html><span style="color:#a6e3ff;font-style:italic;">complementary</span>: <span style="color:#ce9178">The value must be between 2 and 36.</span></html>
    * <html><span style="color:#a6e3ff;font-style:italic;">contrasting</span>: <span style="color:#ce9178">The value must be between 2 and 36.</span></html>
    * <html><span style="color:#a6e3ff;font-style:italic;">sequential</span>: <span style="color:#ce9178">The value must be between 1 and 255.</span></html>
    * <html><span style="color:#a6e3ff;font-style:italic;">qualitative</span>: <span style="color:#ce9178">The value must be between 1 and 255.</span></html>
    * <html><span style="color:#a6e3ff;font-style:italic;">tetrad</span>: <span style="color:#ce9178">The value must be between 4 and 72.</span></html>
    * <html><span style="color:#a6e3ff;font-style:italic;">triad</span>: <span style="color:#ce9178">The value must be between 3 and 54.</span></html>
  * <html><span style="color:#a6e3ff;font-weight:bold;font-style:italic;">apikey</span>: <span style="color:#ce9178">the apikey</span></html>
  * <html><span style="color:#a6e3ff;font-style:italic;">inFormat (optional)</span>: <span style="color:#ce9178">The format of the inputColor. Supported formats: Hex, RGB, HSL. If unspecified, the server will try to parse the inputColor in the order of Hex, RGB and HSL.</span></html>
  * <html><span style="color:#a6e3ff;font-style:italic;">outFormat (optional)</span>: <span style="color:#ce9178">The format in which you want the output colors. Supported formats: Hex, RGB, HSL. Defaults to Hex.</span></html>


//**Sample Request**//      
[[https://cloud.thinkgeo.com/api/v1/color/scheme/analogous/FF00FF/5?apiKey=mykey]]

==== Generate Colors Based On A Random Color ====

<code html>
HTTP GET 
https://cloud.thinkgeo.com/api/v1/color/scheme/{algorithm}/random/{numberOfColors}?outFormat={outFormat}&apiKey={apiKey}
</code>


//**URL Parameters**//
  * <html><span style="color:#a6e3ff;font-weight:bold;font-style:italic;">algorithm</span></html>: The algorithm, supported values are:
    * <html><span style="color:#a6e3ff;font-style:italic;">analogous</span>: <span style="color:#ce9178">Get a family of colors based on three analogous hues.</span></html>
    * <html><span style="color:#a6e3ff;font-style:italic;">complementary</span>: <span style="color:#ce9178">Get a family of colors based on two complementary hues.</span></html>
    * <html><span style="color:#a6e3ff;font-style:italic;">contrasting</span>: <span style="color:#ce9178">Get a family of colors based on two contrasting hues.</span></html>
    * <html><span style="color:#a6e3ff;font-style:italic;">sequential</span>: <span style="color:#ce9178">Get a family of colors with the same hue and sequential variances in lightness and saturation.</span></html>
    * <html><span style="color:#a6e3ff;font-style:italic;">qualitative</span>: <span style="color:#ce9178">Get a family of colors with qualitative variances in hue, but similar lightness and saturation.</span></html>
    * <html><span style="color:#a6e3ff;font-style:italic;">tetrad</span>: <span style="color:#ce9178">Get a family of colors based on a harmonious tetrad of hues.</span></html>
    * <html><span style="color:#a6e3ff;font-style:italic;">triad</span>: <span style="color:#ce9178">Get a family of colors based on a harmonious triad of hues.</span></html>
  * <html><span style="color:#a6e3ff;font-weight:bold;font-style:italic;">numberOfColors</span></html>: The total number of colors you want to be returned, for different algorithm:
    * <html><span style="color:#a6e3ff;font-style:italic;">analogous</span>: <span style="color:#ce9178">The value must be between 3 and 54.</span></html>
    * <html><span style="color:#a6e3ff;font-style:italic;">complementary</span>: <span style="color:#ce9178">The value must be between 2 and 36.</span></html>
    * <html><span style="color:#a6e3ff;font-style:italic;">contrasting</span>: <span style="color:#ce9178">The value must be between 2 and 36.</span></html>
    * <html><span style="color:#a6e3ff;font-style:italic;">sequential</span>: <span style="color:#ce9178">The value must be between 1 and 255.</span></html>
    * <html><span style="color:#a6e3ff;font-style:italic;">qualitative</span>: <span style="color:#ce9178">The value must be between 1 and 255.</span></html>
    * <html><span style="color:#a6e3ff;font-style:italic;">tetrad</span>: <span style="color:#ce9178">The value must be between 4 and 72.</span></html>
    * <html><span style="color:#a6e3ff;font-style:italic;">triad</span>: <span style="color:#ce9178">The value must be between 3 and 54.</span></html>
  * <html><span style="color:#a6e3ff;font-weight:bold;font-style:italic;">apikey</span>: <span style="color:#ce9178">the apikey</span></html>
  * <html><span style="color:#a6e3ff;font-style:italic;">outFormat (optional)</span>: <span style="color:#ce9178">The format in which you want the output colors. Supported formats: Hex, RGB, HSL. Defaults to Hex.</span></html>

//**Sample Request**//
[[https://cloud.thinkgeo.com/api/v1/color/scheme/analogous/random/5?apiKey=mykey]]



===== Consume From Client Side SDKs =====

A .Net SDK //ThinkGeo Cloud Client// is provided to consume the ThinkGeo Cloud Service as well. It's available on [[https://www.nuget.org/packages/ThinkGeo.Cloud.Client|NuGet]], here is the complete [[thinkgeo_cloud_.net_client_apis|API List]]. 

Sample Code: 
<code csharp>
using ThinkGeo.Cloud;
using ThinkGeo.MapSuite.Drawing;

ColorClient client = new ColorClient("Your Client ID", "Your Client Secret");
Dictionary<GeoColor, Collection<GeoColor>> results = client.GetColorsInAnalogousFamily(new GeoColor(255, 0, 255), 5);
Dictionary<GeoColor, Collection<GeoColor>> results = client.GetColorsInAnalogousFamily(5);

</code>

Native SDKs for //Python//, //iOS// and //Android// are coming soon. 

===== Samples =====

Online Sample:
  * [[https://vectormapsamples.thinkgeo.com/#GenerateColorThemes|ThinkGeo Cloud Color Online Sample]]

Desktop Sample:
  * [[https://github.com/ThinkGeo/ThinkGeoCloudColorSample-ForWpf|ThinkGeoCloudColorSample-ForWpf]] for for [[map_suite_desktop_for_wpf|Map Suite Desktop For WPF]]

Web Sample:

<code csharp>

Coming soon

</code>


Mobile Sample: 
<code csharp>

Coming soon

</code>
User Tools

Site Tools

Page Tools
