BackgroundGeocoding refers to enhancing an address with additional information, typically latitude and longitude. This serves two common QBO use cases: calculating distance between entities, and correcting (or normalizing) an address. Geocoding is invoked by calling:
Calling Contact/Geocode is an excellent unit test for a power user, and a useful API for third party systems, but it does not change or save any data in the QBO database. To persist the results of a geocode, call Contact/Normalize which will call Contact/Geocode, and save the results if the confidence returned is high enough. // Create a Contact for us to play with Contact/Normalize?ID=27 Note that the Property class in qbo.Mortgage also supports the Normalize method. MechanicsQBO has built-in mapping providers that perform geo-coding for us, including Google, Bing, Yahoo, and Qualified Address. When calling Contact/Geocode, the following logic is applied:
Note that a given mapping provider (Google, for instance) may return more than 1 address for a given input. Contact/Geocode will return all results sorted by confidence descending, including the calculated confidence for each result. Optional parameters include:
ConfidenceIf a geocodeed address confidence is returns a value of 80 or more, it is considered a 'good' match. Confidence is calculate by comparing the input address to the output address. Specifically:
All of these thresholds are configurable from Design > Configuration > Contact > Settings. Google Maps API ConfigurationThere are several configuration setting specific to the qbo.Google.Maps class used to do Google Maps-based geocoding, each in the qbo.Google.Properties.Settings configuration section:
To override any of these settings, created a SystemDefault like: qbo.Google.Properties. Settings.{Setting}
|
Quandis Business Objects 3 > qbo.Contact >