Retorna uno o más listados de asentamientos.

POST

/asentamientos

const url = 'https://apis.datos.gob.ar/georef/api/asentamientos';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: '{"asentamientos":[{"id":"example","nombre":"example","provincia":"Santa Fe","departamento":"Rosario","municipio":"Granadero Baigorria","localidad_censal":"Granadero Baigorria","orden":"id","aplanar":true,"campos":"estandar","max":10,"inicio":10,"exacto":true}]}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url https://apis.datos.gob.ar/georef/api/asentamientos \
  --header 'Content-Type: application/json' \
  --data '{ "asentamientos": [ { "id": "example", "nombre": "example", "provincia": "Santa Fe", "departamento": "Rosario", "municipio": "Granadero Baigorria", "localidad_censal": "Granadero Baigorria", "orden": "id", "aplanar": true, "campos": "estandar", "max": 10, "inicio": 10, "exacto": true } ] }'

Permite realizar varias búsquedas sobre el listado de asentamientos BAHRA en simultáneo.

Request Body

Consultas en formato JSON.

application/json

object

asentamientos

required

Array<object>

>= 1 items

object

string

>= 1 characters

nombre

string

>= 1 characters

provincia

string

>= 1 characters

Example

Santa Fe

departamento

string

>= 1 characters

Example

Rosario

municipio

string

>= 1 characters

Example

Granadero Baigorria

localidad_censal

string

>= 1 characters

Example

Granadero Baigorria

orden

string

Allowed values: id nombre

aplanar

Example

true

campos

string

>= 1 characters

Example

estandar

max

integer

>= 1 <= 5000

Example

inicio

integer

>= 1 <= 5000

Example

exacto

Example

true

Responses

200

Listados de asentamientos.

application/json

object

resultados

Array<object>

object

cantidad

integer

total

integer

inicio

integer

parametros

object

asentamientos

Array<object>

object

departamento

object

string

nombre

string

nombre

string

provincia

object

string

nombre

string

municipio

object

string

nombre

string

localidad_censal

object

string

nombre

string

categoria

string

Allowed values: Entidad (E) Componente de localidad compuesta (LC) Localidad simple (LS) Localidad simple con entidad (LSE) Componente de localidad compuesta con entidad (LCE) Sitio edificado (ST)

centroide

object

lat

number

lon

number

Example

{
  "resultados": [
    {
      "cantidad": 10,
      "total": 13555,
      "inicio": 0,
      "parametros": {},
      "asentamientos": [
        {
          "departamento": {
            "id": "82084",
            "nombre": "Rosario"
          },
          "id": "82084000012",
          "nombre": "El Prado",
          "provincia": {
            "id": "82",
            "nombre": "Santa Fe"
          },
          "municipio": {
            "id": "820196",
            "nombre": "Granadero Baigorria"
          },
          "localidad_censal": {
            "id": "82084160",
            "nombre": "Granadero Baigorria"
          },
          "categoria": "Entidad (E)",
          "centroide": {
            "lat": -32.861364,
            "lon": -60.706216
          }
        }
      ]
    }
  ]
}

400

Error al procesar las consultas.

application/json

object

errores

Array<Array<object>>

Example

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