Documentación

# Child-Phen LatLon

Este servicio retorna las variables con información de Riesgo por Fenómeno de El Niño de la ubicación latitud, longitud solicitada. Dicha ubicación puede provenir de un dispositivo tipo GPS de un celular, Laptop, Pc, etc. O de información almacenada en sus repositorios de datos.

Parámetros obligatorios en una solicitud de Child-Phen:

  • latlon: los valores de latitud y longitud que especifican la ubicación para la que desea obtener la información de Child-Phen.
  • key: la clave API de su aplicación. Esta clave identifica su aplicación a los efectos de la gestión de cuotas. Aprenda a obtener la clave API.

# Ejemplo de Child-Phen LatLon

La siguiente petición base del servicio tendría la siguiente estructura:

https://apis.geodir.co/child-phen/v1/json?latlon=-12.059888,-77.049072&key=YOUR_KEY

Nota: Asegúrese de que no exista ningún espacio entre los valores de latitud y longitud cuando se pasa en el parámetro latlon.

{


  "status": "OK",
  "results": [
    {
      "name": "risk",
      "description": "Nivel de riesgo por fenomeno de el niño",
      "fields": [
        {
          "name": "662741",
          "name_abbr": "662741",
          "types": [
            "grid_code"
          ]
        },
        {
          "name": "2023-11-08",
          "name_abbr": "2023-11-08",
          "types": [
            "current_date"
          ]
        },
        {
          "name": "2",
          "name_abbr": "2",
          "types": [
            "composite_risk_index"
          ]
        },
        {
          "name": "Alto",
          "name_abbr": "A",
          "types": [
            "composite_risk_level"
          ]
        },
        {
          "name": "2",
          "name_abbr": "2",
          "types": [
            "flood_risk_index"
          ]
        },
        {
          "name": "Alto",
          "name_abbr": "A",
          "types": [
            "flood_risk_level"
          ]
        },
        {
          "name": "4",
          "name_abbr": "4",
          "types": [
            "lands_risk_index"
          ]
        },
        {
          "name": "Bajo o Muy Bajo",
          "name_abbr": "B",
          "types": [
            "lands_risk_level"
          ]
        }
      ]
    }
  ],
  "geometry": {
    "coordinates": {
      "lat": -12.04303244,
      "lon": -77.02491286
    }
  }

}

# Respuestas de Child-phen LatLon

A continuación se muestran los códigos de estado posibles en una respuesta de Child-phen.

# Códigos de Estado de Child-phen LatLon

El campo "status" dentro del objeto de respuesta de Child-phen contiene el estado de la solicitud y puede contener información de depuración para ayudarlo a averiguar por qué la codificación geográfica no funciona. El campo "status" puede contener los siguientes valores:

  • "OK" indica que el servicio Child-phen no produjo errores; el servicio realizo la acción correctamente.
  • "ZERO_RESULTS" indica que el servicio Child-phen se realizó correctamente pero no arrojó resultados. Esto puede ocurrir si al servicio se le pasó un latlon inexistente o fuera de zona.
  • "OVER_QUERY_LIMIT" indica que ha superado su cuota.
  • "REQUEST_DENIED" indica que su solicitud fue denegada.
  • "INVALID_REQUEST" generalmente indica uno de los siguientes:
    • Falta la consulta (address, groups o latlon).
    • Se proporcionó un groups no válido.
  • "UNKNOWN_ERROR" indica que la solicitud no se pudo procesar debido a un error del servidor. La solicitud puede tener éxito si vuelve a intentarlo.

# Parámetros opcionales

Parámetros opcionales:

  • radius: es un valor que especifica la distancia en metros para realizar la búsqueda de resultados para Child-Phen, el valor por defecto es 1,000.

← Diccionario de Datos →