Objeto GeocodeServiceResponse

Una solicitud para el servicio de geocodificación inversa devuelve un objeto GeocodeServiceResponse que incluye:
  • totalPossibleCandidates— la cantidad total de posibles candidatos.
  • totalMatches— la cantidad total de coincidencias.
  • candidates objeto: enumera uno o más candidatos que coincidieron 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 cruce. Contiene los siguientes elementos:
precisionLevel Integer Un código que describe la precisión del código geográfico. Las opciones son:
0
No hay información de coordenadas disponible para la dirección del candidato.
1
Dirección de calle interpolada.
2
Punto medio de segmento de calle.
3
Centroide de código postal 1.
4
Centroide de código postal 2 parcial.
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
Reservado para elementos personalizados sin especificar.
16
El resultado es un punto de dirección.
17
El resultado fue generado 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ó utilizando 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 String 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 todos los otros 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:
Nota: El significado de los siguientes elementos de direcciones varía según el país:
  • mainAddress
  • areaName1
  • areaName2
  • areaName3
  • areaName4
  • postCode1
  • postCode2

Para localizar la información de su país, consulte la sección Información específica del país en el apéndice, que proporciona más detalles.
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. Consulte la sección Información específica del país en el apéndice.
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.
oddEvenIndicator Cadena Proporciona información sobre la numeración de casa del rango del candidato.
ODD
El rango contiene números de casa impares.
EVEN
El rango contiene números de casa pares.
BOTH
El rango contiene números de casa pares e impares.
IRREGULAR
El rango contiene números pares e impares en un orden irregular.
UNKNOWN
No existe información disponible sobre los números de casa pares e impares en este rango.
customValues Mapa Un mapa de valores locales relacionados con el rango del candidato.