Apollo Map Studio

English

简体中文

English

简体中文

Apollo Map StudioHD Map Editor for Apollo

Import, visualise, edit, derive topology, recompute overlaps, and export Apollo base_map data — across Web and Electron desktop, in binary and text protobuf round-trip.

Get Started
Import Your First Map
Architecture Overview
GitHub
Apollo Map Studio
🗺️

Full Apollo Element Coverage

Edit every base_map entity — Lane, Junction, PNC Junction, ParkingSpace, Crosswalk, Signal, StopSign, SpeedBump, YieldSign, ClearArea, Boundary, Region — with first-class visual tooling.

✏️

Powerful Drawing Toolbox

Polyline, Catmull-Rom, Bezier, Arc, Rotated Rect, and Polygon tools — plus click-to-draw, double-click / Enter to commit, control point dragging, Alt smooth-toggle, centre dragging, multi-target alignment and snapping.

🔗

Automatic Topology Derivation

Predecessor / successor / neighbor / self_reverse / junction_id are recomputed from lane endpoint coincidence, geometric adjacency, reverse twins, and junction polygon intersection — incrementally on edit.

🧬

Overlap Recomputation

overlap_id values are maintained from geometric truth across import / edit / export. Lane × crosswalk region overlaps can be pinned in the Inspector to survive recomputation.

📦

Apollo Round-Trip IO

Imports and exports .bin, .txt, and .pb.txt protobuf encodings; preserves header, projection metadata, and untouched fields so a third-party Apollo tool can re-consume the result.

🪟

Photoshop-Style Workbench

Menubar, ToolStrip, Activity Bar, resettable Dockview workspace, Outline, Layer Tree, Search, Inspector, Timeline, and StatusBar — every panel can be docked, floated, or rearranged.

⚡

Cold / Hot Layered Rendering

The Cold Layer maintains a spatial index, decoration cache, and RBush in a Web Worker; the Hot Layer redraws live previews per frame on the main thread. Phase E incremental decoration only re-renders affected lanes.

🖥️

Web & Desktop, One Codebase

Vite-powered web editor for development; Electron shell for desktop, with cross-platform packaging into Linux AppImage, macOS DMG, and Windows NSIS installers.

🔑

Offline Machine-Bound Licensing

The desktop build ships an offline activation flow bound to machine fingerprint; edit actions are uniformly intercepted by editableGuard until activated.

🧠

XState 5 Finite State Machine

editorMachine is the single source of truth for editor interaction, covering idle / drawing / editing states, working hand in hand with useDrawCommit and useActionDispatcher to keep undo / redo and mid-draw cancel coherent.

🧱

Strict Layering & Anti-Corruption

components → hooks → store → lib → core, one-way imports. The entityOps anti-corruption layer shields the UI from Apollo proto v2 upgrade risk — UI code sees only the abstract MapEntity model.

🧪

Complete CI Pipeline

typecheck, ESLint, Prettier, Vitest, benchmarks with regression budgets, husky + lint-staged pre-commit — performance regressions are auto-blocked at PR time.

Where to start ​

If you want to…Start here
Try Apollo Map Studio for the first timeQuick Start
Import an Apollo base_mapImport → Import Deep Dive
Draw lanes and connect themDrawing Tools → Drawing Lanes
Understand coordinates & projectionCoordinate System
Edit attributes in the InspectorInspector
Export the map back to ApolloExport → Export Deep Dive
Activate a desktop licenseLicense Activation
Hack on internalsArchitecture Overview
Add a new action / tool / elementRecipes
Contribute via PRDevelopment Setup

Key concepts ​

  • base_map — the source HD map format from Apollo; the editor's input and output reference.
  • MapEntity — internal entity abstraction, kept proto-agnostic by entityOps.
  • Cold / Hot Layer — committed geometry (cold) and in-flight drawing / editing geometry (hot) flow through different render pipelines.
  • FSM — XState 5 editorMachine, the single truth source for interaction.
  • Junction Graph — endpoint-dependency graph used for incremental decoration.
  • Overlap — N : N references between geometrically overlapping elements (e.g. lane × signal, lane × crosswalk).

Status ​

Contributors

The avatar of contributor named as kent kent

Changelog

Released under the CC BY-NC 4.0 License.

Copyright © 2024-present ShuYingJiYu