Análisis de Calidad del Suelo

Endpoint

Ruta: https://us-central1-totemfunctions.cloudfunctions.net/soilQualityAnalysis
Método: POST

Descripción

Este endpoint realiza un análisis detallado de la calidad del suelo utilizando datos proporcionados. La función evalúa diferentes parámetros del suelo y genera recomendaciones para mejorar su calidad y optimizar el uso agrícola.

Solicitud (Request)

Ejemplo de Cuerpo de Solicitud (JSON)

{
    "uid": "user123",
    "soilData": {
        "pH": 6.8,
        "nitrogen": 2.5,
        "phosphorus": 2.0,
        "potassium": 2.2,
        "organicMatter": 3.5,
        "moisture": 25
    }
}

Descripción de Parámetros

uid (string): Identificador del usuario que está realizando la solicitud. Se utiliza para verificar la autorización del usuario.
soilData (object): Datos de calidad del suelo, que incluyen:
- pH (float): Nivel de pH del suelo.
- nitrogen (float): Nivel de nitrógeno en el suelo.
- phosphorus (float): Nivel de fósforo en el suelo.
- potassium (float): Nivel de potasio en el suelo.
- organicMatter (float): Cantidad de materia orgánica en el suelo.
- moisture (float): Nivel de humedad del suelo.

Errores Comunes

400 Bad Request: Si falta alguno de los parámetros uid o soilData.
403 Forbidden: Si el uid no está autorizado.
500 Internal Server Error: En caso de errores internos del servidor durante el procesamiento de la solicitud.

Respuesta (Response)

Ejemplo de Cuerpo de Respuesta (JSON)

{
    "message": "Resultado del análisis de la calidad del suelo.",
    "soilData": {
        "pH": 6.8,
        "nitrogen": 2.5,
        "phosphorus": 2.0,
        "potassium": 2.2,
        "organicMatter": 3.5,
        "moisture": 25
    },
    "result": {
        "quality": "good",
        "recommendations": [
            "El pH del suelo está en el rango óptimo.",
            "Los niveles de nitrógeno, fósforo y potasio son adecuados.",
            "La materia orgánica y la humedad del suelo son suficientes.",
            "Considera monitorear regularmente los niveles de nutrientes para mantener la calidad del suelo."
        ]
    },
    "recommendations": "Explicación en lenguaje natural de los resultados y sugerencias para mejorar la calidad del suelo."
}

Descripción de Campos

message (string): Mensaje que indica el resultado del análisis de la calidad del suelo.
soilData (object): Datos del suelo analizados.
result (object): Resultados del análisis que incluyen:
- quality (string): Calidad general del suelo, que puede ser 'poor', 'moderate' o 'good'.
- recommendations (array of strings): Recomendaciones para mejorar la calidad del suelo basadas en los datos analizados.
recommendations (string): Recomendaciones detalladas generadas por OpenAI basadas en los resultados del análisis, incluyendo interpretación de resultados, implicaciones agrícolas, recomendaciones para mejorar la calidad del suelo y sugerencias de cultivos óptimos.

Notas Adicionales

El campo recommendations proporciona una interpretación profesional y detallada de los resultados del análisis, con sugerencias prácticas para agricultores sobre cómo mejorar la calidad del suelo y optimizar la producción agrícola.
La respuesta está diseñada para ser útil para agricultores y profesionales de la agronomía, proporcionando información clara y útil para la toma de decisiones y la mejora de prácticas agrícolas.

Last modified: 26 agosto 2024