Dành cho nhà phát triển

Bản đồ học như đầu ra có cấu trúc.

Tạo và chỉnh sửa tài liệu DSL một cách xác định, sau đó hiển thị thành PNG hoặc SVG. Qua HTTP, MCP hoặc CLI — để đưa vào các đường ống và tác nhân của bạn.

Mở Studio →

example · MCP

> validate_gesta_map(doc)
  { "valid": true, "errors": [] }

> render_gesta_map(doc, format="svg")
  { "image_base64": "PD94…",
    "mime": "image/svg+xml" }

Ba bề mặt, một công cụ.

HTTP API

Điểm cuối REST

POST /api/generate      → DSL + PNG/SVG
POST /api/edit          → typed ops
POST /api/apply-ops     → deterministic patch
POST /api/rerender      → re-render
POST /api/render-svg    → SVG, id-tagged layers
POST /api/geocode       → names → coordinates

MCP

Công cụ cho tác nhân

render_gesta_map(doc, format, dpi)
validate_gesta_map(doc)  → {valid, errors}
extract_draft_from_prose(prose)
how_to(feature)          → self-explain
engine_version()

CLI

Dòng lệnh

$ gesta validate  map.gesta.yaml
$ gesta render    map.gesta.yaml -o out.svg
$ gesta geocode   map.gesta.yaml --apply
$ gesta resolve   map.gesta.yaml
$ gesta-serve     # HTTP   ·   gesta-mcp

Chỉnh sửa xác định

Mười hoạt động được gõ trên tài liệu.

Các chỉnh sửa là hoạt động trên AST, không phải tái tạo — không có hồi quy, và các chỉnh sửa thủ công vẫn tồn tại.

create_layermodify_layerdelete_layeradd_memberremove_membermodify_arrowmodify_annotationchange_viewapply_classset_disambiguation

Xác định: Cùng một tài liệu → cùng một bản đồ, chính xác đến từng pixel. Địa mã hóa trực tuyến được chụp nhanh.
Được xác thực: Mỗi tài liệu được kiểm tra dựa trên JSON Schema của định dạng V1.
Đầu ra: PNG, SVG (với một <g> cho mỗi lớp), PDF, JPG. SVG có thể chỉnh sửa ở hạ lưu.
Một công cụ: API, MCP và CLI là các trình bao bọc mỏng trên cùng một đường ống hiển thị.

Open source

The engine is open.

The renderer — the deterministic core that turns a document into a map — is open source. Read it, audit it, run it yourself, self-host. Geographic accuracy comes from the engine and its data, not from a black box.

Renderer on GitHub ↗AGPL-3.0 · commercial licence available

install

# clone the deterministic engine
git clone https://github.com/giacomocavalcabo/gesta-renderer
cd gesta-renderer
pip install -e "renderer[simplify]"

# render a document → SVG
gesta render map.gesta.yaml -o out.svg

Những cửa khác

ICho những người không lập trình→IIINgôn ngữ→