-
Notifications
You must be signed in to change notification settings - Fork 79
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
fix: Update for current reality, andd a few more programs
- Loading branch information
Showing
1 changed file
with
23 additions
and
29 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -93,31 +93,9 @@ course for this to work. That file looks like this: | |
[email protected] | ||
passwd=arfood | ||
|
||
### Environment Variables | ||
|
||
**LOG_LEVEL** | ||
|
||
> If present, will change the log level. Defaults to DEBUG. | ||
**ODK_CENTRAL_URL** | ||
|
||
> The URL for an ODKCentral server to connect to. | ||
**ODK_CENTRAL_USER** | ||
|
||
> The user for ODKCentral. | ||
**ODK_CENTRAL_PASSWD** | ||
|
||
> The password for ODKCentral. | ||
**ODK_CENTRAL_SECURE** | ||
|
||
> If set to False, will allow insecure connections to the ODKCentral API. Else defaults to True. | ||
## Utility Programs | ||
|
||
These programs are more fully documented [in the docs](https://hotosm.github.io/osm-fieldwork/about/odk2geojson/). | ||
These programs are more fully documented [in the docs](https://hotosm.github.io/osm-fieldwork/about/programs/). | ||
This is just a short overview. | ||
|
||
- ### CSVDump.py | ||
|
@@ -152,16 +130,25 @@ This is just a short overview. | |
|
||
This program makes data extracts from | ||
[OpenStreetMap](https://www.openstreetmap.org) data. Multiple input | ||
sources are supported, a local postgresql database, the HOT maintained | ||
[Underpass](https://galaxy.hotosm.org/) database, or | ||
[Overpass](https://overpass-turbo.eu). | ||
sources are supported, a local postgresql database, or the HOT | ||
maintained [Underpass](https://galaxy.hotosm.org/) database. | ||
|
||
- ### json2osm | ||
|
||
|
||
- ### odk2csv.py | ||
- ### odk2csv.py, odk2geojson.py, odk2osm.py | ||
|
||
This program is used when working offline for extended periods. This | ||
These programs ER used when working offline for extended periods. This | ||
converts the ODK XML format on your mobile device into the same CSV | ||
format used for submissions downloaded from [ODK | ||
Central](https://docs.getodk.org/central-intro/) | ||
Central](https://docs.getodk.org/central-intro/), or the JSON format | ||
also from Central. | ||
|
||
- ### odk_merge.py | ||
|
||
This program conflates the data collected by ODK Collect with the | ||
existing OSM data. The output of this file can be loaded into JOSM | ||
for validation and uploading to OpenStreetMap. | ||
|
||
- ### odk_client.py | ||
|
||
|
@@ -183,6 +170,13 @@ This is just a short overview. | |
community. It also filters data extracts so they work with ODK | ||
Collect. | ||
|
||
- ### osm2favorites.py | ||
|
||
This is a silly program, but it takes a GeoJson file, usually an OSM | ||
data extract and generates a GPX file with styling for OsmAnd. This | ||
is useful when ground-truthing map data, as it can be used for | ||
navigating to those areas. | ||
|
||
## Best Practices and troubleshooting | ||
|
||
To ensure the quality of your converted data, here are some best | ||
|