DOCUMENTATION

Build with
GlobMaps API.

Production-ready geo-intelligence APIs — Risk Map, Outbreak Radar, Supply Chain Intelligence, GeoLLM, Smart Alerts, and API Access. Zero setup. Instant integration.

Introduction

GlobMaps provides production-ready geo-intelligence APIs for outbreak detection, climate risk mapping, and global supply chain visibility. Every endpoint returns structured JSON with a consistent response envelope, enabling rapid integration at enterprise scale.

Products & Modules

GlobMaps offers professional geo-intelligence modules: Flood API, Wildfire API, Drought API, Climate Risk Scoring API, Outbreak Radar (disease surveillance), Supply Chain Intelligence (port monitoring), GeoLLM Copilot (natural language interface), Smart Alerts (geo-triggered alerts), and API Access (programmatic data access).

Authentication

Authenticate every production request by including your API key in the X-API-Key header. Keys are issued per account and scoped to specific modules. Obtain or rotate your key from the GlobMaps dashboard at any time.

Quick Start

Integrate GlobMaps in minutes. Send a GET request with your API key to retrieve real-time risk intelligence (Flood, Wildfire, Outbreak, etc.) for any coordinate — no complex setup required.

Endpoints

Access dedicated production endpoints: /v1/flood-api, /v1/wildfire-api, /v1/drought-api, /v1/climate-risk, /v1/outbreak-radar, and /v1/supply-chain. Each returns high-availability, real-time intelligence.

Response Format

All GlobMaps API responses share a consistent envelope — requestId for tracing, asOf for data freshness, a typed data payload, and an optional warnings array for non-blocking advisories.

Error Handling

GlobMaps uses standard HTTP status codes. Error responses include a machine-readable code, a human-readable message, and contextual details to help you diagnose and resolve issues quickly.

Code Examples

Retrieve real-time risk data for Thailand using your preferred language.

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()

Response Format

Every GlobMaps API response follows a consistent envelope structure.

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

Query Parameters

ParameterTypeDescription
localestring (default: en)Response language: en | th | zh
regionIdstringISO country or province code (e.g. TH, US, CN)
asOfISO 8601Timestamp for historical data retrieval

HTTP Status Codes

200Success
400Validation Error
401Unauthorized
404Not Found
429Rate Limited
500Server Error

Error Response

Error responses include a machine-readable code and contextual details for quick diagnosis.

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