Find and inspect
Search the catalog by theme, format, license or area. Read the actual data schema before choosing fields or operations.
AI-native map service · MCP + REST
Maps for
AI agents.
Discover map sources. Retrieve real geometry. Carry the evidence.
Black Sail Map gives agents machine-readable maps, spatial operations and traceable results through MCP and HTTP APIs.
黑帆地图为 AI Agent 提供可发现、可获取、可验证的地图数据。
此页面用于了解服务与接入。
REFERENCE WORKFLOWGeoJSON · CRS84
TOOL / map_point_lookup
{
"id": "ne-110m-countries",
"longitude": 104.0665,
"latitude": 30.5723
}→ VERIFIED EXAMPLE RESULT
{
"numberMatched": 1,
"ADMIN": "China",
"ADM0_A3": "CHN"
}Selected result fields; source, license and hash accompany API output.
7 real data layersApproved acquisition & processing
8 MCP toolsAnonymous public read access
GeoJSON + CRS84Longitude, then latitude
Source evidenceVersion, license & SHA-256
From a map request
to usable data.
Agents can inspect available sources, select by explicit constraints, obtain real features and perform supported spatial operations. Every result keeps its origin and limits in view.
Get real geometry
Fetch approved GeoJSON, filter by property or geometric intersection, and classify points against polygon layers.
Keep the provenance
Inspect the source release, acquisition time, license and pinned content hash. Verification checks integrity and geometry structure.
Real layers.
A defined scope.
Seven generalized Natural Earth layers are available for automatic retrieval and processing. The wider catalog includes six additional source descriptors; those are discovery-only.
| Data layer | Geometry | Features |
|---|---|---|
| Country boundariesne-110m-countries | MultiPolygon, Polygon | 177 |
| Global land polygonsne-110m-land | Polygon | 127 |
| Global coastlinesne-110m-coastline | LineString | 134 |
| Global ocean polygonsne-110m-ocean | Polygon | 2 |
| Global lakesne-110m-lakes | Polygon | 24 |
| Global rivers and lake centerlinesne-110m-rivers | LineString | 13 |
| Global populated placesne-110m-places | Point | 243 |
Natural Earth v5.1.2 · Public domain · 1:110,000,000 reference geography. Read the machine catalog →
A source behind
every result.
Dataset metadata and output include concrete provenance. Agents should preserve it when deriving answers, rather than turn a successful request into a claim of measurement accuracy.
Data with a traceable origin
Fixed upstream releases, source URLs, public-domain terms and SHA-256 checks identify the actual publisher snapshot used.
- Actual property schemas and geometry types
- Acquisition time and cache state
- Explicit stale fallback and upstream failure details
Machine access, clearly separated
POST /agent/mcp exposes public read-only tools. REST APIs, the machine manifest and OpenAPI are available without sign-in.
/mcpuses platform OAuth for ChatGPT- Maintenance writes require a protected token
- Unsupported source adapters return an error
Know the limits
before using a map.
Current processing is scoped to these static vector datasets and supported operations. Source discovery does not mean that a dataset can be acquired or is suitable for any task.
Generalized reference geography
- 1:110,000,000 is a map scale, not 110-meter accuracy.
- No navigation, cadastral or legal-boundary conclusions.
- No live weather, hourly ocean currents or street routing.
- Spatial filtering selects whole features; it does not clip them.
- Time of release is not a uniform observation date.
- SHA-256 verifies content integrity, not positional accuracy.
Let an agent find its next map.
Start with the manifest, inspect the contract, then call the tools.