Earth Map Suite Codegen

metadata-only endpoint 用の安全なサンプルコードを整理します。

Tool / Datasets / Export
広告枠

Codegen status

このページは metadata-only endpoint の呼び出し例だけを扱います。ラスター/COG pixel sampling のコードは未検証のため生成しません。

Guardrails

  • metadata-only response only
  • do not treat synthetic preview as observed precipitation
  • do not generate raster sampling code here
  • keep endpoint errors visible

Endpoint

/api/earth-map-suite/precipitation?bbox=139.5,35.4,140.0,35.9&start=2025-08-01&end=2025-08-03&preset=low

JavaScript fetch example

const params = new URLSearchParams({
  bbox: '139.5,35.4,140.0,35.9',
  start: '2025-08-01',
  end: '2025-08-03',
  preset: 'low'
});

const response = await fetch(`/api/earth-map-suite/precipitation?${params}`, {
  headers: { accept: 'application/json' }
});
const payload = await response.json();

if (response.ok && payload.status === 'ok' && payload.sampling_status === 'metadata_only') {
  console.log('metadata reachable', payload.dataset_id, payload.matched_dates);
} else {
  console.warn('metadata unavailable', payload.error_code, payload.message);
}

cURL example

curl 'https://nicheworks.app/api/earth-map-suite/precipitation?bbox=139.5,35.4,140.0,35.9&start=2025-08-01&end=2025-08-03&preset=low' \
  -H 'accept: application/json'

Expected success shape

{
  "data_type": "real_observation_metadata",
  "status": "ok",
  "dataset_id": "JAXA.EORC_GSMaP_standard.Gauge.00Z-23Z.v6_daily",
  "band": "PRECIP",
  "sampling_status": "metadata_only",
  "matched_dates": ["2025-08-01", "2025-08-02", "2025-08-03"],
  "summary": { "mean": null, "max": null, "min": null }
}
広告枠