Welcome to the Import Guide. This page and its direct links are the main point to actively participate in this addresses import. In case of doubts you can ask for help through the talk-br list or Telegram Ceará.
Preliminary steps
These are the steps to take before you start.
- If you don't already have a user on this wiki, create an account on this wiki. Add this page to your watchlist (the star that appears in the top menu when you are already logged in). In that way you will receive notifications every time the guide is updated.
- The tasks are of an intermediate/advanced level. For more help with OSM, simply consult the instructional guide.
- Create a dedicated user account to work exclusively on imports, separate from your normal account. In the description for the account profile write that it is used for the Addresses Import described in https://wiki.openstreetmap.org/wiki/Rio_Branco,_Acre/Addresses_Import, source: Prefeitura Municipal de Rio Branco (Rio Branco City Council).
- Install JOSM, the recommended editor for this import, if you have not already done so.
- Set up your dedicated account in Authentication Settings: Preferences (F12) > Connection settings > Authentication
- Install these plugins: Preferences (F12) > Plugins.
Importing data into JOSM
- Open JOSM and import the SHP with the addresses.
- Once the file has been imported, use JOSM validator to check for any error. Accept automatic correction suggestions.
- Convert the tags to OSM standard as SHP files change this. Put them as addr:housenumber=* and so on.
- Eliminate nodes that have no address. To do this, in the JOSM search, enter the following expression:
- -"addr:housenumber"=*
- Later, select all fetched nodes and delete them.
- Use the validator again and see if there are still errors. If there are, such as duplicate house numbers, check case by case and perform the necessary fixes.
- See if all nodes are correct or if there are any mismatched nodes on the map.
- We suggest checking block by block, so it is easier to see any wrong or misplaced data.
- You can also better organize the nodes by aligning them (select the desired nodes and press the L key).
With that, we finally have all the data ready to import! The import should not be done yet, as we need to check the data that already exists in the OSM and carry out the conflation.
Data conflation
Having finally got the data clean and ready, we need to check if any of these addresses are already in OpenStreetMap, so that there is no duplicate information, or to check if there is better quality information already mapped. For this, we will use Overpass Turbo and the Conflation plugin.
- Initially we look for addresses already mapped. For this, we use the Overpass turbo, with the following code:
[out:xml][timeout:25];
{{geocodeArea:Neighborhood, Rio Branco}}->.searchArea; //search here the desired neighborhood
(
node["addr:housenumber"](area.searchArea);
way["addr:housenumber"](area.searchArea);
relation["addr:housenumber"](area.searchArea);
);
// print results
out meta;
>;
out meta qt;
- Then export the data to JOSM by clicking the top menu - Export - load data into an OSM editor - JOSM.
- If there is little data, adjust each one manually. Check address by address, and update in OSM if data is better. After verifying, delete these addresses from the JOSM address file so that there is no duplication when importing.
- If there is a lot of data, with JOSM open, use the Conflation plugin. Follow instructions on the plugin page itself.
- With this plugin, check all pointed data one by one.
- Finally, clean up the duplicate data, if any.
Data upload
Having the data ready for upload, some points should be noted. Initially, observing the import guidelines, a specific user must be used for the import. If this is not observed, the data can be reversed and the account can be blocked by the DWG.
In addition, add a description about the upload, adding the hashtag #ImportPMRBaddresses and as the data source the Prefeitura Municipal de Rio Branco (Rio Branco City Council). If you have used a satellite image, add it also in the source, separating it with a semicolon, such as "Prefeitura Municipal de Rio Branco;Bing".
Finally, do not send a massive send of data at once, so as not to overload the server.
In summary, these steps must be done (in more detail again in the import guidelines):
- Check again that you are authenticated with your specific import account and not your usual OSM account.
- Make a brief description of the edition, adding the project-specific hashtag. For example: Addresses import #ImportPMRBaddresses
- Add the data source, which in this case is the Prefeitura Municipal de Rio Branco (Rio Branco City Council). In case of satellite image, also add, for example, "Prefeitura Municipal de Rio Branco;Bing".
Changeset tags
source = Prefeitura Municipal de Rio Branco
comment = Rio Branco addresses import
hashtags = #ImportPMRBaddresses
website = https://wiki.openstreetmap.org/wiki/Rio_Branco,_Acre/Addresses_Import
import = yes
Thank you very much for your contribution!
|