Better Documentation of Dynamic Location Update URL

Question

The New Cache Notifiers page has documentation for setting up GPS Logger for Android, but it does not have a generic documentation of the parameters supported by the https://project-gc.com/api/UserLocation/Update/ API.

A documentation would be nice, especially for parameters that are non-obvious, e.g. like this:

---

# Help: Dynamic Notifiers

You can dynamically update some settings of a notifier by using the URL https://project-gc.com/api/UserLocation/Update/ with parameters. Supported parameters are:

• protocol=1 - the update protocol to use, this must always be 1
• uid=<USER-ID> - your user ID. Use the user id from your settings page.
• token=<TOKEN> - the access token to Project GC. Use the token from your settings page. Keep in mind that the token should be kept as safe as a password.
• nid=<NOTIFIER-ID> - the ID of the notifier. You can see a notifier's ID if you edit it
• ts=<timestamp> - the timestamp of your update, in ISO-format, e.g. 2025-01-31T14:35:59+0100. Updates that have a timestamp that is older than the most recent update are ignored (?)
• latitude=<latitude> - the latitude of the dynamic location, using decimal degrees, such as 12.34567
• longitude=<longitude> - the latitude of the dynamic location, using decimal degrees, such as 56.78901
• acc=<accuracy> - the accuracy of your latitude/longitude measurement in meters. (why would this be relevant?)
• enable=1 - if you add this parameter and the notifier is currently disabled, the update will enable it

To update a notifier, add the parameters to the URL after a question mark, separate them via & signs, for example like this: https://project-gc.com/api/UserLocation/Update/?protocol=1&uid=<USER-ID>&latitude=<latitude>&longitude=<longitude>&ts=<timestamp>&token=<TOKEN>&nid=<NOTIFIER-ID>

Comments

acc and ts isn't used with the current implementation. They are ignored server-side.

Answer 1

It would be fantastic if you could edit this information into Project-GC's Wiki for New Cache Notifiers, here: https://project-gc.com/w/NewCacheNotifiers.

We can then update the page itself to link to this page.

Comments

Documentation added to the Wiki (thank you for reminding me) and pending review. This is basically what I have written above, but with the information that ts and acc are currently ignored.