MDMGeoAnalyticsService Interface

To use the GeoAnalytics service, TIBCO MDM provides a default implementation class, Geocoding Service Implementation Class(com.tibco.mdm.geo.service.impl) property in Configurator. The property uses TIBCO GeoAnalytics (Maporama) REST APIs.

The MDMGeoAnalyticsService interface contains the following two methods:
  • geocode: used for a single record. Includes the following parameters:
    • serviceUrl: the full-service URL for a single record geocoding or reverse geocoding with key or credentials. You can configure the URL using the Geo Analytics URL property in Configurator.
    • addParams: a map of "standard address attribute" to "its value in record" to be cleansed or geocoded. The standard address attributes are COUNTRY, ZIP, CITY, STATE, STREET, and so on.
  • batchGeocode: used for bulk record. Includes the following parameters:
    • serviceUrl: the full-service URL for bulk records geocoding or reverse geocoding with a key or key-value credentials. You can configure the URL by using the Geo Analytics Batch URL property in Configurator.
    • allRecordsAddresses: a collection of a map of "standard address attribute" to "its value in record" to be cleansed or geocoded. However, a map for this method contains one additional property key-value, that is, "ID"-"UNIQUE_RECORD_ID". TIBCO MDM PRODUCTKEYID is used for the value of the ID.
Note:
  • A GeoAnalytics service needs an account with an appropriate key or credentials to access the service or its APIs. Configure the key using the aforementioned serviceUrl parameters.
  • It is recommended to use maximum of 200 records in one batch request in TIBCO GeoAnalytics Maporama service.That means, a maximum batch size for records in a workflow can be 200, and must be tuned as the recommendation of the respective service.