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 ReverseGeocoding ======
ThinkGeo Cloud ReverseGeocoding provides RESTful APIs to find an address from a location. Check out the [[https://cloudclientsamples.thinkgeo.com/#Reverse-Geocoding|online sample]] for a quick look. 

===== RESTful APIs =====
* //**Try it Online**:// All the ThinkGeo Cloud 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.  
  *  //** **// 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 ReverseGeocoding provides the following Restful APIs**.//

<code html>
<!-- Get reverse geocoding for point -->
HTTP GET 
https://cloud.thinkgeo.com/api/v1/location/reverse-geocode/{pointY},{pointX}
</code>
//**Parameters**//
  * //**pointY**//: The Y coordinate of the point.
  * //**pointX**//: The X coordinate of the point.
  * //**srid**//: __Optional__. The SRID (coordinate system) in which to express the result. Defaults to 4326.
  * //**proj4String**//: __Optional__. The Proj4String (coordinate system) in which to express the result.
  * //**lang**//: __Optional__. The language in which to express the result.
  * //**searchRadius**//: __Optional__. The maximun radius around the input point to search for places. Defaults to 200.
  * //**searchRadiusUnit**//: __Optional__. The unit of measure in which the SearchRadius is expressed. Defaults to "Meter".
  * //**maxResults**//: __Optional__. The maximum number of results to return. Defaults to 20.
  * //**locationCategories**//: __Optional__. The categories of locations to include in the result set. The default value is "Common".
  * //**locationTypes**//: __Optional__. Filters the resulting locations by type. Multiple types should be separated by a comma. Defaults to no filter.
  * //**verboseResults**//: __Optional__. Indicates whether the results should be verbose or not. When false, the results will have fewer properties. Defaults to false.
  * //**distanceFromQueryFeatureUnit**//: __Optional__. The unit of measure in which the distance is expressed. Defaults to "Meter".
  
  *  Hit //**Try it Out**// button below [[https://cloud.thinkgeo.com/help/#/ReverseGeocoding/ReverseGeocodeByPointV1|GetResverseGecodingForPoint]] 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, // Optional. The SRID (coordinate system) in which to express the result. Defaults to 4326.
    "proj4String": "string", // Optional. The Proj4String (coordinate system) in which to express the result.
    "lang": "string", // Optional. The language in which to express the result.
    "searchRadius": int, // Optional. The maximun radius around the input point to search for places. Defaults to 200.
    "searchRadiusUnit": "Meter", // Optional. The unit of measure in which the SearchRadius is expressed. Defaults to "Meter".
    "maxResults": int, // Optional. The maximum number of results to return. Defaults to 20.
    "locationCategories": "string", // Optional. The categories of locations to include in the result set. The default value is "Common".
    "locationTypes": "string", // Optional. Filters the resulting locations by type. Multiple types should be separated by a comma. Defaults to no filter.
    "verboseResults": bool, // Optional. Indicates whether the results should be verbose or not. When false, the results will have fewer properties. Defaults to false.
    "distanceFromQueryFeatureUnit": "Meter" // Optional. The unit of measure in which the distance is expressed. Defaults to "Meter".
  }
]</code>
  * //**srid**//: __Optional__. The SRID (coordinate system) in which to express the result. Defaults to 4326.
  * //**proj4String**//: __Optional__. The Proj4String (coordinate system) in which to express the result.
  * //**lang**//: __Optional__. The language in which to express the result.
  * //**searchRadius**//: __Optional__. The maximun radius around the input point to search for places. Defaults to 200.
  * //**searchRadiusUnit**//: __Optional__. The unit of measure in which the SearchRadius is expressed. Defaults to "Meter".
  * //**maxResults**//: __Optional__. The maximum number of results to return. Defaults to 20.
  * //**locationCategories**//: __Optional__. The categories of locations to include in the result set. The default value is "Common".
  * //**locationTypes**//: __Optional__. Filters the resulting locations by type. Multiple types should be separated by a comma. Defaults to no filter.
  * //**verboseResults**//: __Optional__. Indicates whether the results should be verbose or not. When false, the results will have fewer properties. Defaults to false.
  * //**distanceFromQueryFeatureUnit**//: __Optional__. The unit of measure in which the distance is expressed. Defaults to "Meter".

  *  Hit //**Try it Out**// button below [[https://cloud.thinkgeo.com/help/#/ReverseGeocoding/ReverseGeocodeByPointsBatchV1|ReverseGeocodeByPointsBatch]] to test it online. 


<code html>
<!-- Get reverse geocoding for area -->
HTTP GET 
https://cloud.thinkgeo.com/api/v1/location/reverse-geocode/area?wkt={polygon}
</code>
//**Parameters**//
  * //**wkt**//: The Well Known Text (WKT) of the polygon feature to use as the search area.
  * //**srid**//: __Optional__. The SRID (coordinate system) in which to express the result. Defaults to 4326.
  * //**proj4String**//: __Optional__. The Proj4String (coordinate system) in which to express the result.
  * //**lang**//: __Optional__. The language in which to express the result.
  * //**searchRadius**//: __Optional__. The maximun radius around the input point to search for places. Defaults to 200.
  * //**searchRadiusUnit**//: __Optional__. The unit of measure in which the SearchRadius is expressed. Defaults to "Meter".
  * //**maxResults**//: __Optional__. The maximum number of results to return. Defaults to 20.
  * //**locationCategories**//: __Optional__. The categories of locations to include in the result set. The default value is "Common".
  * //**locationTypes**//: __Optional__. Filters the resulting locations by type. Multiple types should be separated by a comma. Defaults to no filter.
  * //**verboseResults**//: __Optional__. Indicates whether the results should be verbose or not. When false, the results will have fewer properties. Defaults to false.
  * //**distanceFromQueryFeatureUnit**//: __Optional__. The unit of measure in which the distance is expressed. Defaults to "Meter".

  *  Hit //**Try it Out**// button below [[https://cloud.thinkgeo.com/help/#/ReverseGeocoding/ReverseGeocodeByAreaV1|GetResverseGecodingForArea]] to test it online. 


<code html>
<!-- Get reverse geocoding for line -->
HTTP GET 
https://cloud.thinkgeo.com/api/v1/location/reverse-geocode/line?wkt={line}
</code>
//**Parameters**//
  * //**wkt**//: The Well Known Text (WKT) of the line feature to use as the search area.
  * //**srid**//: __Optional__. The SRID (coordinate system) in which to express the result. Defaults to 4326.
  * //**proj4String**//: __Optional__. The Proj4String (coordinate system) in which to express the result.
  * //**lang**//: __Optional__. The language in which to express the result.
  * //**searchRadius**//: __Optional__. The maximun radius around the input point to search for places. Defaults to 200.
  * //**searchRadiusUnit**//: __Optional__. The unit of measure in which the SearchRadius is expressed. Defaults to "Meter".
  * //**maxResults**//: __Optional__. The maximum number of results to return. Defaults to 20.
  * //**locationCategories**//: __Optional__. The categories of locations to include in the result set. The default value is "Common".
  * //**locationTypes**//: __Optional__. Filters the resulting locations by type. Multiple types should be separated by a comma. Defaults to no filter.
  * //**verboseResults**//: __Optional__. Indicates whether the results should be verbose or not. When false, the results will have fewer properties. Defaults to false.
  * //**distanceFromQueryFeatureUnit**//: __Optional__. The unit of measure in which the distance is expressed. Defaults to "Meter".

  *  Hit //**Try it Out**// button below [[https://cloud.thinkgeo.com/help/#/ReverseGeocoding/ReverseGeocodeByLineV1|GetResverseGecodingForLine]] to test it online. 

<code html>
<!-- Get place by Id -->
HTTP GET 
https://cloud.thinkgeo.com/api/v1/location/place/{placeId}
</code>
//**Parameters**//
  * //**placeId**//: The OpenStreetMap ID of the place.
  * //**lang**//: __Optional__. Sets the language for the search result. The default value is "en".

  *  Hit //**Try it Out**// button below [[https://cloud.thinkgeo.com/help/#/ReverseGeocoding/GetPlaceByIdV1|GetPlaceById]] to test it online. 


<code html>
<!-- Get location cateogires -->
HTTP GET 
https://cloud.thinkgeo.com/api/v1/location/reverse-geocode/location-categories
</code>
//**Parameters**//
<div>//No parameters.//</div>

  *  Hit //**Try it Out**// button below [[https://cloud.thinkgeo.com/help/#/ReverseGeocoding/GetReverseGeocodingLocationCategoriesV1|GetLocationCateogries]] to test it online. 


<code html>
<!--  Get common location cateogires -->
HTTP GET 
https://cloud.thinkgeo.com/api/v1/location/reverse-geocode/location-categories/common
</code>
//**Parameters**//
<div>//No parameters//</div>

  *  Hit //**Try it Out**// button below [[https://cloud.thinkgeo.com/help/#/ReverseGeocoding/GetReverseGeocodingCommonLocationCategoriesV1|GetLocationCateogriesInCommonGroup]] to test it online. 


===== Consume from Client Side=====
ThinkGeo Cloud ReverseGeocoding 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 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 ====
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'', also you can check out the [[https://github.com/ThinkGeo/ThinkGeoCloudReverseGeocodingSample-ForWpf|ThinkGeoCloudReverseGeocodingSample-ForWpf]] for the start.

=== API Documentation ===
  * [[api/thinkgeo.cloud.reversegeocodingclient|ThinkGeo.Cloud.ReverseGeocodingClient]]<div>This documentation convers the ThinkGeo.Cloud.ReverseGeocodingClient class. It contains all of the members such as Constructors, Methods, Properties and Events.</div>

==== 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/#Reverse-Geocoding|ReverseGeocoding]] sample shows how to work with this SDK.

===== 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_elevation|ThinkGeo Cloud Elevation]]
  * [[thinkgeo_cloud_projection|ThinkGeo Cloud Projection]]
  * [[thinkgeo_cloud_colors|ThinkGeo Cloud Colors]]
User Tools

Site Tools

Page Tools
