rev. 334
Introduction
Sign up
Examples
services/apiref
issue
method
method_index
services/apisrv
installation
installations
stats
services/caches
geocache
geocaches
services/caches/formatters
garmin
gpx
services/caches/search
all
bbox
nearest
services/caches/shortcuts
search_and_retrieve
services/logs
entries
entry
logs
submit
userlogs
services/oauth
access_token
authorize
request_token
services/replicate
changelog
fulldump
info
services/users
by_internal_id
by_internal_ids
by_username
by_usernames
user
users

Search for caches within specified bounding box
:: services/caches/search/bbox method

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

This method is similar to the search/all method, but the results are restricted to the caches situated within a given bounding box (a rectangle on the map).

Unless overriden, results are ordered by the distance from the center of the bounding box. This means, that if you hit the limit of geocaches returned, you will receive the ones that are in the middle of your box, and miss the ones on the edges.
bbox required

The bounding box within to search for caches. The box is defined by a string in "S|W|N|E" format, where:

  • S stands for southern edge latitude of the box,
  • W stands for western edge longitude of the box,
  • N stands for northern edge latitude of the box,
  • E stands for eastern edge longitude of the box.

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. "48.7|15.8|54|24.9").
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.