Archive for the ‘gpx’ Tag

BCaching API

This topic is no longer up to date. The latest API documentation can be found here on the forums.

The bcaching API is intended for use by mobile geocaching apps to retrieve geocache data and have access to a large repository of geocache data without needing to store it all on the device itself. Response data for all requests except for “login” is in the standard GPX format. All query results are restricted to those that are accessible by the authenticated user.

Request format is
http://(www|test).bcaching.com/api/q.ashx?u=<username>&REQUEST&time=<current-time>&sig=<signature>
where:

  • username is a valid bcaching.com username
  • current-time is the current mobile device time in “java” milliseconds (i.e. java.util.Date.getTime) or equivalent
  • signature is an md5 hash of the querystring plus an md5 hash of the bcaching user’s password.

{{REQUEST}} can be one of the following:

  • Verify login only: a=login
    Does nothing more than return success or failure based on the validation of the username password/hashword.
  • Find nearest caches (Summary): a=find&lat=<latitude>&lon=<longitude>&find=<find>&maxdistance=<max-distance>&maxcount=<max-count>
    Returns summary-only gpx data — with no short or long descriptions, extra waypoints, logs, etc.

     

    • latitude is the latitude in signed degree decimal form i.e. 40.123456
    • longitude is the longitude in signed degree decimal form i.e. -74.987654
    • find is a URL-encoded string to search for caches by waypoint# (with or without the GC prefix) or partial name match.
    • max-distance is optional and specifies the maximum distance in degrees. Default is 0.3 – about 30 miles
    • max-count is optional and specifies the maximum number of nearest caches to return in the gpx data. Default is 50.
  • Get cache detail: a=detail&ids=<cache-id-list>&desc=<description-mode>&wpts=<wpts>&logs=<logs>&tbs=<tbs>
    Returns detailed gpx data for one or more caches

     

    • cache-id-list is a comma-separated list of cache ids (not waypoint numbers). Cache ids are included in the summary gpx request.
    • description-mode indicates what form to send the description and can be one of the following:
      • none: neither short nor long description is included
      • short: short description is included, converted to text if was html
      • long: short and long description are included, converted to text they were html
      • html: full original short and long descriptions are included
    • wpts is a flag indicating whether or not additional waypoints should be included: 0 = no waypoints (default), 1 = include waypoints
    • logs is the maximum number of logs to include: 0 = none (default), 1 or more indicates the maximum number
    • tbs is a flag indicating whether or not cache inventory should be included: 0 = no waypoints (default), 1 = include TBs
  • Get nearest caches (Detail): a=nearest&maxcount=<max-count>&desc=<description-mode>&wpts=<wpts>&logs=<logs>&tbs=<tbs>
    • max-count is optional and specifies the maximum number of nearest caches to return in the gpx data. Default is 30.
    • all other parameters (desc, wpts, logs, tbs) are identical to Get cache detail section.
Advertisements

BCaching Release 0.5

Release 0.5 includes a few new Desktop Map features (no mobile enhancements with this release)

  • Desktop Map now includes a Filter panel that allows filtering of geocache types, containers, terrain, difficulty and more.
  • You can now download a summary GPX file (up to 999 waypoints) based on the current filter. The GPX file may be used in Google Earth or to send to your GPS device. The summary includes additional waypoints, but it does not include descriptions or logs. Enter the maximum number of waypoints (default is 500) and click the [Download GPX] button at the bottom of the Desktop Map page.
  • You can also send cache data directly to your Garmin device using the Garmin Communicator web plug-in. It also uses the current filter and sends the same information that would be sent in the GPX file. To begin, click the [Send to Garmin Device] button at the bottom of the Desktop Map page.

If you encounter any issues, please post them on the forum.

– Update 7.28.2009

This wasn’t quite ready last week, but now you can also send waypoints to your Garmin using Custom Waypoint Symbols that represent cache type: traditional, multi, letterbox, mystery, etc. See the follow-up post for details.