ThinkGeo Cloud Maps Query provides RESTful APIs to perform spatial query against each types of data.

* 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 ThinkGeo Cloud Client Keys Guideline to see how to acquire and apply one. All ThinkGeo Cloud evaluations are FREE for 60 days.
• Visit our 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 Maps Query provides the following RESTful APIs:

Get the features that are within the target shape.

HTTP GET
https://cloud.thinkgeo.com/api/v1/maps/query/{queryLayer}/within

URL Parameters

• queryLayer: The layer to query.
• wkt: The well-known text of the target geometry.
• srid: Optional. The SRID of the input and output feature's coordinate system. Defaults to 4326.
• proj4String: Optional. The Proj4 string of the input and output feature's coordinate system.
• maxResults: Optional. The maximum number of features to return. Defaults to 100.
• returnFeatureAttributes: Optional. Specify whether the feature attribute names and values will be returned in the response. Defaults to true.
• featureAttributesToReturn: Optional. If returnFeatureAttributes is true, this specifies which a specific subset of attributes to be returned. Formatted as a comma-delimited list of attribute names that should be returned with each feature in the response.

Visit GetFeaturesWithin and click “Try It Out” to explore this API online.

Get the features that contain the target shape.

HTTP GET
https://cloud.thinkgeo.com/api/v1/maps/query/{queryLayer}/containing

URL Parameters

• queryLayer: The layer to query.
• wkt: The well-known text of the target geometry.
• srid: Optional. The SRID of the input and output feature's coordinate system. Defaults to 4326.
• proj4String: Optional. The Proj4 string of the input and output feature's coordinate system.
• maxResults: Optional. The maximum number of features to return. Defaults to 100.
• returnFeatureAttributes: Optional. Specify whether the feature attribute names and values will be returned in the response. Defaults to true.
• featureAttributesToReturn: Optional. If returnFeatureAttributes is true, this specifies which a specific subset of attributes to be returned. Formatted as a comma-delimited list of attribute names that should be returned with each feature in the response.

Visit GetFeaturesContaining and click “Try It Out” to explore this API online.

Get the features that intersect the target shape.

HTTP GET
https://cloud.thinkgeo.com/api/v1/maps/query/{queryLayer}/intersecting

URL Parameters

• queryLayer: The layer to query.
• wkt: The well-known text of the target geometry.
• srid: Optional. The SRID of the input and output feature's coordinate system. Defaults to 4326.
• proj4String: Optional. The Proj4 string of the input and output feature's coordinate system.
• maxResults: Optional. The maximum number of features to return. Defaults to 100.
• returnFeatureAttributes: Optional. Specify whether the feature attribute names and values will be returned in the response. Defaults to true.
• featureAttributesToReturn: Optional. If returnFeatureAttributes is true, this specifies which a specific subset of attributes to be returned. Formatted as a comma-delimited list of attribute names that should be returned with each feature in the response.

Visit GetFeaturesIntersecting and click “Try It Out” to explore this API online.

Get the features that overlap the target shape.

HTTP GET
https://cloud.thinkgeo.com/api/v1/maps/query/{queryLayer}/overlapping

URL Parameters

• queryLayer: The layer to query.
• wkt: The well-known text of the target geometry.
• srid: Optional. The SRID of the input and output feature's coordinate system. Defaults to 4326.
• proj4String: Optional. The Proj4 string of the input and output feature's coordinate system.
• maxResults: Optional. The maximum number of features to return. Defaults to 100.
• returnFeatureAttributes: Optional. Specify whether the feature attribute names and values will be returned in the response. Defaults to true.
• featureAttributesToReturn: Optional. If returnFeatureAttributes is true, this specifies which a specific subset of attributes to be returned. Formatted as a comma-delimited list of attribute names that should be returned with each feature in the response.

Visit GetFeaturesOverlapping and click “Try It Out” to explore this API online.

Get the features that touch the target shape.

HTTP GET
https://cloud.thinkgeo.com/api/v1/maps/query/{queryLayer}/touching

URL Parameters

• queryLayer: The layer to query.
• wkt: The well-known text of the target geometry.
• srid: Optional. The SRID of the input and output feature's coordinate system. Defaults to 4326.
• proj4String: Optional. The Proj4 string of the input and output feature's coordinate system.
• maxResults: Optional. The maximum number of features to return. Defaults to 100.
• returnFeatureAttributes: Optional. Specify whether the feature attribute names and values will be returned in the response. Defaults to true.
• featureAttributesToReturn: Optional. If returnFeatureAttributes is true, this specifies which a specific subset of attributes to be returned. Formatted as a comma-delimited list of attribute names that should be returned with each feature in the response.

Visit GetFeaturesTouching and click “Try It Out” to explore this API online.

Get the features that are nearest the target shape.

HTTP GET
https://cloud.thinkgeo.com/api/v1/maps/query/{queryLayer}/nearest

URL Parameters

• queryLayer: The layer to query.
• wkt: The well-known text of the target geometry.
• srid: Optional. The SRID of the input and output feature's coordinate system. Defaults to 4326.
• proj4String: Optional. The Proj4 string of the input and output feature's coordinate system.
• searchRadius: Optional. The radius of the search area around the target geometry. If not specified, it's assumed that there is no limit.
• searchRadiusUnit: Optional. The unit of measure in which the searchRadius is expressed. Defaults to Meter.
• maxResults: Optional. The maximum number of features to return. Defaults to 100.
• returnFeatureAttributes: Optional. Specify whether the feature attribute names and values will be returned in the response. Defaults to true.
• featureAttributesToReturn: Optional. If returnFeatureAttributes is true, this specifies which a specific subset of attributes to be returned. Formatted as a comma-delimited list of attribute names that should be returned with each feature in the response.

Visit GetFeaturesNearest and click “Try It Out” to explore this API online.

Get the features that are within a certain distance of the target shape.

HTTP GET
https://cloud.thinkgeo.com/api/v1/maps/query/{queryLayer}/within-distance

URL Parameters

• queryLayer: The layer to query.
• wkt: The well-known text of the target geometry.
• srid: Optional. The SRID of the input and output feature's coordinate system. Defaults to 4326.
• proj4String: Optional. The Proj4 string of the input and output feature's coordinate system.
• distance: Optional. The distance within which to find features. Defaults to 200.
• distanceUnit: Optional. The unit of measure in which the distance is expressed. Defaults to Meter.
• maxResults: Optional. The maximum number of features to return. Defaults to 100.
• returnFeatureAttributes: Optional. Specify whether the feature attribute names and values will be returned in the response. Defaults to true.
• featureAttributesToReturn: Optional. If returnFeatureAttributes is true, this specifies which a specific subset of attributes to be returned. Formatted as a comma-delimited list of attribute names that should be returned with each feature in the response.

Visit GetFeaturesWithinDistance and click “Try It Out” to explore this API online.

Perform a custom spatial query, using the specified query layer, spatial relationship type, and query feature.

HTTP POST
https://cloud.thinkgeo.com/api/v1/maps/query/custom

POST Body (Content-Type: application/json)

{
  "queryLayer": "string", //The layer to query.
  "queryType": "string", //The type of query to perform. Value can be one of: "Within", "Containing", "Intersecting", "Overlapping", "Touching", "Nearest", "Within-Distance".
  "wkt": "string", //The well-known text of the target geometry.
  "srid": int, //Optional. The SRID of the input and output feature's coordinate system. Defaults to 4326.
  "proj4String": "string", //Optional. The Proj4 string of the input and output feature's coordinate system.
  "distance": double, //Optional. The distance within which to find features. Defaults to 200.
  "distanceUnit": "string", //Optional. The unit of measure in which the distance is expressed. Defaults to Meter.
  "searchRadius": double, //Optional. The radius of the search area around the target geometry. If not specified, it's assumed that there is no limit.
  "searchRadiusUnit": "string", //Optional. The unit of measure in which the searchRadius is expressed. Defaults to Meter.
  "maxResults": int, //Optional. The maximum number of features to return. Defaults to 100.
  "returnFeatureAttributes": bool, //Optional. Specify whether the feature attribute names and values will be returned in the response. Defaults to true.
  "featureAttributesToReturn": [
    "string"
  ] //Optional. If returnFeatureAttributes is true, this specifies which a specific subset of attributes to be returned. Formatted as a comma-delimited list of attribute names that should be returned with each feature in the response.
}

Visit GetFeaturesCustom and click “Try It Out” to explore this API online.

List the available query layers.

HTTP GET
https://cloud.thinkgeo.com/api/v1/maps/query/layers

Visit GetQueryLayers and click “Try It Out” to explore this API online.

List the feature attributes available on the given query layer.

HTTP GET
https://cloud.thinkgeo.com/api/v1/maps/query/{queryLayer}/attributes

URL Parameters

• queryLayer: The query layer.

Visit GetAttributesOfLayer and click “Try It Out” to explore this API online.

Coming soon

Online Sample:

Coming soon

Desktop Sample:

Coming soon

Web Sample:

Coming soon

Mobile Sample:

Coming soon

• ThinkGeo Cloud Geocoding
• ThinkGeo Cloud Maps WMS
• ThinkGeo Cloud Maps Vector Tiles
• ThinkGeo Cloud Maps Raster Tiles
• ThinkGeo Cloud Reverse Geocoding
• ThinkGeo Cloud Projection
• ThinkGeo Cloud Colors
• ThinkGeo Cloud Time Zones