trip-map-3d

Was macht trip-map-3d?

Verwandle eine Reise in eine Website: eine echte 3D-Karte pro Region, eine animierte Route pro Tag, Pins, Karten, Wetter und Offline-Unterstützung. Alles stammt aus einer einzigen Datei, trip.yaml.

1. Fragen zur Reise

Frage nach dem, was du noch nicht hast, jeweils ein paar Fragen auf einmal:

• Wo, wann und wie viele Tage.
• Für jeden Tag: was sie vorhaben zu tun, und in welcher Reihenfolge. Namen reichen aus.
• Wo sie übernachten. Warne sie zuerst, dass die Website auf einem kostenlosen GitHub-Konto öffentlich ist, daher reicht eine Nachbarschaft. Gib niemals eine Straßenadresse an, es sei denn, sie bestehen nach dieser Warnung darauf.
• Sprache (en, pt-BR, es) und Einheiten.
• Optional: Surfspots, Gezeiten, Fotos, ein Theme.

Fotos müssen ihre eigenen oder lizenziert sein. Lade keine Fotos aus dem Internet für sie herunter.

2. Schreibe trip.yaml

Folge examples/trip.example.yaml. Nur title, dates.start und days sind erforderlich. Füge immer die Stadt zu einem Ortsnamen hinzu: "Pantheon, Roma", nicht "Pantheon".

3. Erstellen und überprüfen

python -m pip install -r requirements.txt
python -m pipeline check trip.yaml

Lies den Bericht Zeile für Zeile mit dem Benutzer. Der Geocoder kann mit hoher Wahrscheinlichkeit falsch liegen, zeige ihm daher jeden gefundenen Ort. Jede mit CHECK markierte Zeile muss überprüft werden. Wenn ein Ort falsch ist oder fehlt, füge lat und lon in places: ein, anstatt die Suche zu wiederholen.

Dann erstellen:

python -m pipeline build trip.yaml --out dist
python -m pip install -r requirements-dev.txt
python tools/check_site.py dist --shots shots --hashes "" dia-1

Öffne die Screenshots und sieh sie dir an, bevor du sagst, dass es funktioniert. Überprüfe, dass jeder Ort passt, keine Route unter einer Karte liegt und kein Fehler ausgegeben wurde.

4. Veröffentlichen, nur nach Bestätigung des Benutzers

Bestätige den Repository-Namen und dass es öffentlich sein wird. Dann:

1. Pushe in ein Repository, das aus dieser Vorlage erstellt wurde.
2. Gehe zu Einstellungen, Pages, setze Quelle auf GitHub Actions. Dieser Schritt ist manuell.
3. Der Workflow erstellt und veröffentlicht bei jedem Push.

Regeln

• Öffentliche Dienste werden geteilt. Durchlaufe sie niemals in einer Schleife. trip.lock.json speichert jede Antwort: committe sie und lösche sie niemals, um es erneut zu versuchen.
• Dieses Projekt verwendet nicht die öffentliche Nominatim-API. Ihre Richtlinien verbieten die Einbindung in Tools wie dieses als generischen Geocoder. Wenn der Benutzer nach Nominatim fragt, verweise ihn auf die Nutzungsrichtlinien und auf services.geocoder für eine eigene Instanz.
• Die kostenlose Open-Meteo-API ist für nicht-kommerzielle Nutzung bestimmt. Ein Reisebüro benötigt einen kostenpflichtigen Schlüssel: setze services.open_meteo_key.
• Behalte die Datenquellenangaben auf der Website. Sie sind rechtlich erforderlich (siehe DATA_SOURCES.md).