Match modes determine the leniency used to make a match between your input and the data. Select a match mode based on the quality of your input and your desired output. For example, if you have an input database that is prone to errors, you may want to select the relaxed match mode.
Parameter | Description |
---|---|
Option.MatchMode |
|
Interactive match mode
Interactive mode is designed for interactive mobile/web applications. In this use case, it is expected that users may enter single-line addresses that contain misspelled, inaccurate, and/or missing information, so this input is processed utilizing a looser set of criteria for matching than the other match modes. As a result, the matching output could include multiple match candidates. The list of matches would be presented to the user who could then select the desired match candidate. If an exact match is found, then that single match candidate is returned; a mix of accurate and inaccurate results are not presented.
- Interactive match mode allows users to break the cardinal rule: If the user enters 123 S Main and there is only 123 N Main, a match is made and a match code is returned that reflects the modified directional.
- Interactive match mode handles cases where users transpose pre-directionals with post-directionals without penalty.
- Interactive match mode ignores the 'Prefer ZIP Code over city' setting. When the city and ZIP Code don't match correctly, the best geocoding result will be returned based on an analysis of all the input address elements.
- When operating in interactive mode, in cases where a point address or interpolated street address result cannot be determined, ZIP-9 or ZIP-7 centroid(s) may be returned.
The following table shows a comparison of the match results when running in interactive vs. close or relaxed modes.
Single-line input address | Interactive mode match candidates | Close/Relaxed mode single match candidate |
---|---|---|
HIGHLAND VIEW WINCHESTER 01890 |
5 HIGHLAND VIEW AVE, WINCHESTER, MA 01890 5 HIGHLAND TER, 5 HIGHLAND AVE, |
5 HIGHLAND VIEW AVE, WINCHESTER, MA 01890 |
414 PINE WILLIAMSFIELD 61489 |
414 N PINE ST, WILLIMAMSFIELD, IL 61849 414 PINE ST, |
414 N PINE ST, WILLIMAMSFIELD, IL 61849 |
46 HORNBEAM ST CRANSTON RI (conflict with street type) |
46 HORNBEAM DR, |
46 HORNBINE ST, |
611 W 13TH JOPLIN MO 64801 (conflict between directional and ZIP Code) |
611 E 13TH ST, 611 W 13TH ST, |
611 W 13TH ST, |