Resolve coverage
curl --request POST \
--url https://api.verdant-ai.com/api/v1/data/resolve \
--header 'Content-Type: application/json' \
--data '
{
"variables": [
"air_temperature_max"
],
"region": {
"bbox": [
142.3,
-34.45,
142.4,
-34.35
],
"crs": "EPSG:4326"
},
"period": {
"start": "2003-01-01",
"end": "2003-01-01"
},
"temporal_resolution": "daily",
"spatial_resolution": "native",
"units": {
"air_temperature_max": "degC"
},
"data_class": "interpolated_observation",
"format": "json",
"missing_policy": "preserve",
"source_preference": "silo"
}
'import requests
url = "https://api.verdant-ai.com/api/v1/data/resolve"
payload = {
"variables": ["air_temperature_max"],
"region": {
"bbox": [142.3, -34.45, 142.4, -34.35],
"crs": "EPSG:4326"
},
"period": {
"start": "2003-01-01",
"end": "2003-01-01"
},
"temporal_resolution": "daily",
"spatial_resolution": "native",
"units": { "air_temperature_max": "degC" },
"data_class": "interpolated_observation",
"format": "json",
"missing_policy": "preserve",
"source_preference": "silo"
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
variables: ['air_temperature_max'],
region: {bbox: [142.3, -34.45, 142.4, -34.35], crs: 'EPSG:4326'},
period: {start: '2003-01-01', end: '2003-01-01'},
temporal_resolution: 'daily',
spatial_resolution: 'native',
units: {air_temperature_max: 'degC'},
data_class: 'interpolated_observation',
format: 'json',
missing_policy: 'preserve',
source_preference: 'silo'
})
};
fetch('https://api.verdant-ai.com/api/v1/data/resolve', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.verdant-ai.com/api/v1/data/resolve",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'variables' => [
'air_temperature_max'
],
'region' => [
'bbox' => [
142.3,
-34.45,
142.4,
-34.35
],
'crs' => 'EPSG:4326'
],
'period' => [
'start' => '2003-01-01',
'end' => '2003-01-01'
],
'temporal_resolution' => 'daily',
'spatial_resolution' => 'native',
'units' => [
'air_temperature_max' => 'degC'
],
'data_class' => 'interpolated_observation',
'format' => 'json',
'missing_policy' => 'preserve',
'source_preference' => 'silo'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.verdant-ai.com/api/v1/data/resolve"
payload := strings.NewReader("{\n \"variables\": [\n \"air_temperature_max\"\n ],\n \"region\": {\n \"bbox\": [\n 142.3,\n -34.45,\n 142.4,\n -34.35\n ],\n \"crs\": \"EPSG:4326\"\n },\n \"period\": {\n \"start\": \"2003-01-01\",\n \"end\": \"2003-01-01\"\n },\n \"temporal_resolution\": \"daily\",\n \"spatial_resolution\": \"native\",\n \"units\": {\n \"air_temperature_max\": \"degC\"\n },\n \"data_class\": \"interpolated_observation\",\n \"format\": \"json\",\n \"missing_policy\": \"preserve\",\n \"source_preference\": \"silo\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.verdant-ai.com/api/v1/data/resolve")
.header("Content-Type", "application/json")
.body("{\n \"variables\": [\n \"air_temperature_max\"\n ],\n \"region\": {\n \"bbox\": [\n 142.3,\n -34.45,\n 142.4,\n -34.35\n ],\n \"crs\": \"EPSG:4326\"\n },\n \"period\": {\n \"start\": \"2003-01-01\",\n \"end\": \"2003-01-01\"\n },\n \"temporal_resolution\": \"daily\",\n \"spatial_resolution\": \"native\",\n \"units\": {\n \"air_temperature_max\": \"degC\"\n },\n \"data_class\": \"interpolated_observation\",\n \"format\": \"json\",\n \"missing_policy\": \"preserve\",\n \"source_preference\": \"silo\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.verdant-ai.com/api/v1/data/resolve")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"variables\": [\n \"air_temperature_max\"\n ],\n \"region\": {\n \"bbox\": [\n 142.3,\n -34.45,\n 142.4,\n -34.35\n ],\n \"crs\": \"EPSG:4326\"\n },\n \"period\": {\n \"start\": \"2003-01-01\",\n \"end\": \"2003-01-01\"\n },\n \"temporal_resolution\": \"daily\",\n \"spatial_resolution\": \"native\",\n \"units\": {\n \"air_temperature_max\": \"degC\"\n },\n \"data_class\": \"interpolated_observation\",\n \"format\": \"json\",\n \"missing_policy\": \"preserve\",\n \"source_preference\": \"silo\"\n}"
response = http.request(request)
puts response.read_body{
"available": true,
"reason": "available",
"selection": {
"datasetVersion": "<string>",
"tileIds": [
"<string>"
],
"rowCount": 123
},
"acquisitionEnabled": true
}{
"error": "<string>",
"message": "<string>",
"issues": [
{
"code": "<string>",
"path": [
"<string>"
],
"message": "<string>"
}
]
}{
"error": "<string>",
"message": "<string>",
"issues": [
{
"code": "<string>",
"path": [
"<string>"
],
"message": "<string>"
}
]
}{
"error": "<string>",
"message": "<string>",
"issues": [
{
"code": "<string>",
"path": [
"<string>"
],
"message": "<string>"
}
]
}{
"error": "<string>",
"message": "<string>",
"issues": [
{
"code": "<string>",
"path": [
"<string>"
],
"message": "<string>"
}
]
}{
"error": "<string>",
"message": "<string>",
"issues": [
{
"code": "<string>",
"path": [
"<string>"
],
"message": "<string>"
}
]
}Queries
Resolve coverage
Check complete published coverage for a structured climate query. Returns the selected immutable version and row count, or an explicit unavailable reason; acquisitionEnabled reports whether POST /api/v1/data/requests can acquire a miss. Does not acquire data or charge.
POST
/
api
/
v1
/
data
/
resolve
Resolve coverage
curl --request POST \
--url https://api.verdant-ai.com/api/v1/data/resolve \
--header 'Content-Type: application/json' \
--data '
{
"variables": [
"air_temperature_max"
],
"region": {
"bbox": [
142.3,
-34.45,
142.4,
-34.35
],
"crs": "EPSG:4326"
},
"period": {
"start": "2003-01-01",
"end": "2003-01-01"
},
"temporal_resolution": "daily",
"spatial_resolution": "native",
"units": {
"air_temperature_max": "degC"
},
"data_class": "interpolated_observation",
"format": "json",
"missing_policy": "preserve",
"source_preference": "silo"
}
'import requests
url = "https://api.verdant-ai.com/api/v1/data/resolve"
payload = {
"variables": ["air_temperature_max"],
"region": {
"bbox": [142.3, -34.45, 142.4, -34.35],
"crs": "EPSG:4326"
},
"period": {
"start": "2003-01-01",
"end": "2003-01-01"
},
"temporal_resolution": "daily",
"spatial_resolution": "native",
"units": { "air_temperature_max": "degC" },
"data_class": "interpolated_observation",
"format": "json",
"missing_policy": "preserve",
"source_preference": "silo"
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
variables: ['air_temperature_max'],
region: {bbox: [142.3, -34.45, 142.4, -34.35], crs: 'EPSG:4326'},
period: {start: '2003-01-01', end: '2003-01-01'},
temporal_resolution: 'daily',
spatial_resolution: 'native',
units: {air_temperature_max: 'degC'},
data_class: 'interpolated_observation',
format: 'json',
missing_policy: 'preserve',
source_preference: 'silo'
})
};
fetch('https://api.verdant-ai.com/api/v1/data/resolve', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.verdant-ai.com/api/v1/data/resolve",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'variables' => [
'air_temperature_max'
],
'region' => [
'bbox' => [
142.3,
-34.45,
142.4,
-34.35
],
'crs' => 'EPSG:4326'
],
'period' => [
'start' => '2003-01-01',
'end' => '2003-01-01'
],
'temporal_resolution' => 'daily',
'spatial_resolution' => 'native',
'units' => [
'air_temperature_max' => 'degC'
],
'data_class' => 'interpolated_observation',
'format' => 'json',
'missing_policy' => 'preserve',
'source_preference' => 'silo'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.verdant-ai.com/api/v1/data/resolve"
payload := strings.NewReader("{\n \"variables\": [\n \"air_temperature_max\"\n ],\n \"region\": {\n \"bbox\": [\n 142.3,\n -34.45,\n 142.4,\n -34.35\n ],\n \"crs\": \"EPSG:4326\"\n },\n \"period\": {\n \"start\": \"2003-01-01\",\n \"end\": \"2003-01-01\"\n },\n \"temporal_resolution\": \"daily\",\n \"spatial_resolution\": \"native\",\n \"units\": {\n \"air_temperature_max\": \"degC\"\n },\n \"data_class\": \"interpolated_observation\",\n \"format\": \"json\",\n \"missing_policy\": \"preserve\",\n \"source_preference\": \"silo\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.verdant-ai.com/api/v1/data/resolve")
.header("Content-Type", "application/json")
.body("{\n \"variables\": [\n \"air_temperature_max\"\n ],\n \"region\": {\n \"bbox\": [\n 142.3,\n -34.45,\n 142.4,\n -34.35\n ],\n \"crs\": \"EPSG:4326\"\n },\n \"period\": {\n \"start\": \"2003-01-01\",\n \"end\": \"2003-01-01\"\n },\n \"temporal_resolution\": \"daily\",\n \"spatial_resolution\": \"native\",\n \"units\": {\n \"air_temperature_max\": \"degC\"\n },\n \"data_class\": \"interpolated_observation\",\n \"format\": \"json\",\n \"missing_policy\": \"preserve\",\n \"source_preference\": \"silo\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.verdant-ai.com/api/v1/data/resolve")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"variables\": [\n \"air_temperature_max\"\n ],\n \"region\": {\n \"bbox\": [\n 142.3,\n -34.45,\n 142.4,\n -34.35\n ],\n \"crs\": \"EPSG:4326\"\n },\n \"period\": {\n \"start\": \"2003-01-01\",\n \"end\": \"2003-01-01\"\n },\n \"temporal_resolution\": \"daily\",\n \"spatial_resolution\": \"native\",\n \"units\": {\n \"air_temperature_max\": \"degC\"\n },\n \"data_class\": \"interpolated_observation\",\n \"format\": \"json\",\n \"missing_policy\": \"preserve\",\n \"source_preference\": \"silo\"\n}"
response = http.request(request)
puts response.read_body{
"available": true,
"reason": "available",
"selection": {
"datasetVersion": "<string>",
"tileIds": [
"<string>"
],
"rowCount": 123
},
"acquisitionEnabled": true
}{
"error": "<string>",
"message": "<string>",
"issues": [
{
"code": "<string>",
"path": [
"<string>"
],
"message": "<string>"
}
]
}{
"error": "<string>",
"message": "<string>",
"issues": [
{
"code": "<string>",
"path": [
"<string>"
],
"message": "<string>"
}
]
}{
"error": "<string>",
"message": "<string>",
"issues": [
{
"code": "<string>",
"path": [
"<string>"
],
"message": "<string>"
}
]
}{
"error": "<string>",
"message": "<string>",
"issues": [
{
"code": "<string>",
"path": [
"<string>"
],
"message": "<string>"
}
]
}{
"error": "<string>",
"message": "<string>",
"issues": [
{
"code": "<string>",
"path": [
"<string>"
],
"message": "<string>"
}
]
}Body
application/json
A bounded climate query. JSON is the default representation. The response contains data directly; no download or acquisition job is required.
Data meaning is independent of representation and delivery. JSON (default) and CSV are returned inline. Bbox order: west,south,east,north; no antimeridian crossing. Date bounds inclusive; at most 31 days and 10,000 cells; actual coverage must pass resolve. dataset_version pins reproducibility.
Required array length:
1 elementAvailable options:
air_temperature_max, air_temperature_min, precipitation_amount Show child attributes
Show child attributes
Show child attributes
Show child attributes
Allowed value:
"daily"Allowed value:
"native"Exactly one entry, for the requested variable.
Show child attributes
Show child attributes
Allowed value:
"interpolated_observation"Allowed value:
"preserve"Available options:
json, csv auto picks the finest source covering the region: SILO (Australia), NOAA nClimGrid-Daily (contiguous US), NOAA CPC (global).
Available options:
auto, silo, nclimgrid, cpc Pin an immutable published dataset version. Omit to choose a compatible public version.
Pattern:
^[a-zA-Z0-9_-]{1,128}$Response
Coverage checked. available=false is a successful preflight with an unavailable reason.
Available options:
available, coverage_unavailable, request_too_large, no_cell_centers, unsupported_grid Show child attributes
Show child attributes
True when POST /api/v1/data/requests can acquire this missing coverage from the source.