Skip to content

Commit

Permalink
Update for v2
Browse files Browse the repository at this point in the history
  • Loading branch information
NKAmapper authored Mar 28, 2023
1 parent 7e39ba9 commit f98b6fd
Showing 1 changed file with 8 additions and 7 deletions.
15 changes: 8 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,14 +4,13 @@ Compares addresses in OSM with latest address file from Kartverket for a given m

### Usage

1. Run `addr2osm <municipality/county id> [-manual|-upload]`
1. Run `addr2osm <municipality/county id> [-upload]`
* Parameter:
- 4 digit Norwegian municipality code, or
- 2 digit county code for all municipalities within a county, or
- "00" for all municipalities in Norway
* Will produce OSM file with the name *Address import "code" "municipality".osm*
* Optional parameters:
- `-manual` for including copy of "surplus" address nodes, ways and relations not touched by the program + for including *DELETE* tag instead of deleting node for easier verification
* Will produce OSM file with the name *address import "code" "municipality".osm*, ncluding copy of "surplus" address nodes + for including *DELETE* tag for easier verification
* Optional parameter:
- `-upload` for uploading directly to OSM - will ask for OSM user name and password


Expand All @@ -31,14 +30,16 @@ Compares addresses in OSM with latest address file from Kartverket for a given m

### Notes

* Address nodes will be created if they do not currently exist in OSM, even if the address already is contained in e.g. a building or an amenity node.
* Address nodes will be created if they do not currently exist in OSM.
* Address nodes will be relocated according to the lates Kartverket coordinates, if necessary. The implication is that there is no need to move address nodes manually (they will be relocated during the next import update anyway).
* Remaining/not matched "pure" address nodes (without any other tags) will be reused (nearby location) or deleted.
* The *addr:country* tag will be disregarded and removed.
* Duplicated address tags on buildings and other objects will be removed unless the object is also tagged with a *note=** containing "*addr*".
* Street names will be adjusted to get punctuation and spacing right. Errors in street names are also adjusted according to translation table in [addr2osm/corrections.json](https://github.com/NKAmapper/addr2osm/blob/master/corrections.json).
* Code is optimized to near linear complexity with performance at 500-1500 addresses/second in testing (slower with "-manual").
* Uploads to OSM are done as one changeset per municipality. In case of errors the whole changeset will fail. If a municipality has more than 10.000 elements with changes it will have to be uploaded manually in JOSM.
* Code is optimized to near linear complexity with performance at 500-1500 addresses/second in testing.
* Uploads to OSM are done as one changeset per county (alternatively per municipality). In case of errors the whole changeset will fail. If a county or municipality has more than 10.000 elements with changes it will have to be uploaded manually in JOSM.
* A separate file with all new and deleted addresses is saved. Useful for discovering buildings and higheways to be created or deleted.
* A separate file with used address corrections is saved. Useful for updating the correction json file in Github every other year.

### Data sources used

Expand Down

0 comments on commit f98b6fd

Please sign in to comment.