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.

Table 1. Updated AIR.Services.ExposureConcentrationAnalysis.API namespace
Property Type Description
CustomBoundaries List <CustomBoundary> Contains the list of custom boundaries associated with the business unit specified in your request
The CustomBoundary sub-class stores the custom boundary dataset information for a given business unit.
Table 2. Updated AIR.Services.ExposureConcentrationAnalysis.API namespace
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.

  • This API currently supports spatial type = AREA (which is a polygon shapefile)

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.

Table 3. Updated AIR.Services.ExposureConcentrationAnalysis.API namespace
Property Type Description
SIDs list <IDs>
  • Integer
(Required) Contains the list of valid custom boundary SIDs
  • You must specify unique custom boundary SIDs in the request

    Note: A request with duplicate custom boundary SIDs fails

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:

Table 4. Updated AIR.Services.ExposureConcentrationAnalysis.Data namespace
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.

Table 5. Updated AIR.Services.ExposureConcentrationAnalysis.API namespace
Property Type Description
Options CustomBoundaryAnalysisOptions < Options> (Required) Contains a list of analysis options for configuring the geospatial analysis with one or more custom boundaries
Table 6. Updated AIR.Services.ExposureConcentrationAnalysis.Data namespace
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:

Table 7. Updated AIR.Services.ExposureConcentrationAnalysis.API namespace
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.
The GetCustomBoundaryResultsResponse class returns the results of the geospatial analysis for a specific custom boundary and the page layout of the results record.
Table 8. Updated AIR.Services.ExposureConcentrationAnalysis.Data namespace
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.

Table 9. Updated AIR.Services.ExposureConcentrationAnalysis.Data namespace
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