diff --git a/README.md b/README.md index 925bf62..dd6bb47 100644 --- a/README.md +++ b/README.md @@ -1,19 +1,18 @@ -# GPX Route Mapper +# GPX Route Editor -A 100% client-side tool to **draw ferry / sailing routes on OpenStreetMap and export them as GPX** — a [Ferry La](https://www.ferry.hk) × [Stealth Co.](https://stealth-company.co) project for hand-plotting the sea routes that automated routing can't get right. +A 100% client-side editor for **drawing, importing, reshaping, inspecting and exporting GPX tracks on OpenStreetMap**. Adjust route geometry and supported point metadata in the browser without uploading the GPX file. Framing an imported track still fetches OpenFreeMap tiles for that geographic area, so the tile service can infer the route’s approximate region. -Two things set it apart from a plain map drawer: +It is a [Ferry La](https://www.ferry.hk) × [Stealth Co.](https://stealth-company.co) open-source project, but it is not limited to ferry routes. Use it for walking, cycling, driving, sailing or any custom track that you want to shape manually. Optional OpenStreetMap ferry data remains available as one reference source. -- **An "Artistic" basemap** — the same OSM data rendered in ferry.hk's monochrome green + fine-line house style, toggleable against the standard map. -- **A live OSM ferry-route overlay, with bilingual (中文 · English) names** — the real published sailing lines drawn underneath your cursor, so you can *trace* them instead of guessing. +[Open the GPX Route Editor](https://stealth-engine.github.io/gpx-route-editor/) -No API keys, no backend, no build step — the whole app is one `index.html`, deliberately simpler than the big route-planning tools. Open the file and go. +No API keys, no backend and no build step are required. The whole app is one `index.html`, deliberately simpler than a full route-planning service: you control the track geometry and the editor does not invent turn-by-turn directions. ## Features - **OpenStreetMap basemap** via [MapLibre GL JS](https://maplibre.org/) + [OpenFreeMap](https://openfreemap.org/) vector tiles — no key required. -- **Artistic (ferry.hk) basemap** — monochrome deep-green land/water with hairline roads and coastline, generated as a custom MapLibre style over the same vector data. -- **OSM ferry routes overlay** — real `route=ferry` lines drawn as a cyan dashed reference, **with bilingual labels** (`name:zh-Hant · name:en`, falling back gracefully). Works on *both* basemaps. Toggle on/off. +- **Standard and Artistic basemaps** — switch between the normal map and Ferry La's monochrome deep-green MapLibre style over the same OpenStreetMap vector data. +- **Optional OSM ferry references** — load or overlay real `route=ferry` lines, with bilingual labels where available, when a sailing line is useful to the track you are editing. - **Edit a route** — click the map to append points, use the `+` handles to insert points between existing ones, and select a point to reveal contextual **Edit** and **Delete** actions directly on the map. Drag the selected point to move it. Undo with **⌘/Ctrl+Z** and redo with **⌘/Ctrl+Y** or **⌘/Ctrl+Shift+Z**. - **Route shaping** — keep the original line, apply Catmull-Rom smoothing, or snap control points onto nearby OSM roads, paths, tracks, and ferry sailings. Snap follows mapped geometry across vector-tile boundaries; ferry matching also bridges small fragment gaps and can change lines at visible sailing-route intersections. - **Place search** — Google-style start + optional destination boxes ([Nominatim](https://nominatim.org/) geocoding) that drop start/end markers and frame the view. @@ -35,7 +34,8 @@ python3 -m http.server 8000 ``` - Or open `index.html` directly in a browser. -- Or enable **GitHub Pages** (Settings → Pages → deploy from `main`) to host it at a public URL. +- Or use the hosted editor at **https://stealth-engine.github.io/gpx-route-editor/**. +- To host your own fork, enable **GitHub Pages** (Settings → Pages → deploy from `main`). ## How to use the editor @@ -113,8 +113,8 @@ Use **Map** to collapse the control sheet and **Controls** to reopen it. When a ## Notes -- Ferry **labels appear only where OSM has a name** for the route. Major services (Star Ferry, Sun Ferry to the outlying islands) are named; some minor kaito services aren't and show only the dashed line. -- Everything runs in the browser — the only network calls are to the public OSM tile/geocoding services above. +- The ferry source and overlay are optional map references, not a restriction on the kinds of GPX tracks you can edit. Ferry labels appear only where OpenStreetMap provides a route name. +- Everything runs in the browser — the GPX file and exact track points are never uploaded. Network calls go only to the public OSM tile and geocoding services above; fitting the map to an imported or drawn route requests tiles for the visible viewport, which can reveal the geographic area being edited. ## License diff --git a/index.html b/index.html index eaecb4b..b5fd11b 100644 --- a/index.html +++ b/index.html @@ -7,26 +7,26 @@ - + - - - + + + - + - - + + @@ -45,8 +45,8 @@ "@type": "WebApplication", "name": "GPX Route Editor", "alternateName": "GPX Route Editor by Ferry La", - "url": "https://stealth-engine.github.io/gpx-route-mapper/", - "image": "https://stealth-engine.github.io/gpx-route-mapper/og-image.png", + "url": "https://stealth-engine.github.io/gpx-route-editor/", + "image": "https://stealth-engine.github.io/gpx-route-editor/og-image.png", "description": "Draw, import, edit, smooth and export GPX tracks while preserving timestamps, elevation and sensor metadata locally in your browser.", "applicationCategory": "UtilitiesApplication", "operatingSystem": "Any", @@ -315,7 +315,7 @@
- Help & instructions + Help & instructionsProcessed locally in your browser
diff --git a/robots.txt b/robots.txt index 4954d19..b8a140a 100644 --- a/robots.txt +++ b/robots.txt @@ -1,4 +1,4 @@ User-agent: * Allow: / -Sitemap: https://stealth-engine.github.io/gpx-route-mapper/sitemap.xml +Sitemap: https://stealth-engine.github.io/gpx-route-editor/sitemap.xml diff --git a/sitemap.xml b/sitemap.xml index 4f835c8..1d9781d 100644 --- a/sitemap.xml +++ b/sitemap.xml @@ -1,7 +1,7 @@