Smart Map Facts Data & Geometry Query Service (ThematicQuery)
URL http://baoapi.esri.com/rest/report/ThematicQuery

A high performance Web service which easily, quickly, and flexibly provides access to the same set of data and area features that are leveraged behind the scenes by the Esri Business Analyst Online and Community Analyst Web applications. The service supports simple yet advanced spatial and SQL-like attribute query options and the optional ability to retrieve the associated polygon geometries of the output area result set.

See what's possible and get started now.

Description

The Online API contains several thousand valuable projections, estimates, and observations which are of great interest to investors, decision makers, and stakeholders in a wide variety of fields. Cumulatively, this vast and valuable collection of data would be unobtainable to only but the largest of businesses and organizations and; even then, the investment that would have to be made in time, resources, and money would be so great that it would be difficult to justify and produce. Instead, leverage this Cloud-based Service and easily and seamlessly access and leverage up-to-date data through the world's premiere geospatial data hosting and analysis infrastructure.

Output

The result of the service is a list of area features from the Online API data set which satisfy the spatial and/or attribute-based query parameters included in the request.

Each area feature consists of an Esri JSON Feature Object with Attributes and/or mappable Polygon Geometries, depending on the query parameters (See the supported JSON Response syntax and examples).

Since the service is standards based and built on the HTTP stack, any client application which supports HTTP (including simple Web browsers) can consume, leverage, and integrate the output of the service. This lightweight and platform-independent output can be consumed by anything from small, nimble, and simple mobile applications to high performance, complex, and critical LOB enterprise applications.

Optionally, the Esri Web SDKs, including the ArcGIS API for Silverlight, for Flex, and for JavaScript; and the Esri Mobile SDKs, including ArcGIS for iOS, for Windows Phone, and for Android can be leveraged to quickly and easily consume, render, analyze, and work with the output of this service.

Usage Tips

You can provide arguments to the Smart Map Facts (Thematic Query) Service as defined in the parameters table below.

Parameters

Parameter Details
GeoLevelID (Required) Description: (Required). The Online API data layer to query. Use the Get Standard Geography Levels service to obtain a list of administrative boundary/standard geography data layers that can be currently queried.

Default: null

Syntax: GeoLevelID=<string>

Example: GeoLevelID=US.States

Example Description: In this example, the Online API US.States data layer is specified so all U.S. state features and data associated with each state are available for query.

Notes:
Currently, the service does not support the following data layers (by IDs) in the default 'USA' data set: 'US.DMA', 'UC.CD', 'US.Places', and 'UC.CS'.

Known Dependencies: All three of the required parameters plus one or more of the following parameters are required to complete a service request: where, geometry, text.

OutFields (Required) Description: (Required). Specifies the attribute fields from the Online API data layer which will be queried.

Default: null

Syntax: OutFields=<string>, <string>, ... , <string> (Comma-separated list of one or more attribute fields from the Online API data layer)

Example: OutFields=NAME,ID,TOTPOP_CY,TOTHH_CY

Example Description: For each area in the Online API data layer specified in the GeoLevelID parameter value which touches/intersects the input Geometry parameter value. four attributes will be queried: the area name, the unique area ID, the current-year total population, and the current year total household count.

Notes:
Every feature has a NAME and ID parameter and should be specified in the list of attributes. Response data payloads from this service can vary greatly in size due to the complexity, number , and associated attributes of each feature.

It is strongly recommended that the number of attribute fields which are specified be kept at or below 250 in order to ensure the stability of your application and minimize the chance that your request is throttled.

If attribute fields from multiple datapacks are requested, the REST response format will only work with a JSON output format. See the Datapack property for these variables (attribute fields) returned by the Get Summarizations service to see which datapack each of the requested variables belong to.

Known Dependencies:
The specified attribute fields must exist in the currently-specified data set (the ActiveDatasetID parameter)
. See the Get Summarizations service and include the Visibility parameter with the string value '$all' to look up analysis/summarization variables (attribute fields) which are accessible with your Online API subscription and are in the currently-specified data set. This will include a property called, Mappable which will describe if the variable can be queried by this service (Mappable = true).

All three of the required parameters plus one or more of the following parameters are required to complete a service request: where, geometry, text.

Token (Required) Description: (Required). A current and valid Online API token string.

Default: null

Syntax: Token=<string>

Example: Token=ABC123...

Example Description: A token string generated with the Get Token service validates and authenticates your Online API services request.

Notes:
See Get Token for more information on securely obtaining a token.

See the Online API Home Page to get information on obtaining an Online API subscription and free trial.


Known Dependencies: All three of the required parameters plus one or more of the following parameters are required to complete a service request: where, geometry, text.

ActiveDatasetID Description: (Optional). The currently-active data set which is being accessed with the service.

Default: USA

Syntax: ActiveDatasetID=<string>

Example: ActiveDatasetID=Canada

Example Description: Use the service to query data layers in the Canada data set All available administrative boundary/standard geographic data layers (See GeoLevelID parameter) and associated attributes (See OutFields parameter) from the Canada data set become active.

Notes:
See the Get Datasets service to look up the IDs of the Online API data sets which are available to query.


Known Dependencies: The administrative boundary/standard geographic data layer, specified in the GeoLevelID parameter, and the associated attributes being queried, specified in the OutFields parameter, must be available in the currently-active data set.

Access to the various data sets are subject to availability and the terms/restrictions associated with your API subscription.

f Description: (Optional). The REST response format.

Default: HTML

Syntax: f=<string> (Options: HTML | JSON | PJSON | AMF)

Example: f=JSON

Example Description: Retrieve the service response in the JSON format.

Notes:
JSON output format is recommended for consuming/integrating the output of the service in a client application. JSON is a popular semi-structured data format which is easy to consume in a variety of client applications. PJSON is convenient for non-production design-time for its readability.

Known Dependencies: The AMF format is only available when both the ReturnIDsOnly and ReturnCountOnly parameter values are set to false.

GeneralizationLevel

Description: (Optional). The specified level of generalization/detail in the area representations of the administrative boundary/standard geographic data layers

Default: 1

Syntax: GeneralizationLevel=<int> (Options: 1 through 7, where 1 is most detailed and 7 is most generalized)

Example: GeneralizationLevel=7

Example Description: Retrieve the output geometry is the most generalized (bandwidth friendly) manner in order to have a higher performance client application

Notes:
A GeneralizationLevel of 1 will return the most detailed and precise polygon area features but the bandwidth "cost" is very high and will likely lead to performance issues with many client applications depending on the number and size of the features in the query of the service request. On the other hand, a GeneralizationLevel of 7 will produce much smaller and much less detailed polygon area features which will be downloaded and processed much faster by client applications; however, the feature representations may not be accurate enough for your use case. During application design time, it will be essential for you to find a GeneralizationLevel that is appropriate for your requirements.

Known Dependencies:
The service will include polygon area features (output geometries) in the output response if the ReturnGeometry parameter is set to true, the f parameter is set to JSON or PJSON, and both the ReturnIDsOnly and ReturnCountOnly parameter values are set to false.

Geometry Description: (Optional). The spatial description of the area to query. The area(s) in the data layer which touch/intersect the area(s) described by the input Geometry will be queried.

Default: null

Syntax: Geometry=<Esri JSON Point| Esri JSON Multipoint | Esri JSON Envelope | Esri JSON Polyline | Esri JSON Polygon>

Example: Geometry={"xmin":-109.55,"ymin":25.76,"xmax":-86.39,"ymax":49.94,"spatialReference":{"wkid":4326}}

Example Description: In this example, an extent rectangle is specified so all areas which are within or touch/intersect the rectangle will be queried. Note from the table below that the InSR value does not need to be specified (because the SpatialReference property of the example input Geometry is provided) and the GeometryType parameter value should be esriGeometryEnvelope.

Notes:
See the table below for examples of supported input Geometries.


Known Dependencies:
Be sure to note the corresponding InSR and GeometryType parameter values for each associated Geometry value. The GeometryType parameter is required if the Geometry parameter is specified. All three of the required parameters plus one or more of the following parameters are required to complete a service request: where, geometry, text.

 

Description Geometry Example Value InSR Dependent Value GeometryType Dependent Value
Query the area in the data layer intersecting/touching a point location described by geographic (latitude-longitude) coordinates
{
  "x": -118.15,
  "y": 33.80,
  "spatialReference": {"wkid": 4326}
}
null
NOTE: InSR parameter value may be omitted. SpatialReference property of Geometry value overrides InSR parameter value.
esriGeometryPoint
Query the area in the data layer intersecting/touching a point location described by geographic (latitude-longitude) coordinates
{
  "x": -118.15,
  "y": 33.80
}
4326
NOTE: InSR parameter value is required when the SpatialReference property is not specified in the input Geometry.
esriGeometryPoint
Query the area in the data layer intersecting/touching a point location described by geographic (latitude-longitude) coordinates
-118.15, 33.80
NOTE: Simplified non-JSON syntax
4326
NOTE: InSR parameter value is required when the SpatialReference property is not specified in the input Geometry.
esriGeometryPoint
Query the area in the data layer intersecting/touching a point location described by coordinates in a projected coordinate system (Web Mercator)
{
  "points": [[-13306157.88, 4329684.99]],
  "spatialReference": {"wkid": 102100}
}
null
NOTE: InSR parameter value may be omitted. SpatialReference property of Geometry value overrides InSR parameter value.
esriGeometryMultipoint
NOTE: Specify a single Point in an alternate coordinate ref. system as an esriGeometryMultipoint JSON object as shown.
Query the area in the data layer intersecting/touching a point location described by coordinates in a projected coordinate system (Web Mercator)
{
  "points": [[-13306157.88, 4329684.99]]
}
102100
NOTE: InSR parameter value is required when the SpatialReference property is not specified in the input Geometry.
esriGeometryMultipoint
NOTE: Specify a single Point in an alternate coordinate ref. system as an esriGeometryMultipoint JSON object as shown.

Query the area(s) in the data layer intersecting/touching multiple point locations described by geographic (latitude-longitude) coordinates

NOTE: Multiple "matches" on identical areas are returned only once.

{
  "points": [
    [-119.53, 36.21],
    [-75.94, 40.43],
    [-98.26, 30.06]
  ],
  "spatialReference": {"wkid": 4326}
}
null
NOTE: InSR parameter value may be omitted. SpatialReference property of Geometry value overrides InSR parameter value.
esriGeometryMultipoint

Query the area(s) in the data layer intersecting/touching multiple point locations described by geographic (latitude-longitude) coordinates

NOTE: Multiple "matches" on identical areas are returned only once.

{
  "points": [
    [-119.53, 36.21],
    [-75.94, 40.43],
    [-98.26, 30.06]
  ]
}
4326
NOTE: InSR parameter value is required when the SpatialReference property is not specified in the input Geometry.
esriGeometryMultipoint

Query the area(s) in the data layer intersecting/touching multiple point locations described by coordinates in a projected coordinate system (Web Mercator)

NOTE: Multiple "matches" on identical areas are returned only once.

{
  "points": [
    [-13306157.88, 4329684.99],
    [-8453323.83, 4928581.18],
    [-10938444.49, 3511083.75]
  ],
  "spatialReference": {"wkid": 102100}
}
null
NOTE: InSR parameter value may be omitted. SpatialReference property of Geometry value overrides InSR parameter value.
esriGeometryMultipoint

Query the area(s) in the data layer intersecting/touching multiple point locations described by coordinates in a projected coordinate system (Web Mercator)

NOTE: Multiple "matches" on identical areas are returned only once.

{
  "points": [
    [-13306157.88, 4329684.99],
    [-8453323.83, 4928581.18],
    [-10938444.49, 3511083.75]
  ]
}
102100
NOTE: InSR parameter value is required when the SpatialReference property is not specified in the input Geometry.
esriGeometryMultipoint
Query the area(s) in the data layer intersecting/touching an extent rectangle described by geographic (latitude-longitude) coordinates
{
  "xmin": -109.55,
  "ymin": 25.76,
  "xmax": -86.39,
  "ymax": 49.94,
  "spatialReference": {"wkid": 4326}
}
null
NOTE: InSR parameter value may be omitted. SpatialReference property of Geometry value overrides InSR parameter value.
esriGeometryEnvelope
Query the area(s) in the data layer intersecting/touching an extent rectangle described by geographic (latitude-longitude) coordinates
{
  "xmin": -109.55,
  "ymin": 25.76,
  "xmax": -86.39,
  "ymax": 49.94
}
4326
NOTE: InSR parameter value is required when the SpatialReference property is not specified in the input Geometry.
esriGeometryEnvelope
Query the area(s) in the data layer intersecting/touching an extent rectangle described by geographic (latitude-longitude) coordinates
-109.55, 25.76, -86.39, 49.94
NOTE: Simplified non-JSON syntax
4326
NOTE: InSR parameter value is required when the SpatialReference property is not specified in the input Geometry.
esriGeometryEnvelope
Query the area(s) in the data layer intersecting/touching an extent rectangle described by coordinates in a projected coordinate system (Web Mercator)
{
  "xmin": -12195050.22,
  "ymin": 2969386.15,
  "xmax": -9616890.81,
  "ymax": 6435891.37,
  "spatialReference": {"wkid": 102100}
}
null
NOTE: InSR parameter value may be omitted. SpatialReference property of Geometry value overrides InSR parameter value.
esriGeometryEnvelope
Query the area(s) in the data layer intersecting/touching an extent rectangle described by coordinates in a projected coordinate system (Web Mercator)
{
  "xmin": -12195050.22,
  "ymin": 2969386.15,
  "xmax": -9616890.81,
  "ymax": 6435891.37
}
102100
NOTE: InSR parameter value is required when the SpatialReference property is not specified in the input Geometry.
esriGeometryEnvelope
Query the area(s) in the data layer intersecting/touching an extent rectangle described by coordinates in a projected coordinate system (Web Mercator)
-12195050.22, 2969386.15, -9616890.81, 
6435891.37
NOTE: Simplified non-JSON syntax
102100
NOTE: InSR parameter value is required when the SpatialReference property is not specified in the input Geometry.
esriGeometryEnvelope

Query the area(s) in the data layer intersecting/touching line segments described by geographic (latitude-longitude) coordinates

NOTE: Multiple "matches" on identical areas are returned only once.

{
  paths": [[
    [-119.53, 36.21],
    [-98.26, 30.06],
    [-75.94, 40.43]
  ]],
  "spatialReference": {"wkid": 4326}
}
null
NOTE: InSR parameter value may be omitted. SpatialReference property of Geometry value overrides InSR parameter value.
esriGeometryPolyline

Query the area(s) in the data layer intersecting/touching line segments described by geographic (latitude-longitude) coordinates

NOTE: Multiple "matches" on identical areas are returned only once.

{
  "paths": [[
    [-119.53, 36.21],
    [-98.26, 30.06],
    [-75.94, 40.43]
  ]]
}
4326
NOTE: InSR parameter value is required when the SpatialReference property is not specified in the input Geometry.
esriGeometryPolyline

Query the area(s) in the data layer intersecting/touching line segments described by coordinates in a projected coordinate system (Web Mercator)

NOTE: Multiple "matches" on identical areas are returned only once.

{
  "paths": [[
    [-13306157.88, 4329684.99],
    [-10938444.49, 3511083.75],
    [-8453323.83, 4928581.18]
  ]],
  "spatialReference": {"wkid": 102100}
}
null
NOTE: InSR parameter value may be omitted. SpatialReference property of Geometry value overrides InSR parameter value.
esriGeometryPolyline

Query the area(s) in the data layer intersecting/touching line segments described by coordinates in a projected coordinate system (Web Mercator)

NOTE: Multiple "matches" on identical areas are returned only once.

{
  "paths": [[
    [-13306157.88, 4329684.99],
    [-10938444.49, 3511083.75],
    [-8453323.83, 4928581.18]
  ]]
}
102100
NOTE: InSR parameter value is required when the SpatialReference property is not specified in the input Geometry.
esriGeometryPolyline

Query the area(s) in the data layer intersecting/touching polygon areas described by geographic (latitude-longitude) coordinates

NOTE: Multiple "matches" on identical areas are returned only once.

{
  "rings": [[
    [-119.53, 36.21],
    [-75.94, 40.43],
    [-98.26, 30.06],
    [-119.53, 36.21]
  ]],
  "spatialReference": {"wkid": 4326}
}
null
NOTE: InSR parameter value may be omitted. SpatialReference property of Geometry value overrides InSR parameter value.
esriGeometryPolyline

Query the area(s) in the data layer intersecting/touching polygon areas described by geographic (latitude-longitude) coordinates

NOTE: Multiple "matches" on identical areas are returned only once.

{
  "rings": [[
    [-119.53, 36.21],
    [-75.94, 40.43],
    [-98.26, 30.06],
    [-119.53, 36.21]
  ]]
}
4326
NOTE: InSR parameter value is required when the SpatialReference property is not specified in the input Geometry.
esriGeometryPolygon

Query the area(s) in the data layer intersecting/touching polygon areas described by coordinates in a projected coordinate system (Web Mercator)

NOTE: Multiple "matches" on identical areas are returned only once.

{
  "rings": [[
    [-13306157.88, 4329684.99],
    [-8453323.83, 4928581.18],
    [-10938444.49, 3511083.75],
    [-13306157.88, 4329684.99]
  ]],
  "spatialReference": {"wkid": 102100}
}
null
NOTE: InSR parameter value may be omitted. SpatialReference property of Geometry value overrides InSR parameter value.
esriGeometryPolygon

Query the area(s) in the data layer intersecting/touching a polygon areas described by coordinates in a projected coordinate system (Web Mercator)

NOTE: Multiple "matches" on identical areas are returned only once.

{
  "rings": [[
    [-13306157.88, 4329684.99],
    [-8453323.83, 4928581.18],
    [-10938444.49, 3511083.75],
    [-13306157.88, 4329684.99]
  ]]
}
102100
NOTE: InSR parameter value is required when the SpatialReference property is not specified in the input Geometry.
esriGeometryPolygon

 

GeometryType Description: (Optional). The type of supported Geometry specified in the Geometry parameter.

Default: null

Syntax: GeometryType=<string> (Options: esriGeometryPoint | esriGeometryMultipoint | esriGeometryEnvelope | esriGeometryPolyline | esriGeometryPolygon)

Example: GeometryType=esriGeometryEnvelope

Example Description: In this example, the esriGeometryEnvelope type is specified so the corresponding Geometry parameter value should be an extent rectangle.

Notes:
Known Dependencies:
This parameter is required when a value is specified for the Geometry parameter.

The value specified must correspond with the specified GeometryType.

See the comprehensive table of supported Geometry types and sample values in the Geometry parameter.


InSR

Description: (Optional). The spatial reference/coordinate reference system of the input Geometry specified in the Geometry parameter.

Default: 102100

Syntax: InSR=<int> (Options: Well-known ID numbers from the lists of supported ArcGIS Server geographic and projected coordinate systems)

Example: InSR=4326

Example Description: The input Geometry specified in the Geometry parameter is a feature consisting of latitude-longitude coordinates (WGS 1984 Geographic Coordinate System) and the Geometry does not have an embedded SpatialReference property.

Notes:
Known Dependencies
: For latitude-longitude coordinates in an input Geometry value which doesn't include the SpatialReference property, this parameter value must be specified and set to 4326.

This value is overridden by the SpatialReference property of any input Geometry.

OutSR

Description: (Optional). The spatial reference/coordinate reference system of the output Geometry, if Geometry is returned with the output response.

Default: 102100

Syntax: OutSR=<int> (Options: Well-known ID numbers from the lists of supported ArcGIS Server geographic and projected coordinate systems)

Example: OutSR=4326

Example Description: If the output Geometry is returned with the service output response, the output Geometry will consist of latitude-longitude coordinates (WKID: 4326 - WGS 1984 Geographic Coordinate System).

Notes:
The OutSR parameter value will be ignored if the output response does not include output Geometry.

By default, the output geometry will be described in the Web Mercator projected coordinate reference system (WKID: 102100 - WGS 1984 Web Mercator Auxiliary Sphere)
.

Known Dependencies: The service will include polygon area features (output geometries) in the output response if the ReturnGeometry parameter is set to true, the f parameter is set to JSON or PJSON, and both the ReturnIDsOnly and ReturnCountOnly parameter values are set to false.

RelationParam

Description: (Optional). An advanced way to specify custom spatial relationship/intersection rules between the input Geometry (See the Geometry parameter) and the Online API administrative boundary/standard geography area data layer (See the GeoLevelID parameter) when the SpatialRel parameter value is set to esriSpatialRelRelation

Default: null

Syntax: RelationParam=<string> (Options: See the notes and syntax for the Spatial Relate function.)

Example: RelationParam=FFFTTT***

Example Description: If the the SpatialRel parameter value is set to esriSpatialRelRelation, the value of the RelationParam value specifies the parameters of the Spatial Relate function. In this example, the first three intersection relationships must be false (relationships 1-3), the next three must be true (relationships 4-6), and the final three are not considered (relationships 7-9) in the 9IM array.

Notes:
The Spatial Relate function is supported as a unary function for testing against the entire 9IM array. The 9IM array has nine elements of comparison—three elements of each shape versus three elements of the other shape. These elements are boundary, interior, and exterior.

The OutSR parameter value will be ignored if the output response does not include output Geometry.


Known Dependencies
: The value of this parameter will be ignored unless the SpatialRel parameter value is set to esriSpatialRelRelation

ReturnCountOnly

Description: (Optional). Obtain a count (number of area features) which satisfy the query/intersection criteria (See SpatialRel parameter) between the input Geometry (See the Geometry parameter) and the Online API administrative boundary/standard geography area data layer (See the GeoLevelID parameter)

Default: false

Syntax: ReturnCountOnly=<boolean>

Example: ReturnCountOnly=true

Example Description: Only return the count of area features from the specified Online API administrative boundary/standard geography area data layer which intersect the specified input Geometry.

Notes:
If true, the response will not include a FeatureSet in the response and
the behavior of this parameter will override the value of the ReturnIDsOnly parameter.

ReturnGeometry

Description: (Optional). Include the geometric descriptions of the polygon area(s) in the output response which satisfy the query/intersection criteria (See SpatialRel parameter) between the input Geometry (See the Geometry parameter) and the Online API administrative boundary/standard geography area data layer (See the GeoLevelID parameter)

Default: false

Syntax: ReturnGeometry=<boolean>

Example: ReturnGeometry=true

Example Description: Include the geometry in the output response

Notes:
Known Dependencies
: The service will include polygon area features (output geometries) in the output response if the ReturnGeometry parameter is set to true, the f parameter is set to JSON or PJSON, and both the ReturnIDsOnly and ReturnCountOnly parameter values are set to false.

The spatial reference/coordinate reference system of the output Geometry will be describe in the spatial/coordinate reference system described by the OutSR parameter value.

ReturnIDsOnly

Description: (Optional). Obtain a list of area feature IDs which satisfy the query/intersection criteria (See SpatialRel parameter) between the input Geometry (See the Geometry parameter) and the Online API administrative boundary/standard geography area data layer (See the GeoLevelID parameter)

Default: false

Syntax: ReturnIDsOnly=<boolean>

Example: ReturnIDsOnly=true

Example Description: Only return a JSON array of area feature IDs from the specified Online API administrative boundary/standard geography area data layer which intersect the specified input Geometry.

Notes:
If true, the response will not include a FeatureSet in the response.

Known Dependencies: T
he behavior of this parameter will be overridden by the ReturnCountOnly parameter if it is also true.

SpatialRel

Description: (Optional). Specify the query/intersection criteria between the input Geometry (See the Geometry parameter) and the Online API administrative boundary/standard geography area data layer (See the GeoLevelID parameter)

Default: esriSpatialRelIntersects

Syntax: SpatialRel=<esriSpatialRelEnum>

Example: SpatialRel=esriSpatialRelContains

Example Description: This query/intersection criteria states that, an area is returned from the Online API administrative boundary/standard geography area data layer if the area feature is wholly contained within the input Geometry.

Notes:
The default value of this parameter is the most common query/intersection type---this criteria states that, an area is returned from the Online API administrative boundary/standard geography area data layer if the area feature has any spatial relationship with the input Geometry.

The value of the RelationParam parameter will be ignored unless the SpatialRel parameter value is set to esriSpatialRelRelation.

Text

Description: (Optional). Additional query filter option which enables filtering on the area Name attribute of the area features originally satisfying the query/intersection criteria (See SpatialRel parameter) between the input Geometry (See the Geometry parameter) and the Online API administrative boundary/standard geography area data layer (See the GeoLevelID parameter)

Default: null

Syntax: Text=<string>

Example: Text=Dakota

Example Description: Further filter the output area features of the service to only include the areas which have the case-sensitive keyword Dakota in their Name attribute.

Notes:
The
keyword query string is case sensitive.

Known Dependencies:
All three of the required parameters plus one or more of the following parameters are required to complete a service request: where, geometry, text.

Where

Description: (Optional). Additional filter option which enables SQL-like queries on the attribute values of the area features in the current Online API administrative boundary/standard geography area data layer (See the GeoLevelID parameter) of the currently active data set (See the ActiveDatasetID parameter)

Default: null

Syntax: Where=<string>

Some Supported Operators and Characters

Logical Operators Description Examples
= LHS equals RHS 2, 3, 4
< LHS is less than RHS 5
> LHS is greater than RHS 5, 7
<= LHS is less than or equal to RHS 11
>= LHS is greater than or equal to RHS 6, 11
<> LHS does not equal RHS  
IN is in RHS 7
AND LHS is true and RHS is true 5, 7, 10, 11
OR LHS is true and/or RHS is true 4
NOT Is not RHS 10
LIKE Is like RHS

Enables comparisons with wild card character(s) where a shorter string is used or exact spelling is not known
8, 9, 10

 

Wild Card Characters Description Examples
_ Any one character only 9
% Zero or more characters 8, 10

 

Math Operators Description Examples
+ Addition of numeric values  
- Subtraction of numeric values  
* Multiplication of numeric values 11
/ Division of numeric values 6, 7, 11

 

Grouping Characters Description Examples
( ) Group operators, characters, variables, and values 2, 3, 4, 5, 6, 7, 8, 9, 10, 11
' ' Group string values 2, 3, 4, 7, 8, 9, 10



Example: Where=((X2001_X / TOTHH_CY) >= 750)

Example Description: Further filter the output area features of the service to only include the areas which have households which spend at least $750.00 per year on alcohol
(Summarization/analysis variable IDs: 'X2001_X' = Estimate of consumer spending on alcohol in 2010; 'TOTHH_CY' = Estimate of total households in 2010)

Notes:
Known Dependencies: All three of the required parameters plus one or more of the following parameters are required to complete a service request: where, geometry, text.

Example Usage


Example 1: Query the total number of households and total annual alcohol consumer spending of each of the 48 contiguous states

Request Example (1)

http://baoapi.esri.com/rest/maps/ThematicQuery/execute?
geoLevelID=US.States&
f=json&
outFields=NAME,ID,TOTHH_CY,X2001_X&
geometry={"xmin":-125,"ymin":25,"xmax":-43,"ymax":50}&
geometryType=esriGeometryEnvelope&
InSR=4326&
Token=ABC123

Notes: See the REST Response of the Example here. The spatial extent of the 48 contiguous states is described with the geometry parameter value. The analysis variable IDs are provided in the outFields parameter. See the Get Summarizations service and include the Visibility parameter with the string value '$all' to look up analysis/summarization variables (attribute fields) which are accessible with your Online API subscription and are in the currently-specified data set. This will include a property called, Mappable which will describe if the variable can be queried by this service (Mappable = true). The Request Example is hyperlinked with the URL-encoded request URI without a valid token parameter value. Include a valid token value to submit. See Get Token for more information on obtaining a token.



Example 2: Query the average and median owner-occupied home values; and the number of owner-occupied, renter-occupied, and vacant-housing units in a single ZIP code (and include the detailed/higher-precision polygon geometry in the default Web Mercator format in the output)

Request Example (2)

http://baoapi.esri.com/rest/maps/ThematicQuery/execute?
geoLevelID=US.ZIP5&
f=pjson&
outFields=NAME,ID,AVGVAL_CY,MEDVAL_CY,OWNER_CY,RENTER_CY,VACANT_CY&
returnGeometry=true&
Where=(ID='92373')&
Token=ABC123

Notes: See the REST Response of the Example here. The ZIP code is described in the Where parameter value. The analysis variable IDs are provided in the outFields parameter. See the Get Summarizations service and include the Visibility parameter with the string value '$all' to look up analysis/summarization variables (attribute fields) which are accessible with your Online API subscription and are in the currently-specified data set. This will include a property called, Mappable which will describe if the variable can be queried by this service (Mappable = true). The Request Example is hyperlinked with the URL-encoded request URI without a valid token parameter value. Include a valid token value to submit. See Get Token for more information on obtaining a token.

 

Example 3: Query the annual average household spending on sports, recreation and exercise equipment of a specific state (and include the generalized polygon geometry in the default Web Mercator format in the output)

Request Example (3)

http://baoapi.esri.com/rest/maps/ThematicQuery/execute?
geoLevelID=US.States&
generalizationLevel=7&
f=pjson&
outFields=NAME,ID,X9039_X&
returnGeometry=true&
Where=(NAME='Colorado')&
Token=ABC123

Notes: See the REST Response of the Example here. The state name is described in the Where parameter value. The analysis variable IDs are provided in the outFields parameter. See the Get Summarizations service and include the Visibility parameter with the string value '$all' to look up analysis/summarization variables (attribute fields) which are accessible with your Online API subscription and are in the currently-specified data set. This will include a property called, Mappable which will describe if the variable can be queried by this service (Mappable = true). The Request Example is hyperlinked with the URL-encoded request URI without a valid token parameter value. Include a valid token value to submit. See Get Token for more information on obtaining a token.

 

Example 4: Query the total number of households and total population count of two specific ZIP codes (and include the generalized polygon geometry in the default Web Mercator format in the output)

Request Example (4)

http://baoapi.esri.com/rest/maps/ThematicQuery/execute?
geoLevelID=US.ZIP5&
generalizationLevel=7&
f=pjson&
outFields=NAME,ID,TOTHH_CY,TOTPOP_CY&
returnGeometry=true&
Where=(ID='92373' OR ID='92374')&
Token=ABC123

Notes: See the REST Response of the Example here. The ZIP codes are described in the Where parameter value. The analysis variable IDs are provided in the outFields parameter. See the Get Summarizations service and include the Visibility parameter with the string value '$all' to look up analysis/summarization variables (attribute fields) which are accessible with your Online API subscription and are in the currently-specified data set. This will include a property called, Mappable which will describe if the variable can be queried by this service (Mappable = true). The Request Example is hyperlinked with the URL-encoded request URI without a valid token parameter value. Include a valid token value to submit. See Get Token for more information on obtaining a token.

 

Example 5: Query every Census Tract where the average household has a net worth between 1.9 and 2 million dollars

Request Example (5)

http://baoapi.esri.com/rest/maps/ThematicQuery/execute?
geoLevelID=US.Tracts&
f=pjson&
outFields=NAME,ID,AVGNW_CY&
Where=(AVGNW_CY > 1900000 AND AVGNW_CY < 2000000)&
Token=ABC123

Notes: See the REST Response of the Example here. The SQL-like attribute value query is in the Where parameter value. The analysis variable IDs are provided in the outFields parameter. See the Get Summarizations service and include the Visibility parameter with the string value '$all' to look up analysis/summarization variables (attribute fields) which are accessible with your Online API subscription and are in the currently-specified data set. This will include a property called, Mappable which will describe if the variable can be queried by this service (Mappable = true). The Request Example is hyperlinked with the URL-encoded request URI without a valid token parameter value. Include a valid token value to submit. See Get Token for more information on obtaining a token.

 

Example 6: Query every ZIP code where the annual spending on Child Care is at least $2000 per household

Request Example (6)

http://baoapi.esri.com/rest/maps/ThematicQuery/execute?
geoLevelID=US.ZIP5&
f=json&
outFields=NAME,ID,X4003_X,TOTHH_CY&
Where=((X4003_X / TOTHH_CY) >= 2000)&
Token=ABC123

Notes: See the REST Response of the Example here. The SQL-like attribute value query is in the Where parameter value. The analysis variable IDs are provided in the outFields parameter. See the Get Summarizations service and include the Visibility parameter with the string value '$all' to look up analysis/summarization variables (attribute fields) which are accessible with your Online API subscription and are in the currently-specified data set. This will include a property called, Mappable which will describe if the variable can be queried by this service (Mappable = true). The Request Example is hyperlinked with the URL-encoded request URI without a valid token parameter value. Include a valid token value to submit. See Get Token for more information on obtaining a token.

 

Example 7: Query states from a specified list whose average annual household spending on auto insurance exceed $1250 (and include the generalized polygon geometry in latitude-longitude format in the output)

Request Example (7)

http://baoapi.esri.com/rest/maps/ThematicQuery/execute?
geoLevelID=US.States&
generalizationLevel=7&
f=json&
outFields=NAME,ID,X6040_X,TOTHH_CY&
returnGeometry=true&
OutSR=4326&
Where=(NAME IN ('Illinois','Michigan','Massachusetts','New York','California','Florida','Louisiana') AND ((X6040_X / TOTHH_CY) > 1250))&
Token=ABC123

Notes: See the REST Response of the Example here. The list of states and the SQL-like attribute value query are in the Where parameter value. The analysis variable IDs are provided in the outFields parameter. See the Get Summarizations service and include the Visibility parameter with the string value '$all' to look up analysis/summarization variables (attribute fields) which are accessible with your Online API subscription and are in the currently-specified data set. This will include a property called, Mappable which will describe if the variable can be queried by this service (Mappable = true). The Request Example is hyperlinked with the URL-encoded request URI without a valid token parameter value. Include a valid token value to submit. See Get Token for more information on obtaining a token.

 

Example 8: Query the total number of households and total population count of all the ZIP codes associated with the name 'Redlands' (and include the detailed/high-precision polygon geometry in latitude-longitude format in the output)

Request Example (8)

http://baoapi.esri.com/rest/maps/ThematicQuery/execute?
geoLevelID=US.ZIP5&
f=pjson&
outFields=NAME,ID,TOTHH_CY,TOTPOP_CY&
returnGeometry=true&
OutSR=4326&
Where=(NAME LIKE'%Redlands%')&
Token=ABC123

Notes: See the REST Response of the Example here. The SQL-like attribute value query is in the Where parameter value. The analysis variable IDs are provided in the outFields parameter. See the Get Summarizations service and include the Visibility parameter with the string value '$all' to look up analysis/summarization variables (attribute fields) which are accessible with your Online API subscription and are in the currently-specified data set. This will include a property called, Mappable which will describe if the variable can be queried by this service (Mappable = true). The Request Example is hyperlinked with the URL-encoded request URI without a valid token parameter value. Include a valid token value to submit. See Get Token for more information on obtaining a token.

 

Example 9: Query the average annual disposable income for each household in state names which contain 'Ne_ada' (where '_' is a wild card representing a single unknown character) (and include the generalized polygon geometry in latitude-longitude format in the output)

Request Example (9)

http://baoapi.esri.com/rest/maps/ThematicQuery/execute?
geoLevelID=US.States&
generalizationLevel=7&
f=pjson&
outFields=NAME,ID,AVGDI_CY&
returnGeometry=true&
OutSR=4326&
Where=(NAME LIKE'Ne_ada')&
Token=ABC123

Notes: See the REST Response of the Example here. The SQL-like attribute value query is in the Where parameter value. The analysis variable IDs are provided in the outFields parameter. See the Get Summarizations service and include the Visibility parameter with the string value '$all' to look up analysis/summarization variables (attribute fields) which are accessible with your Online API subscription and are in the currently-specified data set. This will include a property called, Mappable which will describe if the variable can be queried by this service (Mappable = true). The Request Example is hyperlinked with the URL-encoded request URI without a valid token parameter value. Include a valid token value to submit. See Get Token for more information on obtaining a token.

 

Example 10: Query the total number of married, divorced, widowed, and single(never-married) individuals in states which have names which begin with 'Ne' and not 'New'

Request Example (10)

http://baoapi.esri.com/rest/maps/ThematicQuery/execute?
geoLevelID=US.States&
f=pjson&
outFields=NAME,ID,NEVMARR_CY,MARRIED_CY,WIDOWED_CY,DIVORCD_CY&
Where=((NAME LIKE'Ne%') AND NOT (NAME LIKE'New%'))&
Token=ABC123

Notes: See the REST Response of the Example here. The SQL-like attribute value query are in the Where parameter value. The analysis variable IDs are provided in the outFields parameter. See the Get Summarizations service and include the Visibility parameter with the string value '$all' to look up analysis/summarization variables (attribute fields) which are accessible with your Online API subscription and are in the currently-specified data set. This will include a property called, Mappable which will describe if the variable can be queried by this service (Mappable = true). The Request Example is hyperlinked with the URL-encoded request URI without a valid token parameter value. Include a valid token value to submit. See Get Token for more information on obtaining a token.

 

Example 11: Query every county in the 48 contiguous states where 25% or more of the adult population (25 and older) attended high school but did not graduate (and only return counties where ACS values for 'ACSSOMEHS' and 'ACSEDUCBAS' are considered reliable estimates)

Request Example (11)

http://baoapi.esri.com/rest/maps/ThematicQuery/execute?
geoLevelID=US.Counties&
f=pjson&
outFields=NAME,ID,MOESOMEHS,ACSSOMEHS,MOEEDUCBAS,ACSEDUCBAS&
geometry={"xmin":-125,"ymin":25,"xmax":-43,"ymax":50}&
geometryType=esriGeometryEnvelope&
InSR=4326&
Where=((((MOESOMEHS / 1.645 * 100)/ACSSOMEHS) <= 12) AND (((MOEEDUCBAS /1.645 * 100)/ACSEDUCBAS) <= 12) AND ((ACSSOMEHS * 1.0/ACSEDUCBAS) >= 0.25))&
Token=ABC123

Notes: See the REST Response of the Example here. This is an American Community Survey data example where the Margin of Error (MOE) values for each ACS variable used are leveraged in the query to ensure that the query result only contains reliable results. More information about leveraging ACS Data in the Online API can be found here. In the SQL-like query in the Where parameter value, each term is either multiplied or divided by a decimal number to convert any int numbers into double numbers for increased precision. The spatial extent of the 48 contiguous states is described with the geometry parameter value. The analysis variable IDs are provided in the outFields parameter. See the Get Summarizations service and include the Visibility parameter with the string value '$all' to look up analysis/summarization variables (attribute fields) which are accessible with your Online API subscription and are in the currently-specified data set. This will include a property called, Mappable which will describe if the variable can be queried by this service (Mappable = true). The Request Example is hyperlinked with the URL-encoded request URI without a valid token parameter value. Include a valid token value to submit. See Get Token for more information on obtaining a token.

 


Example Response

JSON Response Syntax 1 of 4 (when returnIDsOnly = false and returnCountOnly = false and returnGeometry =false)

{
  "displayFieldName" : <string>,
  "fieldAliases" : {
    <string> : <string>,

    ...

    <string> : <string>
  },
  "fields" : [
    {
      "name" : <string>,
      "type" : <string>,
      "alias" : <string>,
      "length" : <int>
    },

    ...

    {
      "name" : <string>,
      "type" : <string>,
      "alias" : <string>,
      "length" : <int>
    }
  ],
  "features" : [
    <Esri JSON Feature Object with Attributes property only>,

    ...

    <Esri JSON Feature Object with Attributes property only>
  ]
}

JSON Response Syntax 2 of 4 (when returnIDsOnly = false and returnCountOnly = false and returnGeometry = true)

{
  "displayFieldName" : <string>,
  "fieldAliases" : {
    <string> : <string>,

    ...

    <string> : <string>
  },
  "geometryType" : <string>,
  "spatialReference" : {
    "wkid" : <int>
  },
  "fields" : [
    {
      "name" : <string>,
      "type" : <string>,
      "alias" : <string>,
      "length" : <int>
    },

    ...

    {
      "name" : <string>,
      "type" : <string>,
      "alias" : <string>,
      "length" : <int>
    }
  ],
  "features" : [
    <Esri JSON Feature Object with Attributes and Polygon Geometry properties>,

    ...

    <Esri JSON Feature Object with Attributes and Polygon Geometry properties>
  ]
}

JSON Response Syntax 3 of 4 (when returnCountOnly =true)

{
  "count" : <int>
}

JSON Response Syntax 4 of 4 (when returnIDsOnly =true)

{
  "objectIdFieldName" : "ObjectID", 
  "objectIds" : [
    <int>,
 
    <int> 
  ]
}


 

 

JSON Response Example (1)

{"displayFieldName":"NAME","fieldAliases":{"ID":"ID","NAME":"NAME","TOTHH_CY":"TOTHH_CY","X2001_X":"X2001_X"},"fields":[{"name":"ID","type":"esriFieldTypeString","alias":"ID","length":2},{"name":"NAME","type":"esriFieldTypeString","alias":"NAME","length":22},{"name":"TOTHH_CY","type":"esriFieldTypeInteger","alias":"TOTHH_CY"},{"name":"X2001_X","type":"esriFieldTypeDouble","alias":"X2001_X"}],"features":[{"attributes":{"ID":"09","NAME":"Connecticut","TOTHH_CY":1352501,"X2001_X":1064325913}},. ... {"attributes":{"ID":"51","NAME":"Virginia","TOTHH_CY":3045412,"X2001_X":1948755943}},{"attributes":{"ID":"54","NAME":"West Virginia","TOTHH_CY":761707,"X2001_X":272821777}}]}

Notes: The response has been abbreviated in the example where "..." is noted.

 

JSON Response Example (2)

{
  "displayFieldName" : "Name",
  "fieldAliases" : {
    "ID" : "ID",
    "NAME" : "NAME",
    "AVGVAL_CY" : "AVGVAL_CY",
    "MEDVAL_CY" : "MEDVAL_CY",
    "OWNER_CY" : "OWNER_CY",
    "RENTER_CY" : "RENTER_CY",
    "VACANT_CY" : "VACANT_CY"
  },
  "geometryType" : "esriGeometryPolygon",
  "spatialReference" : {
    "wkid" : 102100
  },
  "fields" : [
    {
      "name" : "ID",
      "type" : "esriFieldTypeString",
      "alias" : "ID",
      "length" : 5
    },
    {
      "name" : "NAME",
      "type" : "esriFieldTypeString",
      "alias" : "NAME",
      "length" : 28
    },
    {
      "name" : "AVGVAL_CY",
      "type" : "esriFieldTypeInteger",
      "alias" : "AVGVAL_CY"
    },
    {
      "name" : "MEDVAL_CY",
      "type" : "esriFieldTypeInteger",
      "alias" : "MEDVAL_CY"
    },
    {
      "name" : "OWNER_CY",
      "type" : "esriFieldTypeInteger",
      "alias" : "OWNER_CY"
    },
    {
      "name" : "RENTER_CY",
      "type" : "esriFieldTypeInteger",
      "alias" : "RENTER_CY"
    },
    {
      "name" : "VACANT_CY",
      "type" : "esriFieldTypeInteger",
      "alias" : "VACANT_CY"
    }
  ],
  "features" : [
    {
      "attributes" : {
        "NAME" : "Redlands",
        "ID" : "92373",
        "AVGVAL_CY" : 357105,
        "MEDVAL_CY" : 278759,
        "OWNER_CY" : 7219,
        "RENTER_CY" : 6571,
        "VACANT_CY" : 787
      },
      "geometry" : {
        "rings" : [
          [
            [
              -13045154.979862113,
              4023591.173150504
            ],

            ...

            [
              -13044588.695384659,
              4023593.3247004217
            ],
            [
              -13045154.979862113,
              4023591.173150504
            ]
          ]
        ]
      }
    }
  ]
}

Notes: The response has been abbreviated in the example where "..." is noted.

 

JSON Response Example (3)

{
  "displayFieldName" : "Name",
  "fieldAliases" : {
    "ID" : "ID",
    "NAME" : "NAME",
    "X9039_X" : "X9039_X"
  },
  "geometryType" : "esriGeometryPolygon",
  "spatialReference" : {
    "wkid" : 102100
  },
  "fields" : [
    {
      "name" : "ID",
      "type" : "esriFieldTypeString",
      "alias" : "ID",
      "length" : 2
    },
    {
      "name" : "NAME",
      "type" : "esriFieldTypeString",
      "alias" : "NAME",
      "length" : 22
    },
    {
      "name" : "X9039_X",
      "type" : "esriFieldTypeDouble",
      "alias" : "X9039_X"
    }
  ],
  "features" : [
    {
      "attributes" : {
        "ID" : "08",
        "NAME" : "Colorado",
        "X9039_X" : 322085273
      },
      "geometry" : {
        "rings" : [
          [
            [
              -12138858.693560056,
              4438979.2514990252
            ],
            [
              -12139684.689281188,
              4719488.0963623906
            ],
            [
              -12139399.047449317,
              5012438.8612142093
            ],
            [
              -11857021.125889536,
              5012627.0759869646
            ],
            [
              -11583154.804847971,
              5012549.0478147548
            ],
            [
              -11360347.836596938,
              5012684.1593603808
            ],
            [
              -11360348.176928287,
              4866389.5736374799
            ],
            [
              -11359584.300330875,
              4636636.1137548732
            ],
            [
              -11359290.196361899,
              4438142.6939694155
            ],
            [
              -11411643.419722101,
              4438397.8905663528
            ],
            [
              -11466155.237926973,
              4439135.4981982689
            ],
            [
              -11827440.41910914,
              4438307.7085271459
            ],
            [
              -12138858.693560056,
              4438979.2514990252
            ]
          ]
        ]
      }
    }
  ]
}

 

JSON Response Example (4)

{
  "displayFieldName" : "Name",
  "fieldAliases" : {
    "ID" : "ID",
    "NAME" : "NAME",
    "TOTHH_CY" : "TOTHH_CY",
    "TOTPOP_CY" : "TOTPOP_CY"
  },
  "geometryType" : "esriGeometryPolygon",
  "spatialReference" : {
    "wkid" : 102100
  },
  "fields" : [
    {
      "name" : "ID",
      "type" : "esriFieldTypeString",
      "alias" : "ID",
      "length" : 5
    },
    {
      "name" : "NAME",
      "type" : "esriFieldTypeString",
      "alias" : "NAME",
      "length" : 28
    },
    {
      "name" : "TOTHH_CY",
      "type" : "esriFieldTypeInteger",
      "alias" : "TOTHH_CY"
    },
    {
      "name" : "TOTPOP_CY",
      "type" : "esriFieldTypeInteger",
      "alias" : "TOTPOP_CY"
    }
  ],
  "features" : [
    {
      "attributes" : {
        "NAME" : "Redlands",
        "ID" : "92374",
        "TOTHH_CY" : 13522,
        "TOTPOP_CY" : 42170
      },
      "geometry" : {
        "rings" : [
          [
            [
              -13035868.705833083,
              4034193.1228384441
            ],

            ...

            [
              -13037746.997374948,
              4024549.9049475668
            ],
            [
              -13045154.979862113,
              4023591.1789187342
            ]
          ]
        ]
      }
    }
  ]
}

Notes: The response has been abbreviated in the example where "..." is noted.

 

JSON Response Example (5)

{
  "displayFieldName" : "Name",
  "fieldAliases" : {
    "ID" : "ID",
    "NAME" : "NAME",
    "AVGNW_CY" : "AVGNW_CY"
  },
  "fields" : [
    {
      "name" : "ID",
      "type" : "esriFieldTypeString",
      "alias" : "ID",
      "length" : 11
    },
    {
      "name" : "NAME",
      "type" : "esriFieldTypeString",
      "alias" : "NAME",
      "length" : 13
    },
    {
      "name" : "AVGNW_CY",
      "type" : "esriFieldTypeInteger",
      "alias" : "AVGNW_CY"
    }
  ],
  "features" : [
    {
      "attributes" : {
        "ID" : "15003000102",
        "NAME" : "150030001.02",
        "AVGNW_CY" : 1932861
      }
    },

    ...

    {
      "attributes" : {
        "ID" : "12099003502",
        "NAME" : "120990035.02",
        "AVGNW_CY" : 1917328
      }
    },
    {
      "attributes" : {
        "ID" : "12099007003",
        "NAME" : "120990070.03",
        "AVGNW_CY" : 1993359
      }
    }
  ]
}

Notes: The response has been abbreviated in the example where "..." is noted.

 

JSON Response Example (6)

{"displayFieldName":"NAME","fieldAliases":{"ID":"ID","NAME":"NAME","X4003_X":"Child Care:Tot","TOTHH_CY":"TOTHH_CY"},"fields":[{"name":"ID","type":"esriFieldTypeString","alias":"ID","length":5},{"name":"NAME","type":"esriFieldTypeString","alias":"NAME","length":28},{"name":"X4003_X","type":"esriFieldTypeDouble","alias":"Child Care:Tot"},{"name":"TOTHH_CY","type":"esriFieldTypeInteger","alias":"TOTHH_CY"}],"features":[{"attributes":{"ID":"94027","NAME":"Atherton","X4003_X":5009483,"TOTHH_CY":2462}}]}

 

JSON Response Example (7)

{"displayFieldName":"NAME","fieldAliases":{"ID":"ID","NAME":"NAME","X6040_X":"Vehicle Insurance:Tot","TOTHH_CY":"TOTHH_CY"},"geometryType":"esriGeometryPolygon","spatialReference":{"wkid":4326},"fields":[{"name":"ID","type":"esriFieldTypeString","alias":"ID","length":2},{"name":"NAME","type":"esriFieldTypeString","alias":"NAME","length":22},{"name":"X6040_X","type":"esriFieldTypeDouble","alias":"Vehicle Insurance:Tot"},{"name":"TOTHH_CY","type":"esriFieldTypeInteger","alias":"TOTHH_CY"}],"features":[{"attributes":{"ID":"25","NAME":"Massachusetts","X6040_X":3656413699,"TOTHH_CY":2520494},"geometry":{"rings":[[[-73.487313979469803,42.049638019703544],...[-70.011504034557646,41.542924008719019],[-70.014456973909731,41.545533968077045]]]}},{"attributes":{"ID":"06","NAME":"California","X6040_X":17057269755,"TOTHH_CY":12662806},"geometry":{"rings":[[[-114.63301304132813,35.002086015697813],...[-119.43283001007292,34.016105018891921],[-119.43272601180524,34.016058030776868]]]}},{"attributes":{"ID":"17","NAME":"Illinois","X6040_X":6102310878,"TOTHH_CY":4838349},"geometry":{"rings":[[[-89.132685947657777,36.982199999910804],...[-89.173828999246055,37.06633902289223],[-89.132685947657777,36.982199999910804]]]}},{"attributes":{"ID":"36","NAME":"New York","X6040_X":9391217524,"TOTHH_CY":7259376},"geometry":{"rings":[[[-73.487313979469803,42.049638019703544],...[-73.820594020347826,40.612317024308091],[-73.832920950041768,40.638887987702326]]]}}]}

Notes: The response has been abbreviated in the example where "..." is noted.

 

JSON Response Example (8)

{
  "displayFieldName" : "NAME",
  "fieldAliases" : {
    "ID" : "ID",
    "NAME" : "NAME",
    "TOTHH_CY" : "TOTHH_CY",
    "TOTPOP_CY" : "TOTPOP_CY"
  },
  "geometryType" : "esriGeometryPolygon",
  "spatialReference" : {
    "wkid" : 4326
  },
  "fields" : [
    {
      "name" : "ID",
      "type" : "esriFieldTypeString",
      "alias" : "ID",
      "length" : 5
    },
    {
      "name" : "NAME",
      "type" : "esriFieldTypeString",
      "alias" : "NAME",
      "length" : 28
    },
    {
      "name" : "TOTHH_CY",
      "type" : "esriFieldTypeInteger",
      "alias" : "TOTHH_CY"
    },
    {
      "name" : "TOTPOP_CY",
      "type" : "esriFieldTypeInteger",
      "alias" : "TOTPOP_CY"
    }
  ],
  "features" : [
    {
      "attributes" : {
        "ID" : "92374",
        "NAME" : "Redlands",
        "TOTHH_CY" : 13522,
        "TOTPOP_CY" : 42170
      },
      "geometry" : {
        "rings" : [
          [
            [
              -117.10320100225222,
              34.040140008232292
            ],

            ...

            [
              -117.18153400116765,
              33.961199968190911
            ],
            [
              -117.18662102118022,
              33.961184023438683
            ]
          ]
        ]
      }
    }
  ]
}

Notes: The response has been abbreviated in the example where "..." is noted.

 

JSON Response Example (9)

{
  "displayFieldName" : "Name",
  "fieldAliases" : {
    "ID" : "ID",
    "NAME" : "NAME",
    "AVGDI_CY" : "AVGDI_CY"
  },
  "geometryType" : "esriGeometryPolygon",
  "spatialReference" : {
    "wkid" : 4326
  },
  "fields" : [
    {
      "name" : "ID",
      "type" : "esriFieldTypeString",
      "alias" : "ID",
      "length" : 2
    },
    {
      "name" : "NAME",
      "type" : "esriFieldTypeString",
      "alias" : "NAME",
      "length" : 22
    },
    {
      "name" : "AVGDI_CY",
      "type" : "esriFieldTypeInteger",
      "alias" : "AVGDI_CY"
    }
  ],
  "features" : [
    {
      "attributes" : {
        "ID" : "32",
        "NAME" : "Nevada",
        "AVGDI_CY" : 60031
      },
      "geometry" : {
        "rings" : [
          [
            [
              -114.05059999438132,
              37.000397005199929
            ],

            ...

            [
              -114.04777597764506,
              39.365397002262227
            ],
            [
              -114.05059999438132,
              37.000397005199929
            ]
          ]
        ]
      }
    }
  ]
}

Notes: The response has been abbreviated in the example where "..." is noted.

 

JSON Response Example (10)

{
  "displayFieldName" : "Name",
  "fieldAliases" : {
    "ID" : "ID",
    "NAME" : "NAME",
    "NEVMARR_CY" : "NEVMARR_CY",
    "MARRIED_CY" : "MARRIED_CY",
    "WIDOWED_CY" : "WIDOWED_CY",
    "DIVORCD_CY" : "DIVORCD_CY"
  },
  "fields" : [
    {
      "name" : "ID",
      "type" : "esriFieldTypeString",
      "alias" : "ID",
      "length" : 2
    },
    {
      "name" : "NAME",
      "type" : "esriFieldTypeString",
      "alias" : "NAME",
      "length" : 22
    },
    {
      "name" : "NEVMARR_CY",
      "type" : "esriFieldTypeInteger",
      "alias" : "NEVMARR_CY"
    },
    {
      "name" : "MARRIED_CY",
      "type" : "esriFieldTypeInteger",
      "alias" : "MARRIED_CY"
    },
    {
      "name" : "WIDOWED_CY",
      "type" : "esriFieldTypeInteger",
      "alias" : "WIDOWED_CY"
    },
    {
      "name" : "DIVORCD_CY",
      "type" : "esriFieldTypeInteger",
      "alias" : "DIVORCD_CY"
    }
  ],
  "features" : [
    {
      "attributes" : {
        "ID" : "31",
        "NAME" : "Nebraska",
        "NEVMARR_CY" : 411112,
        "MARRIED_CY" : 806186,
        "WIDOWED_CY" : 88576,
        "DIVORCD_CY" : 143439
      }
    },
    {
      "attributes" : {
        "ID" : "32",
        "NAME" : "Nevada",
        "NEVMARR_CY" : 635698,
        "MARRIED_CY" : 1139810,
        "WIDOWED_CY" : 119734,
        "DIVORCD_CY" : 289317
      }
    }
  ]
}

 

JSON Response Example (11)

{
  "displayFieldName" : "NAME",
  "fieldAliases" : {
    "ID" : "ID",
    "NAME" : "NAME",
    "MOESOMEHS" : "MOESOMEHS",
    "ACSSOMEHS" : "ACSSOMEHS",
    "MOEEDUCBAS" : "MOEEDUCBAS",
    "ACSEDUCBAS" : "ACSEDUCBAS"
  },
  "fields" : [
    {
      "name" : "ID",
      "type" : "esriFieldTypeString",
      "alias" : "ID",
      "length" : 5
    },
    {
      "name" : "NAME",
      "type" : "esriFieldTypeString",
      "alias" : "NAME",
      "length" : 45
    },
    {
      "name" : "MOESOMEHS",
      "type" : "esriFieldTypeInteger",
      "alias" : "MOESOMEHS"
    },
    {
      "name" : "ACSSOMEHS",
      "type" : "esriFieldTypeInteger",
      "alias" : "ACSSOMEHS"
    },
    {
      "name" : "MOEEDUCBAS",
      "type" : "esriFieldTypeInteger",
      "alias" : "MOEEDUCBAS"
    },
    {
      "name" : "ACSEDUCBAS",
      "type" : "esriFieldTypeInteger",
      "alias" : "ACSEDUCBAS"
    }
  ],
  "features" : [
    {
      "attributes" : {
        "ID" : "13167",
        "NAME" : "Johnson County",
        "MOESOMEHS" : 244,
        "ACSSOMEHS" : 1579,
        "MOEEDUCBAS" : 199,
        "ACSEDUCBAS" : 6209
      }
    },
    {
      "attributes" : {
        "ID" : "13065",
        "NAME" : "Clinch County",
        "MOESOMEHS" : 213,
        "ACSSOMEHS" : 1104,
        "MOEEDUCBAS" : 92,
        "ACSEDUCBAS" : 4405
      }
    },
    {
      "attributes" : {
        "ID" : "13269",
        "NAME" : "Taylor County",
        "MOESOMEHS" : 217,
        "ACSSOMEHS" : 1436,
        "MOEEDUCBAS" : 90,
        "ACSEDUCBAS" : 5670
      }
    },
    {
      "attributes" : {
        "ID" : "51029",
        "NAME" : "Buckingham County",
        "MOESOMEHS" : 631,
        "ACSSOMEHS" : 3966,
        "MOEEDUCBAS" : 315,
        "ACSEDUCBAS" : 13795
      }
    }
  ]
}

 

 



See Also

Get Datasets

Get Standard Geography Levels

Get Summarizations

Get Token