Hailpoint
by miked

Hailpoint

HailPoint API Documentation
RESTful API for HailCloud™

Welcome to the HailPoint HailCloud API Documentation.

The HailPoint API allows you to access the real-time HailCloud hail database.

Queries presently are completed through requesting hail history (now to 2012) through any point location in the U.S. or Southern Canada by either latitude/longitude or by street address.

The API will allow you to quickly script or program powerful queries against our every growing libray of HailPoint’s exanding line of hail impact products.

hail
GET /hail

For retrivial of the continuously updated hail history information at a specific location. The reporated maximum hail size, each day is returned from the HailCloud™ database.

Request parameters

lat
number optional

latitude in degrees north

Collection format: multi
Min: 20
Max: 55
Examples:
25.2135.01
lon
number optional

longitude in degrees north

Min: -55
Max: -129.5
Examples:
-80.1054-110.43542
city
string optional

City of address locaton

Examples:
BostonSt Louis
state
string optional

2 character Postale code of State of the street Address. (CN for Canada)

Examples:
NYTXCN (Canada)
street
string optional

Street address

Examples:
6012 North Poplar St1200 Eastway Drive
date1
string optional

Ending search date in HailPoint™ database.
Supported valid date formats are specified in:
http://search.cpan.org/~sbeck/Date-Manip-6.54/lib/Date/Manip/Date.pod#VALID_DATE_FORMATS

radius
number optional

Hail that has fallen and dates with x miles of location.

Min: 0.1
Max: 200
Example:
10
token
string required
Example:
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJodHRwczovL2V4YW1wbGUuYXV0aDAuY29tLyIsImF1ZCI6Imh0dHBzOi8vYXBpLmV4YW1wbGUuY29tL2NhbGFu34dPyL3YxLyIsInN1YiI6InVzcl8xMjMiLCJpYXQiOjE0NTg3ODU3OTYsImV4cCI6MTQ1ODg3MjE5Nn0.CA7eaHjIHz5NxeIJoFK9kr

Responses

200 Ok

response message

Headers
data address
string optional

Complete street address of the location requested of center of hail location. Reponse in all capital letters

Example:
6012 N 102ND ST, OMAHA, NE, 68134
city
string optional

City of the address street address of the location requested of center of hail location. Lower case response

date1
string optional

beginning of the search range

Example:
2016-06-17
date2
string optional

ending of the search range

Example:
2016-08-17
lat
number optional

Latitude of the location requested.

Example:
41.312965
lon
string optional

Longitude of the location requested

Example:
-96.07281
radius
number optional

Radius from the center of location the hail search was conducted. In statute miles.

Example:
0.1
state
string optional

Postal abbreviation for the state. Two characters. Canada is reported as “cn”

Examples:
neny
street
string optional

Street address of the location requested. A “+” sign is used as a space delimter"

Example:
6012+N+102nd+St
dates
string optional

Dates that hail occured 0.5" or greater. The format is DYYYY-MM-DD=“X.XX” where: D is the character “D” YYYY is the year MM is the month DD is the day X.XX is the maximum hail size in inches.

Min length: 20,120,601
Example:
D2016-07-17="0.75"
404 Not Found

Parameter Not Found

503 Service Unavailable

Problem with HailPoint’s Web Service

Examples

Hail Impact lookup by Address from the HailCloud™ Database

GET https://api.hailpoint.com/hail?state=nc&city=charlotte&street=1200 King St&date1=2014-03-01?token=xxxx HTTP/1.1

Hail Impact lookup by LAT/LON from the HailCloud™ Database

GET https://api.hailpoint.com/hail?lat=35.0154&lon=95.1302?token=xxxx HTTP/1.1