Objeto ReverseGeocodeServiceResponse

Una solicitud para el servicio Reverse Geocode devuelve un objeto GeocodeServiceResponse que incluye:
  • totalPossibleCandidates: la cantidad total de posibles candidatos.
  • totalMatches: la cantidad total de cruces.
  • Objeto candidates: enumera uno o más candidatos que coinciden con las coordenadas de entrada. Para cada candidato, se muestra información sobre la dirección y datos que coinciden.
Tabla 1. Definiciones de los elementos de GeocodeServiceResponse
Nombre 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 la dirección asociada, además de información sobre 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.                

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ó mediante el uso de 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ó con la función de desplazamiento de la 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.
Nota: Este campo no se devuelve para EE. UU. Para ver información de precisión de la geocodificación para EE. UU., consulte Códigos de ubicación.
formattedStreetAddress Cadena

La línea principal de dirección con formato.

formattedLocationAddress Cadena La última línea de dirección con formato.
precisionCode Cadena El código de resultado devuelto para la geocodificación inversa. Las definiciones aparecen en el apéndice. Para EE. UU., consulte Códigos de ubicación de dirección; para los demás países, consulte Códigos de resultado "R" de geocodificación inversa.
sourceDictionary Cadena Identifica el diccionario que es el origen de los datos y la información del candidato. El diccionario de origen es un valor entero basado en 0 que indica desde qué diccionario configurado proviene el candidato. Si solo tiene un diccionario, este siempre corresponderá a "0".
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 Country
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".
customFields Objeto Los campos y valores correspondientes devueltos son específicos del país.
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 The range is on the left side of the street.

RIGHT The range is on the right side of the street.

BOTH The range is on both the left and right side of the street.

UNKNOWN No information is available on the side of the street this range is located.

oddEvenIndicator Cadena Proporciona información sobre la numeración de casa del rango del candidato.

ODD The range contains odd house numbers.

EVEN The range contains even house numbers.

BOTH The range contains both odd and even house numbers.

IRREGULAR The range contains both even and odd numbers in an irregular order.

UNKNOWN No information is available on the odd/even house numbering on this range.

customValues Mapa Un mapa de valores locales relacionados con el rango del candidato.