Endpoints Geogr\u00e1ficos¶

Endpoints para acceder a los datos de la jerarqu\u00eda geogr\u00e1fica: pa\u00edses, divisiones administrativas (Admin1, Admin2) y estaciones meteorol\u00f3gicas/ubicaciones.

Pa\u00edses¶

Listar todos los pa\u00edses¶

GET /countries

Retorna todos los pa\u00edses habilitados con id, nombre y c\u00f3digo iso2.

Respuesta:

[
  { "id": 1, "name": "COLOMBIA", "iso2": "CO" },
  { "id": 2, "name": "PERU", "iso2": "PE" }
]

Obtener pa\u00edses por nombre¶

GET /countries/by-name?name=<name>

Par\u00e1metro	Tipo	Descripci\u00f3n
name	string	Nombre del pa\u00eds a buscar

Nivel Admin 1 (Departamentos / Estados)¶

Obtener por ID de pa\u00eds¶

GET /admin1/by-country-id?country_id=<id>

Par\u00e1metro	Tipo	Descripci\u00f3n
country_id	integer	ID del pa\u00eds

Respuesta:

[
  {
    "id": 1,
    "name": "Putumayo",
    "ext_id": "86",
    "country_id": 3,
    "country_name": "AMAZONIA",
    "country_iso2": "ST"
  }
]

Obtener por nombre¶

GET /admin1/by-name?name=<name>

Nivel Admin 2 (Municipios / Distritos)¶

Obtener por ID de pa\u00eds¶

GET /admin2/by-country-id?country_id=<id>

Obtener por nombre¶

GET /admin2/by-name?name=<name>

Respuesta:

[
  {
    "id": 1,
    "name": "Mocoa",
    "ext_id": "86001",
    "admin1_id": 1,
    "admin1_name": "Putumayo",
    "admin1_ext_id": "86",
    "country_id": 3,
    "country_name": "AMAZONIA",
    "country_iso2": "ST"
  }
]

Ubicaciones (Estaciones Meteorol\u00f3gicas)¶

Obtener por ID¶

GET /locations/by-id?id=<id>

Obtener por nombre¶

GET /locations/by-name?name=<name>

Obtener ubicaciones con datos de monitoreo recientes¶

GET /locations/by-country-ids-with-data?country_ids=<ids>&days=<days>

Retorna las ubicaciones con su jerarqu\u00eda administrativa completa y los datos de monitoreo m\u00e1s recientes.

Par\u00e1metro	Tipo	Descripci\u00f3n
country_ids	string	IDs de pa\u00edses separados por comas
days	integer	D\u00edas hacia atr\u00e1s para datos recientes (0 = sin l\u00edmite, m\u00e1x 365)

Respuesta:

{
  "id": 1,
  "name": "CAMPUCANA",
  "ext_id": "44010030",
  "machine_name": "campucana",
  "enable": true,
  "altitude": 1400.0,
  "latitude": 1.2025,
  "longitude": -76.68083333,
  "visible": true,
  "source_id": 1,
  "source_name": "IDEAM",
  "source_type": "observational",
  "admin2_id": 1,
  "admin2_name": "Mocoa",
  "admin1_id": 1,
  "admin1_name": "Putumayo",
  "country_id": 3,
  "country_name": "AMAZONIA",
  "country_iso2": "ST",
  "latest_data": {
    "date": "1996-10-01",
    "measures": [
      {
        "measure_id": 7,
        "measure_name": "Minimum temperature",
        "measure_short_name": "tmin",
        "measure_unit": "\u00b0C",
        "value": 20.71
      }
    ]
  }
}