เอกสารอ้างอิง

พัฒนาด้วย
GlobMaps API

API ภูมิสารสนเทศระดับ Production — Risk Map, Outbreak Radar, Supply Chain Intelligence, GeoLLM, Smart Alerts และ API Access ไม่ต้องตั้งค่า เชื่อมต่อได้ทันที

บทนำ

GlobMaps มอบ API ภูมิสารสนเทศระดับองค์กรสำหรับการตรวจจับการระบาด การทำแผนที่ความเสี่ยงภูมิอากาศ และการติดตามห่วงโซ่อุปทานทั่วโลก ทุก Endpoint ส่งคืนข้อมูล JSON ที่มีโครงสร้างสอดคล้องกัน รองรับการเชื่อมต่อระดับองค์กรอย่างรวดเร็ว

ผลิตภัณฑ์และโมดูล

GlobMaps มีโมดูลภูมิสารสนเทศระดับมืออาชีพ ได้แก่ Flood API, Wildfire API, Drought API, Climate Risk Scoring API, Outbreak Radar (เฝ้าระวังโรค), Supply Chain Intelligence (ติดตามท่าเรือ), GeoLLM Copilot (อินเทอร์เฟซภาษาธรรมชาติ), Smart Alerts (แจ้งเตือนตามพื้นที่) และ API Access (เข้าถึงข้อมูลทางโปรแกรม)

การยืนยันตัวตน

ยืนยันตัวตนทุกคำขอโปรดักชันโดยระบุ API Key ในส่วนหัว X-API-Key คีย์ออกตามบัญชีผู้ใช้และกำหนดขอบเขตตามโมดูลที่ใช้งาน สามารถขอรับหรือเปลี่ยนคีย์ใหม่ได้ทุกเมื่อผ่าน GlobMaps Dashboard

เริ่มต้นอย่างรวดเร็ว

เชื่อมต่อ GlobMaps ได้ภายในไม่กี่นาที ส่งคำขอ GET พร้อม API Key เพื่อดึงข้อมูลความเสี่ยงแบบเรียลไทม์ (น้ำท่วม, ไฟป่า, โรคระบาด ฯลฯ) สำหรับทุกพิกัด ไม่ต้องตั้งค่าที่ซับซ้อน

รายการ Endpoint

เข้าถึง Endpoint สำหรับใช้งานจริง: /v1/flood-api, /v1/wildfire-api, /v1/drought-api, /v1/climate-risk, /v1/outbreak-radar และ /v1/supply-chain ทุกรายการให้ข้อมูลแบบเรียลไทม์พร้อมความพร้อมใช้งานสูง

รูปแบบการตอบกลับ

การตอบกลับจาก GlobMaps API ทุกรายการมีโครงสร้างสม่ำเสมอ ประกอบด้วย requestId สำหรับติดตาม, asOf สำหรับระบุความทันสมัยของข้อมูล, ข้อมูลหลักแบบ Typed และอาร์เรย์ warnings สำหรับแจ้งเตือนเพิ่มเติม

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

GlobMaps ใช้ HTTP Status Code มาตรฐาน การตอบกลับข้อผิดพลาดประกอบด้วยรหัสที่อ่านได้ด้วยเครื่อง ข้อความที่มนุษย์อ่านได้ และรายละเอียดบริบทเพื่อช่วยวิเคราะห์และแก้ปัญหาได้อย่างรวดเร็ว

ตัวอย่างโค้ด

ดึงข้อมูลความเสี่ยงแบบเรียลไทม์สำหรับประเทศไทยด้วยภาษาที่คุณถนัด

cURL
curl -X GET "https://api.globmaps.com/v1/risk-data?regionId=TH" \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json"
JavaScript
const response = await fetch('https://api.globmaps.com/v1/risk-data?regionId=TH', {
  headers: {
    'X-API-Key': 'your_api_key',
    'Content-Type': 'application/json'
  }
});
const data = await response.json();
Python
import requests

response = requests.get(
    'https://api.globmaps.com/v1/risk-data',
    params={'regionId': 'TH'},
    headers={'X-API-Key': 'your_api_key'}
)
data = response.json()

รูปแบบการตอบกลับ

การตอบกลับจาก GlobMaps API ทุกรายการมีโครงสร้างที่สม่ำเสมอ

{
  "requestId": "req_abc123",
  "asOf": "2026-04-19T10:30:00Z",
  "data": {},
  "warnings": []
}

พารามิเตอร์คำขอ

พารามิเตอร์ประเภทคำอธิบาย
localestring (ค่าเริ่มต้น: en)ภาษาของการตอบกลับ: en | th | zh
regionIdstringรหัสประเทศหรือจังหวัด ISO (เช่น TH, US, CN)
asOfISO 8601เวลาอ้างอิงสำหรับดึงข้อมูลย้อนหลัง

รหัสสถานะ HTTP

200สำเร็จ
400ข้อมูลไม่ถูกต้อง
401ไม่ได้รับอนุญาต
404ไม่พบข้อมูล
429เกินขีดจำกัดคำขอ
500ข้อผิดพลาดเซิร์ฟเวอร์

รูปแบบการตอบกลับข้อผิดพลาด

การตอบกลับข้อผิดพลาดมีรหัสที่อ่านได้ด้วยเครื่องและรายละเอียดบริบทสำหรับการวินิจฉัยอย่างรวดเร็ว

{
  "requestId": "req_abc123",
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid regionId",
    "details": {
      "field": "regionId"
    }
  }
}