Normaliza una dirección.

GET

/direcciones

curl --request GET \
  --url 'https://apis.datos.gob.ar/georef/api/direcciones?direccion=Urquiza%20400&provincia=Santa%20Fe&departamento=Rosario&localidad_censal=Granadero%20Baigorria&localidad=Granadero%20Baigorria&orden=id&aplanar=true&campos=estandar&max=10&inicio=0&exacto=true&formato=json'

Permite normalizar una dirección utilizando el listado de vías de circulación.

Parameters

Query Parameters

direccion

required

string

>= 1 characters

Example

Urquiza 400

Dirección a normalizar. No debe incluir datos de localidad.

provincia

string

>= 1 characters

Example

Santa Fe

Filtrar por nombre o ID de provincia. Se pueden especificar varios IDs separados por comas.

departamento

string

>= 1 characters

Example

Rosario

Filtrar por nombre o ID de departamento. Se pueden especificar varios IDs separados por comas.

localidad_censal

string

>= 1 characters

Example

Granadero Baigorria

Filtrar por nombre o ID de localidad censal. Se pueden especificar varios IDs separados por comas.

localidad

string

>= 1 characters

Example

Granadero Baigorria

Filtrar por nombre o ID de localidad. Se pueden especificar varios IDs separados por comas.

orden

string

Allowed values: id nombre

Campo por el cual ordenar los resultados.

aplanar

Example

true

Cuando está presente, muestra el resultado JSON con una estructura plana.

campos

string

>= 1 characters

Example

estandar

Campos a incluir en la respuesta separados por comas, sin espacios. Algunos campos siempre serán incluidos, incluso si no se agregaron en la lista. Para incluir campos de sub-entidades, separar los nombres con un punto, por ejemplo: provincia.id. También se pueden especificar los valores especiales basico, estandar y completo.

max

integer

>= 1 <= 5000

Example

10

Cantidad máxima de resultados a devolver.

inicio

integer

<= 10000

Example

0

Cantidad de resultados a saltear.

exacto

Example

true

Cuando está presente, se activa el modo de búsqueda por texto exacto. Sólo tiene efecto cuando se usan campos de búsqueda por texto (por ejemplo, nombre).

formato

string

Allowed values: json csv geojson xml

Formato de datos en el cual devolver los resultados.

Responses

200

Listado de direcciones normalizadas.

Media typeapplication/json

object

cantidad

integer

total

integer

inicio

integer

parametros

object

direcciones

Array<object>

object

altura

object

valor

integer

unidad

string

calle

object

id

string

nombre

string

categoria

string

calle_cruce_1

object

id

string

nombre

string

categoria

string

calle_cruce_2

object

id

string

nombre

string

categoria

string

piso

string

nomenclatura

string

ubicacion

object

lat

number

lon

number

provincia

object

id

string

nombre

string

departamento

object

id

string

nombre

string

localidad_censal

object

id

string

nombre

string

categoria

string

Example

{
  "cantidad": 10,
  "total": 28,
  "inicio": 0,
  "parametros": {},
  "direcciones": [
    {
      "altura": {
        "valor": 400,
        "unidad": "Nro."
      },
      "calle": {
        "id": "8208416001280",
        "nombre": "URQUIZA"
      },
      "nomenclatura": "URQUIZA 400, Rosario, Santa Fe",
      "ubicacion": {
        "lat": -32.932417,
        "lon": -60.688217
      },
      "provincia": {
        "id": "82",
        "nombre": "Santa Fe"
      },
      "departamento": {
        "id": "82084",
        "nombre": "Rosario"
      },
      "localidad_censal": {
        "id": "82084160",
        "nombre": "Granadero Baigorria"
      },
      "categoria": "CALLE"
    }
  ]
}

400

Error al procesar la consulta.

Media typeapplication/json

object

errores

Array<object>

object

codigo_interno

integer

mensaje

string

nombre_parametro

string

ubicacion

string

Example

{
  "errores": [
    {
      "codigo_interno": 1000,
      "mensaje": "El parámetro especificado no existe.",
      "nombre_parametro": "prueba",
      "ubicacion": "querystring"
    }
  ]
}