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 Elevation ======
ThinkGeo Cloud Elevation provides the way to get elevation data from ThinkGeo's Cloud Server. Check out [[https://samples.thinkgeo.com/cloud/#GetElevationAlongPath|Get Elevation Along Path]] for a quick look.

The Elevation SDK supports querying of elevation data by points, line and polygon based on SRTM and Ned13 elevation source data. It returns 3 types of data:
  * For points - Creates a buffer and aggregates all points within buffer to create averages for the elevation of the point.
  * For lines - There are two ways to get the elevation data of the line. First, get the points on the line by setting the interval distance. The other, is to take the points by setting the number of points to be fetched. Then querying the elevation data of the point.
  * For polygons - By setting the interval distance, clip the polygon to the grids and get all the center of the grids where the polygon is located. Now, determine whether the center points are within the surface or inside the surface (use improved arc-length method).

===== RESTful APIs =====

* //**Try it Online**:// All of the ThinkGeo Cloud RESTful APIs can be tested online by 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]] to see how to acquire and apply one. All ThinkGeo Cloud evaluations are 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. 

//**ThinkGeo Cloud Elevation provides the following RESTful APIs**://
<code html>
<!-- Get the elevation of a point -->
HTTP GET
https://cloud.thinkgeo.com/api/v1/elevation/{pointY},{pointX}
</code>

//**Parameters**//
  * //**pointY**//: __Required__. The Y coordinate of the point.
  * //**pointX**//: __Required__. The X coordinate of the point.


  *  Hit //**Try it Out**// button below [[https://cloud.thinkgeo.com/help/#/Elevation/GetElevationOfPointV1|GetElevationOfPoint]] to test it online. 
  
<code html>
<!-- Get the elevation of points along a line -->
HTTP GET
https://cloud.thinkgeo.com/api/v1/elevation/line
</code>

//**Parameters**//
  * //**wkt**//: The Well Known Text (WKT) of a line feature to get the elevation.
  * //**srid**//: __Optional__. The SRID (coordinate system) of the input feature.
  * //**proj4String**//: __Optional__. The Proj4String (coordinate system) of the input feature.
  * //**NumberOfSegments**//: __Optional__. Splits the requested line into this many segments, then calculates elevation of each point joining the segments.
  * //**ElevationUnit**//: __Optional__. The unit of measure in which the elevation result is expressed. Defaults to "Feet".
  * //**IntervalDistance**//: __Optional__. Splits the requested line into intervals of this length. The unit of measure for this distance is specified by the IntervalDistanceUnit parameter.
  * //**IntervalDistanceUnit**//: __Optional__. The unit of measure in which the IntervalDistance is expressed. Defaults to "Feet".


  *  Hit //**Try it Out**// button below [[https://cloud.thinkgeo.com/help/#/Elevation/GetElevationOfLineV1|GetElevationOfLine]] to test it online. 
  
<code html>
<!-- Get the elevation of a matrix of points within an area. -->
HTTP GET
https://cloud.thinkgeo.com/api/v1/elevation/area
</code>

//**Parameters**//
  * //**wkt**//: The Well Known Text (WKT) of a polygon feature to get the elevation.
  * //**srid**//: __Optional__. The SRID (coordinate system) of the input feature.
  * //**proj4String**//: __Optional__. The Proj4String (coordinate system) of the input feature.
  * //**ElevationUnit**//: __Optional__. The unit of measure in which the elevation result is expressed. Defaults to "Feet".
  * //**IntervalDistance**//: __Optional__. The distance between every two points in the area matrix. Elevation of each point will be calculated and returned. Defaults to 1000.0. The unit of measure for this distance is specified by the IntervalDistanceUnit parameter.
  * //**IntervalDistanceUnit**//: __Optional__. The unit of measure in which the IntervalDistance is expressed. Defaults to "Feet".   


  *  Hit //**Try it Out**// button below [[https://cloud.thinkgeo.com/help/#/Elevation/GetElevationOfAreaV1|GetElevationOfArea]] to test it online. 
  
<code html>
<!-- Get reverse geocoding for points -->
HTTP POST
https://cloud.thinkgeo.com/api/v1/location/reverse-geocode/multi
</code>
//**Parameters**//
<code javascript>
/* POST parameters, if a parameter specified in both POST and GET, the value from POST parameter will be applied. */
[
  {
    "coord": "string", // The coordinates of the point. The format is: y,x.
    "srid": int, // The SRID (coordinate system) of the input feature. Defaults to 4326.
    "proj4String": "string", // The Proj4 (coordinate system) of the input feature.
    "elevationUnit": "string" // The unit of measure in which the elevation result is expressed. Defaults to "Feet".
  }
]</code>
  * //**srid**//: __Optional__. The SRID (coordinate system) of the input feature. Defaults to 4326.
  * //**proj4String**//: __Optional__. The Proj4 (coordinate system) of the input feature.
  * //**ElevationUnit**//: __Optional__. The unit of measure in which the elevation result is expressed. Defaults to "Feet".

  *  Hit //**Try it Out**// button below [[https://cloud.thinkgeo.com/help/#/Elevation/GetElevationsOfPointsBatchV1|GetElevationsOfPointsBatch]] to test it online. 
  
<code html>
<!--  Get the grade (slope) of a line, optionally split into segments -->
HTTP GET
https://cloud.thinkgeo.com/api/v1/elevation/grade/line
</code>

//**Parameters**//
  * //**wkt**//: The Well Known Text(WKT) of the line feature to get the grade.
  * //**srid**//: __Optional__. The SRID (coordinate system) of the input feature.
  * //**proj4String**//: __Optional__. The Proj4String (coordinate system) of the input feature.
  * //**NumberOfSegments**//: __Optional__. Splits the requested line into this many segments, then calculates elevation of each point joining the segments.
  * //**ElevationUnit**//: __Optional__. The unit of measure in which the elevation result is expressed. Defaults to "Feet".
  * //**IntervalDistance**//: __Optional__. Splits the requested line into intervals of this length. The unit of measure for this distance is specified by the IntervalDistanceUnit parameter.
  * //**IntervalDistanceUnit**//: __Optional__. The unit of measure in which the IntervalDistance is expressed. Defaults to "Feet".


  *  Hit //**Try it Out**// button below [[https://cloud.thinkgeo.com/help/#/Elevation/GetGradeOfLineV1|GetGradeOfLine]] to test it online. 

===== 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>
ElevationClient elevationClient = new ElevationClient(clientId, clientSecret);
elevationClient.BaseUris.Add(new Uri(GisServerUri));
var response = elevationClient.GetElevationOfLineAsync(line, 3857, numberOfSegments: pointNumber, elevationUnit: DistanceUnit.Meter);
</code>

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

===== Samples =====

Online Sample:
  * [[https://samples.thinkgeo.com/cloud/#GetElevationAlongPath|ThinkGeo Cloud Elevation Online Sample]]

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


===== Related Links =====
  * [[thinkgeo_cloud_geocoding|ThinkGeo Cloud Geocoding]]
  * [[thinkgeo_cloud_maps_wms|ThinkGeo Cloud Maps WMS]]
  * [[thinkgeo_cloud_maps_vector_tiles|ThinkGeo Cloud Maps Vector Tiles]]
  * [[thinkgeo_cloud_maps_raster_tiles|ThinkGeo Cloud Maps Raster Tiles]]
  * [[thinkgeo_cloud_reverse_geocoding|ThinkGeo Cloud Reverse Geocoding]]
  * [[thinkgeo_cloud_projection|ThinkGeo Cloud Projection]]
  * [[thinkgeo_cloud_colors|ThinkGeo Cloud Colors]]
User Tools

Site Tools

Page Tools
