Suggest

Servicios web

Documentación sobre la funcionalidad Suggest disponible a través del webservice HTTP-JSON de la plataforma CERCALIA.

La URL base a utilizar es:

* Clave de seguridad. Es la misma KEY que para la API de mapas de Cercalia

Las peticiones HTTP se pueden enviar en GET o POST
Las respuestas son en formato JSON

Introducción API Cercalia Suggest

Webservice suggest direcciones. Este servicio permite lanzar:

  1. Peticiones de sugerencias:
    Incluye direcciones, localidades y puntos de interés. No incluye las coordenadas de la dirección, requere realizar la petición de geocodificación de dirección
  2. Peticiones para geocodificar direcciones
    Obtener la X,Y de una dirección

Las peticiones de sugerencias ya incluyen la coordenada de cada candidato, a excepción de las direcciones (sólo se devuelve la coordenada por defecto de la calle). En este caso es necesario realizar una segunda petición al webservice, para obtener las coordenadas de detalle del portal.

Dirección del WebService:
http://ws.cercalia.com/suggest/SuggestServlet?

Peticiones sugerencias

Petición:

Se acepta el método GET y POST.
Los parámetros siempre deben ir codificados en UTF-8

Parámetros de petición:

"key"
Clave de seguridad:

  • Para aplicaciones WEB, utilizar la misma KEY que para la API de mapas de Cercalia
  • Para el resto de aplicaciones (servidor, APP, ...), pedir una KEY a Nexus

"t"
Texto a buscar. Puede contener la calle, número, localidad, código postal, etc. El código postal actúa como limitador: en caso de no encontrar coincidencias amplía la búsqueda a todo el municipio perteneciente al CP.
 

Parámetros opcionales:

"stnum"
Número de portal a buscar. No se extraerá de "t". Si "stnum" está informado, los valores numéricos de dentro de "t" se interpretarán como parte del nombre de la calle / población, no como número de portal.

"alllike"
Para utilizar like en todas las palabras. Utilizar los valores "Yes","Y" o "1".

"nofuzzy"
Para no utilizar fuzzy (búsqueda de palabras similares). Utilizar los valores "Yes","Y" o "1".

"getype"
Filtro por tipos de elemento. Lista separada por comas.
Posibles valores:

  • st= Calles
  • ct= Localidades
  • all= los devuelve todos, equivale a no enviar el parámetro

Ej.: getype=st,ct
 

Filtros opcionales:

  • ctryc: código de país (ej: ESP,FRA)
  • regc: código de región - comunidad (ej: ESPMAD,ESPCAT)
  • subregc: código de subregión - provincia (ej:ESP08,EPS28)
  • munc: código de municipio (ej: ESP080193,ESP280796)
  • rsc: código de municipio / región / subregión / país (substituye munc, subregc , regc y ctryc). Ej: ESP,ESPMAD,ESP08,ESP410917
  • rscp: código de municipio / región / subregión / país preferido. Este filtro, prioriza los resultados que se encuentren en las regiones especificadas, por encima del resto de candidatos, llenando la lista de sugerencias con los candidatos de la región /es priorizadas (siempre que encuentre candidatos), pero no elimina los resultados del resto de regiones o países. Este filtro se puede combinar con el filtro "rsc", para obtener un filtro máximo de resultados más allá de los preferidos. Ej: ESPVAL
    * rscp1 – rscp2 ...: En caso de necesitar priorizar los candidatos dentro de la lista de regiones preferidas, pueden separarse las regiones por parámetros separados según nivel de prioridad: rscp1: prioridad máxima, rscp2: segundo nivel de prioridad, ...
  • rsclp: código de municipio / región / subregión / país preferido. No compatible con el filtro rscp Este filtro, prioriza de manera más suave que "rscp" los resultados que se encuentren en las regiones especificadas: solo recoge un máximo de 3 candidatos de mayor score de las regiones especificadas, y no elimina los del resto de regiones. Este filtro se puede combinar con el filtro "rsc", para obtener un filtro máximo de resultados más allá de los preferidos. Ej: ESPVAL
    * rsclp1 – rsclp2 ...: En caso de necesitar priorizar los candidatos dentro de la lista de regiones preferidas, pueden separarse las regiones por parámetros separados según nivel de prioridad: rsclp1: prioridad máxima, rsclp2: segundo nivel de prioridad, ...
  • excluderegions=1 este parámetro booleano evita incluir el filtro por nombre de región en la búsqueda. Es un parámetro opcional, recomendable en el caso de filtrar la búsqueda por radio, o quando se utilizan los parámetros &rsc= / &rscp=
  • stc: código de calle (ej: ESP280796000099043)
  • hnrt: aplicar una tolerancia en el número de portal buscado, para priorizar direcciones que contengan el número de portal buscado, incluyendo el margen de tolerancia. Este margen es de 50 números, y 500 en el caso de USA (el de USA aplica siempre que se filtre la búsqueda a nivel de USA o una de sus regiones). Posible valores:
    [0] = no aplica. Valor por defecto
    [1] = aplica
  • lang: código/códigos de idioma preferido (idioma en el que prefieres que se devuelvan las sugerencias, si disponible). Códigos ISO 3 dígitos. Ej: lang=baq,spa -> prioriza el Eskera, y si no está disponible, el Español. Idiomas principales:

Idioma

Código

Alemán

GER

Árabe

ARA

Catalán

CAT

Checo

CZE

Croata

SCR

Danés

DAN

Eslovaco

SLO

Esloveno

SLV

Estonio

EST

Eskera

BAQ

Finés

FIN

Neerlandés

DUT

Francés

FRE

Gallego

GLG

Griego

GRE

Hebreo

HEB

Hindi

HIN

Hungarés

HUN

Inglés

ENG

Islandés

ICE

Italiano

ITA

Letón

LAV

Lituano

LIT

Noruego

NOR

Polaco

POL

Portugués

POR

Rumanés

RUM

Ruso

RUS

Sueco

SWE

Turco

TUR

Valenciano

VAL


Filtro por radio:

Permite filtrar los resultados por proximidad a un punto (coordenada). Se trata de un filtro restrictivo (solo devuelve candidatos que se encuentren dentro del radio).

  • pt: coordenada "lat,lon"
  • d: distancia radial en kilómetros, por defecto 25 km. El valor mínimo es de 5 km

Ej: pt=40.417025,-3.703505&d=25

Ejemplo de petición:
http://ws.cercalia.com/suggest/SuggestServlet?key=xxxxxxxxxxxx&t=avinguda%20diagonal%20200,%20barcelona&getype=st,ct&ctryc=ESP

Respuesta:

La respuesta siempre se devuelve en formato JSON.
La respuesta siempre se devuelve con codificación UTF-8.

Tipos de elementos devueltos por la API de sugerencias:

Localidad

Si el campo "id" empieza por 'CT', es una localidad.

Direcciones (*)

Si el campo "id" empieza por 'ST', es una calle.

La calle también puede tener los campos opcionales "portal_min" , "portal_max" , "portal" , "portal_disponible" y/o "portal_en".

  • "portal" (número del portal) aparece cuando se ha separado el número del resto de la dirección.
  • "portal_disponible" (número del portal disponible) aparece cuando se ha separado el número del resto de la dirección y se ajusta a los portales disponibles para cada dirección.
  • "portal_en" indica si la dirección el usuario la ha escrito en formato inglés [true/false].
  • "codigo_postal" indica el código postal de la dirección, siempre y cuando esté disponible y/o se haya indicado una dirección completa (calle y número).

(*) Importante: las coordenadas devueltas en cada candidato son las de defecto de la calle. Para obtener las coordenadas exactas del númerode portal indicado es necesario realizar la petición de geocodificación de la dirección.

 

Ejemplo de respuesta:

{
   responseHeader:{
      status:0,
      QTime:88,
      params:{
         ctryc:"ESP",
         getype:"st,ct",
         key:"07de1b67aa00baf5f1284298f88132e3914e4fb380fce9d91c815aa372fe67c4",
         t:"paseo de la castellana 300, madrid"
      }
   },
   response:{
      numFound:1,
      start:0,
      maxScore:2134.202,
      docs:[
         {
            id:"STESP215604",
            calle_id:"ESP280796000091443",
            calle_descripcion:"Paseo de la Castellana",
            calle_nombre:"Castellana",
            calle_tipo:"Paseo",
            calle_articulo:"de la",
            localidad_id:"ESP17240001236707",
            localidad_nombre:"Madrid",
            municipio_id:"ESP280796",
            municipio_nombre:"Madrid",
            provincia_id:"ESP28",
            provincia_nombre:"Madrid",
            comunidad_id:"ESPMAD",
            comunidad_nombre:"Comunidad de Madrid",
            pais_id:"ESP",
            pais_nombre:"España",
            oficial:"Y",
            portal_min:1,
            portal_max:308,
            puntuacio:2,
            coord:"40.482803,-3.682507",
            _version_:1645646022384287700,
            portal:300,
            portal_disponible:300,
            portal_en:false,
            score:2134.202,
            codigo_postal:"28046"
         }
      ]
   }
}

 

Cruces de calle & dirección con referencia a segunda calle

La respuesta es igual a la de direcciones con la información de la segunda calle del cruce, más un elemento "intersection" en cada candidato, donde el elemento "intersection" contiene la información de la primera calle del cruce, pero con la coordenada "coord" del cruce.

Permite buscar / geocodificar dos tipos de direcciones:

  • Cruces de calle: Ejemplo: Calle de Diego de León / Velázquez, Madrid (España)
  • Dirección exacta de una calle, referenciando a una calle con la que cruza (sistema comúnmente utilizado en países como Turquía o Colombia). Ejemplos:
    • Namik Kemal Sokak & Kocayol Caddesi 12, Bostanci (Turquía)
    • Carrera 69P & calle 70-63, Bogotá (Colombia)

Para separar la primera calle de la segunda se puede utilizar el separador " & " o " / ", con los espacios. Si no hay espacios entre el separador se entenderá que forma parte del propio nombre de calle.

Ejemplo respuesta:
"avinguda diagonal & rambla catalunya, barcelona""

{
   responseHeader:{
      status:0,
      QTime:972,
      params:{
         ctryc:"ESP",
         getype:"st,ct",
         key:"07de1b67aa00baf5f1284298f88132e3914e4fb380fce9d91c815aa372fe67c4",
         t:"avinguda diagonal / rambla catalunya, barcelona"
      }
   },
   response:{
      numFound:2,
      start:0,
      maxScore:112.967384,
      docs:[
         {
            id:"STESP51095",
            calle_id:"ESP080193000000807",
            calle_descripcion:"Avinguda Diagonal / Rambla de Catalunya",
            calle_nombre:"Catalunya",
            calle_tipo:"Rambla",
            calle_articulo:"de",
            localidad_id:"ESP17240008430951",
            localidad_nombre:"Barcelona",
            municipio_id:"ESP080193",
            municipio_nombre:"Barcelona",
            provincia_id:"ESP08",
            provincia_nombre:"Barcelona",
            comunidad_id:"ESPCAT",
            comunidad_nombre:"Catalunya",
            pais_id:"ESP",
            pais_nombre:"España",
            oficial:"Y",
            portal_min:1,
            portal_max:137,
            puntuacio:1.9,
            coord:"41.395714,2.1569343",
            _version_:1645646009292816400,
            score:129.48283,
            intersection:{
               id:"STESP853564",
               calle_id:"ESP080193000092155",
               calle_descripcion:"Avinguda Diagonal",
               calle_nombre:"Diagonal",
               calle_tipo:"Avinguda",
               localidad_id:"ESP17240008430951",
               localidad_nombre:"Barcelona",
               municipio_id:"ESP080193",
               municipio_nombre:"Barcelona",
               provincia_id:"ESP08",
               provincia_nombre:"Barcelona",
               comunidad_id:"ESPCAT",
               comunidad_nombre:"Catalunya",
               pais_id:"ESP",
               pais_nombre:"España",
               oficial:"Y",
               portal_min:1,
               portal_max:9998,
               puntuacio:1.9,
               coord:"41.395706,2.1569269",
               _version_:1645646071517413400,
               score:112.967384
            }
         },
         {
            id:"STESP607177",
            calle_id:"ESP080193000002900",
            calle_descripcion:"Avinguda Diagonal / Rambla del Poblenou",
            calle_nombre:"Poblenou",
            calle_tipo:"Rambla",
            calle_articulo:"del",
            localidad_id:"ESP17240008430951",
            localidad_nombre:"Barcelona",
            municipio_id:"ESP080193",
            municipio_nombre:"Barcelona",
            provincia_id:"ESP08",
            provincia_nombre:"Barcelona",
            comunidad_id:"ESPCAT",
            comunidad_nombre:"Catalunya",
            pais_id:"ESP",
            pais_nombre:"España",
            oficial:"Y",
            portal_min:1,
            portal_max:227,
            puntuacio:1.9,
            coord:"41.405388,2.1957703",
            _version_:1645646052257169400,
            score:80.742424,
            intersection:{
               id:"STESP853564",
               calle_id:"ESP080193000092155",
               calle_descripcion:"Avinguda Diagonal",
               calle_nombre:"Diagonal",
               calle_tipo:"Avinguda",
               localidad_id:"ESP17240008430951",
               localidad_nombre:"Barcelona",
               municipio_id:"ESP080193",
               municipio_nombre:"Barcelona",
               provincia_id:"ESP08",
               provincia_nombre:"Barcelona",
               comunidad_id:"ESPCAT",
               comunidad_nombre:"Catalunya",
               pais_id:"ESP",
               pais_nombre:"España",
               oficial:"Y",
               portal_min:1,
               portal_max:9998,
               puntuacio:1.9,
               coord:"41.405384,2.19577",
               _version_:1645646071517413400,
               score:112.967384
            }
         }
      ]
   }
}

Peticiones geocodificación direcciones

Petición:

Para geocodificar una dirección (obtener las coordenadas exactas de detalle del portal), es necesario recoger los parámetros de respuesta de sugerencias del candidato seleccionado, y lanzar la petición con estos parámetros:

"key"
Clave de seguridad:

  • Para aplicaciones WEB, utilizar la misma KEY que para la API de mapas de Cercalia
  • Para el resto de aplicaciones (servidor, APP, ...), pedir una KEY a Nexus

"ctc"
Código de localidad (campo localidad_id del suggest)

"pcode"
Código postal (campo codigo_postal del suggest)

"stc"
Código de calle (campo calle_id del suggest)

"stnum"
Número de portal (campo portal)

Es obligatorio informar de todos los códigos obtenidos en la respuesta. Es posible que para algunos países no se devuelva el Código Postal.

Ejemplo petición:
http://ws.cercalia.com/suggest/SuggestServlet?key=xxxxxxxxx&ctc=ESP17240207272367&pcode=08007&stc=ESP030149000090298&stnum=17

Respuesta:

La respuesta siempre se devuelve en formato JSON.
La respuesta siempre se devuelve con codificación UTF-8.

La respuesta incluye las coordenadas, en formato geográficas. Ejemplo de respuesta

{
    "response": {
        "coord": {
            "x": 2.166539,
            "y": 41.388577
    },
    "desc": "Rambla de Catalunya, 17 (Barcelona)",
    "housenumber": 17,
    "housenumberText": null,
    "name": "Rambla de Catalunya, 17",
    "postalcode": "08007"
    },
    "responseHeader": {
        "QTime": 0,
        "params": {
            "ctc": "ESP17240008430951",
            "key": "07de1b67aa00baf5f1284298f88132e3914e4fb380fce9d91c815aa372fe67c4",
            "stc": "ESP080193000000807",
            "stnum": "17"
        },
        "status": 0
    }
}

Cruces de calle

Ejemplo: Calle de Diego de León / Velázquez, Madrid (España)

Para este caso, NO es necesario realizar la petición de geocodificación de direcciones (aunque se puede hacer), puesto que la respuesta del servicio de sugerencias ya incorpora la coordenada del cruce de calles.

Peticiones sugerencias Puntos de Interés (POI)

Petición:

Se acepta el método GET y POST.
Los parámetros siempre deben ir codificados en UTF-8.

"key"
Clave de seguridad:

  • Para aplicaciones WEB, utilizar la misma KEY que para la API de mapas de Cercalia
  • Para el resto de aplicaciones (servidor, APP, ...), pedir una KEY a Nexus

"pois"
Enviar siempre "pois" con valor a "1".

"t"
Texto a buscar. Puede contener la calle, número, localidad, código postal, etc. El código postal actúa como limitador: en caso de no encontrar coincidencias amplía la búsqueda a todo el municipio perteneciente al CP.

"nofuzzy"
Para no utilizar fuzzy (búsqueda de palabras similares). Utilizar los valores "Yes","Y" o "1".

Filtros opcionales:

  • ctryc: código de país (ej: ESP,FRA)
  • regc: código de región - comunidad (ej: ESPMAD,ESPCAT)
  • subregc: código de subregión - provincia (ej:ESP08,EPS28)
  • munc: código de municipio (ej: ESP080193,ESP280796)
  • rsc: código de municipio / región / subregión / país (substituye munc, subregc , regc y ctryc). Ej: ESP,ESPMAD,ESP08,ESP410917
  • rscp: código de municipio / región / subregión / país preferido. Este filtro, prioriza los resultados que se encuentren en las regiones especificadas, por encima del resto de candidatos, llenando la lista de sugerencias con los candidatos de la región /es priorizadas (siempre que encuentre candidatos), pero no elimina los resultados del resto de regiones o países. Este filtro se puede combinar con el filtro "rsc", para obtener un filtro máximo de resultados más allá de los preferidos. Ej: ESPVAL
    * rscp1 – rscp2 ...: En caso de necesitar priorizar los candidatos dentro de la lista de regiones preferidas, pueden separarse las regiones por parámetros separados según nivel de prioridad: rscp1: prioridad máxima, rscp2: segundo nivel de prioridad, ...
  • rsclp: código de municipio / región / subregión / país preferido. No compatible con el filtro rscp Este filtro, prioriza de manera más suave que "rscp" los resultados que se encuentren en las regiones especificadas: solo recoge un máximo de 3 candidatos de mayor score de las regiones especificadas, y no elimina los del resto de regiones. Este filtro se puede combinar con el filtro "rsc", para obtener un filtro máximo de resultados más allá de los preferidos. Ej: ESPVAL
    * rsclp1 – rsclp2 ...: En caso de necesitar priorizar los candidatos dentro de la lista de regiones preferidas, pueden separarse las regiones por parámetros separados según nivel de prioridad: rsclp1: prioridad máxima, rsclp2: segundo nivel de prioridad, ...
  • id: código de poi (ej: PESP724009000642061)
  • poicat (*): código de categoría de POI. Lista separada por comas. Ej:
    poicat=C005,C043

     

(*) poicat: en caso de no especificar categorías de POIs, el sistema busca sugerencias únicamente entre las categorías marcadas por defecto en la tabla de categorías. En caso de querer buscar en todas las categorías, o unas determinadas, se deben indicar mediante este parámetro.

 

Filtro por radio:

Permite filtrar los resultados por proximidad a un punto (coordenada). Se trata de un filtro restrictivo (solo devuelve candidatos que se encuentren dentro del radio).

  • pt: coordenada "lat,lon"
  • d: distancia radial en kilómetros, por defecto 25 km. El valor mínimo es de 5 km

Ej: pt=40.417025,-3.703505&d=25

Ejemplo de petición:
http://ws.cercalia.com/suggest/SuggestServlet?key=xxxxxxxxxxxx&pois=1&t=Museo%20del%20Prado%20Madrid&ctryc=ESP

Respuesta:

La respuesta siempre se devuelve en formato JSON.
La respuesta siempre se devuelve con codificación UTF-8.

Tipos de elementos devueltos por la API de sugerencias:

  • Si el campo "id" empieza por "P" es un punto de interés (POI).

Listado de categorías de POIs (*):

(*) poicat: en caso de no especificar categorías de POIs, el sistema busca sugerencias únicamente entre las categorías marcadas por defecto en la tabla de categorías. En caso de querer buscar en todas las categorías, o unas determinadas, se deben indicar mediante este parámetro.

CÓDIGO DESCRIPCIÓN INCLUIDO EN BÚSQUEDA POR DEFECTO

C012

Administración pública

SI

C005

Aeropuerto

SI

C037

Atracción turística importante

SI

C023

Camping

SI

C036

Casino

SI

C010

Centro comercial

SI

C043

Centro de convenciones

SI

D00ESC

Escuela

SI

C004

Estación de ferrocarril

SI

C015

Estadio / centro deportivo

SI

C046

Campo de golf

SI

C009

Hospital / Clínica

SI

C013

Hotel

SI

C030

Museo

SI

C112

Parada de transporte público, sin categorizar

SI

C045

Parque de atracciones

SI

C044

Puerto deportivo

SI

C031

Teatro

SI

C016

Acceso aeropuerto

SI

C006

Terminal de Ferry

SI

C027

Universidad

SI

C048

Zoo

SI

C076

Bed & Breakfast

SI

C047

Biblioteca

SI

D00CAP

Centro de Asistencia Primaria (solo España)

SI

C032

Centro de deportes

SI

C025

Cine

SI

C070

Estación de esquí

SI

C110

Industria

SI

C035

Lugar de culto

SI

C107

Mercado

SI

C041

Ópera

SI

C074

Parque acuático

SI

C072

Parque botánico

SI

C075

Parque de fauna salvaje

SI

C039

Parque y área recreativa

SI

C038

Pista de patinaje sobre hielo

SI

C022

Playa

SI

C050

Polígono industrial

SI

C077

Resort hotelero

SI

C042

Sala de conciertos

SI

C079

Aeropuerto militar

 

C105

Alquiler de vehículos

 

C007

Aparcamiento

 

C108

Aparcamiento para camiones

 

C002

Área de aparcamiento & descanso

 

C003

Área de servicio

 

C106

Banco

 

C080

Campo de aviación

 

C029

Centro de información turística

 

C033

Comisaría de policía

 

C018

Embajada

 

C026

Farmacia

 

C001

Gasolinera

 

D00GUA

Guarderías (España)

 

C109

Lavado de vehículos

 

C049

Metro

 

C040

Palacio de justicia

 

C083

Parada de autocar

 

C081

Parada de BUS interurbano

 

C051

Parada de tranvía

 

D00BUS

Paradas de BUS urbano

 

C111

Parquing alquiler vehículos

 

C019

Paso fronterizo

 

C020

Pico de montaña

 

C034

Piscina

 

C017

Puerto de montaña

 

D104

Puntos de recarga vehículos eléctricos

 

C014

Restaurante

 

C078

Supermercado & Hypermercado

 

C028

Taller mecánico

 

D00TRA

Tranvías (España)

 

C056

Venta de coches

 

 

Ejemplo de respuesta:

{
   responseHeader:{
      status:0,
      QTime:23,
      params:{
         ctryc:"ESP",
         key:"07de1b67aa00baf5f1284298f88132e3914e4fb380fce9d91c815aa372fe67c4",
         pois:"1",
         t:"Museo del Prado Madrid"
      }
   },
   response:{
      numFound:3,
      start:0,
      maxScore:26.154898,
      docs:[
         {
            id:"PESP724009001959912",
            categoria_id:"C037",
            poi_nombre:"Museo Nacional del Prado",
            codigo_postal:"28014",
            localidad_nombre:"Madrid",
            municipio_id:"ESP280796",
            municipio_nombre:"Madrid",
            provincia_id:"ESP28",
            provincia_nombre:"Madrid",
            comunidad_id:"ESPMAD",
            comunidad_nombre:"Comunidad de Madrid",
            pais_id:"ESP",
            pais_nombre:"España",
            direccion:"Paseo del Prado, 28014 Madrid",
            calle_descripcion:"Paseo del Prado",
            puntuacio:1,
            coord:"40.414856,-3.6925297",
            lang:"SPA",
            _version_:1645647790034911200,
            score:26.154898
         },
         {
            id:"PESP724009000642061",
            categoria_id:"C030",
            poi_nombre:"Museo del Prado",
            codigo_postal:"28014",
            localidad_nombre:"Madrid",
            municipio_id:"ESP280796",
            municipio_nombre:"Madrid",
            provincia_id:"ESP28",
            provincia_nombre:"Madrid",
            comunidad_id:"ESPMAD",
            comunidad_nombre:"Comunidad de Madrid",
            pais_id:"ESP",
            pais_nombre:"España",
            direccion:"Paseo del Prado, 28014 Madrid",
            calle_descripcion:"Paseo del Prado",
            tel:"+(34)-(913)-302800",
            mail:"[email protected]",
            web:"www.museoprado.mcu.es",
            puntuacio:0.9,
            coord:"40.413776,-3.6924677",
            lang:"SPA",
            _version_:1645647790035959800,
            score:23.539408
         },
         {
            id:"PESPLU01N2945",
            categoria_id:"LU01",
            poi_nombre:"Jardines del Museo del Prado",
            localidad_nombre:"Madrid",
            municipio_id:"ESP280796",
            municipio_nombre:"Madrid",
            provincia_id:"ESP28",
            provincia_nombre:"Madrid",
            comunidad_id:"ESPMAD",
            comunidad_nombre:"Comunidad de Madrid",
            pais_id:"ESP",
            pais_nombre:"España",
            puntuacio:0.8,
            coord:"40.414196,-3.6926923",
            _version_:1645647795570344000,
            score:20.923918
         }
      ]
   }
}

Error

Si "status" es 0, la respuesta es correcta.

Respuesta de error: cuando "status" diferente a 0.

{
   "responseHeader":{
      "QTime":0,
      "params":{
         "key":"______",
         "ctryc":"esp",
         "ctc":"ESP17240205556728",
         "stc":"ESP170792000090959",
         "stnum":"17"
      },
      "status":1
   },
   "error":{
      "code":1,
      "msg":"FileNotFoundException: http://ws.cercalia.com/cercalia_lbs/server?cmd=cand&detcand=1&clientid=___&ctc=ESP17240205556728&ctryc=esp&stc=ESP170792000090959&stnum=17"
   }
}

Opcional: utilizar corchetes para diferenciar la localidad del resto de la dirección

Petición:

Parámetros de la petición:

"t" = Texto a buscar. Puede contener la dirección (calle, número, código postal). Y en este caso el nombre de localidad esta entre corchetes cuadrados al final del texto. Se ignorará la parte que vaya después de la localidad.

Es importante tener en cuenta que utilizando este sistema de búsqueda se tiene que incluir solo la dirección y la población, puesto que busca concordancias solo en los campos de calle y localidad.

Ejemplo:

  • Calle de Barcelona 16 [Madrid]   ->  &t=Calle+de+Barcelona+16,%20%5BMadrid%5D
  • Calle de Barcelona 16, 28012 [Madrid]   ->  t=Calle+de+Barcelona+16,%2028012%20%5BMadrid%5D

El resto de parámetros son iguales a las peticiones anteriores de sugerencias.

Respuesta:

Igual al resto de las peticiones anteriores de sugerencias.