POST Request Parameters
Parameter | Description | Usage |
---|---|---|
locations object contains the following elements: | ||
objectId | Uniquely identifies location coordinates. If provided, the associated objectId with location coordinates is returned in the response for reference. It should be a valid positive integer. If not provided, then the objectId is generated starting '1' and auto incremented. | Optional |
locations.geometry object contains the following elements: | ||
type | Point | Optional |
coordinates | Specifies the x, y input coordinates, where x=longitude and y=latitude. For example: [ -105.25175, 40.024494 ] | Required |
preferences object contains the following elements: | ||
maxCandidates | Specifies the maximum number of water bodies that this service retrieves. The default value is 1. The retrieved water bodies are distance ordered from the specified location. Maximum of 3 water bodies can be retrieved. | Optional |
waterBodyType | Specifies the type of water bodies to be returned. The type of
water bodies include:
Default: 'all' The input values can be case-insensitive. |
Optional |
searchDistance | Specifies the distance within which this method searches for
water bodies. If not provided, the nearest water body is searched.
The allowed minimum value is greater than or equal to 0 and maximum
range in all allowed units is mentioned below: Default: 20 Miles In Miles: upto 100 Miles In Feet: upto 528,000 Feet In Kilometers: upto 160.934 Kilometers In Meters: upto 160934 Meters In case no value is provided, the default searchDistance of 20 miles is applicable. |
Optional |
searchDistanceUnit | The acceptable unit values are: Feet, Kilometers, Miles and
Meters. The searchDistanceUnit is optional, if not provided, the unit ‘Miles’ is taken by default, otherwise the search is performed based upon the searchDistance calculated in the specified unit. The search results are returned accordingly in the specified unit. For example, 'Kilometers' searchDistanceUnit returns results in 'Kilometers'. The input values can be case-insensitive. |
Optional |