Geocoding Layers
Understand data layers used in geocoding operations.
Overview
Geocoding is the process of enriching a location exposure with geolocation data that precisely identifies the global coordinates of a site.
Geocoding is a prerequisite for all catastrophe modelling processes. A location must be enriched with precise geolocation data before it can be modelled. The global coordinates define a spatial reference system that can be recognized by a model.
Data layer versions
A geocode data layer is a geographic database that contains location data: street addresses, counties, postal codes, and global coordinates. During geocoding, a geocoding engine uses the available location data to "look up" information about a location exposure in the geocode layer. The geocoding engine assigns a latitude-longitude coordinate pair to the location, validates or standardizes address elements (e.g. postal codes, cities), and appends or "backfills" missing location information.
The Geohaz API and Bulk Geohaz API expose operations that enable client applications to geocode locations. These operations require that the request specifies the data layer name, model type, and model version.
The table identifies geocoding layers supported by the Geohaz API and Bulk Geohaz API:
Data Layer | version | engineType | Bulk Geohaz engineType |
---|---|---|---|
geocode | 18.0 | RL | 0 |
geocode | 18.1 | HD | 1 |
geocode | 18.1 | RL | 0 |
geocode | 21.0 | HD | 1 |
geocode | 21.0 | RL | 0 |
geocode | 22.0 | HD | 1 |
geocode | 22.0 | RL | 0 |
geocode | 23.0 | RL or HD | 0 or 1 |
geocode | 24.0 | RL or HD | 0 or 1 |
geocode | 25.0 | RL or HD | 0 or 1 |
Every request to geocode an exposure must specify three parameters: the data layer (geocode
), the version, the engine type, which corresponds to the engine used to model the account, or portfolio exposure.
Note
Valid values for the
engineType
parameter differ between the Create Geohaz Job and Create Bulk Geohaz Job operations.
- The
RL
(or0
) engine type supports geocoding of exposures modeled using detailed loss models (DLM).- The
HD
(or1
) engine type supports geocoding of exposures modeled using High Definition models (HD).
Updated 9 days ago