diff --git a/docs/img/web-forms/geopoint-maps-appearance.png b/docs/img/web-forms/geopoint-maps-appearance.png index 465488c19..9f6453962 100644 --- a/docs/img/web-forms/geopoint-maps-appearance.png +++ b/docs/img/web-forms/geopoint-maps-appearance.png @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:772395e13d8bf1b463ac938d11ffdc4caf831054eebe19e22e10873a0e669229 -size 2532104 +oid sha256:f97fb1f21f49f3a0b528dcf8d6dacabcb73b987fc6ed337931f2b9c8a86d007a +size 189735 diff --git a/docs/img/web-forms/geopoint-placement-map-appearance.png b/docs/img/web-forms/geopoint-placement-map-appearance.png index 90c529bdf..042952573 100644 --- a/docs/img/web-forms/geopoint-placement-map-appearance.png +++ b/docs/img/web-forms/geopoint-placement-map-appearance.png @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:bf0e08d22fcb743e84e161eac0b7626a83a7c416a6c5059bee52a0fe77183b04 -size 3082199 +oid sha256:e5dabb53a5b4470dcaf25c5104d0dabad7d9d841f3499ae61646181eaedf8413 +size 473274 diff --git a/docs/img/web-forms/geoshape.png b/docs/img/web-forms/geoshape.png new file mode 100644 index 000000000..7b49b5878 --- /dev/null +++ b/docs/img/web-forms/geoshape.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:4b03e026c94e1afd23c83a373381a7a0a4db561eebb6a12a493f09a51f71c5da +size 212429 diff --git a/docs/img/web-forms/geotrace.png b/docs/img/web-forms/geotrace.png new file mode 100644 index 000000000..dccb76f3b --- /dev/null +++ b/docs/img/web-forms/geotrace.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:c68f1542592a6e049f13eca2d71494b8a902554d337a0496f650d724ef3d9953 +size 315009 diff --git a/docs/img/web-forms/map-advanced-panel.png b/docs/img/web-forms/map-advanced-panel.png new file mode 100644 index 000000000..82b491c9e --- /dev/null +++ b/docs/img/web-forms/map-advanced-panel.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:93e34056d363548160085fd9978c9aa748a5465364408d88e1b38ee1bde83cda +size 319405 diff --git a/docs/web-forms-intro.rst b/docs/web-forms-intro.rst index e4c72d9e7..09b9b53a8 100644 --- a/docs/web-forms-intro.rst +++ b/docs/web-forms-intro.rst @@ -46,17 +46,13 @@ Question types To know which question types are currently supported in Web Forms, see `the Github feature matrix `_. While most supported functionality is very similar to Collect's, this section describes question types with more complex functionality or that differ from Collect. -Web Forms currently supports 3 geo question types and appearances: +Web Forms currently supports 5 geo question types and appearances: * :ref:`Geopoint ` * :ref:`Maps appearance ` * :ref:`Placement-map appearance ` - -**Coming soon** - -- Geoshape -- Geotrace -- Editing all map appearances +* :ref:`Geoshape ` +* :ref:`Geotrace ` Geopoint without appearance ~~~~~~~~ @@ -80,7 +76,7 @@ Once location permissions are granted to Web Forms, it will start reading locati Geopoint with `maps` appearance ~~~~~~~~ -The `maps` appearance allows users to capture their current location while viewing it on a map. After tapping **Get location** and granting permissions, the map automatically zooms to the user’s current location. The user taps **Save point** to save the location. Once saved, the marker turns green to indicate success and the bottom panel displays **Point saved**. The user can remove the saved point and try again if needed. +The `maps` appearance allows users to capture their current location while viewing it on a map. After tapping **Get location** and granting permissions, the map automatically zooms to the user’s current location and saves the location. The marker turns green to indicate success and the bottom panel displays Point saved. The user can remove the saved point and try again if needed. .. image:: /img/web-forms/geopoint-maps-appearance.* :alt: Web forms geopoint with maps appearance @@ -88,13 +84,36 @@ The `maps` appearance allows users to capture their current location while viewi Geopoint with `placement-map` appearance ~~~~~~~~ -The `placement-map` appearance is similar to `maps`, but also allows the user to manually move the marker. If location permissions are granted, the map zooms to the user’s current location. The user can save the current location or manually place the marker by long-pressing on the map. The marker can be dragged to adjust the position. The user can remove the marker and try again at any time before moving on. +The `placement-map` appearance is similar to `maps`, but also allows the user to manually move the marker. If location permissions are granted, the map zooms to the user’s current location. The marker is saved by tapping on the map. The marker can be dragged to adjust the position. The user can remove the marker and try again at any time before moving on. For both `maps` and `placement-map` appearances, location capture stops when the user scrolls away from the question. .. image:: /img/web-forms/geopoint-placement-map-appearance.* :alt: Web forms geopoint with placement-map appearance +Geoshape +~~~~~~~~ + +A series of points that form a closed polygon. Points can be added by tapping the screen to place each point. Each coordinate is represented by small circles with outlines. These are connected by lines. The last point that was entered has a darker outline. Use the trash bin icon to delete the entire shape or the undo button to go back a step. + +.. image:: /img/web-forms/geoshape.* + :alt: Web forms geoshape + +Geotrace +~~~~~~~~ + +A series of points. Identical to geoshape except that the first and last point may be different and at least 2 points are required. + +Points can be added by tapping the screen to place each point. Each coordinate is represented by small circles with outlines. These are connected by lines. The last point that was entered has a darker outline. + +.. image:: /img/web-forms/geotrace.* + :alt: Web forms geotrace + +For scenarios requiring precise coordinate adjustments, an advanced panel is available for manual data entry. Expanding this panel allows to specify the latitude, longitude, altitude, and accuracy for specific points. Additionally, use the import option to replace the existing trace or shape with external data. + +.. image:: /img/web-forms/map-advanced-panel.* + :alt: Web forms advanced panel for geoshape and geotrace + Image ~~~~~~~~