FRAMES | NO FRAMES

 

B U S I N E S S   A N A L Y S T   10.2   R E S T    R E P O R T    T A S K

Benchmark Report Endpoint

A comparative report that benchmarks two or more trade areas based on selected volumetric data (typically demographic data).

 

Availability: Business Analyst Online, Business Analyst Server.

 

URL Example

http://localhost:6080/arcgis/rest/services/DefaultMap/MapServer/exts/BAServer/BenchmarkReport/execute

Specific Parameters

Parameter

Description

BenchmarkOptions (required)

Benchmark area calculation method. Type esriBABenchmarkOptions.

Summarizations (required)

Fields of the geography data layer to be summarized for trade areas and compared with the benchmark. Type array of string.

TradeAreas (required)

Array containing one or more trade area layers to produce the benchmark report. Type array of DataLayer.

BenchmarkAreaOID (optional)

OID of area from the BenchmarkLayer layer to be used as a benchmark area. Type int.

BenchmarkLayer (optional)

Data layer used for calculation the benchmark area. Type DataLayer.

DataHierarchy (optional)

Name of a hierarchy of data layers used for summarization. Type string. Use the Get Data Hierarchies lookup operation to query available geography hierarchies.

Default: Standard Business Analyst Data.

FieldSortType (optional)

Report fields sorting options. Type esriBABenchmarkSortOptions.

Default: sortNone.

SortFieldName (optional)

Name of summarization field the sorting will be based on. Type string.

TAinRows (optional)

Report layout options. The "trade areas in rows" layout is used by default. Type boolean.

Default: true.

TALayersFields (optional)

Fields of trade area layers that will appear in the report. Type array of string.

Other Parameters

Parameter

Description

OutputType (required)

Array of task output options. Options for this method include creating a report (GetReport). Type array of TaskOutputType.

StandardReportOptions (required)

Report parameters. Type ReportOptions. The TemplateName parameter is ignored. Available with Business Analyst Online and Business Analyst Server.

ActiveDatasetID (optional)

ID of the active dataset. Type string.

Default: ID of the first available dataset.

f (optional)

Response format. Type string. Available formats: HTML, JSON, PJSON, XML.

Default: HTML.

IsFullErrorMessage (optional)

Mode for composing error messages. Type boolean.

Default: false.

OutputReportItem (optional)

Configuration options for storing the output report in the repository. This will enable viewing and working with the output result in subsequent tasks. Type esriFolderItem.

token

Authentication token. In Business Analyst Server, this parameter is required if your Business Analyst Server is secured. Type string.

Returns

Variable of type TaskResultOutput

Remarks

The Benchmark Report allows you to compare multiple trade areas against one another to decipher how different or similar one location is over the next. You can easily measure the demographic characteristics of one area versus all other areas. The report shows statistical differences in raw number, percent, and index values.

 

The BenchmarkOptions parameter specifies how to create the benchmark area:

 

useOneOfTheTradeAreas selects the benchmark area by its OID from the benchmark layer (the BenchmarkLayer and BenchmarkAreaOID parameters should be specified).

useAverageValues creates the benchmark area by calculating average summarization values for all areas in trade area layers.

useMedianValues creates the benchmark area by calculating median summarization values for all areas in trade area layers.

useNone means no benchmark (creates a report without comparison with benchmark).

 

The TAinRows option determines the orientation of the summarization fields in the report:

 

true value outputs the report with the summarization fields in columns and the trade areas in rows.

false value outputs the report with the summarization fields in rows and the trade areas in columns.

 

The FieldSortType option specifies the sorting rules based on the SortFieldName field:

 

sortNone means no sorting.

sortByFieldOnly sorts by the field itself.

sortByFieldDifference sorts by calculated difference between the field value and the benchmark field value.

sortByFieldPercent sorts by calculated percent of the field value with respect to the benchmark field value.

sortByFieldIndex sorts by the field index (available for some summarization fields).

 

NOTE: Since Business Analyst Server 10.0, the DataLayerID parameter is replaced with an optional DataHierarchy parameter.

Usage Tips

• The benchmarks can only be made on variables that exist in all trade area layers being compared.

• Variables and trade areas can be shown as either rows or columns.

• When benchmarking all trade areas against a single trade area, the average or the median of all the trade areas is calculated and used as the benchmark.

Example Usage

The example below generates a benchmark report based on drive-time trade areas.

 

NOTE: The example uses the "Drive Time Polygons 1" polygon layer already created in the Trade Areas folder of the San Francisco Tutorial Project of the Default Workspace.

 

Request

http://localhost:6080/arcgis/rest/services/DefaultMap/MapServer/exts/BAServer/BenchmarkReport/execute?tradeareas=[{"Recordset":{"geometryType":"esriGeometryPolygon","spatialReference":{"wkid":4269},"features":[{"geometry":{"rings":[[[-122.4346,37.8566476371076],[-122.360655858915,37.826739954428],[-122.347749703146,37.761714833162],[-122.406398364369,37.7151967133423],[-122.488250155425,37.7254855017619],[-122.525947479981,37.784114591287],[-122.488335196333,37.8427896412311],[-122.4346,37.8566476371076]]],"spatialReference":{"wkid":4269}},"attributes":{"OID":1,"AREA_ID":"1_1","STORE_ID":"1","RING":1,"RING_DEFN":"5","AREA_DESC":"0 - 5 Miles"}},{"geometry":{"rings":[[[-122.4329,37.8057482650651],[-122.35900658434,37.775840365754],[-122.346109142864,37.7108146974946],[-122.404717633044,37.6642961225184],[-122.48651348554,37.6745850161913],[-122.524184911958,37.7332146557964],[-122.486598312884,37.791890171551],[-122.4329,37.8057482650651]]],"spatialReference":{"wkid":4269}},"attributes":{"OID":2,"AREA_ID":"2_1","STORE_ID":"2","RING":1,"RING_DEFN":"5","AREA_DESC":"0 - 5 Miles"}}]}}]&benchmarkoptions=useNone&summarizations=["TOTPOP_CY","HHPOP_CY"]&standardreportoptions={"ReportFormat":"HTML","ReportHeader":[{"key":"subtitle","value":"Report title"}]}&outputtype=[GetReport]&f=pjson

 

Response

{
 "results": [
  {
   "paramName": "Benchmark Report.HTML",
   "dataType": "GPDataFile",
   "value": {
    "url": "http://localhost:6080/arcgis/rest/directories/arcgisoutput/DefaultMap_MapServer/_ags_T700D354FB4D5486EDB1C375BD3ABE.html"
   }
  }
 ],
 "messages": [
  
 ]
}

 

See Also

Business Analyst Server REST Reference