Skip to main content

Servicios Web

Entornos 

La API de Clima Local está disponible en los siguientes entornos:

Ambiente URL
Pruebas https://test-aplicaciones.tamaulipas.gob.mx/srv-clima/
Producción No disponible actualmente
Endpoints de la API

Todos los endpoints están disponibles bajo el prefijo:
/api/v1/

Enpoints disponibles
Método Endpoint Descripción
GET /api/v1/clima-actual Consulta el clima actual por coordenadas geográficas.
GET /api/v1/clima-pronostico Consulta el pronóstico del clima para los próximos días.

 


📡 GET /api/v1/clima-actual

Descripción

Consulta el clima actual en función de las coordenadas geográficas proporcionadas. Utiliza los datos más recientes disponibles en la base de datos local.

Parámetros esperados (query string)

Parámetro Tipo Requerido Descripción
latitud float Sí Latitud en formato decimal.
longitud float Sí Longitud en formato decimal.

Ejemplo de petición

GET /api/v1/clima-actual?latitud=23.731100&longitud=-99.151300

Ejemplo de respuesta exitosa (200 OK)

{
  "error": false,
  "status": 200,
  "message": "Clima actual obtenido correctamente.",
  "data": {
    "id_estado": 28,
    "id_municipio": 41,
    "nombre_estado": "Tamaulipas",
    "nombre_municipio": "Victoria",
    "dia_local": "2025-06-24 00:00:00",
    "numero_dia": 0,
    "temperatura_maxima_c": "31.70",
    "temperatura_minima_c": "18.90",
    "descripcion_cielo": "Poco nuboso",
    "probabilidad_precipitacion_porcentaje": 50,
    "precipitacion_litros_m2": "14.70",
    "velocidad_viento_kmh": "10.60",
    "direccion_viento_cardinal": "Sureste",
    "direccion_viento_grados": "135.00",
    "cobertura_nubes_porcentaje": "7.75",
    "latitud": "23.731100",
    "longitud": "-99.151300",
    "diferencia_utc": 6
  },
  "metadata": {
    "Organization": "Agencia de Innovación e Inteligencia Digital de Tamaulipas",
    "Department": "Departamento de Desarrollo de Soluciones Informáticas"
  }
}

 

 

🌦️ GET /api/v1/clima-pronostico

Descripción

Devuelve el pronóstico del clima para los próximos días en la ubicación indicada. La información se obtiene de registros meteorológicos precargados en una base de datos local.

Parámetros esperados (query string)

Parámetro Tipo Requerido Descripción
latitud float Sí Latitud en formato decimal.
longitud float Sí Longitud en formato decimal.

Ejemplo de petición

GET /api/v1/clima-pronostico?latitud=23.731100&longitud=-99.151300

Ejemplo de respuesta exitosa (200 OK)

{
  "error": false,
  "status": 200,
  "message": "Clima obtenido correctamente.",
  "data": [
    {
      "id_estado": 28,
      "id_municipio": 41,
      "nombre_estado": "Tamaulipas",
      "nombre_municipio": "Victoria",
      "dia_local": "2025-06-24 00:00:00",
      "numero_dia": 0,
      "temperatura_maxima_c": "31.70",
      "temperatura_minima_c": "18.90",
      "descripcion_cielo": "Poco nuboso",
      "probabilidad_precipitacion_porcentaje": 50,
      "precipitacion_litros_m2": "14.70",
      "velocidad_viento_kmh": "10.60",
      "direccion_viento_cardinal": "Sureste",
      "direccion_viento_grados": "135.00",
      "cobertura_nubes_porcentaje": "7.75",
      "latitud": "23.731100",
      "longitud": "-99.151300",
      "diferencia_utc": 6
    },
    {
      "id_estado": 28,
      "id_municipio": 41,
      "nombre_estado": "Tamaulipas",
      "nombre_municipio": "Victoria",
      "dia_local": "2025-06-25 00:00:00",
      "numero_dia": 1,
      "temperatura_maxima_c": "31.60",
      "temperatura_minima_c": "19.30",
      "descripcion_cielo": "Medio nublado",
      "probabilidad_precipitacion_porcentaje": 0,
      "precipitacion_litros_m2": "0.90",
      "velocidad_viento_kmh": "11.60",
      "direccion_viento_cardinal": "Sur",
      "direccion_viento_grados": "180.00",
      "cobertura_nubes_porcentaje": "63.76",
      "latitud": "23.731100",
      "longitud": "-99.151300",
      "diferencia_utc": 6
    },
    {
      "id_estado": 28,
      "id_municipio": 41,
      "nombre_estado": "Tamaulipas",
      "nombre_municipio": "Victoria",
      "dia_local": "2025-06-26 00:00:00",
      "numero_dia": 2,
      "temperatura_maxima_c": "31.10",
      "temperatura_minima_c": "19.20",
      "descripcion_cielo": "Medio nublado",
      "probabilidad_precipitacion_porcentaje": 10,
      "precipitacion_litros_m2": "1.60",
      "velocidad_viento_kmh": "8.80",
      "direccion_viento_cardinal": "Sureste",
      "direccion_viento_grados": "135.00",
      "cobertura_nubes_porcentaje": "60.21",
      "latitud": "23.731100",
      "longitud": "-99.151300",
      "diferencia_utc": 6
    },
    {
      "id_estado": 28,
      "id_municipio": 41,
      "nombre_estado": "Tamaulipas",
      "nombre_municipio": "Victoria",
      "dia_local": "2025-06-27 00:00:00",
      "numero_dia": 3,
      "temperatura_maxima_c": "31.80",
      "temperatura_minima_c": "19.00",
      "descripcion_cielo": "Cielo nublado",
      "probabilidad_precipitacion_porcentaje": 10,
      "precipitacion_litros_m2": "1.40",
      "velocidad_viento_kmh": "9.60",
      "direccion_viento_cardinal": "Sureste",
      "direccion_viento_grados": "135.00",
      "cobertura_nubes_porcentaje": "32.28",
      "latitud": "23.731100",
      "longitud": "-99.151300",
      "diferencia_utc": 6
    }
  ],
  "metadata": {
    "Organization": "Agencia de Innovación e Inteligencia Digital de Tamaulipas",
    "Department": "Departamento de Desarrollo de Soluciones Informáticas"
  }
}

 

Back to top