...
Returns the value of the nearest point to a given location (or locations) in each field of a fieldset. The field must be a gridded field. If a list is given, it must contain two numbers - latitude and longitude. If two numbers are given, the first is the latitude, the second the longitude. For batch processing of multiple locations, two vectors can be given, the first is a vector of latitudes, the second the longitudes; this can be much more efficient than multiple calls with a single location each. If the fieldset has only one field, a number (or vector) is returned; otherwise a list of numbers (or a list of vectors) is returned. Where it is not possible to generate a sensible value due to lack of valid data in the fieldset, the a
When the nearest gridpoint value is a missing value or the location is out of the grid area nil is returned in the case of a single coordinate, or vector_missing_value in the case of a vector. Note that a similar function, interpolate(), also exists.
geopoints nearest_gridpoint ( fieldset,geopoints )
...