API 参考手册

GlobMaps
API 参考手册

生产级气候智能 API。真实干旱数据（ERA5/SPEI）、疾病监测与供应链情报——单个 API 密钥即可访问全部。

请求提前访问查看定价

身份验证

所有端点均需 X-API-Key 请求头。在 GlobMaps 控制台获取您的密钥。

X-API-Key: <your_api_key>
Content-Type: application/json(POST only)

Base URL

PRODUCTION
https://api.globmaps.com

需要 X-API-Key，按计划限速。

DASHBOARD API
https://app.globmaps.com/api

会话认证。供控制台 UI 使用。

干旱严重程度等级（USDM / EU CDI）

LevelDescriptionScoreSPEI-1
🟡 D0Abnormally Dry≥40-0.5 to -0.8
🟠 D1Moderate Drought≥50-0.8 to -1.3
🔴 D2Severe Drought≥65-1.3 to -1.6
🚨 D3Extreme Drought≥80-1.6 to -2.0
⛔ D4Exceptional Drought≥95< -2.0

风险等级参考

低
0–29
中
30–59
高
60–79
严重
80–100

风险评分 API

任意坐标的综合风险评分。干旱使用真实 ERA5/SPEI 数据，其他类型使用聚合实时数据。

POST/api/risk-map/scoreREAL DATA

获取任意坐标的综合风险评分。支持干旱（ERA5/SPEI 真实数据）、洪水、野火、热浪和风暴风险类型。

请求体
latnumberreq
纬度（-90 到 90）
lngnumberreq
经度（-180 到 180）
riskTypestringreq
风险类型
includeHistoricalbooleanopt
包含历史背景（默认：false）
timeframestringopt
时间范围（默认：30d）
请求示例
curl -X POST "https://api.globmaps.com/api/risk-map/score" \
  -H "X-API-Key: <your_api_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "lat": 13.7563,
  "lng": 100.5018,
  "riskType": "drought",
  "timeframe": "30d"
}'
响应示例
{
  "success": true,
  "data": {
    "location": { "lat": 13.7563, "lng": 100.5018 },
    "riskType": "drought",
    "riskScore": 67,
    "riskLevel": "high",
    "summary": "Drought severity: D2 (SPEI-1: -1.42). 3.2km from nearest grid point.",
    "details": {
      "currentConditions": {
        "spei1": -1.42, "spei3": -1.18, "spei6": -0.91, "spei12": -0.54,
        "severity": "D2", "distanceKm": 3.2, "month": "2026-04"
      }
    },
    "dataSources": ["ERA5 Climate Reanalysis", "GlobMaps Drought Pipeline"],
    "timestamp": "2026-05-10T08:00:00Z"
  }
}
POST/api/risk-map/score?format=geojson

与上方相同，但返回 GeoJSON Feature 格式——可直接用于 QGIS、ArcGIS、Mapbox 和 Kepler.gl。

请求示例
curl -X POST "https://api.globmaps.com/api/risk-map/score" \
  -H "X-API-Key: <your_api_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "lat": 13.7563,
  "lng": 100.5018,
  "riskType": "drought"
}'
响应示例
{
  "type": "Feature",
  "geometry": { "type": "Point", "coordinates": [100.5018, 13.7563] },
  "properties": {
    "riskType": "drought",
    "riskScore": 67,
    "riskLevel": "high",
    "summary": "Drought severity: D2 (SPEI-1: -1.42).",
    "spei1": -1.42, "spei3": -1.18,
    "dataSources": ["ERA5 Climate Reanalysis", "GlobMaps Drought Pipeline"],
    "timestamp": "2026-05-10T08:00:00Z"
  }
}

干旱 API

基于 ERA5 再分析数据的完整 SPEI/SPI 干旱情报。支持格网级和省级查询。

GET/api/risk-map/droughtREAL DATA

查询任意坐标的干旱指数（SPEI-1/3/6/12、SPI-1、MCDI）。返回最近格网点及完整气候学详情。

查询参数
latnumberreq
纬度
lngnumberreq
经度
monthstringopt
YYYY-MM 格式（默认：最新）
请求示例
curl "https://api.globmaps.com/api/risk-map/drought?lat=13.7563&lng=100.5018" \
  -H "X-API-Key: <your_api_key>"
响应示例
{
  "success": true,
  "data": {
    "location": {
      "requestedLat": 13.7563, "requestedLng": 100.5018,
      "gridId": "THA_1234", "gridLat": 13.75, "gridLng": 100.50,
      "distanceKm": 0.8, "country": "THA"
    },
    "period": {
      "month": "2026-04",
      "climatologyBaseline": "1991-2020"
    },
    "drought": {
      "score": 67, "level": "high",
      "indices": { "spei1": -1.42, "spei3": -1.18, "spei6": -0.91, "spei12": -0.54, "spi1": -1.31, "mcdi": -1.05 },
      "severity": { "spei1": "D2" }
    }
  }
}
GET/api/risk-map/drought/provinceREAL DATA

按省份名称查询干旱数据。目前支持泰国全部 77 个府（country=THA）。

查询参数
namestringreq
省份名称（如 Bangkok、Chiang Mai）
countrystringopt
ISO 国家代码（默认：THA）
monthstringopt
YYYY-MM 格式（默认：最新）
请求示例
curl "https://api.globmaps.com/api/risk-map/drought/province?name=Chiang+Mai&country=THA" \
  -H "X-API-Key: <your_api_key>"
响应示例
GET /api/risk-map/drought/province?name=Chiang+Mai&country=THA

{
  "success": true,
  "data": {
    "province": "Chiang Mai",
    "country": "THA",
    "month": "2026-04",
    "score": 72,
    "level": "high",
    "indices": { "spei1": -1.61, "spei3": -1.32, "spei6": -1.08 },
    "severity": { "spei1": "D3" }
  }
}

批量 API

一次调用处理多个位置。GeoJSON 输出可直接用于 GIS 工具。

POST/api/risk-map/batchREAL DATA

单次请求最多处理 100 个位置，返回每个坐标的干旱指数。支持 JSON 和 GeoJSON FeatureCollection 输出。

请求体
locationsarrayreq
{id?, lat, lng} 数组，最多 100 个
riskTypestringreq
drought（当前唯一支持的类型）
formatstringopt
json · geojson（默认：json）
请求示例
curl -X POST "https://api.globmaps.com/api/risk-map/batch" \
  -H "X-API-Key: <your_api_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "riskType": "drought",
  "format": "json",
  "locations": [
    { "id": "bkk",  "lat": 13.7563, "lng": 100.5018 },
    { "id": "cnx",  "lat": 18.7883, "lng": 98.9853  },
    { "id": "hkt",  "lat": 7.8804,  "lng": 98.3923  }
  ]
}'
响应示例
{
  "success": true,
  "data": {
    "count": 3,
    "riskType": "drought",
    "results": [
      { "id": "bkk", "lat": 13.7563, "lng": 100.5018, "riskScore": 67, "riskLevel": "high",   "severity": "D2", "spei1": -1.42 },
      { "id": "cnx", "lat": 18.7883, "lng": 98.9853,  "riskScore": 78, "riskLevel": "high",   "severity": "D3", "spei1": -1.68 },
      { "id": "hkt", "lat": 7.8804,  "lng": 98.3923,  "riskScore": 22, "riskLevel": "low",    "severity": null, "spei1":  0.31 }
    ],
    "timestamp": "2026-05-10T08:00:00Z"
  }
}

Outbreak Radar API

由 WHO EIOS、CDC FluNet、ProMED 和 HealthMap 驱动的疾病监测情报。

POST/api/outbreak-radar/query

任意坐标的疾病监测情报。由 WHO EIOS、CDC FluNet、ProMED 和 HealthMap 数据源驱动。

请求体
latnumberreq
纬度
lngnumberreq
经度
diseaseTypestringreq
疾病类型
timeframestringopt
时间范围（默认：30d）
请求示例
curl -X POST "https://api.globmaps.com/api/outbreak-radar/query" \
  -H "X-API-Key: <your_api_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "lat": 13.7563,
  "lng": 100.5018,
  "diseaseType": "dengue",
  "timeframe": "30d"
}'
响应示例
{
  "success": true,
  "data": {
    "location": { "lat": 13.7563, "lng": 100.5018 },
    "diseaseType": "dengue",
    "riskScore": 78,
    "riskLevel": "high",
    "outbreakStatus": "warning",
    "activeClusters": 3,
    "caseEstimate": 1240,
    "trend": "increasing",
    "summary": "Elevated dengue activity confirmed in Bangkok metro area.",
    "details": {
      "intelligence": "WHO EIOS monitoring confirms elevated dengue activity...",
      "keyFindings": [
        "Risk score: 78/100 based on WHO EIOS + CDC FluNet",
        "3 active clusters within 100km radius",
        "Trend: increasing — 30-day rolling average"
      ]
    },
    "dataSources": ["WHO EIOS", "CDC FluNet", "ProMED", "HealthMap", "ECDC"],
    "timestamp": "2026-05-10T08:00:00Z"
  }
}

Supply Chain Intelligence API

来自 AIS 和 UN Comtrade 的港口拥堵、船舶追踪、ETA 延误及贸易中断情报。

POST/api/supply-chain/query

港口拥堵、船舶数量、ETA 延误及贸易中断情报。提供坐标或 UN/LOCODE 港口代码。

请求体
latnumberopt
纬度——未提供 portCode 时必填
lngnumberopt
经度——未提供 portCode 时必填
portCodestringopt
UN/LOCODE（如 THLCH、SGSIN、NLRTM）
queryTypestringreq
查询类型
请求示例
curl -X POST "https://api.globmaps.com/api/supply-chain/query" \
  -H "X-API-Key: <your_api_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "portCode": "THLCH",
  "queryType": "congestion"
}'
响应示例
{
  "success": true,
  "data": {
    "port": { "code": "THLCH", "name": "Laem Chabang" },
    "queryType": "congestion",
    "congestionIndex": 54,
    "vesselCount": 18,
    "avgDwellDays": 3.2,
    "etaDelayHours": 14,
    "disruptionRisk": "medium",
    "summary": "Moderate congestion at Laem Chabang — above baseline threshold.",
    "details": {
      "keyFindings": [
        "Congestion index: 54/100 — above baseline of 40",
        "18 vessels at anchor — 4 bulk carriers, 9 container ships, 5 tankers",
        "ETA delay: +14 hours average vs scheduled arrival"
      ]
    },
    "dataSources": ["AIS Real-time (MarineTraffic)", "VesselsValue", "UN Comtrade"],
    "timestamp": "2026-05-10T08:00:00Z"
  }
}

错误代码

400VALIDATION_ERRORMissing or invalid request parameters
401INVALID_API_KEYMissing, invalid, or expired API key
404NOT_FOUNDNo data available for this location
429RATE_LIMIT_EXCEEDEDRequest quota exceeded for your plan
500INTERNAL_ERRORUnexpected server error