> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.
# UPRA Preços da terra rural
> O preço comercial da terra rural agropecuária na Colômbia por hectare, zona a zona: cerca de 179.000 zonas em 18 departamentos dos estudos de mercado de terras da UPRA, consultáveis por município e preço ou sob um ponto.
A Unidad de Planificación Rural Agropecuaria (UPRA), a unidade de planejamento do Ministério da Agricultura, mapeia quanto vale a terra agropecuária na Colômbia: departamento por departamento, traça zonas e dá a cada uma uma faixa de preço comercial em pesos por hectare, a partir de entrevistas de campo, estudos de mercado e ofertas. Esta fonte guarda esse mapa inteiro, cerca de 179.000 zonas, cada uma com sua faixa, o ano do estudo, sua condição no mercado de terras, sua área e seu polígono.
O mapa cobre 18 departamentos, total ou parcialmente: Antioquia, Arauca, Atlántico, Bolívar, Boyacá, Casanare, Cauca, Cesar, Córdoba, Cundinamarca, Huila, La Guajira, Meta, Nariño, Quindío, Sucre, Tolima e Vichada, cada um com o ano de seu estudo (2015 a 2023).
Busque as zonas de um município ou departamento por preço, ou informe uma coordenada e obtenha a zona que a cobre.
## Buscar zonas
`POST /co/upra/land-prices-search/v1` Dataset
As zonas de preço de um município ou departamento, da mais cara à mais barata, filtradas por preço por hectare.
| Campo | Tipo | Notas |
| - | - | - |
| `municipality_code` | string | Código DANE opcional de cinco dígitos do município, p. ex. `73001` (Ibagué). É obrigatório `municipality_code` ou `department_code`. |
| `department_code` | string | Código DANE opcional de dois dígitos do departamento, p. ex. `73` (Tolima) ou `50` (Meta). |
| `min_price_per_hectare` | number | Opcional: zonas cuja faixa começa neste preço ou acima, em pesos por hectare. Por padrão `0`. |
| `max_price_per_hectare` | number | Opcional: zonas cuja faixa termina neste preço ou abaixo, em pesos por hectare. Por padrão `0`. |
| `page` | integer | Número da página, começa em 1. Por padrão `1`. |
| `per_page` | integer | Resultados por página (1-50); cada resultado traz sua geometria. Por padrão `20`. |
```bash theme={"dark"}
curl https://api.croma.run/co/upra/land-prices-search/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "municipality_code": "73001" }'
```
Retorna `as_of`, os filtros aplicados, `total` e `total_is_exact`, `page`, `per_page`, `total_pages`, `count` e `results[]`. Cada zona traz `id`, `department_code`, `department`, `municipality_code`, `municipality`, `valuation_year` (o ano do estudo do departamento), `price_status` (`priced`; `excluded` para terra fora do mercado de terras agropecuárias; `no_information`), `price_range` (o rótulo da UPRA, em milhões de pesos por hectare), `exclusion` (por que uma zona excluída está fora do mercado, p. ex. `Zonas urbanas`, `Resguardos indígenas constituidos`, `Parques Nacionales Naturales`), `price_code`, `min_price_cop_per_ha` e `max_price_cop_per_ha` (a faixa em pesos por hectare; a faixa mais alta não tem teto), `market_category` (`Incluida` ou `Condicionada`), `area_ha`, `latitude`, `longitude` e `geometry` (GeoJSON em WGS84), ou `geometry_url` quando o polígono é grande demais para ir em linha.
A UPRA traça essas faixas na escala 1:100.000 a partir de estudos de mercado e entrevistas. Descrevem o mercado de terras rurais de uma zona; a UPRA adverte que não são a avaliação de um imóvel nem base de cálculo de impostos, e deixam de fora a terra de uso residencial, industrial ou comercial.
## A zona em um ponto
`POST /co/upra/land-price-by-point/v1` Entra uma coordenada, sai o preço por hectare da zona rural que a cobre.
| Campo | Tipo | Notas |
| - | - | - |
| `latitude` | number | **Obrigatório.** Latitude em graus decimais (WGS84). |
| `longitude` | number | **Obrigatório.** Longitude em graus decimais (WGS84), negativa na Colômbia. |
```bash theme={"dark"}
curl https://api.croma.run/co/upra/land-price-by-point/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "latitude": 4.3, "longitude": -75 }'
```
Retorna `found`, `latitude`, `longitude` e `zone`, null quando nenhuma cobre o ponto. Cada zona traz `id`, `department_code`, `department`, `municipality_code`, `municipality`, `valuation_year` (o ano do estudo do departamento), `price_status` (`priced`; `excluded` para terra fora do mercado de terras agropecuárias; `no_information`), `price_range` (o rótulo da UPRA, em milhões de pesos por hectare), `exclusion` (por que uma zona excluída está fora do mercado, p. ex. `Zonas urbanas`, `Resguardos indígenas constituidos`, `Parques Nacionales Naturales`), `price_code`, `min_price_cop_per_ha` e `max_price_cop_per_ha` (a faixa em pesos por hectare; a faixa mais alta não tem teto), `market_category` (`Incluida` ou `Condicionada`), `area_ha`, `latitude`, `longitude` e `geometry` (GeoJSON em WGS84), ou `geometry_url` quando o polígono é grande demais para ir em linha.
A UPRA traça essas faixas na escala 1:100.000 a partir de estudos de mercado e entrevistas. Descrevem o mercado de terras rurais de uma zona; a UPRA adverte que não são a avaliação de um imóvel nem base de cálculo de impostos, e deixam de fora a terra de uso residencial, industrial ou comercial. O mapa cobre 18 departamentos, total ou parcialmente: Antioquia, Arauca, Atlántico, Bolívar, Boyacá, Casanare, Cauca, Cesar, Córdoba, Cundinamarca, Huila, La Guajira, Meta, Nariño, Quindío, Sucre, Tolima e Vichada, cada um com o ano de seu estudo (2015 a 2023).
Esquemas, todos os campos de resposta e um playground interativo.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.