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 |
---|---|
Option.AddressPreference |
Determina cuál dirección se utilizará cuando hay más de una dirección presente en el bloque de direcciones.
|
Option.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:
|
Option.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 Se devolverá la dirección de calle: 405 Lexington Ave 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 Recibirá la dirección de la calle: 405 Lexington Ave Nota: Este tipo de cruce no está disponible cuando se procesa en modo CASS.
|
Option.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.
Este ejemplo incluye una primera letra incorrecta:
Entrada: 4750 nalnut boulder co 80301 Este ejemplo no incluye una primera letra:
Entrada: 4750 alnut boulder co 80301 Este ejemplo incluye una primera letra extra:
Entrada: 4750 wwalnut boulder co 80301 |
Option.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.
Para obtener más información, consulteÚltima línea predictiva. |
Option.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 Option.OutputRecordType.
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. |
Option.PerformLACSLink |
Especifica si se procesan direcciones con LACSLink.
Si utiliza LACSLink, asegúrese de escoger especifique los tipos de registro de salida P y Q para que los campos USLACS, USLACS.ReturnCode y LACSADDRESS se incluyan en el resultado. Para obtener más información, consulteSistema de conversión de direcciones localizables (LACS). |
Option.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.
Por ejemplo, considere estos datos de entrada: 301 BRYANT ST Sin esta opción activada, el mejor cruce sería el que coincide con el nombre de la ciudad de entrada:
301 BRYANT ST 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 |
Option.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.
|
Option.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.
|
Option.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.
|
Option.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. Este parámetro es diferente de Option.KeepMultimatch debido a que el parámetro Option.KeepMultimatch no obtiene candidatos si la dirección de entrada coincide con una única dirección.
|
Option.CloseMatchesOnly |
Si especifica Option.KeepCandidates=Y, 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 el parámetro Option.MatchMode.
|
Option.MatchMode |
Determina la indulgencia utilizada para encontrar un cruce. Una de las siguientes:
|
Option.ExtendedMatchCode |
Especifica si se devuelve el código extendido de cruce. Para obtener más información, consulteCódigos de cruce extendidos.
|
Option.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.
|
Option.MustMatchStreet |
Especifica si los candidatos deben coincidir con el nombre de la calle.
|
Option.MustMatchStateProvince |
Especifica si los candidatos deben coincidir con el estado.
|
Option.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 Option.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:
|
Option.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.
|
Option.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.
|
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 Option.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.