31 lines
1.2 KiB
Markdown
31 lines
1.2 KiB
Markdown
|
# gc_area
|
||
|
|
|
||
|
|
Python3 scripts to filter geocaches bounded to a certain area.
|
||
|
|
The area is an OpenStreetMap "relation" consisting of ways that make up the area.
|
||
|
|
This OSM relation is then converted to a polygon.
|
||
|
|
The polygon is then used to determine whether a geocache lies within the area or not.
|
||
|
|
|
||
|
|
## Usage
|
||
|
|
|
||
|
|
### Prerequisites
|
||
|
|
|
||
|
|
1. Determine the OpenStreetMap relation ID. To do this, go to [openstreetmap.org](https://www.openstreetmap.org) and search for your area.
|
||
|
|
2. Create a GPX file containing at least all geocaches in the area. You can do this by simply going to the Geocaching website, creating a filter and add filtered geocaches to a list. Then go to your lists page and download the GPX file for this list.
|
||
|
|
3. Install the required Python3 packages:
|
||
|
|
```cli
|
||
|
|
pip install -r requirements.txt
|
||
|
|
```
|
||
|
|
|
||
|
|
### Using the Scripts
|
||
|
|
|
||
|
|
1. Create the polygon describing your area (replace `<osm-relation-id>` with your ID):
|
||
|
|
```cli
|
||
|
|
$ python3 create_polygon.py <osm-relation-id>
|
||
|
|
```
|
||
|
|
For more options, see `python3 create_polygon.py --help`.
|
||
|
|
|
||
|
|
2. Filter out any geocaches outside this area (replace <input-file> with your GPX file and <output-file> with desired result GPX file):
|
||
|
|
```cli
|
||
|
|
$ python3 gc_area.py <input-file> <output-file>
|
||
|
|
```
|
||
|
|
For more options, see `python3 gc_area.py --help`.
|