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 =====

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>
https://cloud.thinkgeo.com/api/v1/color/scheme/{algorithm}/{inputColor}/{numberOfColors}?inFormat={inFormat}&outFormat={outFormat}&apiKey={apiKey}</code>
//**Parameters**//
  * //**algorithm**//: The algorithm, supported values are:
    * //analogous//: Get a family of colors based on three analogous hues.
    * //complementary//: Get a family of colors based on two complementary hues.
    * //contrasting//: Get a family of colors based on two contrasting hues.
    * //sequential//: Get a family of colors with the same hue and sequential variances in lightness and saturation.
    * //qualitative//: Get a family of colors with qualitative variances in hue, but similar lightness and saturation.
    * //tetrad//: Get a family of colors based on a harmonious tetrad of hues.
    * //triad//: Get a family of colors based on a harmonious triad of hues.
  * //**inputColor**//: A base color, for different algorithms:
    * //analogous//: Two analogous hues will be found for you.
    * //complementary//: A complementary hue will be found for you.
    * //contrasting//: A contrasting hue will be found for you.
    * //sequential//: It's the color on which you want to base the color collection.
    * //qualitative//: It's the color on which you want to base the color collection.
    * //tetrad//: Three harmonious hues will be found for you.
    * //triad//: It's the color on which you want to base the colors collections.
  * //**numberOfColors**//: The total number of colors you want to be returned, for different algorithms:
    * //analogous//: The value must be between 3 and 54.
    * //complementary//: The value must be between 2 and 36.
    * //contrasting//: The value must be between 2 and 36.
    * //sequential//: The value must be between 1 and 255.
    * //qualitative//: The value must be between 1 and 255.
    * //tetrad//: The value must be between 4 and 72.
    * //triad//: The value must be between 3 and 54.
  * //**apikey**//: the apikey
  * //inFormat (optional)//: 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.
  * //outFormat (optional)//: The format in which you want the output colors. Supported formats: Hex, RGB, HSL. Defaults to Hex.


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

//**Responses**//
  *  //**200**//: Success. 
  *  //**401**//: Unauthorized. 
  *  //**403**//: Forbidden. 

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

Three analogous colors will be generated randomly as the base colors

<code>
https://cloud.thinkgeo.com/api/v1/color/scheme/{algorithm}/random/{numberOfColors}?outFormat={outFormat}&apiKey={apiKey}</code>
//**Parameters**//
  * //**algorithm**//: The algorithm, supported values are:
    * //analogous//: Get a family of colors based on three analogous hues.
    * //complementary//: Get a family of colors based on two complementary hues.
    * //contrasting//: Get a family of colors based on two contrasting hues.
    * //sequential//: Get a family of colors with the same hue and sequential variances in lightness and saturation.
    * //qualitative//: Get a family of colors with qualitative variances in hue, but similar lightness and saturation.
    * //tetrad//: Get a family of colors based on a harmonious tetrad of hues.
    * //triad//: Get a family of colors based on a harmonious triad of hues.
  * //**numberOfColors**//: The total number of colors you want to be returned, for different algorithm:
    * //analogous//: The value must be between 3 and 54.
    * //complementary//: The value must be between 2 and 36.
    * //contrasting//: The value must be between 2 and 36.
    * //sequential//: The value must be between 1 and 255.
    * //qualitative//: The value must be between 1 and 255.
    * //tetrad//: The value must be between 4 and 72.
    * //triad//: The value must be between 3 and 54.
  * //**apikey**//: the apikey
  * //outFormat (optional)//: The format in which you want the output colors. Supported formats: Hex, RGB, HSL. Defaults to Hex.

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

//**Responses**//
  *  //**200**//: Success. 
  *  //**401**//: Unauthorized. 
  *  //**403**//: Forbidden. 

//**Try it Online**//
  *  Check out [[thinkgeo_cloud_quick_start_guide|Quick Start Guide]] and get an APIKey for free for 60 days. 
  *  Authorize with the key at the top of [[https://cloud.thinkgeo.com/help/|ThinkGeo Cloud APIs]] and 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. 


===== 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.GisServer.Client|NuGet]], here is the complete [[thinkgeo_cloud_.net_client_apis|API List]]. 

Sample Code: 
<code csharp>
ColorClient client = new ColorClient("clientId", "clientSecret");

Dictionary<GeoColor, Collection<GeoColor>> results = client.GetColorsInAnalogousFamily(new GeoColor(255, 0, 255), 5);
Task<Dictionary<GeoColor, Collection<GeoColor>>> results = client.GetColorsInAnalogousFamily(new GeoColor(255, 0, 255), 5);

Dictionary<GeoColor, Collection<GeoColor>> results = client.GetColorsInAnalogousFamily(5);
Task<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]]
User Tools

Site Tools

Page Tools
