开发者文档

集成
GlobMaps API

生产级地理智能 API——Risk Map、Outbreak Radar、Supply Chain Intelligence、GeoLLM、Smart Alerts 及 API Access，无需配置，即刻集成。

简介

GlobMaps 提供企业级地理智能 API，涵盖疫情检测、气候风险制图与全球供应链可视化。每个端点均返回结构一致的 JSON 响应，支持企业级快速集成。

产品与模块

GlobMaps 提供专业的地理智能模块：Flood API、Wildfire API、Drought API、Climate Risk Scoring API、Outbreak Radar（疾病监测）、Supply Chain Intelligence（港口监控）、GeoLLM Copilot（自然语言界面）、Smart Alerts（地理触发警报）以及 API Access（编程数据访问）。

身份验证

在每个生产环境请求的 X-API-Key 请求头中附上您的 API 密钥以完成身份验证。密钥按账户签发，并与特定模块绑定。您可随时通过 GlobMaps 控制台获取或轮换密钥。

快速开始

几分钟内即可完成 GlobMaps 集成。携带 API 密钥发送 GET 请求，即可获取任意坐标的实时风险情报（洪水、野火、疫情等）——无需复杂配置。

API 端点

访问专用生产端点：/v1/flood-api、/v1/wildfire-api、/v1/drought-api、/v1/climate-risk、/v1/outbreak-radar 及 /v1/supply-chain。每个端点均返回高可用、实时的智能情报。

响应格式

所有 GlobMaps API 响应均遵循统一的信封结构——requestId 用于追踪，asOf 表示数据时效性，typed data 为主体数据，warnings 数组提供非阻塞性提示信息。

错误处理

GlobMaps 采用标准 HTTP 状态码。错误响应包含机器可读的代码、人类可读的消息以及上下文详情，帮助您快速诊断并解决问题。

代码示例

使用您偏好的编程语言获取泰国的实时风险数据。

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
regionIdstringISO 国家或省份代码（如 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"
    }
  }
}