Skip to content

Commit

Permalink
Improve readme with a couple of links (#94)
Browse files Browse the repository at this point in the history
  • Loading branch information
m-kuhn authored Jul 9, 2024
1 parent e85f4a1 commit f405074
Show file tree
Hide file tree
Showing 4 changed files with 43 additions and 29 deletions.
72 changes: 43 additions & 29 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,46 +1,60 @@
# Swiss Locator plugin

# QGIS Swiss Locator plugin

## What
A Swiss Geoportal locator filter plugin for QGIS 3
Integrates the Swiss Geoportal into QGIS

Similarly to the online geoportal [https://map.geo.admin.ch](https://map.geo.admin.ch/), this plugin allows to search within [QGIS](https://qgis.org/) desktop for

* locations:
* cantons, cities and communes,
* all names as printed on the national map (SwissNames)
* districts
* Locations:
* Cantons, cities and municipalities,
* Place names as printed on the national map (SwissNames)
* Districts
* ZIP codes
* addresses
* cadastral parcels
* WMS layers from Federal Geoportal (map.geo.admin.ch) or opendata.swiss, which can easily be added to the map
* features (search through features descriptions)


## Where

The search is performed through the QGIS [locator bar](https://qgis.org/en/site/forusers/visualchangelog30/#feature-locator-bar).

Configuration is achieved in the main application settings under the `locator` tab. You will be able to:
* enable or disable searches (locations, layers, features)
* customize prefixes, define if they are default filters (used without prefix)
* access to the configuration of the plugin
* include or exclude opendata.swiss data from layer searches

In the configuration of the plugin, further customization can be achieved:
* language definition (English, German, French, Italian, Rumantsch)
* CRS definition (project, CH1903 or CH1903+)
* defining if the plugin will try to display further information in a tool tip
* defining layers used in the feature search
* Addresses
* Cadastral parcels
* Layers from the Federal Geoportal (map.geo.admin.ch) or opendata.swiss, which can easily be added to the map
* WMS
* WMTS
* Vector Tiles
* Features (search through features descriptions)

## How

Type the text to search in the locator bar.

If the result is a **WMS layer**, double-clicking on it will try to add it to the map.
If the result is a **WMTS layer**, double-clicking on it will try to add it to the map.
It might not be possible since some layers are only visible in the geoportal (map.geo.admin.ch).
In this case, a link will be shown to display the layer in the geoportal.

![WMTS layer search](./doc/wmts_search.png)

If the result is a **location** or **feature**,
double-clicking on it will move the map canvas to the result and highlight its position.
If any further information can be shown, an info window will be shown over the map.

![Feature search](./doc/feature_search.png)

If the result is a **vector tiles layer**,
double clicking it will add it to the map canvas as another background layer.

![Vector Tiles layer search](./doc/vector_tiles_search.png)

## More

The search is performed through the QGIS [locator bar](https://qgis.org/en/site/forusers/visualchangelog30/#feature-locator-bar).

Configuration is achieved in the main application settings under the `locator` tab. You will be able to:
* Enable or disable searches (locations, layers, features)
* Customize prefixes, define if they are default filters (used without prefix)
* Access to the configuration of the plugin
* Include or exclude opendata.swiss data from layer searches

In the configuration of the plugin, further customization can be achieved:
* Language definition (English, German, French, Italian, Rumantsch)
* CRS definition (project, CH1903 or CH1903+)
* Defining if the plugin will try to display further information in a tool tip
* Defining layers used in the feature search

## Who

This plugin has been developped by OPENGIS.ch with friendly support from the [Swiss QGIS User Group](https://qgis.ch).
Binary file added doc/feature_search.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added doc/vector_tiles_search.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added doc/wmts_search.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit f405074

Please sign in to comment.