Skip to content

Commit

Permalink
Backport last commits from dev branch.
Browse files Browse the repository at this point in the history
  • Loading branch information
wlorenzetti committed Jan 22, 2024
1 parent cf7d2e8 commit 8f44b54
Showing 1 changed file with 63 additions and 59 deletions.
122 changes: 63 additions & 59 deletions g3wsuite_administration.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -158,12 +158,14 @@ The icons at the head of each row, allow you to:

### Add Group Users
Through this form it is possible to create new user groups and define their role.
Through this form it is possible to create new user groups and define their role.

It is possible to create only two types of user groups:
* **`Editor`:** in which only Editor2 users can be inserted
* **`Viewer`:** in which only Viewer users can be inserted

The association between user and user groups can also be achieved at the individual user management level.
The association between user and user groups can also be achieved at the individual user management level.

In the specific form for creating user groups, the following info are defined:
* **Name**
Expand Down Expand Up @@ -230,65 +232,6 @@ After compiling the form, click on the **Save button** to confirm your choices.
![](images/manual/buttom_save.png)


#### Geocoding map control use case for populating project layers
A specific editing function is associated with the Geocoding map control.

In fact, it is possible to use the results deriving from the providers associated with this map control (OSM, Bing Streets, Bing Places) to populate point layers present within the webgis service.

Below are the settings and steps to perform for this purpose.

##### Activation of Geocoding map control at Cartographic Group level
First of all, **Geocoding** must be associated with the Cartographic Group by selecting it at the **Base Layers and Map default features** session level. This will ensure that the tool is present on all WebGis services published within the Group.

![](images/geocoding_providers.png)

##### Definition of the providers to use for each WebGis service
In the publication form of your QGIS project you need to define the providers to be associated with the Geocoding map control:
* **Nominatim (OSM):** addresses based on OpenStreetMap
* **Bing Streets:** Addresses based on Bing maps
* **Bing Places:** places based on Bing maps (service available only for the USA)

The association is created at the **Geocoding providers** session level.

The use of the providers Bing Streets and Bing Places requires the acquisition of a free Bing API.

See [Settings](https://g3w-suite.readthedocs.io/en/v3.6.x/settings.html) section for the API key definition.

##### Using the Geocoding map control on the WebGis service
The Geocoding tool allows you to search for addresses and places (based on active providers) and view their position on the map and the associated information on the information panel on the right.

It is possible to load markers relating to multiple searches into the map.

![](images/geocoding_marker.png)

On the right of the search tool there will now be three new icons:
* **Clear markers selection:** to delete all markers inserted on the map
* **Toogle markers visibility:** to activate/deactivate the display of markers
* **Toogle sidebar panel:** to view the list of markers loaded in the map and their attributes on the right panel

![](images/ggeocoding_icons.png)

##### Insert the markers present in the map into a vector layer
This function allows you to insert the results, obtained through the Geocoding map control, at the level of one or more layers, exclusively point-like, present in the WebGis service.

To be able to carry out this operation, the online editing functionality must be active on these layers.

Only in this case will there be a pencil icon at the search results level.

Clicking on this icon will show the list of point layers on which online editing is enabled.

After choosing the layer on which to insert the result, click on the pencil icon to the right of the layer name to determine the insertion of the point on the layer itself.

![](images/geocoding_insert.png)

On the right, the information panel will open which will show the attributes of the self-editing layer filled in only to the fields of the same name as those of the source markers.

![](images/geocoding_insert_attributes.png)

By clicking on the green **Insert/Edit** button the point will be permanently saved on the layer in use.



### MacroGroups list
The menu provides access to the list of cartographic macro-groups present.

Expand All @@ -307,6 +250,7 @@ There are a series of icons to access specific functions:
#### Define the MacroGroups order on the FrontEnd
Through the Drag & Drop function it is possible to define the order of the MacroGroups in the list. This order will be reflected in the FrontEnd.


## Cartographic Groups
_**In this section it is possible to view the list of Cartographic Groups present, manage them and create new ones.**_

Expand Down Expand Up @@ -440,6 +384,66 @@ After filling in the various form, click on the **Save** button to confirm your

![](images/manual/buttom_save.png)


### Geocoding map control use case for populating project layers
A specific editing function is associated with the Geocoding map control.

In fact, it is possible to use the results deriving from the providers associated with this map control (OSM, Bing Streets, Bing Places) to populate point layers present within the webgis service.

Below are the settings and steps to perform for this purpose.

#### Activation of Geocoding map control at Cartographic Group level
First of all, **Geocoding** must be associated with the Cartographic Group by selecting it at the **Base Layers and Map default features** session level. This will ensure that the tool is present on all WebGis services published within the Group.

![](images/manual/geocoding_providers.png)

#### Definition of the providers to use for each WebGis service
In the publication form of your QGIS project you need to define the providers to be associated with the Geocoding map control:
* **Nominatim (OSM):** addresses based on OpenStreetMap
* **Bing Streets:** Addresses based on Bing maps
* **Bing Places:** places based on Bing maps (service available only for the USA)

The association is created at the **Geocoding providers** session level.

The use of the providers Bing Streets and Bing Places requires the acquisition of a free Bing API.

See [Settings](https://g3w-suite.readthedocs.io/en/v3.6.x/settings.html) section for the API key definition.

#### Using the Geocoding map control on the WebGis service
The Geocoding tool allows you to search for addresses and places (based on active providers) and view their position on the map and the associated information on the information panel on the right.

It is possible to load markers relating to multiple searches into the map.

![](images/manual/geocoding_marker.png)

On the right of the search tool there will now be three new icons:
* **Clear markers selection:** to delete all markers inserted on the map
* **Toogle markers visibility:** to activate/deactivate the display of markers
* **Toogle sidebar panel:** to view the list of markers loaded in the map and their attributes on the right panel

![](images/manual/geocoding_icons.png)

#### Insert the markers present in the map into a vector layer
This function allows you to insert the results, obtained through the Geocoding map control, at the level of one or more layers, exclusively point-like, present in the WebGis service.

To be able to carry out this operation, the online editing functionality must be active on these layers.

Only in this case will there be a pencil icon at the search results level.

Clicking on this icon will show the list of point layers on which online editing is enabled.

After choosing the layer on which to insert the result, click on the pencil icon to the right of the layer name to determine the insertion of the point on the layer itself.

![](images/manual/geocoding_insert.png)

On the right, the information panel will open which will show the attributes of the self-editing layer filled in only to the fields of the same name as those of the source markers.

![](images/manual/geocoding_insert_attributes.png)

By clicking on the green **Insert/Edit** button the point will be permanently saved on the layer in use.



### Groups List
**From this item you can access the list of the created cartographic groups.**

Expand Down

0 comments on commit 8f44b54

Please sign in to comment.