Buscar colonias de México por nombre
La gente recuerda el nombre de su colonia. Casi nunca recuerda su código postal. Esta es la consulta que corre en esa dirección: escribes parte del nombre de una colonia y obtienes todas las coincidencias del país con el código, el municipio y el estado.
Cuando tienes el nombre y no el número
Hay dos situaciones que llevan a esto, y por fuera no se parecen en nada.
-
Un formulario con el campo de código postal vacío.
Alguien está capturando una dirección que conoce de vista y no por papeles. Déjalo empezar por la colonia y rellénale el código, en vez de mandarlo a buscarlo y perder la venta.
-
Una tabla de direcciones que alguien capturó hace años.
Los registros heredados de clientes casi siempre guardaron un nombre de colonia y nada con qué relacionarlo. Volver a emparejar esos nombres con colonias reales es como le pones un código postal a filas que nunca lo tuvieron.
Entra parte del nombre, salen las coincidencias
El mínimo son dos caracteres, suficiente para mover un autocompletado sin pedirle al catálogo entero todo lo que empiece con A.
Solicitud
curl -H "Authorization: Bearer YOUR_API_KEY" \ "https://api.postalkit.mx/v1/settlements?q=Polanco&page=1"
Respuesta
{
"data": [
{
"id": 8421,
"name": "Polanco I Sección",
"type": "Colonia",
"postal_code": "11510",
"municipality": "Miguel Hidalgo",
"state": "Ciudad de México"
}
],
"links": { "first": "...", "last": "...", "prev": null, "next": "..." },
"meta": { "current_page": 1, "total": 6, "per_page": 20 }
}
Cada coincidencia trae su propio municipio y estado. Eso no es relleno: es lo único que hace utilizable el resultado, porque un nombre de colonia por sí solo no identifica un lugar.
Antes de publicarlo
Emparejar nombres en México no es un problema resuelto
-
«Centro» no es un solo lugar.
Los nombres comunes se repiten entre estados, y una búsqueda por uno de ellos va a devolver muchos. Nunca tomes el primer resultado. Este endpoint recibe un nombre y nada más, así que o muestras el municipio y el estado en el selector y dejas que una persona elija, o —cuando ya sabes el estado— usas mejor la búsqueda geográfica, que filtra por estado, municipio y colonia a la vez.
-
Los resultados vienen paginados, de veinte en veinte.
El bloque meta trae el total real. Un autocompletado que solo lee la primera página está bien; un proceso de limpieza de datos que hace lo mismo descarta en silencio la mayoría de sus candidatos.
-
El catálogo escribe los nombres como los escribe SEPOMEX.
Con acentos, y con las abreviaturas desarrolladas. Tus filas heredadas casi seguro no hacen ninguna de las dos cosas, así que cuenta con emparejar sobre una forma normalizada de lo que tienes y no sobre la cadena tal cual.
-
Guarda el id, no el nombre.
Una vez que una persona eligió la colonia correcta, quédate con su id. Sobrevive a la actualización mensual, y significa que nunca vuelves a correr esta búsqueda sobre el mismo registro.