The driver overlays the original input record address fields with the results. Each specific address component identified as input in the Definition File is overlaid with the information returned from the Finalist API call. To use the Overlay Option, in the [OPTIONS] section of the Job File, specify jOverlay=YES.
Note that any address components that are not specified as input in the Definition File cannot be overlaid with return information and may result in incomplete and/or incompatible address information existing within your data file. For example, let's say your input ZIP Code exists as part of the input field defined as the city name (iCity in the Definition File). The driver program cannot return the ZIP Code because you did not define a location for it. This would result in you losing the original ZIP Code from your input record because the driver would overlay your original city, state and ZIP Code with just the city name.
You should only use the overlay option when you know the exact location of specific address components. Ideally, you can use this option to update your address file in a single pass without the need for a site-specific post processing application to analyze a separate output file containing the Finalist results.
You should use block-type address lines and the jOverlay=NO option if either of the following conditions are true:
- Your address data fields are not in fixed locations within the data record.
- Multiple address components float within a certain range in the record.