Geospatial analysis
We enhanced our suite of geospatial APIs to help further streamline your workflows that use custom boundaries.
We introduced a number of custom boundary related APIs to automate geospatial analyses. We also made changes to our Geospatial engine to align more closely with the updated NGM loss engine.
Enhancements
We implemented the following enhancements that enable you to:
-
Retrieve a list of custom boundaries for a specific business unit in Touchstone.
-
Specify custom boundaries and run a geospatial analysis.
Retrieve results of geospatial analyses run with custom boundaries through a geospatial API.
Add bounding box definitions for a grid ring analysis using the geospatial public API.
Retrieve a list of custom boundaries
You can retrieve a list of custom boundaries available for geospatial analysis in a specific business unit. We implemented a new GetCustomBoundaries method to retrieve the custom boundary details, such as name and SID, and geospatial area shapefile, which you can use to visualize where your exposures are accumulated and then drill down to key locations. The request class inherits a valid SQL Instance ID and business unit (BU) SID for which you want to fetch the boundary datasets. The GetCustomBoundariesResponse class returns a list of all existing area custom boundaries for the given BU SID.
Property | Type | Description |
---|---|---|
CustomBoundaries | List <CustomBoundary> | Contains the list of custom boundaries associated with the business unit specified in your request |
Property | Type | Description |
---|---|---|
Name | String | Contains the name of the custom boundary |
SID | Integer | Contains the Touchstone business unit SID |
SpatialFileType | String |
Contains the type of spatial dataset.
|
Retrieve details of each custom boundary
You can use the area polgon custom SIDs to retrieve granular details for each custom boundary SID. We implemented a new GetCustomBoundariesDetails method for retrieving the details of each custom boundary. This method includes a new CustomBoundaryOption sub-class for storing details such as the number of boundary records, name, user-provided peril, unique identifier of each boundary, and the type of spatial shape. The new request class contains the list of unique SIDs for each custom boundary.
Property | Type | Description |
---|---|---|
SIDs | list <IDs>
|
(Required) Contains the list of valid custom boundary SIDs
|
We implemented a new CustomBoundaryOption sub-class to store custom boundary details such as the number of boundary records, name, user-provided peril, unique identifier of each boundary, and the type of spatial shape. This sub-class includes the following properties:
Property | Type | Description |
---|---|---|
LegendItems | LegendItems <LegendItem> | The list of data categories or ranges associated with the custom boundary file. |
Name | String | Name of the boundary |
PerilSet | PerilSet <PerilSetCode> | The user-specified peril for each custom boundary.Note: By default, the custom boundary retrieved from Touchstone UI does not include peril assignments. You must assign perils for each custom boundary. |
Sid | Integer | Unique SID of the custom boundary |
SpatialQueryType | String | The shape of the dataset. Currently we support area polygon. |
Run Geospatial analysis with custom boundaries
You can run a geospatial analysis with custom boundary definitions. We implemented a new SubmitCustomBoundaryExposureConcentrationAnalysis method that allows you to specify one or more custom boundaries and configure a geospatial analysis. The request class includes a new CustomBoundaryAnalysisOptions sub-class to store the following custom boundary details.
Property | Type | Description |
---|---|---|
Options | CustomBoundaryAnalysisOptions < Options> | (Required) Contains a list of analysis options for configuring the geospatial analysis with one or more custom boundaries |
Property | Type | Description |
---|---|---|
Name | String | Name of the custom boundary |
SID | Integer | Unique SID of the custom boundary |
SpatialFileType | String | The geometry of the custom boundary dataset. Currently we support area polygon. |
The SubmitCustomBoundaryExposureConcentrationAnalysisResponse class returns the activity SID associated with the request.
Retrieve results of the Geospatial analysis
We implemented a new GetCustomBoundaryResults method to retrieve results of the custom boundary geospatial analysis. The GetCustomBoundaryResultsRequest class contains the following properties:
Property | Type | Description |
---|---|---|
AnalysisSID | Integer | (Required) The unique SID of the geospatial analysis for which you want to retrieve custom boundary results. |
PagingInfo | PagingInfo <PagingInfo> | (Optional) This object stores the page layout including the page number that you want to access and the number of records to display per page. |
SortingInfo | ResultsSortingInfo <SortingInfo> | (Optional) This object stores the desired sorting of the analysis results. |
Property | Type | Description |
---|---|---|
ID | Integer | The custom boundary ID. |
Name | String | Name of the custom boundary |
Add bounding box coordinates
You can define bounding box coordinates for a grid ring analysis. We implemented a new BoundingBox class to define the latitude and longitude coordinates in geospatial analyses.
Property | Type | Description |
---|---|---|
Point1Latitude | Decimal | (Optional) Represents latitude of the upper-left corner of the bounding box |
Point2Latitude | Decimal | (Optional) Represents latitude of the bottom-right corner of the bounding box |
Point1Longitude | Decimal |
(Optional) Represents longitude of the upper-left corner of the bounding box |
Point2Longitude | Decimal | (Optional) Represents longitude of the bottom-right corner of the bounding box |