This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
thinkgeo_cloud_projection [2019/03/04 18:55] sacha [ThinkGeo Cloud Projection] |
thinkgeo_cloud_projection [2019/06/21 21:06] (current) brianr Fixed some leftover references to Geocoding |
||
---|---|---|---|
Line 1: | Line 1: | ||
====== ThinkGeo Cloud Projection ====== | ====== ThinkGeo Cloud Projection ====== | ||
- | ThinkGeo Cloud Projection provides RESTful APIs to re-project the shape between two projections. Check out the [[https://cloudclientsamples.thinkgeo.com/|online sample]] for a quick look. | + | ThinkGeo Cloud Projection provides RESTful APIs to re-project a point, line, or polygon shape between two coordinate systems. Check out the [[https://samples.thinkgeo.com/cloud/#TransformProjection|online sample]] for a quick look. |
===== RESTful APIs ===== | ===== RESTful APIs ===== | ||
Line 6: | Line 6: | ||
* //**Try it Online**:// All the ThinkGeo Projection RESTful APIs can be tested online following the instructions below: | * //**Try it Online**:// All the ThinkGeo Projection RESTful APIs can be tested online following the instructions below: | ||
* Get a ThinkGeo Cloud Client Key. Check out [[https://wiki.thinkgeo.com/wiki/thinkgeo_cloud_client_keys_guideline|ThinkGeo Cloud Client Keys Guideline]] see how to apply one. It's free for 60 days. | * Get a ThinkGeo Cloud Client Key. Check out [[https://wiki.thinkgeo.com/wiki/thinkgeo_cloud_client_keys_guideline|ThinkGeo Cloud Client Keys Guideline]] see how to apply one. It's 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. | + | * 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. |
- | //**ThinkGeo Cloud Geocoding provides the following Restful APIs**:// | + | //**ThinkGeo Cloud Projection provides the following Restful APIs**:// |
+ | ==== Project Point ==== | ||
+ | Converts a point from one spatial reference system to another. | ||
<code html> | <code html> | ||
- | <!-- Converts a point from one spatial reference system to another --> | ||
HTTP GET | HTTP GET | ||
https://cloud.thinkgeo.com/api/v1/projection/{pointY},{pointX} | https://cloud.thinkgeo.com/api/v1/projection/{pointY},{pointX} | ||
</code> | </code> | ||
- | //**Parameters**// | + | //**URL Parameters**// |
- | * //**pointY**//: __Required__. The Y coordinate of the point. | + | - //All parameters for this API are required and must be specified on each request.// |
- | * //**pointX**//: __Required__. The X coordinate of the point. | + | * <html><span class="api-parameter"><span class="api-parameter-name">pointY:</span> The Y coordinate of the point.</span></html> |
- | * //**fromProj**//: __Required__. The EPSG/ESRI ID or Proj4 projection string describing the original spatial reference | + | * <html><span class="api-parameter"><span class="api-parameter-name">pointX:</span> The X coordinate of the point.</span></html> |
- | system in which the geometry is expressed. If using a Proj4 string, the value should be | + | * <html><span class="api-parameter"><span class="api-parameter-name">fromProj:</span> The EPSG/ESRI ID or Proj4 projection string describing the original spatial reference system in which the geometry is expressed. If using a Proj4 string, the value should be URL-encoded.</span></html> |
- | URL-encoded. | + | * <html><span class="api-parameter"><span class="api-parameter-name">toProj:</span> The EPSG/ESRI ID or Proj4 projection string describing the target spatial reference system that you want the geometry reprojected to. If using a Proj4 string, the value should be URL-encoded.</span></html> |
- | * //**toProj**//: __Required__. The EPSG/ESRI ID or Proj4 projection string describing the target spatial reference | + | |
- | system that you want the geometry reprojected to. If using a Proj4 string, the value | + | |
- | should be URL-encoded. | + | |
+ | Visit [[https://cloud.thinkgeo.com/help/#/Projection/ProjectPointV1|ProjectPoint]] and click "Try It Out" to explore this API online. | ||
+ | |||
+ | ==== Project Geometry ==== | ||
+ | Converts geometry in Well Known Text format from one spatial reference system to another. | ||
- | * Hit //**Try it Out**// button below [[https://cloud.thinkgeo.com/help/#/Projection/ProjectPointV1|ProjectPoint]] to test it online. | ||
<code html> | <code html> | ||
- | <!-- Converts geometry in Well Known Text format from one spatial reference system to another --> | ||
HTTP GET | HTTP GET | ||
https://cloud.thinkgeo.com/api/v1/projection | https://cloud.thinkgeo.com/api/v1/projection | ||
</code> | </code> | ||
- | //**Parameters**// | + | //**URL Parameters**// |
- | * //**wkt**//: __Required__. The geometry that you want to reproject. | + | - //All parameters for this API are required and must be specified on each request.// |
- | * //**fromProj**//: __Required__. The EPSG/ESRI ID or Proj4 projection string describing the original spatial reference | + | * <html><span class="api-parameter"><span class="api-parameter-name">wkt:</span> The geometry that you want to reproject.</span></html> |
- | system in which the geometry is expressed. If using a Proj4 string, the value should be | + | * <html><span class="api-parameter"><span class="api-parameter-name">fromProj:</span> The EPSG/ESRI ID or Proj4 projection string describing the original spatial reference system in which the geometry is expressed. If using a Proj4 string, the value should be URL-encoded.</span></html> |
- | URL-encoded. | + | * <html><span class="api-parameter"><span class="api-parameter-name">toProj:</span> The EPSG/ESRI ID or Proj4 projection string describing the target spatial reference system that you want the geometry reprojected to. If using a Proj4 string, the value should be URL-encoded.</span></html> |
- | * //**toProj**//: __Required__. The EPSG/ESRI ID or Proj4 projection string describing the target spatial reference | + | |
- | system that you want the geometry reprojected to. If using a Proj4 string, the value | + | |
- | should be URL-encoded. | + | |
- | + | Visit [[https://cloud.thinkgeo.com/help/#/Projection/ProjectGeometryV1|ProjectGeometry]] and click "Try It Out" to explore this API online. | |
- | * Hit //**Try it Out**// button below [[https://cloud.thinkgeo.com/help/#/Projection/ProjectGeometryV1|ProjectGeometry]] to test it online. | + | |
===== Consume from Client Side===== | ===== Consume from Client Side===== | ||
- | ThinkGeo Cloud Projection does not allow anonymous users to access. Before working with these APIs, you need to get your own clients. A new account come with two clients: **NativeConfidential** and **JavaScript**. See more details at [[thinkgeo_cloud_client_keys_guideline|here]]. | + | ThinkGeo Cloud Projection does not allow anonymous users to access the API. Before working with these APIs, you will need to register with ThinkGeo Cloud and create your own clients. A new account come with two clients: **NativeConfidential** and **JavaScript**. See more details at [[thinkgeo_cloud_client_keys_guideline|here]]. |
ThinkGeo Cloud provides standard RESTful APIs which can be consumed in any platform through any language. ThinkGeo also offers two prepackaged API clients to make it easier to integrate into .NET and JavaScript applications. | ThinkGeo Cloud provides standard RESTful APIs which can be consumed in any platform through any language. ThinkGeo also offers two prepackaged API clients to make it easier to integrate into .NET and JavaScript applications. | ||
==== SDK for .NET ==== | ==== SDK for .NET ==== | ||
- | The SDK for .NET enables developers to build .NET application that uses the ThinkGeo Cloud services. The NuGet package can be found at [[https://www.nuget.org/packages/ThinkGeo.Cloud.Client|ThinkGeo.Cloud.Client]] or you can install this package with PM by running the command: ''Install-Package ThinkGeo.Cloud.Client -Version VERSION_TO_BE_INSTALLED'', here is the complete [[thinkgeo_cloud_.net_client_apis|API List]]. Also you can check out the [[https://github.com/ThinkGeo?utf8=%E2%9C%93&q=cloud&type=&language=|ThinkGeoCloudSample]] for a start. | + | The SDK for .NET enables developers to build .NET applications that use the ThinkGeo Cloud services. The NuGet package can be found at [[https://www.nuget.org/packages/ThinkGeo.Cloud.Client|ThinkGeo.Cloud.Client]] or you can install this package with PM by running the command: ''Install-Package ThinkGeo.Cloud.Client -Version VERSION_TO_BE_INSTALLED'', here is the complete [[thinkgeo_cloud_.net_client_apis|API List]]. Also you can check out the [[https://github.com/ThinkGeo?utf8=%E2%9C%93&q=cloud&type=&language=|ThinkGeoCloudSample]] for a start. |
=== API Documentation === | === API Documentation === | ||
Line 60: | Line 56: | ||
==== SDK for JavaScript ==== | ==== SDK for JavaScript ==== | ||
- | The SDK for JavaScript enables developers to directly access ThinkGeo Cloud services from JavaScript code running in brower. This SDK can be found at [[https://www.npmjs.com/package/thinkgeocloudclient-js|thinkgeocloudclient-js]]. The [[https://cloudclientsamples.thinkgeo.com|Geocoding]] sample shows how to work with this SDK. | + | The SDK for JavaScript enables developers to directly access ThinkGeo Cloud services from JavaScript code running in brower. This SDK can be found at [[https://www.npmjs.com/package/thinkgeocloudclient-js|thinkgeocloudclient-js]]. The [[https://samples.thinkgeo.com/cloud/#TransformProjection|Transform Projection]] sample shows how to work with this SDK. |
+ | |||
+ | ===== Samples ===== | ||
+ | |||
+ | Online Sample: | ||
+ | <code csharp> | ||
+ | |||
+ | Coming soon | ||
+ | |||
+ | </code> | ||
+ | |||
+ | Desktop Sample: | ||
+ | <code csharp> | ||
+ | |||
+ | Coming soon | ||
+ | |||
+ | </code> | ||
+ | |||
+ | |||
+ | Web Sample: | ||
+ | |||
+ | <code csharp> | ||
+ | |||
+ | Coming soon | ||
+ | |||
+ | </code> | ||
+ | |||
+ | Mobile Sample: | ||
+ | <code csharp> | ||
+ | |||
+ | Coming soon | ||
+ | |||
+ | </code> | ||
===== Related Links ===== | ===== Related Links ===== | ||
Line 70: | Line 99: | ||
* [[thinkgeo_cloud_elevation|ThinkGeo Cloud Elevation]] | * [[thinkgeo_cloud_elevation|ThinkGeo Cloud Elevation]] | ||
* [[thinkgeo_cloud_colors|ThinkGeo Cloud Colors]] | * [[thinkgeo_cloud_colors|ThinkGeo Cloud Colors]] | ||
+ | * [[thinkgeo_cloud_timezone|ThinkGeo Cloud Time Zones]] | ||