เริ่มต้นใช้งาน

ดึงข้อมูลความเสี่ยงภัยแล้งรายจังหวัดของไทย เวียดนาม และมาเลเซีย ได้ภายใน 5 นาที ประเทศและจังหวัดที่คีย์ของคุณอ่านได้ขึ้นอยู่กับแพ็กเกจที่ใช้

ดึงข้อมูลความเสี่ยงภัยแล้งรายจังหวัดของไทย เวียดนาม และมาเลเซีย ได้ภายใน 5 นาที ประเทศและจังหวัดที่คีย์ของคุณอ่านได้ขึ้นอยู่กับแพ็กเกจที่ใช้

Base URL: https://climate.globmaps.com


1. รับคีย์ API

  1. เข้าสู่ระบบ แล้วเปิดเมนู คีย์ API ทางซ้าย
  2. กด สร้างคีย์ใหม่ ตั้งชื่อที่จำได้ (เช่น my-first-app) แล้วกด สร้าง
  3. กด คัดลอก แล้วเก็บคีย์ไว้ในที่ปลอดภัย ระบบแสดงคีย์เต็มเพียงครั้งเดียว หากคีย์หาย ให้สร้างคีย์ใหม่แล้วเพิกถอนคีย์เดิม

รูปแบบคีย์: ci_ ตามด้วยอักขระฐานสิบหก 48 ตัว (เช่น ci_a1b2c3d4e5f6...)

ไม่สะดวกใช้เทอร์มินัล? เปิดเมนู ทดลองเรียก API ทางซ้าย วางคีย์ เลือก endpoint แล้วกด ส่งคำขอ


2. เรียก API ครั้งแรก

ทำตามทีละขั้น

  1. เปิดเทอร์มินัล — macOS: แอป Terminal · Windows: PowerShell (พิมพ์ curl.exe แทน curl) · Linux: เทอร์มินัลใดก็ได้
  2. กด คัดลอก ที่คำสั่งด้านล่าง
  3. วางลงในเทอร์มินัล แล้วแทน ci_YOUR_KEY ด้วยคีย์ที่คัดลอกไว้ในขั้นที่ 1
  4. กด Enter จะได้คำตอบเป็น JSON หน้าตาแบบเดียวกับหัวข้อที่ 3
  5. หากได้ข้อผิดพลาดแทน ให้ดูหัวข้อที่ 6 ซึ่งบอกว่าต้องแก้อะไร

curl

curl -H "x-api-key: ci_YOUR_KEY" "https://climate.globmaps.com/api/risk-map/drought/province?country=THA&name=Chiang%20Rai"

Python

import requests

API_KEY = "ci_YOUR_KEY"
BASE_URL = "https://climate.globmaps.com"

response = requests.get(
    f"{BASE_URL}/api/risk-map/drought/province",
    params={"country": "THA", "name": "Chiang Rai"},
    headers={"x-api-key": API_KEY},
)
data = response.json()
print(data["data"]["riskLevel"])   # "low" | "moderate" | "high" | "extreme"
print(data["data"]["mdi_score"])   # 0–1 Multi-Dimensional Drought Index

JavaScript

const API_KEY = "ci_YOUR_KEY";

const res = await fetch(
  "https://climate.globmaps.com/api/risk-map/drought/province?country=THA&name=Chiang%20Rai",
  { headers: { "x-api-key": API_KEY } }
);
const { data } = await res.json();
console.log(data.riskLevel);   // "low"
console.log(data.mdi_score);   // 0.1272

3. ตัวอย่างคำตอบ

จังหวัด: Chiang Rai เดือน: 2026-05 (ข้อมูลจริง)

{
  "success": true,
  "data": {
    "province": "Chiang Rai",
    "lat": 19.8433,
    "lng": 99.866,
    "month": "2026-05",

    "spei1": -0.1755,
    "spei3": -0.3232,
    "spei6": -0.4351,
    "spei12": -0.2198,
    "spi1": -0.4948,
    "spi3": -0.3874,

    "spei1_class": "N",
    "severity": "N",
    "riskScore": 9,
    "riskLevel": "low",

    "confidence": 0.649,
    "confidenceLabel": "Medium",

    "mdi_score": 0.1272,
    "mdi_severity": "none",

    "forecast": [
      { "ym": "2026-06", "spei1": -0.2823, "severity": "N", "tp_mm": 184.07, "t2m_c": 25.58, "tp_cv": 0.339 },
      { "ym": "2026-07", "spei1": 0.1239,  "severity": "N", "tp_mm": 329.69, "t2m_c": 25.0,  "tp_cv": 0.298 },
      { "ym": "2026-08", "spei1": 0.3315,  "severity": "N", "tp_mm": 360.36, "t2m_c": 24.82, "tp_cv": 0.237 },
      { "ym": "2026-09", "spei1": -0.1263, "severity": "N", "tp_mm": 230.17, "t2m_c": 24.25, "tp_cv": 0.310 },
      { "ym": "2026-10", "spei1": 0.4797,  "severity": "N", "tp_mm": 134.60, "t2m_c": 23.02, "tp_cv": 0.704 },
      { "ym": "2026-11", "spei1": 0.6907,  "severity": "W1","tp_mm": 73.30,  "t2m_c": 21.44, "tp_cv": 0.771 }
    ]
  }
}

4. คำอธิบายฟิลด์

ฟิลด์ชนิดคำอธิบาย
provincestringชื่อจังหวัด
lat, lngfloatพิกัดจุดศูนย์กลางจังหวัด
monthstringเดือนอ้างอิง (YYYY-MM) — ข้อมูลจาก pipeline ERA5
spei1floatค่า SPEI-1 (1 เดือน) ต่ำกว่า −1.28 = D2 ขึ้นไป · ต่ำกว่า 0 = เริ่มขาดน้ำ
spei3, spei6, spei12floatSPEI ระยะยาว
spi1, spi3floatSPI (คิดจากฝนอย่างเดียว)
spei1_classstringN · D0–D4 (แล้ง) · W1–W2 (ชื้น)
severitystringเหมือน spei1_class
riskScoreintคะแนนความเสี่ยงรวม 0–100
riskLevelstringlow · moderate · high · extreme
confidencefloatความเชื่อมั่นของพยากรณ์ 0–1 (เดือนถัดไป)
confidenceLabelstringLow · Medium · High
mdi_scorefloatดัชนีภัยแล้งหลายมิติ 0–1 (SPEI+VCI+ESI+SMI)
mdi_severitystringnone · mild · moderate · severe · extreme หลายระดับของ severity_class อาจได้ค่าเดียวกัน: D1 และ D2 ได้ moderate ทั้งคู่
severity_classstringNone · D0–D4 · W0–W2 — ระดับหลัก ควรใช้แทน severity
alert_levelstringnone · watch · warning · alert
forecast[]arrayพยากรณ์ SEAS5.1 ล่วงหน้า 6 เดือน
forecast[].ymstringเดือน (YYYY-MM)
forecast[].spei1floatSPEI-1 ที่พยากรณ์
forecast[].severitystringN / D0–D4 / W1–W2
forecast[].tp_mmfloatปริมาณฝนที่พยากรณ์ (มม.)
forecast[].t2m_cfloatอุณหภูมิที่พยากรณ์ (°C)
forecast[].tp_cvfloatความไม่แน่นอนของฝน (CV)

5. endpoint ภัยแล้งทั้งหมด

MethodEndpointคำอธิบายต้องใช้คีย์
GET/api/risk-map/drought/provinceMDI + SPEI รายจังหวัด✅
GET/api/risk-map/droughtข้อมูลระดับกริด (lat/lng)✅
GET/api/risk-map/drought/summaryสรุปรายประเทศที่ AI เขียน✅
GET/api/risk-map/drought/alertจังหวัดที่เข้าเกณฑ์ภัยแล้ง✅

พารามิเตอร์ — /api/risk-map/drought/province

พารามิเตอร์จำเป็นค่าเริ่มต้นหมายเหตุ
countryไม่THATHA · VNM · MYS (รหัส ISO ตัวพิมพ์ใหญ่)
nameใช่—ชื่อจังหวัดภาษาอังกฤษ เช่น Chiang Rai, Bangkok
monthไม่ล่าสุดระบุ YYYY-MM (→ 404 หากไม่มีเดือนนั้นในข้อมูล)

การค้นชื่อจังหวัดไม่สนตัวพิมพ์เล็กใหญ่และช่องว่าง: chiangrai = Chiang Rai


6. การจัดการข้อผิดพลาด

ข้อผิดพลาดทุกแบบตอบในรูป: { "error": "<message>" }

HTTPข้อความสาเหตุ
401"Missing API key."ไม่ได้ใส่ header x-api-key
401"Invalid API key."ไม่พบคีย์ หรือคีย์ถูกเพิกถอนแล้ว
429"Rate limit exceeded."เรียกเกินจำนวนครั้งต่อนาทีของแพ็กเกจ
403"No active subscription for THA..."ประเทศไม่อยู่ในแพ็กเกจ
403"upgrade_required" พร้อม reason province_not_included หรือ country_not_includedจังหวัดหรือประเทศนั้นไม่อยู่ในแพ็กเกจของคุณ แพ็กเกจฟรีใช้ได้ 1 ประเทศและจังหวัดที่เลือกไว้ตอนสมัคร — ดู แพ็กเกจของคุณ ที่ด้านบนของหน้านี้
400"name is required."ไม่ได้ใส่พารามิเตอร์ name
404"Province \"X\" not found."สะกดชื่อจังหวัดผิด

ขีดจำกัดอัตราการเรียก

แพ็กเกจครั้ง/นาที
API_SANDBOX30
API_PRO120
API_BUSINESS300
BUNDLE_PRO120

7. ประเทศและจังหวัดที่มีข้อมูล

ประเทศรหัสตัวอย่างจังหวัด
ไทยTHABangkok, Chiang Rai, Chiang Mai, Phuket, Nakhon Ratchasima (ทั้งหมด 77 จังหวัด)
เวียดนามVNMHanoi, Ho Chi Minh City, Da Nang
มาเลเซียMYSKuala Lumpur, Penang, Johor

8. แหล่งข้อมูล

แหล่งบทบาท
ERA5-Land (ECMWF)ข้อมูล reanalysis รายเดือน 0.1° — ฐานของ SPEI/SPI
SEAS5.1 system=51 (ECMWF)พยากรณ์ 6 เดือนแบบ ensemble 51 สมาชิก
MODIS MOD13Q1 V6.1 (NASA)ดัชนีสภาพพืชพรรณ (VCI) ความละเอียด 250 ม.
ERA5 ET proxyดัชนีความเครียดจากการคายระเหย (ESI)

ค่าปกติภูมิอากาศอ้างอิง: 1991–2020 (ช่วงมาตรฐานของ WMO)


ตรวจสอบ API จากโค้ดและข้อมูลจริง — 2026-06-16
ที่มา: src/app/api/risk-map/drought/province/route.ts