get/public/v2/geocoding/placesAPI pública

Reduce errores de captura antes de consultar datos inmobiliarios.

Buscar lugares

Convierte texto libre en candidatos de ubicación consistentes para direcciones, barrios, ciudades y puntos de interés.

Los resultados son candidatos; confirma la selección del usuario antes de guardar coordenadas.

AudienciaIntegradores y productos externos
AutenticaciónSin API key
EstabilidadContrato público versionado

Cuándo usarlo

Autocomplete
Normalización de direcciones
Selección de ciudad

Comportamiento

Búsqueda de lugares para autocompletar direcciones, barrios, ciudades o puntos de interés.

  • Devuelve hasta 5 candidatos de ubicación (Google Maps Geocoding API).
  • Requiere GOOGLE_MAPS_API_KEY en el servidor; el cliente no envía clave.
  • Uso típico: autocompletado de direcciones o ciudades en el cliente.

Acceso sin credenciales

Puedes probar este recurso directamente; aplica límites de uso razonable y disponibilidad del servicio.

Parámetros de la solicitud

Campos definidos por el contrato OpenAPI.

qRequerido
query·string

Consulta de texto (dirección, barrio, ciudad, punto de interés).

Respuestas

Estados públicos del contrato y estructura de cada respuesta JSON.

200Lista de candidatos de ubicación.
{}
422Validation Error
{
  "detail": [
    {
      "ctx": {},
      "input": {},
      "loc": [],
      "msg": {},
      "type": {}
    }
  ]
}