Campos de salida

Una solicitud al servicio Geocode muestra un objeto GeocodeServiceResponse que contiene:
  • totalPossibleCandidates: la cantidad total de posibles candidatos.
  • totalMatches: la cantidad total de cruces.
  • candidates: indica uno o más candidatos que coinciden con la o las direcciones de entrada. Para cada candidato, se muestra información sobre la ubicación y datos que coinciden.

En esta tabla, se describen los posibles campos de devolución disponibles para el servicio Geocoding. No todos los campos se devolverán con un candidato de cruce.

Campo Tipo Descripción
totalPossibleCandidates Integer Indica la cantidad total de posibles candidatos.
totalMatches Integer Indica la cantidad total de coincidencias.
candidates: objeto de tipo Candidate que consta de una serie de uno o más candidatos de cruce y direcciones asociadas, junto con información de ubicación y comparación. Contiene los siguientes elementos:
precisionLevel Integer Un código que describe la precisión del código geográfico. Una de las siguientes:

0: No hay información de coordenadas disponible para esta dirección de candidato. Las direcciones de USA devuelven 0.

1: Dirección de calle interpolada.
2: Punto medio de segmento de calle.

3: Centroide de código postal 1.

4: Centroide parcial de código postal 2.

5: Centroide de código postal 2.

6: Intersección.

7: Punto de interés. (Si la base de datos contiene datos de POI).

8: Centroide de estado/provincia.

9: Centroide de condado.

10: Centroide de ciudad.

11: Centroide de localidad.

12-15: Reservados para elementos personalizados sin especificar.

16: El resultado es un punto de dirección.

17: El resultado se generó usando datos de puntos de dirección para modificar los datos de segmentos del candidato.

18: El resultado es un punto de dirección que se proyectó utilizando la función de desplazamiento de línea central. Debe tener una base de datos de rango de puntos y calles para utilizar la función de desplazamiento de línea central.
formattedStreetAddress Cadena

La línea principal de dirección con formato.
formattedLocationAddress Cadena La última línea de dirección con formato.
identifier Cadena Para candidatos de nivel de punto o calle, este normalmente es la ID de segmento.
precisionCode Cadena Un código que describe la precisión del código geográfico. Para obtener más información, consulte Códigos de resultado de geocodificación directa.
matching: objeto de tipo FieldsMatching que consta de una serie de uno o más candidatos de cruce. Contiene los siguientes elementos:
matchOnAddressNumber Boolean Indica si el número de dirección de entrada coincidió con el número de dirección del candidato.
true
El número de dirección de entrada coincidió con el número de dirección del candidato.
False
El número de dirección de entrada no coincidió con el número de dirección del candidato.
matchOnPostCode1 Boolean Indica si el campo postCode1 de entrada coincidió con el campo postCode1 del candidato.
true
El campo postCode1 de entrada coincidió con el campo postCode1 del candidato.
False
El campo postCode1 de entrada no coincidió con el campo postCode1 del candidato.
matchOnPostCode2 Boolean Indica si el campo postCode2 de entrada (extensión de código postal) coincidió con el campo postCode2 del candidato.
true
El campo postCode2 de entrada coincidió con el campo postCode2 del candidato.
False
El campo postCode2 de entrada no coincidió con el campo postCode2 del candidato.
matchOnAreaName1 Boolean Indica si el campo areaName1 de entrada coincidió con el campo areaName1 del candidato.
true
El campo areaName1 de entrada coincidió con el campo areaName1 del candidato.
False
El campo de entrada areaName1 no coincidió con el campo areaName1 del candidato.
matchOnAreaName2 Boolean Indica si el campo areaName2 de entrada coincidió con el campo areaName2 del candidato.
true
El campo areaName2 de entrada coincidió con el campo areaName2 del candidato.
False
El campo areaName2 de entrada no coincidió con el campo areaName2 del candidato.
matchOnAreaName3 Boolean Indica si el campo areaName3 de entrada coincidió con el campo areaName3 del candidato.
true
El campo areaName3 de entrada coincidió con el campo areaName3 del candidato.
False
El campo areaName3 de entrada no coincidió con el campo areaName3 del candidato.
matchOnAreaName4 Boolean Indica si el campo areaName4 de entrada coincidió con el campo areaName4 del candidato.
true
El campo areaName4 de entrada coincidió con el campo areaName4 del candidato.
False
El campo areaName4 de entrada no coincidió con el campo areaName4 del candidato.
matchOnStreetName Boolean Indica si el nombre de calle de entrada coincidió con el nombre de calle del candidato.
true
El nombre de calle de entrada coincidió con el nombre de calle del candidato.
False
El nombre de calle de entrada no coincidió con el nombre de calle del candidato.
matchOnStreetType Boolean Indica si el tipo de calle de entrada coincidió con el tipo de calle del candidato.
true
El tipo de calle de entrada coincidió con el tipo de calle del candidato.
False
El tipo de calle de entrada no coincidió con el tipo de calle del candidato.
matchOnStreetDirectional Boolean Indica si la dirección de calle de entrada coincidió con la dirección de calle del candidato.
true
La dirección de calle de entrada coincidió con la dirección de calle del candidato.
False
La dirección de calle de entrada no coincidió con la dirección de calle del candidato.
matchOnPlaceName Boolean Indica si el nombre de lugar de entrada coincidió con el nombre de lugar del candidato.
true
El nombre de lugar de entrada coincidió con el nombre de lugar del candidato.
False
El nombre de lugar de entrada no coincidió con el nombre de lugar del candidato.
Objeto geométrico. Código geográfico devuelto que consta de los siguientes elementos:
coordinates Double El código geográfico del candidato, especificado como coordenadas x (longitud), y (latitud), separadas por una coma.
crs Cadena El sistema de referencia de coordenadas utilizado para el código geográfico del candidato.
type Cadena Tipo de geometría. El valor devuelto es siempre Point.
Objeto dirección. Dirección del candidato devuelto, que puede incluir alguno de los siguientes elementos:
mainAddressLine Cadena Línea de dirección del candidato.
addressLastLine Cadena Última línea de dirección del candidato.
placeName Cadena Nombre de firma, empresa, organización, comercial o edificio.
areaName1 Cadena Estado, provincia o región.
areaName2 Cadena Condado o distrito.
areaName3 Cadena Ciudad, pueblo o suburbio.
areaName4 Cadena Locality
postCode1 Cadena Código postal principal.
postCode2 Cadena Código postal secundario, si hay uno.
country Cadena Nombre del país en formato ISO 3166-1 Alpha-2 o Alpha-3, o un nombre común del país, como Estados Unidos de América.
addressNumber Cadena El número de casa o de edificio.
streetName Cadena Nombre de la calle.
unitType Cadena El tipo de unidad, por ejemplo, Apt., Ste. y Bldg.
unitValue Cadena El número o valor de la unidad, por ejemplo, "3B".
rangos: objeto CandidateRange. Contiene información sobre los rangos del candidato, que consisten en los siguientes elementos:
placeName Cadena Si corresponde, indica el nombre del edificio o lugar del candidato.
lowHouse Cadena Indica el número bajo de casa en el rango de calle del candidato.
highHouse Cadena Indica el número alto de casa en el rango de calle del candidato.
side Cadena Proporciona información sobre el lado de la calle donde se encuentra ubicado el rango del candidato.
LEFT
El rango corresponde al lado izquierdo de la calle.
RIGHT
El rango corresponde al lado derecho de la calle.
BOTH
El rango se encuentra en el lado izquierdo y derecho de la calle.
UNKNOWN
No existe información disponible sobre el lado de la calle donde se encuentra este rango.
customValues Mapa Un mapa de valores locales relacionados con el rango del candidato.
unidades: objeto CandidateRangeUnit. Contiene información sobre las unidades del rango del candidato, que consisten en los siguientes elementos:
placeName Cadena Si corresponde, indica el nombre del edificio o lugar del candidato.
unitType Cadena Indica el tipo de unidad (APT, STE, etc.).
highUnitValue Cadena Indica el número de unidad alto de esta unidad de rango.
lowUnitValue Cadena Indica el número de unidad bajo de esta unidad de rango.
customValues Mapa Un mapa de valores locales relacionados con la unidad.