rev. 334
services/apiref
services/apisrv
services/caches
services/caches/formatters
services/caches/search
services/caches/shortcuts
services/logs
services/oauth
services/replicate
services/users

Search for nearest geocaches
:: services/caches/search/nearest method

Minimum Authentication: Level 1 (see Authentication Levels)
http://www.opencaching.us/okapi/services/caches/search/nearest

Find the nearest geocaches. Unless overriden, results are ordered by the distance from the given center point.

center required

The center point (typically - the user's location), in the "lat|lon" format.

Use positive numbers for latitudes in the northern hemisphere and longitudes in the eastern hemisphere (and negative for southern and western hemispheres accordingly). These are full degrees with a dot as a decimal point (ex. "54.3|22.3").

radius optional

Maximal distance (from the center point) for the cache to be included in the results. Unlike in most other places, this distance is given in kilometers instead of meters (it can contain a floating point though).

type optional Inherited from services/caches/search/all method.
status optional Inherited from services/caches/search/all method.
owner_uuid optional Inherited from services/caches/search/all method.
name optional Inherited from services/caches/search/all method.
terrain optional Inherited from services/caches/search/all method.
difficulty optional Inherited from services/caches/search/all method.
size optional Inherited from services/caches/search/all method.
rating optional Inherited from services/caches/search/all method.
min_rcmds optional Inherited from services/caches/search/all method.
min_founds optional Inherited from services/caches/search/all method.
max_founds optional Inherited from services/caches/search/all method.
modified_since optional Inherited from services/caches/search/all method.
found_status optional Inherited from services/caches/search/all method.
found_by optional Inherited from services/caches/search/all method.
not_found_by optional Inherited from services/caches/search/all method.
exclude_my_own optional Inherited from services/caches/search/all method.
limit optional Inherited from services/caches/search/all method.
offset optional Inherited from services/caches/search/all method.
order_by optional Inherited from services/caches/search/all method.
format optional Standard common formatting argument.
callback optional Standard common formatting argument.
Plus required consumer_key argument, assigned for your application.

Returned value:

Same format as in the search/all method. The more key will be skipped when no radius argument is given.