เริ่มต้นใช้งาน
ดึงข้อมูลความเสี่ยงภัยแล้งรายจังหวัดของไทย เวียดนาม และมาเลเซีย ได้ภายใน 5 นาที ประเทศและจังหวัดที่คีย์ของคุณอ่านได้ขึ้นอยู่กับแพ็กเกจที่ใช้
ดึงข้อมูลความเสี่ยงภัยแล้งรายจังหวัดของไทย เวียดนาม และมาเลเซีย ได้ภายใน 5 นาที ประเทศและจังหวัดที่คีย์ของคุณอ่านได้ขึ้นอยู่กับแพ็กเกจที่ใช้
Base URL: https://climate.globmaps.com
1. รับคีย์ API
- เข้าสู่ระบบ แล้วเปิดเมนู คีย์ API ทางซ้าย
- กด สร้างคีย์ใหม่ ตั้งชื่อที่จำได้ (เช่น
my-first-app) แล้วกด สร้าง - กด คัดลอก แล้วเก็บคีย์ไว้ในที่ปลอดภัย ระบบแสดงคีย์เต็มเพียงครั้งเดียว หากคีย์หาย ให้สร้างคีย์ใหม่แล้วเพิกถอนคีย์เดิม
รูปแบบคีย์: ci_ ตามด้วยอักขระฐานสิบหก 48 ตัว (เช่น ci_a1b2c3d4e5f6...)
ไม่สะดวกใช้เทอร์มินัล? เปิดเมนู ทดลองเรียก API ทางซ้าย วางคีย์ เลือก endpoint แล้วกด ส่งคำขอ
2. เรียก API ครั้งแรก
ทำตามทีละขั้น
- เปิดเทอร์มินัล — macOS: แอป Terminal · Windows: PowerShell (พิมพ์
curl.exeแทนcurl) · Linux: เทอร์มินัลใดก็ได้ - กด คัดลอก ที่คำสั่งด้านล่าง
- วางลงในเทอร์มินัล แล้วแทน
ci_YOUR_KEYด้วยคีย์ที่คัดลอกไว้ในขั้นที่ 1 - กด Enter จะได้คำตอบเป็น JSON หน้าตาแบบเดียวกับหัวข้อที่ 3
- หากได้ข้อผิดพลาดแทน ให้ดูหัวข้อที่ 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. คำอธิบายฟิลด์
| ฟิลด์ | ชนิด | คำอธิบาย |
|---|---|---|
province | string | ชื่อจังหวัด |
lat, lng | float | พิกัดจุดศูนย์กลางจังหวัด |
month | string | เดือนอ้างอิง (YYYY-MM) — ข้อมูลจาก pipeline ERA5 |
spei1 | float | ค่า SPEI-1 (1 เดือน) ต่ำกว่า −1.28 = D2 ขึ้นไป · ต่ำกว่า 0 = เริ่มขาดน้ำ |
spei3, spei6, spei12 | float | SPEI ระยะยาว |
spi1, spi3 | float | SPI (คิดจากฝนอย่างเดียว) |
spei1_class | string | N · D0–D4 (แล้ง) · W1–W2 (ชื้น) |
severity | string | เหมือน spei1_class |
riskScore | int | คะแนนความเสี่ยงรวม 0–100 |
riskLevel | string | low · moderate · high · extreme |
confidence | float | ความเชื่อมั่นของพยากรณ์ 0–1 (เดือนถัดไป) |
confidenceLabel | string | Low · Medium · High |
mdi_score | float | ดัชนีภัยแล้งหลายมิติ 0–1 (SPEI+VCI+ESI+SMI) |
mdi_severity | string | none · mild · moderate · severe · extreme หลายระดับของ severity_class อาจได้ค่าเดียวกัน: D1 และ D2 ได้ moderate ทั้งคู่ |
severity_class | string | None · D0–D4 · W0–W2 — ระดับหลัก ควรใช้แทน severity |
alert_level | string | none · watch · warning · alert |
forecast[] | array | พยากรณ์ SEAS5.1 ล่วงหน้า 6 เดือน |
forecast[].ym | string | เดือน (YYYY-MM) |
forecast[].spei1 | float | SPEI-1 ที่พยากรณ์ |
forecast[].severity | string | N / D0–D4 / W1–W2 |
forecast[].tp_mm | float | ปริมาณฝนที่พยากรณ์ (มม.) |
forecast[].t2m_c | float | อุณหภูมิที่พยากรณ์ (°C) |
forecast[].tp_cv | float | ความไม่แน่นอนของฝน (CV) |
5. endpoint ภัยแล้งทั้งหมด
| Method | Endpoint | คำอธิบาย | ต้องใช้คีย์ |
|---|---|---|---|
| GET | /api/risk-map/drought/province | MDI + 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 | ไม่ | THA | THA · 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_SANDBOX | 30 |
| API_PRO | 120 |
| API_BUSINESS | 300 |
| BUNDLE_PRO | 120 |
7. ประเทศและจังหวัดที่มีข้อมูล
| ประเทศ | รหัส | ตัวอย่างจังหวัด |
|---|---|---|
| ไทย | THA | Bangkok, Chiang Rai, Chiang Mai, Phuket, Nakhon Ratchasima (ทั้งหมด 77 จังหวัด) |
| เวียดนาม | VNM | Hanoi, Ho Chi Minh City, Da Nang |
| มาเลเซีย | MYS | Kuala 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