Documentation

# Child-Phen LatLon

This service returns the variables with El Niño Phenomenon Risk information for the requested latitude and longitude location. This location can come from a GPS-type device on a cell phone, laptop, PC, etc. Or information stored in their data repositories.

Required parameters in a Child-Phen request:

  • latlon: the latitude and longitude values ​​that specify the location for which you want to get Child-Phen information.
  • key: the API key of your application. This key identifies your application for the purposes of quota management. Learn how to get API key.

# Child-Phen LatLon Example

The following base service request would have the following structure:

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

Note: Make sure there is no space between the latitude and longitude values ​​when passed in the latlon parameter.

{


  "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
    }
  }

}

# Answers by Child-phen LatLon

Below are the possible status codes in a Child-phen response.

# Child-phen LatLon Status Codes

The "status" field inside the Child-phen response object contains the status of the request and may contain debugging information to help you figure out why geocoding is not working. The "status" field can contain the following values:

  • "OK" indicates that the Child-phen service did not produce errors; The service performed the action correctly.
  • "ZERO_RESULTS" indicates that the Child-phen service succeeded but returned no results. This can occur if the service was passed a non-existent or out-of-zone latlon.
  • "OVER_QUERY_LIMIT" indicates that you have exceeded your quota.
  • "REQUEST_DENIED" indicates that your request was denied.
  • "INVALID_REQUEST" usually indicates one of the following:
    • The query is missing (address, groups or latlon).
    • An invalid groups was provided.
  • "UNKNOWN_ERROR" indicates that the request could not be processed due to a server error. The request may be successful if you try again.

# Optional parameters

Optional parameters:

  • radius: is a value that specifies the distance in meters to perform the search results for Child-Phen, the default value is 1,000.

← Data dictionary →