La API

Una solicitud, una lectura.

El mismo motor que usa el sitio, abierto a un script, un notebook, un SIG o un agente. Envíe cualquier terreno del planeta y reciba lo que leyó el instrumento: la puntuación, el veredicto, cada hallazgo detrás de él, las fuentes que respondieron y las que no dieron datos. Sin clave. Cada lectura hecha así es pública y entra en el muro, igual que una hecha en el sitio.

Endpoints

POST /api/v1/readings: Lee un terreno. Envíe un Polygon de GeoJSON, o un punto con medio lado en km (de 0.06 a 12). Responde 201 con la lectura y su enlace permanente.
GET /api/v1/readings/{id}: Una lectura pública completa. Acepta el id de una lectura, un slug de /p o la clave de un ejemplo: monteverde, guanacaste, pedasi, amazon.
GET /api/v1/readings?limit=24: Las lecturas públicas más recientes, como las muestra el muro: lugar, coordenadas, área, puntuación, veredicto, titular.

Leer alrededor de un punto

curl -X POST https://read.dearwise.earth/api/v1/readings \
  -H "Content-Type: application/json" \
  -d '{ "point": { "lat": 0.35, "lon": 36.95, "half_km": 0.6 } }'

Leer un lindero exacto

Las posiciones van como [longitud, latitud]; el anillo cierra en su primera posición. El motor lee de 1 a 50,000 hectáreas.

curl -X POST https://read.dearwise.earth/api/v1/readings \
  -H "Content-Type: application/json" \
  -d '{ "geometry": { "type": "Polygon", "coordinates": [[
        [-84.812, 10.296], [-84.788, 10.296],
        [-84.788, 10.312], [-84.812, 10.312],
        [-84.812, 10.296] ]] } }'

Lo que devuelve

{
  "id": "…",
  "url": "https://read.dearwise.earth/p/…",
  "score": 72,
  "verdict": "Restore",
  "headline": "Good bones. The rest is work.",
  "area_ha": 145,
  "sources_read": ["terrain", "water", "soil", "climate", …],
  "sources_silent": [],
  "asset": { …the full reading: pillars, findings, sources, silence… }
}

Una lectura tarda menos de un minuto; la conexión sigue abierta hasta que llega. Una fuente que falta baja la confianza, nunca la puntuación: la fuente sin datos se nombra en el activo, no se rellena.

Desde Python

import requests
r = requests.post("https://read.dearwise.earth/api/v1/readings",
                  json={"point": {"lat": -1.9, "lon": 113.6, "half_km": 0.6}})
reading = r.json()
print(reading["score"], reading["verdict"], reading["url"])

Límites y condiciones

·12 lecturas por hora por dirección, como límite de cortesía; un 429 indica cuándo se renueva. ¿Necesita más, para un portafolio o una investigación? Escríbanos.
·Las lecturas son públicas, como las del sitio. Las lecturas privadas son parte de TERRA Pro y por ahora se quedan en el sitio.
·Los datos son públicos y cada respuesta nombra sus fuentes; dé crédito a ellas cuando publique. El lente (los pesos que convierten las lecturas en una puntuación) es nuestro.
·Una lectura es una primera mirada desde la órbita: un punto de partida para la debida diligencia y el diseño, no un levantamiento ni un anuncio de venta.

Se aceptan solicitudes desde cualquier origen. Las respuestas llevan X-TERRA-API-Version.