Being able to update "location" in the geocaching data

[jcea]

Hi, thanks for this project!

I see I can update "cache.location" in my code (it has a setter), but the changes are not uploaded to geocaching.com.

Would be nice to have that capability.

Thanks.

[FriedrichFroebel]

All attributes of the Cache class have a setter. Nevertheless, there is indeed no method to push cache details back, which is clearly visible from the features inside the README. Given that it requires interacting with further endpoints, I guess that this will take some more efforts. You might want to further analyze this and document the necessary details here before starting with an actual implementation.

[jcea]

I will bite the bullet.

When you update coordinates, the webpage first does a GET to https://www.geocaching.com/api/geocode?parse=<YOUR TEXT HTML-ESCAPED>. The reply contains the converted coordinates to DEG.DECIMAL and a bunch of other text values with the coordinates in quite a few different representations.

I guess you don't need this step if you already parse and sanitize the coordinates.

To actually change the coordinates, you do a POST to https://www.geocaching.com/seek/cache_details.aspx/SetUserCoordinate with a JSON with this format:

{"dto":{"data":{"lat":40.892783333333334,"lng":-3.4499833333333334},"ut":"<USER_TOKEN_FOR_THAT_CACHE>"}}

To reset the coordinates to the original value, you must do a POST to https://www.geocaching.com/seek/cache_details.aspx/ResetUserCoordinate with this JSON:

{
        "dto": {
                "ut": <"USER_TOKEN_FOR_THAT_CACHE>"
        }
}

I didn't check error codes, invalid entries, and so on, but I guess this information is enough for a first implementation.