When using the search widget with the ESRI world geocoder service, the suggestions in the geocoder are different from the results of the find address in the map viewer classic.
Suggestion Payload:
Suggestions Results:
Find Payload:
Find Addresses results is returning different results as such:
and sometimes it returns one wrong result.
Suggest and findAddressCandidates expose different functionality and are not intended to be identical.
Suggest is used to quickly suggest results based on the partial input you have entered. Some call this auto-complete. Once the user selects one of the suggestions, the magicKey received from the suggest result can be passed into the findAddressCandidates operation to get back the geometry and other geocoding attributes.
FindAddressCandidates expects more complete input where an entire address or place of interest is entered. It expects that the words entered would be complete but does support misspellings and the omission of some tokens. FindAddressCandidates can be used by itself or in conjunction with the suggest operation by passing the magicKey from suggest into the findAddressCandidates operation.