Coordenadas con una dirección de referencia.
Añade contexto legible a una latitud y longitud sin cambiar las coordenadas originales que necesita tu aplicación.
Crea tu API keycurl "https://maps-api.nexode.app/v1/reverse?lat=-12.119906&lng=-77.028971" \ -H "X-API-Key: TU_API_KEY"
Permiso de la clave: reverse. Cada petición admitida consume una unidad del plan.
Qué es la geocodificación inversa
La geocodificación inversa convierte unas coordenadas en una referencia de dirección. Sirve para mostrar un texto junto a un pin, contextualizar una visita o ayudar a una persona a reconocer una ubicación guardada. Mapora consulta Photon/OpenStreetMap para encontrar información cercana; no identifica necesariamente una puerta o un predio exacto.
El punto original y la coincidencia
Envía lat y lng; también se admite lon como nombre alternativo de la longitud. latitude y longitude en la respuesta conservan el punto solicitado. Cuando existe una coincidencia, matchedLatitude y matchedLongitude describen el punto del proveedor utilizado como referencia. Esta distinción evita que una búsqueda de dirección mueva silenciosamente una ubicación elegida por tu usuario.
Datos disponibles y casos sin cobertura
La respuesta normalizada puede incluir placeName, address, streetAddress, ciudad, región y país, según los datos disponibles. La cobertura puede ser incompleta o distinta entre zonas. Si el proveedor no encuentra una dirección o no responde a tiempo, el endpoint devuelve un error; tu interfaz debe poder conservar las coordenadas y ofrecer reintentar. Para un enlace de Google Maps con dirección opcional, utiliza el flujo de resolución de enlaces.
Consumo y caché
Las peticiones admitidas consumen una unidad del plan, incluidas las respuestas desde caché y los errores del proveedor. Una consulta repetida puede aprovechar la caché, pero eso no cambia su contabilización. No uses esta operación para validar domicilios, comprobar presencia física ni sustituir la confirmación de una persona cuando tu proceso requiera precisión adicional.
Autenticación, cuotas y errores
Envía la clave en X-API-Key o Authorization: Bearer. HTTP 401 indica una clave ausente o inválida; 403, falta de permiso o cuenta suspendida; 429, cuota o velocidad excedida. Consulta las cabeceras de cuota y respeta Retry-After. El panel muestra tu plan y consumo real.