Ir al contenido
POST AI agent ready /v1/geo/reverse

API de codificación geográfica inversa: conversión de latitud/longitud en dirección

Envíe un par de latitud y longitud y reciba la dirección, ciudad, país y nombre para mostrar correspondientes. Desarrollado por el servicio OpenStreetMap Nominatim. Útil para convertir coordenadas GPS de dispositivos, datos EXIF ​​de fotografías o clics en mapas en ubicaciones legibles.

Parameters

numberrequired

Latitude in decimal degrees (-90 to 90).

numberrequired

Longitude in decimal degrees (-180 to 180).

Code examples

curl -X POST https://api.botoi.com/v1/geo/reverse \
  -H "Content-Type: application/json" \
  -d '{"lat":37.4224,"lng":-122.0842}'

When to use this API

Mostrar una dirección legible cuando los usuarios colocan un marcador en un mapa

Cuando un usuario toca una ubicación en su mapa, envía las coordenadas a este punto final y muestra la dirección de la calle en una información sobre herramientas o barra lateral. Evita que los usuarios tengan que escribir la dirección manualmente.

Etiquetar fotografías con nombres de ubicación a partir de datos EXIF ​​​​GPS

Extraiga lat/lng de los metadatos EXIF ​​de la foto y realice una geocodificación inversa. Muestre "Tomada en Mountain View, California" en lugar de coordenadas sin procesar en su galería de fotos.

Enriquezca los datos de seguimiento de flotas con direcciones postales

Convierta coordenadas GPS de rastreadores de vehículos en direcciones postales para registros de despacho, confirmaciones de entrega e informes de ruta.

Frequently asked questions

¿Qué datos incluye la respuesta?
La respuesta incluye el nombre para mostrar completo (dirección calle), un campo de dirección más corto, ciudad, país y la latitud/longitud original. El nivel de detalle depende de la cobertura de OpenStreetMap para la ubicación.
¿Qué sucede si las coordenadas están en el océano o en un área no cartografiada?
La API devuelve un error 404 NOT_FOUND si Nominatim no puede encontrar una dirección para las coordenadas dadas. Es posible que el océano abierto, la naturaleza remota y la Antártida no tengan datos de dirección.
¿Qué tan precisos son los resultados?
La precisión depende de la densidad de datos de OpenStreetMap para el área. En las ciudades, normalmente se obtiene una precisión a nivel de edificio. En las zonas rurales, los resultados pueden resolverse hasta la carretera o el pueblo más cercano.
¿Puedo codificar geográficamente varias coordenadas en una sola solicitud?
No. Cada solicitud maneja un único par de coordenadas. Para el procesamiento por lotes, realice solicitudes paralelas. Respete el límite de velocidad de Nominatim de 1 solicitud/segundo para acceso anónimo.
¿Este punto final es gratuito?
Sí. El acceso anónimo permite 5 solicitudes por minuto. Una clave API aumenta el límite de tarifa según el nivel de su plan. No hay cargos por solicitud.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.

Sign up free View full docs