GET /agri/geocode — Search LATAM locations

The geocode endpoint lets you search for a location by name and retrieve its geographic coordinates along with administrative metadata. It is backed by the Open-Meteo Geocoding API and is oriented toward Latin American regions. You can use it to resolve a user-entered place name into latitude/longitude before calling other endpoints such as /agri/advisor or /fires/hotspots.

Endpoint

GET api.climatifai.com/agri/geocode

Parameters

string

required

Location name to search. Can be a city, municipality, region, or other place name. Example: "Oaxaca", "Valle del Cauca", "Cochabamba".

integer

default:"5"

Maximum number of results to return. The API returns the top matches ranked by relevance.

Response

array

required

Array of matching locations. May be empty if no results are found.

Show Location object properties

string

Display name of the location.

float

Latitude in decimal degrees, WGS 84.

float

Longitude in decimal degrees, WGS 84.

string

Country name. Example: "Mexico".

string

First-level administrative division (state, department, or province). May be null for some entries.

float

Elevation above sea level in metres. May be null.

integer

Approximate population of the location. May be null for rural areas or administrative regions.

Error codes

Code	Description
`502`	Upstream error from the Open-Meteo Geocoding service.
`503`	Open-Meteo rate limit exceeded. Retry after a short back-off.

Example

curl "https://api.climatifai.com/agri/geocode?q=Oaxaca&count=3"

{
  "results": [
    {
      "name": "Oaxaca",
      "lat": 17.0667,
      "lon": -96.7167,
      "country": "Mexico",
      "admin1": "Oaxaca",
      "elevation": 1555.0,
      "population": 258008
    },
    {
      "name": "Oaxaca de Juárez",
      "lat": 17.0606,
      "lon": -96.7254,
      "country": "Mexico",
      "admin1": "Oaxaca",
      "elevation": 1531.0,
      "population": 264968
    },
    {
      "name": "San Pablo Villa de Mitla",
      "lat": 16.9247,
      "lon": -96.4019,
      "country": "Mexico",
      "admin1": "Oaxaca",
      "elevation": 1520.0,
      "population": 11102
    }
  ]
}

curl "https://api.climatifai.com/agri/geocode?q=Oaxaca&count=3"

{
  "results": [
    {
      "name": "Oaxaca",
      "lat": 17.0667,
      "lon": -96.7167,
      "country": "Mexico",
      "admin1": "Oaxaca",
      "elevation": 1555.0,
      "population": 258008
    },
    {
      "name": "Oaxaca de Juárez",
      "lat": 17.0606,
      "lon": -96.7254,
      "country": "Mexico",
      "admin1": "Oaxaca",
      "elevation": 1531.0,
      "population": 264968
    },
    {
      "name": "San Pablo Villa de Mitla",
      "lat": 16.9247,
      "lon": -96.4019,
      "country": "Mexico",
      "admin1": "Oaxaca",
      "elevation": 1520.0,
      "population": 11102
    }
  ]
}

REST Endpoints

GraphQL

GET /agri/geocode — Search LATAM locations

Endpoint

Parameters

Response

Error codes

Example

​Endpoint

​Parameters

​Response

​Error codes

​Example

Endpoint

Parameters

Response

Error codes

Example