POST AI agent ready /v1/geo/geocode

API de codificación geográfica: convertir dirección a coordenadas de latitud/longitud

Envíe una cadena de dirección (calle, nombre de ciudad, punto de referencia o código postal) y reciba la latitud, longitud, nombre para mostrar y tipo de ubicación correspondientes. Desarrollado por el servicio OpenStreetMap Nominatim. Admite direcciones mundiales en cualquier idioma.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/geo/geocode \
  -H "Content-Type: application/json" \
  -d '{"address":"1600 Amphitheatre Parkway, Mountain View, CA"}'

When to use this API

Convierta direcciones ingresadas por usuarios en pines de mapa en su aplicación

Cuando un usuario escribe una dirección en un formulario, la geocodifica y coloca un marcador en el mapa. Esto reemplaza la necesidad de una API de codificación geográfica de Google Maps paga en muchos casos de uso.

Enriquezca sus registros de CRM o base de datos con coordenadas

Geocodifique por lotes las direcciones de los clientes para agregar campos de latitud/longitud. Utilice las coordenadas para búsquedas de proximidad, cálculos de zonas de entrega o informes geográficos.

Frequently asked questions

¿Qué proveedor de codificación geográfica impulsa este punto final?

OpenStreetMap Nominatim. Los resultados reflejan la calidad de los datos de OpenStreetMap, que es sólida en la mayoría de los países, pero puede ser menos detallada en áreas rurales o en desarrollo.

¿Este punto final admite direcciones que no estén en inglés?

Sí. Nominatim admite direcciones en la mayoría de los idiomas y escrituras. Puedes enviar direcciones en japonés, árabe, cirílico o cualquier idioma admitido por OpenStreetMap.

¿Qué pasa si la dirección es ambigua o no se encuentra?

Si ningún resultado coincide, la API devuelve un error 404 NOT_FOUND. Para direcciones ambiguas, la API devuelve la mejor coincidencia. Sea lo más específico posible (incluya ciudad, estado, país) para una mayor precisión.

¿Existe un límite de tasa para las solicitudes de geocodificación?

El acceso anónimo permite 5 solicitudes por minuto. Con una clave API, el límite de tarifa lo determina su plan. El propio Nominatim tiene una política de 1 solicitud/segundo, que este punto final respeta.

¿Puedo geocodificar direcciones IP con este punto final?

No. Este punto final convierte direcciones de calles en coordenadas. Para la geolocalización de IP, utilice el punto final /v1/ip/lookup.

Get your API key

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