GetCandidateAddresses

GetCandidateAddresses renvoie une liste d'adresses considérées comme des correspondances pour une adresse d'entrée donnée. GetCandidateAddresses renvoie les adresses candidates uniquement si l'adresse d'entrée correspond à plusieurs adresses dans la base de données postale. Si l'adresse d'entrée correspond à une seule adresse de la base de données postale, aucune donnée d'adresse n'est renvoyée.

Pour les adresses en dehors des États-Unis et du Canada, il se peut que vous notiez des résultats incohérents entre les correspondances multiples renvoyées par ValidateAddress et les résultats pour cette même adresse renvoyés par GetCandidateAddresses. Si vous obtenez des résultats incohérents, c'est probablement parce que le réglage des performances dans ValidateAddress a été configuré sur une valeur différente de 100. Pour obtenir des résultats cohérents entre GetCandidateAddresses et ValidateAddress, paramétrez l'option de réglage des performances sur 100.

Remarque : Par défaut, l'option GetCandidateAddresses n'effectue pas de correspondance au niveau des numéros de maison individuelle. Elle utilise plutôt des plages de numéro de maison pour chaque rue. Une fois que l'option GetCandidateAddresses a déterminé le nom de la rue, le nom de la ville, le nom de l'état/province et le code postal, elle vérifie que le numéro de maison en entrée se situe dans l'une des plages de numéros de maison données pour le nom de rue correspondant. Le même type de logique s'applique aux numéros d'unité. Pour déterminer si un numéro de maison est valide, vous devez utiliser l'option de traitement du système DPV de ValidateAddress. Le traitement DPV n'est disponible que pour les adresses américaines.

Le codeur canadien contient une routine de recherche inversée qui prend en entrée un code postal spécifique et renvoie les informations de la rue stockées dans la base de données de ce code postal. Pour utiliser cette fonction, ne saisissez qu'un code postal canadien dans le champ CodePostal. Voir le deuxième exemple pour afficher le retour d'un code postal de l'échantillon.

GetCandidateAddresses fait partie du module Universal Addressing.