Skip to content
Provides bulk nominatim geocoding for QGIS
Branch: master
Clone or download
Latest commit 9330f0a Jun 22, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
doc
images
LICENSE
Makefile
__init__.py Initial commit of code Jan 26, 2017
bulkDialog.py updated for QGIS 3 Jun 22, 2018
bulkNominatim.py updated for QGIS 3 Jun 22, 2018
bulkNominatim.ui
helphead.html
metadata.txt updated for QGIS 3 Jun 22, 2018
readme.md updated documentation Jun 20, 2018
reverse.xcf Initial commit of code Jan 26, 2017
reverseGeocode.py
reverseGeocode.ui Added reverse geocode highlighting Jan 31, 2017
settings.py updated for QGIS 3 Jun 22, 2018
settings.ui Added reverse geocode highlighting Jan 31, 2017

readme.md

Bulk Nominatim Plugin

The Bulk Nominatim QGIS Plugin interfaces with an OpenStreetMap nominatim service to provide geocoding of addresses and reverse geocoding of coordinates. This plugin is only recommended to be used with personal nominatim servers because OpenStreetMap does not permit bulk nominatim requests.

Installation

The plugin can be installed by downloading bulknominatim.zip, unzipping it and then moving the bulknominatim folder to C:\Users\<Your User Name>\.qgis2\python\plugins. Now launch QGIS and select Plugins->Manage and Install Plugins... from the menu. Click on the Installed tab on the left and make sure the check box next to Bulk Nominatim GeoCoding is checked. Click the Close button and you are ready to start address geocoding.

Installing Plugin

Bulk Nominatim Tools

The plugin Settings need to be configured to point to a nominatim endpoint. See the Settings section on how to do this. The plugin can be accessed from the Plugins->Nominatim GeoCoding menu or from the two tool bar icons.

Nominatim GeoCoding

The menu items are:

  • Bulk GeoCoding Bulk GeoCoding - Main tool for bulk geocoding of addresses to coordinates and bulk reverse geocoding of coordinates to addresses.
  • Reverse Point GeoCoding Reverse Point GeoCoding - This tool allows the user to click on the map to determine the closest address or feature.
  • Settings Settings - Configuration for the Nominatim Service URL as well as other settings.
  • Help Help - Displays help information for the tools.

Both Bulk GeoCoding and Reverse Point GeoCoding are installed on the tool bar for quick access.

Toolbar

Bulk GeoCoding

Selecting this tool provides 3 different methods of geocoding. All three return a new vector layer.

Bulk Geocoding
  • Geocode Table - Input is either a QGIS table or vector layer containing address information. Input Address Layer contains a list of tables and vector layer. Select one that contains the address information needed. The plugin will attempt to find matches for the individual address fields Street Number, Street Name, City, County, State, Country, and Postal Code. The address fields can also be manually selected. If one of the fields contains the entire address select it from Full Address Field. This overrides all the other field selections.
  • Geocode Addresses - This is a text area where you can paste in addresses - one per line. The addresses are address strings and not individual fields.
  • Reverse Geocode - Input is a points layer and it attempts to find the closest address for each point. For remote locations the closest feature may be an administrative boundary.

Across the top are three tabs representing these three geocoding tools. The lower part of the dialog box has common functionality for the three tools and are:

  • Output Layer Name - This is the name of the vector layer that will be created in QGIS. Note that this is a memory vector layer and not a file layer. If you want to retain the results you will need to save the layer.
  • Maximum Results per Entry - For each address multiple results can be returned. (Not applicable for Reverse Geocode.)
  • Label Geocoded Points - Automatically show the labels in QGIS for the geocoded point.
  • Included Detailed Address Results - Returns an enhanced table of address details.
  • Results - Shows the results of the geocoding and any addresses that failed.

Clicking on the OK button causes the plugin to start geocoding.

Reverse Point GeoCoding

Clicking on this tool allows the user to be able to click on the map and return the closet feature/address in a dockable window. Note that the closes feature may be an administrative boundary or another feature that is not that close to the point clicked on. If the nominatim service is using the latest software, the actual polygon or point of the located feature will be displayed.

Settings

In Settings the user can select the Nominatim Service URL endpoint, the maximum number of addresses to geocode and for reverse geocoding the level of detail where 0 represents the country and 18 the address number. Here is the dialog window.

Settings

Please note that this plugin is designed to use commercial or personal Nominatim services. The OpenStreetMap URL displayed here is not for bulk use as it violates their policy and will result in the user being blocked from their site for a period of time.

You can’t perform that action at this time.