Output

Closest Site returns information about each site within the search radius. Each site match is returned in a separate record along with the data listed in the following table. Sites are returned in the order from closest to farthest from the input location.

Table 1. Closest Site Output

Field Name

Format

Description / Valid Values

[DataSource].[Attribute]

String

Contains information about the site, where [DataSource] is the name of the database selected in the Database option and [Attribute] is the name of the site attribute. The specific information returned in the [DataSource].[Attribute] fields varies based on the database. For example, if you are matching against a database of hail events, these fields may contain things like the date of the hail storm, the diameter of the hail, and the number of injuries caused by the storm. For a complete listing of attribute fields, see the documentation included with the database.

[DataSource].SiteCount

String

The number of sites returned for the input location. If no sites were found this field will contain "0". If the number of sites in the search radius exceeds the value specified in the Maximum Results option, then this field will contain the actual number of sites returned, not the total number of sites in the search radius.

[DataSource] is the name of the database selected in the Database option.

[DataSource].SiteDirection

String

The direction, in compass degrees, to the site. For example, if the site is directly south of the input location, this field would be 180.

[DataSource] is the name of the database selected in the Database option.

[DataSource].SiteDistance

String

The distance from the input location to the site, in the units specified in the Distance Units option.

[DataSource] is the name of the database selected in the Database option.

[DataSource].SiteName

String [128]

The name of the site.

[DataSource] is the name of the database selected in the Database option.

[DataSource].SiteLatitude

String

The latitude coordinate of the site in decimal assumed format.

[DataSource] is the name of the database selected in the Database option.

[DataSource].SiteLongitude

String

The longitude coordinate of the site in decimal assumed format.

[DataSource] is the name of the database selected in the Database option.

Status

String [1]

Reports the success or failure of the match attempt.

null
Success
F
Failure

Status.Code

String [100]

Reason for failure, if there is one. One of the following:

NoMatchFound
Closest Site could not find any sites in the search area.
InsufficientInputData
There is not enough data in the input record to determine a location.
MalformedInputData
The input location is not in a recognized format.
InputOutOfRange
The latitude or longitude is outside of the acceptable range. Latitude coordinates must be between -90° and 90°. Longitude coordinates must be between -180° and 180°.

Status.Description

String [100]

Description of failure indicated in Status.Code.