Karten: Geografische Annotation mit Punkten, Linien, Polygonen und Regionen

Neu in v2.12.0

geo_annotation bringt eine Karte auf die Annotationsseite. Annotatoren zeichnen darauf beschriftete Punkte, Linien und Polygone, setzen Stecknadeln an Orte oder vergeben Labels an die Regionen einer Umrisskarte. Die Karte ist OpenLayers 10.9.0, das Potato selbst ausliefert, sodass keine Kartenbibliothek aus dem Internet geladen wird.

annotation_schemes:
  - annotation_type: geo_annotation
    name: land_cover
    description: "Outline the land cover"
    task: draw
    tools: [polygon, freehand, point]
    labels:
      - {name: Water, color: "#0072B2"}
      - {name: Forest, color: "#009E73"}
    basemap:
      geojson: maps/regions.geojson

Das Potato-Repository enthält zwei lauffähige Beispiele. examples/advanced/dialect-map/ ist eine Draw-a-Map-Dialektbefragung über ein fiktives Land, die alle drei Aufgaben verwendet (Perzeptive Dialektologie), und examples/image/geo-annotation/ umrandet die Landbedeckung auf georeferenzierten Bildern, ein Bild pro Item, mit einem vorgeschlagenen Polygon auf dem ersten Item.

Aufgaben

Die Grundkarte

Jedes Schema braucht eine Grundkarte, in basemap oder pro Item über basemap_field, und ohne eine weisen potato validate und der Server die Konfiguration zurück. Potato greift nicht auf eine Internetkarte zurück, sodass eine Studie keine Karte aus dem Internet lädt, sofern ihre Konfiguration keine nennt.

Ein GeoJSON-Umriss lässt sich mit einer Rasterquelle kombinieren, wobei der Umriss obenauf gezeichnet wird.

Die Kachelserver der OpenStreetMap Foundation laufen auf gespendeten Ressourcen, und ihre Richtlinie zur Kachelnutzung verbietet intensive Nutzung. Eine Studie, in der viele Annotatoren eine Karte verschieben, ist intensive Nutzung, daher akzeptiert Potato die URL mit einer Warnung im Log. Hosten Sie eigene Kacheln oder verwenden Sie einen kommerziellen Anbieter.

basemap_field nennt ein Item-Feld, das die Grundkarte des Items enthält: eine GeoJSON-FeatureCollection, eine URL als String (.tif und .tiff werden als GeoTIFF gelesen, alles andere als GeoJSON) oder ein Objekt mit denselben Schlüsseln wie basemap. Der Server prüft die Grundkarte jedes Items nach denselben Regeln, bevor er das Item sendet, und ein Item darf einen externen Server nur nennen, wenn die eigene basemap des Schemas eine URL auf diesem Host nennt.

Bei classify_region ist jedes Feature des Umrisses eine Region. Ihre ID ist die Eigenschaft region_id_property (Standard id), dann die GeoJSON-Feature-ID, dann r<index>, und ihr Name ist die Eigenschaft region_name_property (Standard name).

Optionen

Die Karte verwenden

Wählen Sie zum Zeichnen ein Label und dann ein Werkzeug. Ein Punkt ist ein Klick. Eine Linie ist ein Klick pro Punkt und ein Doppelklick auf den letzten. Ein Polygon ist ein Klick pro Ecke, abgeschlossen durch einen Klick auf die erste Ecke, einen Doppelklick oder Enter, wobei Backspace die letzte Ecke entfernt und Esc abbricht. Freihand ist Drücken und Ziehen. Das Auswahlwerkzeug formt ein Feature über seinen Umriss oder einen Eckpunkt um, und Delete entfernt es. Jedes Feature erscheint in der Liste unter der Karte mit einem Label-Menü, dem Namensfeld, Show und Delete.

Bei Stecknadeln zeigt die Liste eine Zeile pro Label, und ein Klick auf die Karte setzt die aktive. Bei Regionen wählen Sie eine Label-Schaltfläche und klicken auf Regionen.

Gehen Sie mit der Tastatur per Tab zur Karte; dann verschieben die Pfeiltasten die Ansicht, und + und - zoomen. Add point at map centre und Use map centre setzen Punkte ohne Maus, und Label, Name und Löschen jedes Features sind über die Liste erreichbar.

Features aus preannotation_field sind mit "(suggested)" gekennzeichnet. Sie werden erst dann als Antwort des Annotators gespeichert, wenn der Annotator eines bearbeitet oder Accept suggestions drückt, sodass ein Item, das der Annotator nur geöffnet hat, nicht als beschriftet zählt.

Gespeicherte Daten

Die Antwort ist eine GeoJSON-FeatureCollection in EPSG:4326 nach RFC 7946: Positionen sind [longitude, latitude], äußere Ringe verlaufen gegen den Uhrzeigersinn und Löcher im Uhrzeigersinn, Koordinaten haben 7 Nachkommastellen (etwa 1 cm), und Längengrade werden in den Bereich -180 bis 180 umgebrochen.

{"type": "FeatureCollection", "features": [
  {"type": "Feature", "id": "f1",
   "geometry": {"type": "Polygon", "coordinates": [[[-29.0, -38.3], [-28.2, -38.3], [-28.6, -37.5], [-29.0, -38.3]]]},
   "properties": {"label": "Very different", "text": "Coast talk", "tool": "polygon"}}
]}

Das Schema funktioniert auch auf Umfrageseiten, wo es kein Item gibt, sodass basemap_field und preannotation_field dort nichts bewirken.

Export

# Every feature as GeoJSON, one file per item (geojson/<item>.geojson)
python -m potato.export --config config.yaml --format geojson --output out/
# ... or one file for the whole project
python -m potato.export --config config.yaml --format geojson --output out/ --option layout=single
 
# Heat maps of overlapping polygons, plus CSVs of names and region labels
python -m potato.export --config config.yaml --format geo_overlap --output out/

Der GeoJSON-Export normalisiert jedes Feature erneut und fügt seinen Eigenschaften item_id, user_id, schema und feature_id hinzu. Features, die sich nicht normalisieren lassen, etwa eine Position außerhalb des gültigen Bereichs oder ein Ring ohne Fläche, werden ausgelassen und in den Exportwarnungen aufgeführt. Antworten aus classify_region erhalten ihre Regionsgeometrie aus dem Umriss zurück. geo_overlap wird in Perzeptive Dialektologie beschrieben.

Grenzen

• Ein Polygon, das den 180. Längengrad überquert, wird nicht geteilt; zeichnen Sie daher zwei Polygone.
• Ein GeoTIFF in einer anderen Projektion als EPSG:4326 oder EPSG:3857 wird nicht angezeigt, und ohne WebGL wird überhaupt kein GeoTIFF angezeigt. Die Seite weist darauf hin, und der Umriss funktioniert weiterhin.
• Ein GeoTIFF wird ohne Interpolation gezeichnet, sodass beim Hineinzoomen die tatsächlichen Pixelgrenzen sichtbar werden.
• Für Pixelkoordinaten auf einem gewöhnlichen Bild statt geografischer Koordinaten verwenden Sie die Bildannotation.

Weiterführende Informationen

• Perzeptive Dialektologie - Draw-a-Map-Dialektbefragungen und Überlappungs-Heatmaps
• Kamerafallen - Detektorprüfung mit Export von Darwin-Core-Vorkommen
• Annotation ohne Netzwerkverbindung - Potato ohne Internetzugang betreiben

Implementierungsdetails finden Sie in der Quelldokumentation.