get/public/v2/location/enrichAPI pública

Añade país, ciudad, localidad, barrio y señales cercanas en una sola llamada.

Enriquecer ubicación

Resuelve contexto administrativo y urbano a partir de una dirección o un par de coordenadas.

La disponibilidad de cada capa depende de la cobertura geográfica publicada.

AudienciaIntegradores y productos externos

AutenticaciónAPI key

EstabilidadContrato público versionado

Cuándo usarlo

Perfil territorial

Validación de direcciones

Contexto para scoring

Comportamiento

Recibe una dirección o coordenadas. Las direcciones se geocodifican con Google Maps; después se resuelven país, ciudad, localidad y barrio, junto con capas urbanas cercanas.

API key requerida

Envía tu clave en X-Api-Key o Authorization: Bearer. No expongas la credencial en código cliente público.

Parámetros de la solicitud

Campos definidos por el contrato OpenAPI.

address

query·anyOf

Dirección libre. No se combina con latitude/longitude.

latitude

query·anyOf

Sin descripción adicional.

longitude

query·anyOf

Sin descripción adicional.

radius_m

query·number

Distancia máxima para devolver elementos cercanos.

limit_per_layer

query·integer

Máximo de elementos devueltos por categoría y sistema.

Respuestas

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

200Successful Response

{
  "administrative": {
    "city": "…",
    "city_id": "…",
    "country": "…",
    "country_code": "…",
    "locality": "…",
    "locality_id": "…",
    "neighborhood": "…",
    "neighborhood_id": "…"
  },
  "enriched_at": "2024-01-01T00:00:00Z",
  "layers": [
    {
      "category": {},
      "counts": "…",
      "label": {},
      "nearby": [],
      "nearest": "…",
      "system": {}
    }
  ],
  "location": {
    "formatted_address": "…",
    "geocoding_provider": "…",
    "input_address": "…",
    "input_type": "string",
    "latitude": 42,
    "longitude": 42
  },
  "search_radius_m": 42
}

422Validation Error

{
  "detail": [
    {
      "ctx": {},
      "input": {},
      "loc": [],
      "msg": {},
      "type": {}
    }
  ]
}