Moody’s strongly recommends that Risk Modeler and UnderwriteIQ tenants use the Platform APIs instead of the Risk Modeler APIs for all future projects. See Migrate to Plaform APIs.

Geocode address

Geocodes locations that match the specified parameters.

Geocoding enriches a location exposure with geolocation data that precisely identifies the global coordinates of a site.

A location may be geocoded at different resolution levels. The lower the resolution level, the more accurate the the location coordinates returned by the geocoding service.

🍊

Licensing

The Risk Modeler API supports the definition, importation, and geocoding of locations in over 230 countries. Locations may be geocoded in countries that have RMS catastrophe models and countries that have no models. Your ability to geocode locations in specific countries depend on your company’s licensing agreements with RMS.

Accuracy and confidence in modeled results are driven by the quality of geolocation reference data provided to the gelocation engine. As geocoding resolution increases, the number of assumptions made during the modeling process decreases and the more accurate the global coordinates returned during gelocation.

The table lists layer attributes by resolution level. Lower resolutions are presented at the top of the table:

Resolution CodeGeographic identifiers
14countryScheme, countryGeoId, countryRmsCode, country
11zone1Name zone1GeoId
11zone3Name zone3GeoId
11zone4Name zone4GeoId
10admin1Code, admin1Name, admin1GeoId
9admin2Code, admin2Name, admin2GeoId
8admin3Code, admin3Name, admin3GeoId
7cityCode, cityName, cityGeoId
6admin4Code, admin4Name, admin4GeoId
5postalCodeGeoId, postalCode
5locationCode, locationCodeGeoId
Body Params
int32

ID for address.

area
object
string

ID for building.

string

Name of building.

addressType
object
country
object
string

Standard for user-supplied country code, e.g. ISO2A

int32
string

Internal RMS code for country.

double

Latitude coordinates.

double

Longitude coordinates.

string

Supplemental text captured for address.

string

Address containing number, street name, street type, etc.

string

Code for city/town.

string

Name of city/town.

int64

Globally unique ID of city/town.

string

Postal code.

int64

Globally unique ID for postal code.

string

ID of block.

string

ID of block group.

string

Census track number / Sonpro / Sector / Short post code.

int64
string

ID of parcel.

string

Name of sub-locality (neighborhood).

double

Geocode confidence percentage.

double

Geocode accuracy buffer.

string
string

Accuracy of assigned geocode for US high resolution geocoding.

string

Code for portions of the input address that matched, did not match, or were modified during the geocoding process.

int32

Geocode data source ID.

geoResolutionCode
object
int32
string
string

Timestamp in ISO 8601 format, i.e. YYYY-MM-DDThh:mm:ss.sss

string

Date and time address record was updated.

string

Code for administrative level 1. Admin1 represents large geographic divisions, such as states or provinces.

int64

Globally unique RMS ID for administrative level 1.

string

Name of administrative level 1.

string

Code for administrative level 2. Admin2 represents smaller geographic divisions, such as counties.

int64

Globally unique RMS ID for administrative level 2.

string

Name of administrative level 2.

string

Code for administrative level 3. Admin3 represents smaller geographic divisions, such as districts.

int64

Globally unique RMS ID for administrative level 3.

string

Name of administrative level 3.

string

Code for administrative level 4.

int64

Globally unique RMS ID for administrative level 4.

string

Name of administrative level 4.

string

Code for administrative level 5.

int64

Globally unique RMS ID for administrative level 5.

string

Name of administrative level 5.

int64

Zone level 1 GeoID.

int64

Zone level 2 GeoID.

int64

Zone level 3 GeoID.

int64

Zone level 4 GeoID.

int64

Zone level 5 GeoID.

string

CRESTA zone ID

string

For finer zone definitions.

string

For further finer zone definitions.

string
string
string
string
string
string
string

Unique global identifier.

Responses

Language
Credentials
URL
LoadingLoading…
Response
Choose an example:
application/json