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/08 05:31] tgwikiupdate |
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} | ||
Line 18: | Line 19: | ||
//**URL 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 | ||
Line 37: | Line 37: | ||
//**URL 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===== | ||
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]] | ||