Retorna un listado de provincias

GET

/provincias

const url = 'https://apis.datos.gob.ar/georef/api/provincias?interseccion=provincia%3A82%2Cdepartamento%3A82084%2Cmunicipio%3A820196&orden=id&aplanar=true&campos=estandar&max=10&inicio=0&exacto=true&formato=json';
const options = {method: 'GET'};

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

curl --request GET \
  --url 'https://apis.datos.gob.ar/georef/api/provincias?interseccion=provincia%3A82%2Cdepartamento%3A82084%2Cmunicipio%3A820196&orden=id&aplanar=true&campos=estandar&max=10&inicio=0&exacto=true&formato=json'

Permite realizar búsquedas sobre el listado de provincias.

Parameters

Query Parameters

string

>= 1 characters

Filtrar por ID. Se pueden especificar varios IDs separados por comas.

nombre

string

>= 1 characters

Filtrar por nombre.

interseccion

string

Example

provincia:82,departamento:82084,municipio:820196

Filtrar por intersección con otras entidades geográficas. El valor del campo debe tener el siguiente formato:

< tipo de entidad A>:<id 1>:<id 2>, < tipo de entidad B>:<id 1>:<id 2>, …

Se incluye en la respuesta cualquier entidad que intereseccione con una o más de las entidades con los IDs especificados.

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

Cantidad máxima de resultados a devolver.

inicio

integer

<= 10000

Example

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 provincias.

application/json

object

cantidad

integer

total

integer

inicio

integer

parametros

object

provincias

Array<object>

object

string

nombre

string

nombre_largo

string

iso_nombre

string

iso_id

string

categoria

string

centroide

object

lat

number

lon

number

Example

{
  "cantidad": 24,
  "total": 24,
  "inicio": 0,
  "parametros": {},
  "provincias": [
    {
      "id": "82",
      "nombre": "Santa Fe",
      "nombre_largo": "Provincia de Santa Fe",
      "iso_nombre": "Santa Fe",
      "iso_id": "AR-S",
      "categoria": "Provincia",
      "centroide": {
        "lat": -30.706927,
        "lon": -60.558832
      }
    }
  ]
}

400

Error al procesar la consulta.

application/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"
    }
  ]
}