Opciones de comparación

Opciones de comparación de GeocodeUSAddress

Las opciones de cruce se utilizan para determinar cómo se realizan las búsquedas de direcciones. Le permiten definir preferencias de cruce, criterios y restricciones y múltiples valores de configuración de cruce para que la comparación sea tan estricta o relajada como se requiera.

Parameter Descripción

AddressPreference

Determina cuál dirección se utilizará cuando hay más de una dirección presente en el bloque de direcciones.

PreferPOBox
Usar la casilla postal (P.O. Box).
PreferBottom
Utiliza la segunda línea introducida. Opción predeterminada. Debe seleccionar este valor si .
PreferStreetAddress
Utilizar la dirección de la calle.

FirmNameSearch

Especifica si se utiliza la lógica de comparación de nombre de empresas para mejorar la comparación de direcciones. La lógica de comparación de empresas cruza un nombre de empresa en la entrada con nombres de las empresas reconocidos. No es necesario escribir correctamente el nombre de la empresa de entrada para obtener un cruce. Se utiliza un algoritmo soundex para que coincida con el nombre de la empresa. No se requiere un número de suite o unidad para hacer el cruce.

Nota: Este tipo de cruce no está disponible cuando se procesa en modo CASS.

Una de las siguientes:

Always
Siempre intentar realizar un cruce usando el cruce de nombre de firmas. Si no hay cruce de nombre de empresas, intente realizar un cruce usando cruce de direcciones.
OnAddressLineFail
Usar la comparación de empresas solo si no se puede determinar un cruce usando cruce de direcciones.
Never
No utilizar comparación de empresas. Opción predeterminada. Tenga en cuenta que puede corregirse el nombre de la empresa si especifica Nunca si puede encontrarse un cruce con los datos de línea de dirección.

BuildingSearch

Especifica si se intenta obtener una dirección de la calle cuando la dirección de entrada contiene un nombre del edificio sin número de suite o unidad.

Cuando esta opción está desactivada, el geocodificador es capaz de igualar a nombres de edificios solo si hay un número de unidad en la entrada. Por ejemplo, si la opción de búsqueda de edificio estaba desactivada e ingresó esta entrada:

5001 Chrysler Bldg
New York, NY 10174

Se devolverá la dirección de calle:

405 Lexington Ave
RMB 5001
New York, NY 10174-5002

Con esta opción activada, el geocodificador también puede obtener una dirección de calle cuando solo se proporciona un nombre de edificio sin número de unidad. Por ejemplo, si activa esta opción y proporciona esta dirección:

Chrysler Bldg
New York, NY 10174

Recibirá la dirección de la calle:

405 Lexington Ave
New York, NY 10174-00

Nota: Este tipo de cruce no está disponible cuando se procesa en modo CASS.
Y
Utilizar lógica de comparación de nombre de empresas. Opción predeterminada.
N
No utilizar la lógica de comparación de nombre de empresas.

FirstLetterSearch

Especifica si se va a buscar la primera letra correcta de un nombre de la calle en caso de que falte la primera letra o sea incorrecta. Si esta opción está activada, el geocodificador busca a través del alfabeto usando la primera letra correcta para completar la dirección de la calle.

Nota: Esta opción no está disponible si el modo de cruce está establecido en exacto.
Y
Realizar búsqueda de primera letra.
N
No realizar la búsqueda por primera letra. Opción predeterminada.
Este ejemplo incluye una primera letra incorrecta:

Entrada: 4750 nalnut boulder co 80301
Salida: 4750 Walnut St Boulder CO 80301-2532

Este ejemplo no incluye una primera letra:

Entrada: 4750 alnut boulder co 80301
Salida: 4750 Walnut St Boulder CO 80301-2532

Este ejemplo incluye una primera letra extra:

Entrada: 4750 wwalnut boulder co 80301
Salida: 4750 Walnut St Boulder CO 80301-2532

PredictiveLastLine

Especifica si GeocodeUSAddress debería realizar el cruce utilizando la dirección de calle y las coordinadas de latitud/longitud de entrada, en lugar de la dirección de calle tradicional con la entrada de la última línea.

Y
Activar proceso de predicción de la última línea
N
Desactivar proceso de predicción de la última línea. Opción predeterminada.

Para obtener más información, consulteÚltima línea predictiva.

PerformDPV

Especifica si se procesan las direcciones mediante validación de punto de entrega (DPV). DPV es una tecnología del Servicio Postal de los Estados Unidos (USPS) que valida la exactitud de la información de la dirección respecto de un punto de entrega físico. Cuenta con licencia para que la opción de procesamiento de DPV opcional use esta característica. También, debe instalar la base de datos de DPV.

Para utilizar DPV, active esta opción de procesamiento y especifique D en OutputRecordType.

Y
Ejecute DPV.
N
No ejecutar DPV. Opción predeterminada.

Si utiliza DPV, se resuelven múltiples cruces de forma automática.

Las direcciones de falsos positivos, que también se conocen como registros de semilla, son direcciones que el USPS monitores para garantizar que los usuarios no intenten crear una lista de correos a partir de los datos de DPV. Si el geocodificador cruza una dirección en los datos de entrada con una dirección de falso positivo, recibirá un mensaje que indica que se ha detectado una dirección de falso positivo. El procesamiento continúa hasta el final de su trabajo, pero el procesamiento de DPV no está disponible para este trabajo y los trabajos posteriores hasta que se haya informado a soporte técnico sobre la dirección de falso positivo y se haya recibido una nueva clave de seguridad.

PreferZipCodeOverCity

Especifica si se prefieren a candidatos que coinciden con el código postal (ZIP code) sobre los candidatos que coinciden con la ciudad de entrada.

Nota: Esta opción no está disponible cuando se procesa en modo CASS.
Y
Preferir candidatos que coincidan con el código ZIP de entrada.
N
Preferir candidatos que coincidan con la ciudad de entrada. Opción predeterminada.

Por ejemplo, considere estos datos de entrada:

301 BRYANT ST
SAN FRANCISCO CA 94301

Sin esta opción activada, el mejor cruce sería el que coincide con el nombre de la ciudad de entrada:

301 BRYANT ST
SAN FRANCISCO CA 94107-4167

Con esta opción activada, el mejor cruce sería el que coincide con el código postal (ZIP code) de entrada:

301 BRYANT ST
PALO ALTO CA 94301-1408

FIND_SEARCH_AREA

Estas opciones establecen las limitaciones de búsqueda que se utilizarán para los cruces. Pueden ayudar a encontrar un cruce, cuando la dirección de entrada contiene información imprecisa o limitada del código postal o la ciudad. Para obtener más información, consulteÁrea de búsqueda.
Nota: En el modo de cruce CASS, solo las opciones del área de búsqueda que se describen en FIND_SEARCH_AREA_DEFAULT están disponibles.
FIND_SEARCH_AREA_DEFAULT
El impacto de la opción de la configuración FIND_SEARCH_AREA_DEFAULT depende del modo de cruce que esté utilizando para la comparación.
Cuando se establece FIND_SEARCH_AREA_DEFAULT y está comparando con los modos de cruce CASS o Relaxed, el área de búsqueda se determina según la configuración CentroidPreference :
  • Si CentroidPreference = AllCentroids, se utiliza el área de búsqueda FIND_SEARCH_AREA_CITY.
  • Si CentroidPreference se establece en NoCentroids o AddressUnavailable, se utiliza el área de búsqueda FIND_SEARCH_AREA_FINANCE.

Cuando FIND_SEARCH_AREA_DEFAULT se establece y está comparando con cualquier otro modo de cruce, Custom, Exact, Close o Interactive, se utiliza el área de búsqueda FIND_SEARCH_AREA_FINANCE.

FIND_SEARCH_AREA_FINANCE
Busca las calles posibles en toda el área financiera.
Nota: Esta opción no tiene efecto cuando se realiza un cruce de centroide de código postal o una geocodificación geográfica.
FIND_SEARCH_AREA_CITY
Busca la ciudad especificada.
FIND_SEARCH_AREA_EXPANDED
Permite la configuración de la distancia de radio de búsqueda que se utilizará en la comparación. Consulte FIND_SEARCH_AREA_DISTANCE a continuación.
FIND_EXPND_SRCH_LIM_TO_STATE
Limita la búsqueda al estado dentro de la distancia de radio de búsqueda. El radio de búsqueda predeterminado es de 40 km.

FIND_SEARCH_AREA_DISTANCE

Cuando se selecciona la opción FIND_SEARCH_AREA_EXPANDED, este campo le permite ingresar la distancia de radio de búsqueda que se utilizará en la comparación. Valores válidos = 0-159 (kilómetros). Predeterminado = 40 kilómetros.
Nota: Se ignora en el modo de cruce CASS.

KeepMultimatch

Seleccione esta opción para volver a la lista de los posibles cruces cuando exista más de un posible cruce para la dirección de entrada y no pueda identificarse un único cruce óptimo.

Y
Devolver las direcciones que son posibles cruces para la dirección de entrada. Opción predeterminada.
N
No devolver cruces ambiguos.

KeepCandidates

Seleccione esta opción para devolver las direcciones de candidatos siempre que intento de cruce produzca candidatos. Si se activa esta opción, el geocodificador devolverá candidatos cuando la dirección de entrada corresponda a una única dirección y cuando la dirección de entrada coincida con varias direcciones.

Esta opción es diferente de KeepMultimatch debido a que la opción KeepMultimatch no devuelve candidatos si la dirección de entrada coincide con una única dirección.

Y
Devolver candidatos para todos los intentos de cruce.
N
No devolver candidatos de todos los cruces. Opción predeterminada.

CloseMatchesOnly

Si especifica , puede elegir devolver solamente los candidatos que se consideran un cruce cercano. Los criterios utilizados para determinar si un candidato es un cruce cercano son aquellos que se especifique en la opción MatchMode.

Y
Devolver solo candidatos de cruce cercano. Opción predeterminada.
N
Devolver todos los candidatos.

MatchMode

Determina la indulgencia utilizada para encontrar un cruce. Una de las siguientes:

Custom
Le permite seleccionar los criterios específicos que se utiliza cuando se compara la dirección de entrada con una dirección en la base de datos postal.
Exact
Requiere un cruce muy ajustado. Este es un modo restrictivo que genera el menor número de candidatos de cruce para buscar, lo que reduce el tiempo para obtener un cruce. Cuando se utiliza este modo, asegúrese de que su lista de direcciones de entrada esté muy limpia, libre de errores ortográficos y direcciones incompletas.
Close
Requiere un cruce de confianza moderada. Genera un número moderado de candidatos de cruce.
Relax
Este es el modo de cruce más holgado modo partido y genera la mayoría de los candidatos de cruce, lo que aumenta el tiempo de procesamiento y da como resultado múltiples coincidencias. Utilice este modo si su lista de direcciones puede contener errores ortográficos y direcciones incompletas. Este modo no respeta la paridad de calles para un cruce de dirección. Opción predeterminada.
Interactive
Disponible únicamente en coincidencia con dirección de una línea. Este modo está diseñado para gestionar mejor los desafíos de coincidencia específicos que se presentan en el cruce interactivo. El modo interactivo permite patrones de coincidencia más flexibles y puede, en algunos casos, devolver posibles coincidencias adicionales que el modo de cruce relajado. Este modo reconoce y analiza dos números de unidad en la misma línea de la dirección, por ejemplo un número de edificio y de unidad. Este modo no respeta la paridad de rango a la hora de realizar un cruce de dirección.
Capacidades y restricciones:
  • El modo de coincidencia interactivo permite a los usuarios romper la regla cardinal: si el usuario escribe 123 S Main y solo existe 123 N Main, se encontrará una coincidencia y se proporciona un código de coincidencia que refleja la dirección modificada.
  • El modo de coincidencia interactivo maneja casos donde los usuarios transponen datos predireccionales con posdireccionales sin penalización.
  • El modo de coincidencia interactivo omite la configuración "Usar código postal en lugar de ciudad". Cuando el código postal y la ciudad no coinciden exactamente, se obtendrá el mejor resultado de geocodificación en base al análisis de todos los elementos de la dirección de entrada.
  • Cuando se usa el modo Interactivo, en los casos en los cuales no se puede determinar el resultado de una dirección de punto o dirección con calle interpolada, se obtendrá un centroide de código postal 9 o 7.
CASS
Impone reglas adicionales para garantizar el cumplimiento de la normativa de USPS para CASS. El objetivo de este modo es crear una lista de direcciones a las que se puedan enviar correos. Este modo genera una gran cantidad de candidatos de cruce. Este modo se aparta de los otros modos en su procesamiento. Este modo no realiza cruces de intersección, nombre del edificio o alias espaciales (alias de nombres de calles de TIGER y TomTom). Tampoco coincide con candidatos de fuentes de datos que no tengan registros equivalentes al USPS. Este modo reconoce y analiza dos números de unidad en la misma línea de la dirección, por ejemplo un número de edificio y de unidad.

ExtendedMatchCode

Especifica si se devuelve el código extendido de cruce. Para obtener más información, consulteCódigos de cruce extendidos.

Y
Sí, devuelve el código extendido de cruce.
N
No, no devuelve el código extendido de cruce. Opción predeterminada.

MustMatchInput

Especifica si los candidatos deben coincidir con todos los campos de entrada que no están en blanco. Por ejemplo, si una dirección de entrada contiene una ciudad y un código postal, los candidatos para esta dirección deben coincidir con la ciudad y el código postal.

Y
Sí, los candidatos deben coincidir con todas las entradas.
N
No, los candidatos no tienen que coincidir con todas las entradas. Opción predeterminada.

MustMatchStreet

Especifica si los candidatos deben coincidir con el nombre de la calle.

Y
Sí, los candidatos deben coincidir con el nombre de la calle.
N
No, los candidatos no tienen que coincidir con el nombre de la calle. Opción predeterminada.

MustMatchStateProvince

Especifica si los candidatos deben coincidir con el estado.

Y
Sí, los candidatos deben coincidir con el estado.
N
No, los candidatos no tienen que coincidir con el estado. Opción predeterminada.

MustMatchHouseNumber

Especifica si los candidatos deben coincidir con el número de la casa. Si el número de la casa de entrada no se encuentra dentro de un intervalo desde la calle, GeocodeUSAddress selecciona el intervalo más cercano en la calle que tiene la misma paridad (número de casa par o impar) como el número de dirección de entrada. GeocodeUSAddress devuelve una o más de los cruces más próximas dentro de este rango que conserva la paridad de calles. Esto requiere GeocodeUSAddress cambie el número de la casa. El nuevo número de la casa es igual a uno de los puntos extremos del intervalo, posiblemente más o menos uno para mantener la paridad de calles.

Nota: Incluso si esta opción está desactivada y se encuentra un cruce inexacto en el número de casa, GeocodeUSAddress aún devuelve un código de error.

Cuando esta opción está desactivada y no se encuentra un número de coincidencia, se devuelve un código de cruce E029 (sin rango de coincidencia, se ha encontrado un segmento de calle único), o E030 (sin rango de coincidencia, segmento de calle múltiple).

GeocodeUSAddress no cambia el número en la casa de la dirección de salida. Con el fin de acceder a los candidatos con número de dirección inexacto, debe especificar KeepMultimatch=Y. Si se devuelven candidatos con número de dirección inexacta, los códigos de cruce correspondientes comienzan con la letra "H" que indica que el número de la casa no coincide.

Además, incluso cuando se encuentran uno o más candidatos exactos, en la lista de posibles candidatos sigue habiendo cruces inexactos con el número de la casa y estos pueden diferenciarse de los demás por sus códigos de cruce Hxx. Para obtener más información sobre los códigos de coincidencia, consulte Códigos de cruce.

Una de las siguientes:

Y
Sí, los candidatos deben coincidir con el número de la casa. Opción predeterminada.
N
No, los candidatos no tienen que coincidir con el número de la casa.

MustMatchCity

Especifica si los candidatos deben coincidir con la ciudad. Si no se indica que debe haber cruces exactos para la ciudad, el geocodificador buscará en las direcciones de calles cruzadas con un código postal en particular y tendrá en cuenta otras ciudades que no coinciden con el nombre pero sí con el código postal.

Y
Sí, los candidatos deben coincidir con la ciudad.
N
No, los candidatos no tienen que coincidir con la ciudad. Opción predeterminada.

MustMatchPostalCode

Especifica si los candidatos deben coincidir con el código postal. Si no se indica que debe haber cruces exactos para los códigos postales, el geocodificador buscará en un área más amplia para encontrar un cruce. Si bien de este modo la velocidad de rendimiento es menor, el índice de cruce es más alto porque la solicitud no necesita establecer un cruce exacto al comparar candidatos.

Y
Sí, los candidatos deben coincidir con el código postal.
N
No, los candidatos no tienen que coincidir con el código postal. Opción predeterminada.

Diferencia entre criterios de cruce para geocodificación de Estados Unidos y que no corresponde a Estados Unidos. Geocodificación

Los "criterios de coincidencia obligatoria" que se utilizan en el modo de cruce personalizado de Geocode US Address funcionan de manera diferente a la de "criterios de cruce cercano" en geocodificadores que no corresponden a Estados Unidos. Para Geocode US Address, los criterios de cruce personalizados especifican cuáles elementos de dirección deben coincidir con la base de datos de referencia con el fin de que el cruce se devuelva como candidato. Todos los candidatos que devuelve Geocode US Address coinciden con los elementos que se especifica, siempre que dichos elementos estén disponibles en la base de datos de referencia. Sin embargo, en geocodificadores que no corresponden a Estados Unidos, los criterios de "cruce cercano" se utilizan para determinar cuáles candidatos son cruces cercanos y cuáles no lo son. a Estados Unidos los geocodificadores pueden devolver tanto candidatos cercanos como candidatos no cercanos, en función de si se activa la opción CloseMatchesOnly. En resumen, los criterios de "coincidencia obligatoria" que utiliza Geocode US Address limitan automáticamente los candidatos devueltos, mientras que los criterios de "cruce cercano" que usan geocodificadores que no corresponden a Estados Unidos no limitan los candidatos devueltos.