Geliştiriciler için

Kartografi yapılandırılmış çıktı olarak.

DSL belgesini deterministik olarak oluşturun ve düzenleyin, ardından PNG veya SVG'ye dönüştürün. HTTP, MCP veya CLI üzerinden — boru hatlarınıza ve ajanlarınıza entegre edin.

Studio'yu aç →

örnek · MCP

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

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

Üç yüzey, bir motor.

HTTP API

REST uç noktaları

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

Ajanlar için araçlar

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

Komut satırı

$ 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

Deterministik düzenleme

Belgede on yazılı işlem.

Düzenlemeler AST üzerinde işlemlerdir, yeniden oluşturmalar değildir — regresyon yoktur ve manuel düzenlemeler kalır.

create_layermodify_layerdelete_layeradd_memberremove_membermodify_arrowmodify_annotationchange_viewapply_classset_disambiguation

Deterministik: Aynı belge → aynı harita, piksele kadar. Çevrimiçi coğrafya kodlama anlık görüntüsü alınır.
Doğrulanmış: Her belge V1 biçiminin JSON Schema'sına karşı kontrol edilir.
Çıktı: PNG, SVG (katman başına <g> ile), PDF, JPG. SVG aşağı akışta düzenlenebilir.
Bir motor: API, MCP ve CLI aynı render boru hattının ince sarmalayıcılarıdır.

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

Diğer kapılar

IKodlamayan kullanıcılar için→IIIDil→