====== ThinkGeo Cloud Reverse Geocoding ======
ThinkGeo Cloud Reverse Geocoding provides RESTful APIs to find an address from a location/location coordinates. 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.
* 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 ReverseGeocoding provides the following Restful APIs**.//
==== Get Reverse Geocoding For Point ====
Get reverse geocoding for point.
HTTP GET
https://cloud.thinkgeo.com/api/v1/location/reverse-geocode/{pointY},{pointX}
//**URL 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".
Visit [[https://cloud.thinkgeo.com/help/#/ReverseGeocoding/ReverseGeocodeByPointV1|GetReverseGeocodingForPoint]] and click "Try It Out" to explore this API online.
==== Reverse Geocode By Points (Batch Request) ====
Get reverse geocoding for points.
HTTP POST
https://cloud.thinkgeo.com/api/v1/location/reverse-geocode/multi
//**POST Body (Content-Type: application/json)**//
[
{
"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".
}
]
Each item in the batch can locally override a parameter specified on the request URL.
//**URL Parameters**//
* 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".
Visit [[https://cloud.thinkgeo.com/help/#/ReverseGeocoding/ReverseGeocodeByPointsBatchV1|ReverseGeocodeByPointsBatch]] and click "Try It Out" to explore this API online.
==== Get Reverse Geocoding For Area ====
Get reverse geocoding for area. Returns locations found only within the polygon you specify.
HTTP GET
https://cloud.thinkgeo.com/api/v1/location/reverse-geocode/area?wkt={polygon}
//**URL 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".
Visit [[https://cloud.thinkgeo.com/help/#/ReverseGeocoding/ReverseGeocodeByAreaV1|GetReverseGeocodingForArea]] and click "Try It Out" to explore this API online.
==== Get Reverse Geocoding For Line ====
Get reverse geocoding along a line. Useful for seeing what addresses or places are located along a road or highway.
HTTP GET
https://cloud.thinkgeo.com/api/v1/location/reverse-geocode/line?wkt={line}
//**URL 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".
Visit [[https://cloud.thinkgeo.com/help/#/ReverseGeocoding/ReverseGeocodeByLineV1|GetReverseGeocodingForLine]] and click "Try It Out" to explore this API online.
==== Get Place By ID ====
Get details about a specific point of interest by its ID. Places returned in response to your reverse geocode requests will have IDs associated with them, which you can use with this endpoint.
HTTP GET
https://cloud.thinkgeo.com/api/v1/location/place/{placeId}
//**URL Parameters**//
* placeId: The OpenStreetMap ID of the place.
* lang: Optional. Sets the language for the search result. The default value is "en".
Visit [[https://cloud.thinkgeo.com/help/#/ReverseGeocoding/GetPlaceByIdV1|GetPlaceById]] and click "Try It Out" to explore this API online.
==== Get Location Categories ====
Get a list of the available location categories. These can be passed in to the reverse geocoding endpoints to filter the types of locations the service will return to you.
HTTP GET
https://cloud.thinkgeo.com/api/v1/location/reverse-geocode/location-categories
//**URL Parameters**//
HTTP GET
https://cloud.thinkgeo.com/api/v1/location/reverse-geocode/location-categories/common
//**URL Parameters**//
Coming soon
Mobile Sample:
Coming soon
===== 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]]
* [[thinkgeo_cloud_timezone|ThinkGeo Cloud Time Zones]]