Open Street Map Plug-in

The OpenStreetMap Plug-in for Convergence for MDM uses the OpenStreetMap API to provide an enricher for international postal addresses. This enricher cleanses, standardizes and enriches the postal address.

OpenStreetMap Enricher

Plug-in ID

OpenStreetMap Enricher - com.semarchy.engine.plugins.openstreetmap

Description

This enricher takes an input address, enriches and validates this postal address using the OpenStreetMap Service.

Note: This enricher uses the OpenStreetMap Service, which must be accessible from the Convergence for MDM Application at the URL specified in the OpenStreetMap URL parameter. Make sure to make this URL accessible through your firewalls.

Plug-in Parameters

The following table lists the plug-in parameters.

Parameter Name Mandatory Type Description
OpenStreetMap URL Yes String URL used to query OpenStreetMap API. Typically http://api.openstreetmap.org/

Plug-in Inputs

The following table lists the plug-in inputs.

Parameter Name Mandatory Type Description
Address Line Yes String Address line to process. If the address is composed of multiple lines, then these lines must be provided as a comma-separated list of address lines.
Postal Code No String Postal code of the address.
City No String City of the address.
Country No String Country of the address.

Note: The entire address, including the Address Line, Postal Code, City and Country values can be passed to the plugin as a single concatenated string in the Address Line input. If the source data contains the address in a single string, then you can pass this string directly in the Address Line input.

Plug-in Outputs

The following table lists the plug-in outputs.

Parameter Name Type Description
Address String Complete address of the location.
City String City of the location.
Country String Country of the location.
Country Code String Country code of the location.
County String County of the location.
Latitude String Latitude of the location.
Longitude String Longitude of the location.
Postal Code String Postal code of the location.
Process Code String Code that indicates the result status of the address processing.
State String State of the Location.
Street Number String Street number of the location.
Street Name String Street name of the location.