|GSAK (Geocaching Swiss Army Knife)|
Use this option to get cache data directly from the Groundspeak web site.
Note: For premium members the limits are currently 6,000 full caches per day (+10,000 "lite" caches). For non premium members the limits are 3 full caches per day (+10,0000 "lite" caches) In addition, the api only gets the number of logs requested and unlike a PQ you are not guaranteed to get your log unless it is in the number of logs retrieved. Use the Balances button to view your current balances of these totals.
Circle - Enter the coordinates from where the search for selected Geocaches will begin. You can enter the coordinates directly or select any location from the drop down list. Include a distance so that only caches within this distance will be selected. Note: The Groundspeak api currently only scans up to 50kms from this point. Click on the "Google map" button to generate the circle using the google maps interface.
Rectangle - The rectangle box is a set of coordinates (top left and bottom right) which define a rectangle. Only caches within this rectangle will be selected. The maximum allowed distance between the two points is 100kms. Click on the "Google map" button to generate the rectangle using the google maps interface.
GCXXXX code - A csv list (just separate each with a comma) of Geocaching.com codes.
Country/State - Select this option to get geocaches in any supported country or state (see page 2) without regard to circle or rectangle coordinates. This option allows you to get bulk caches in very large areas in one single go.
Max geocaches to get - Enter the maximum number of geocaches you want to fetch.
Logs per cache - Enter the maximum number of logs you want each cache to include. This number may not exceed 30. Also, this option will be disabled if you have selected the "Light" format (see advanced tab)
Include - You can elected to include any of (Found by me, Archived, or Disabled). Any item that is not selected will have caches that meet that criteria, excluded from the "Get"
Container size - Choose which container sizes should be included
Cache types - Choose the required cache types
Difficulty between - Choose the range of difficulty to be included. Ranges from and to are inclusive.
Terrain between - Choose the range of terrain to be included. Ranges from and to are inclusive.
Owned by - You can enter up to 5 cacher names here. Separate each name by a , (comma). If a cacher name includes a comma, then enclose the full name with " (double quotes). In other words, the list of names is a standard CSV format string. Only caches that are owned by the cacher names entered will be selected.
Exclude owned by - You can enter up to 5 cacher names in the same format as "Owned by" above. Only caches that are *not* owned by these users will be selected.
Not found by - You can enter up to 5 cacher names in the same format as "Owned by" above. Only caches that have *not* been found by these cachers will be selected. For example, you could use this option when going "group" caching - you want to hunt caches that no one in a group has found.
Load settings - You can select a load setting (see "File=>Load gpx/loc file) that will be applied to the import of this data. Basically, when the api is used to fetch the data, a GPX file is generated and then loaded into GSAK. You can control how this file is loaded by associating a "load" setting with this fetch. If not sure then just use the default of "*Use GSAK defaults*" which will load the GPX file using the default GSAK settings (the same settings as if you checked the box "Use defaults" on the load dialog) . Click on the "Settings dialog" button to view or change any saved setting.
Data format - Full : Select this option to fetch the full cache information (for those familiar with Groundspeak data formats this is synonymous with the GPX file format). As this option fetches all the information for a cache it can take a significant amount of time to process. Light: Select this option to fetch just the summary details of the cache (for those familiar with Groundspeak data formats this is loosely synonymous with the LOC file format). This option is much quicker that the full cache format, but the data returned is limited to:
1. Cache Code
2. Cache Name
3. Status (archived, disabled, available)
6. Cache type
7. Container size
10. Favorite points
12. Cache ID #
13. Owner name
14. Owner ID #
15. Placed by
16. Placed date
17. Url link
Favorite points between - Choose caches that have the required range of favorite points. Ranges from and to are inclusive.
Publish date - Choose caches within certain publish dates.
Country/State - Here you can make Country/State selections. If your selection on page1 is set to "Country/State" then caches will be selected without regard to any circle or rectangle coordinates. For more information see this link
Settings - This is the standard GSAK settings box that allows you to save and restore your selections.
This button will display the available balances for "Full" and "Light" caches. These balances will reset every 24 hours.
This button will display the total number of caches that will be fetched using the current selected criteria. This can be used to determine how many caches match your selection criteria *before* you actually fetch them.
Copyright 2004-2015 CWE Computer Services |