From bc1b0c30c3eb03ecaf2e0fbb94e259ce78358b88 Mon Sep 17 00:00:00 2001 From: minff <16268924+minff@users.noreply.github.com> Date: Mon, 28 Aug 2023 21:25:38 +0200 Subject: [PATCH 1/3] update readme Signed-off-by: minff <16268924+minff@users.noreply.github.com> --- README.md | 93 ++++++++++++++++++++++++++----------------------------- 1 file changed, 44 insertions(+), 49 deletions(-) diff --git a/README.md b/README.md index c1045f1..3227f56 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,7 @@ # HERE Maps for QGIS Plugin -HERE Maps for QGIS is a [QGIS](https://www.qgis.org) plugin which can be used to visualize, edit and analyze data from [HERE Data Hub](https://www.here.xyz/) spaces and from Interactive Map Layer inside the [HERE Platform](https://platform.here.com/). +HERE Maps for QGIS is a [QGIS](https://www.qgis.org) plugin which can be used to visualize, edit and analyze data from [Interactive Map Layers](https://developer.here.com/documentation/data-api/data_dev_guide/rest/layers.html#interactive-map-layers) (IML) on [HERE Platform](https://platform.here.com/) and from [HERE Data Hub](https://github.com/heremaps/xyz-hub) spaces directly on a map. ![new connection](res/new-connection.png) @@ -25,15 +25,51 @@ HERE Maps for QGIS is a [QGIS](https://www.qgis.org) plugin which can be used to ## Usage -Once you have installed and enabled the plugin HERE Maps for QGIS, it can be accessed via the toolbar, or the menu **Web**. The main dialog contains 5 tabs: +Once user have installed and enabled the plugin HERE Maps for QGIS, it can be accessed via the toolbar, or the menu **Web**. To use the plugin, user first need to create an account in [HERE Platform](https://platform.here.com/). Once done, user can try to login in the plugin either with the same HERE Platform user credential or with the app credential (in case the first option does not work). -+ `Load` : load data from an XYZ space into QGIS, given a valid token and server (PRD/CIT). To learn more about how to generate a token, refer to https://www.here.xyz/api/getting-token/ and https://xyz.api.here.com/token-ui/. +### Login + +#### Add User Credential + +1. Ensure that `HERE Platform` is selected in the Server drop down. +2. If the User credential `HERE Platform User Login` exist in the Credential drop down, proceed directly to step 7 +3. Click on `Add` to add your credential. +4. Tick the box `User login` +5. Enter "HERE Platform User Login" in the `Name`, user email in the `User email` and the realm from the Account confirmation email. +6. Click on OK to save the credential +7. Select the User credential and click `Connect` to login for the first time. The Platform login webpage will pop up. +8. Follow the steps in the Platform login webpage. Once login succesfully, the popup windows will be closed automatically and the list of available IML layers in your Platform account shall show up. + +#### Add App Credential (optional) + +1. Ensure that `HERE Platform` is selected in the Server drop down. +2. Click on `Add` to add your credential. +3. Enter "My App credential" as the name. +4. Select a `credentials.properties` containing your HERE Platform app credential (typically location in `{$HOME}/.here/credentials.properties`) +5. If user don't already have an app or a `credentials.properties` file then user can create one, following [the instructions here](https://developer.here.com/documentation/identity-access-management/dev_guide/topics/plat-token.html). +6. Grant access on the data to the HERE platform app so that it can access your project, following [the instructions here](https://developer.here.com/documentation/identity-access-management/dev_guide/topics/manage-projects.html). +7. Click on OK to save the credential, and close the connection window. +8. Click `Connect` to show the list of available IML layers. + +#### Connect and list catalogs and layers + +1. Select either the User credential or the App credential and click `Connect` +2. The list of available IML layers in your Platform account shall show up in the tabular form +3. User use the search bar to find the catalogs and layers of interest + +### Features + +The main dialog contains 5 tabs: + ++ `Load` : load data from a HERE Platform IML into QGIS, given a valid credential. + `Mode`: there are 3 modes of loading + `Live loading`: interactively refresh features in tiles within the current canvas. Useful for visualization of dynamic dataset with full editing capabilities + `Incremental loading`: interactively refresh and cached features in tiles within the current canvas (no features delete). Useful for visualization and exploration of large dataset + `Static loading`: load and cache all features in space in background. Useful for importing and analysis of static dataset - + `Chunk size` indicates the number of features per tile or iteration + + + `Chunk size` indicates the number of features per tile or iteration. Default: 100. For large layer of point, lines features, value of 10000 is recommended. For large layer of polygon features, value of 1000 is recommended. + + `Layering` controls the organization of data in XYZ space into different QGIS layers based on fields similarity, with 3 levels: + `single`: merge data into 1 layer per geometry type + `maximal`: do not merge data, as many layers per geometry type @@ -48,53 +84,11 @@ Once you have installed and enabled the plugin HERE Maps for QGIS, it can be acc + `Settings` : + `Clear cache` : empty the temporary cache folder. Active layers will be invalid after clearing cache. + + `Clear cookies` : clear the login cookies. This could be helpful when login or loading show Authorization error When the user make some edits to the loaded layer, the changes can be pushed to XYZ Hub via the button `Push changes` in the toolbar. -### Configure Server connection - -Official Data Hub server is predefined under name "HERE Server" and thus is not required to be created. The following steps are only required for self-hosted Data Hub server and HERE Platform server. - -1. From the "Web" menu in QGIS, select "HERE Maps for QGIS" > "Add HERE Layer". -2. Press the "Setup" button and then "Setup Server" to add a new server. -3. Click "Add" to add a new server. -4. Select server type - - a. Server Type: DATAHUB, enter "HERE self-hosted Data Hub" as the name and your Data Hub URL as the server. - - b. Server Type: PLATFORM, enter "HERE platform" as the name and PLATFORM_PRD as the server. - -5. Click on OK to save the new server and OK again to return to the setup screen. - -### Add HERE Data Hub Token - -1. From the "Web" menu in QGIS, select "HERE Maps for QGIS" > "Add HERE Layer". -2. Press the "Setup", ensure that "HERE Server" is selected in the Server drop down. -3. Click on "Add" to add your token. -4. Enter a name and corresponding Data Hub token created previously according to the guide https://www.here.xyz/api/getting-token/ -5. Click on OK to save the token, and close the connection window - -### Add HERE Platform Credentials - -1. From the "Web" menu in QGIS, select "HERE Maps for QGIS" > "Add HERE Layer". -2. Press the "Setup", ensure that "HERE Platform" is selected in the Server drop down. -3. Click on "Add" to add your credentials. -4. Enter "My credentials" as the name. -5. Select a credentials.properties containing your HERE Platform app credentials (typically location in `{USER_HOME}/.here/credentials.properties` -6. If you don't already have an app or a credentials.properties file then you can follow "platform credentials" section of this guide to create one: https://developer.here.com/documentation/java-scala-dev/dev_guide/topics/get-credentials.html -7. Grant access on the data to the HERE platform app so that it can access your project. Do so by following this guide: https://developer.here.com/documentation/identity-access-management/dev_guide/topics/manage-projects.html -8. Click on OK to save the credentials, and close the connection window - -### Load Your Data from HERE Platform - -1. Create a new project (Project → New), save the project -2. From the "Web" menu in QGIS, select "HERE Maps for QGIS" > "Add HERE Layer" -3. From the Connection drop down, select the "HERE Platform" connection and the "My Credentials" credentials that you created previously -4. Click "Connect" -5. Select one or more Interactive Map Layer entries -6. Click on "Load" to load the data - -**Note:** You can also add background map tiles via the "Map Tile" tab. You will need to use your credentials from https://developer.here.com/. +**Note:** User can also add background map tiles via the "Map Tile" tab. User will need to use your credential from https://developer.here.com/. ## Testing @@ -116,8 +110,9 @@ e.g. `sh makeBuild.sh 1.5.5`. ## Changelog [CHANGELOG](CHANGELOG.md) + ## License -Copyright (C) 2019-2021 HERE Europe B.V. +Copyright (C) 2019-2023 HERE Europe B.V. This project is licensed under the MIT license - see the [LICENSE](./LICENSE) file in the root of this project for license details. From 0938612cc9742fbe2d325b102db43c9ab1f8db1a Mon Sep 17 00:00:00 2001 From: minff <16268924+minff@users.noreply.github.com> Date: Tue, 29 Aug 2023 11:30:21 +0200 Subject: [PATCH 2/3] try to fix mamba error Signed-off-by: minff <16268924+minff@users.noreply.github.com> --- .github/workflows/main.yml | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml index ebf3c96..ca5d305 100644 --- a/.github/workflows/main.yml +++ b/.github/workflows/main.yml @@ -26,11 +26,8 @@ jobs: - name: Setup conda uses: conda-incubator/setup-miniconda@v2 with: - mamba-version: "*" channels: conda-forge - - - name: Mamba install dependencies - run: mamba install python=${{ matrix.python-version }} pip + python-version: ${{ matrix.python-version }} - name: Install dependencies run: | From de7ff7d98bc77e62a3e5e23076951a6460ee3655 Mon Sep 17 00:00:00 2001 From: Minh Nguyen <16268924+minff@users.noreply.github.com> Date: Wed, 31 Jan 2024 14:49:47 +0100 Subject: [PATCH 3/3] update readme + links --- README.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index 3227f56..f31985e 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,7 @@ # HERE Maps for QGIS Plugin -HERE Maps for QGIS is a [QGIS](https://www.qgis.org) plugin which can be used to visualize, edit and analyze data from [Interactive Map Layers](https://developer.here.com/documentation/data-api/data_dev_guide/rest/layers.html#interactive-map-layers) (IML) on [HERE Platform](https://platform.here.com/) and from [HERE Data Hub](https://github.com/heremaps/xyz-hub) spaces directly on a map. +HERE Maps for QGIS is a [QGIS](https://www.qgis.org) plugin which can be used to visualize, edit and analyze data from [Interactive Map Layers](https://www.here.com/docs/bundle/data-api-developer-guide/page/rest/layers.html#interactive-map-layers) (IML) on [HERE Platform](https://platform.here.com/) and from [xyz-hub](https://github.com/heremaps/xyz-hub) spaces directly on a map. ![new connection](res/new-connection.png) @@ -46,8 +46,8 @@ Once user have installed and enabled the plugin HERE Maps for QGIS, it can be ac 2. Click on `Add` to add your credential. 3. Enter "My App credential" as the name. 4. Select a `credentials.properties` containing your HERE Platform app credential (typically location in `{$HOME}/.here/credentials.properties`) -5. If user don't already have an app or a `credentials.properties` file then user can create one, following [the instructions here](https://developer.here.com/documentation/identity-access-management/dev_guide/topics/plat-token.html). -6. Grant access on the data to the HERE platform app so that it can access your project, following [the instructions here](https://developer.here.com/documentation/identity-access-management/dev_guide/topics/manage-projects.html). +5. If user don't already have an app or a `credentials.properties` file then user can create one, following [the instructions here](https://www.here.com/docs/bundle/identity-and-access-management-developer-guide/page/topics/plat-token.html). +6. Grant access on the data to the HERE platform app so that it can access your project, following [the instructions here](https://www.here.com/docs/bundle/identity-and-access-management-developer-guide/page/topics/manage-projects.html). 7. Click on OK to save the credential, and close the connection window. 8. Click `Connect` to show the list of available IML layers. @@ -70,12 +70,12 @@ The main dialog contains 5 tabs: + `Chunk size` indicates the number of features per tile or iteration. Default: 100. For large layer of point, lines features, value of 10000 is recommended. For large layer of polygon features, value of 1000 is recommended. - + `Layering` controls the organization of data in XYZ space into different QGIS layers based on fields similarity, with 3 levels: + + `Layering` controls the organization of data in one layer into different QGIS layers based on fields similarity, with 3 levels: + `single`: merge data into 1 layer per geometry type + `maximal`: do not merge data, as many layers per geometry type + `balanced`: merge only similar data into 1 layer, balanced number of layers per geometry type -+ `Upload` : upload current Vector Layer to a new XYZ Hub space. For this to work, make sure that your token also has write-level permissions. ++ `Upload` : upload local QGIS Vector Layer to the server. For this to work, make sure that your token also has write-level permissions. + `Manage` : create new space, edit or delete existing space. @@ -86,9 +86,9 @@ The main dialog contains 5 tabs: + `Clear cache` : empty the temporary cache folder. Active layers will be invalid after clearing cache. + `Clear cookies` : clear the login cookies. This could be helpful when login or loading show Authorization error -When the user make some edits to the loaded layer, the changes can be pushed to XYZ Hub via the button `Push changes` in the toolbar. +When the user make some edits to the loaded layer, the changes can be pushed to the server via the button `Push changes` in the toolbar. -**Note:** User can also add background map tiles via the "Map Tile" tab. User will need to use your credential from https://developer.here.com/. +**Note:** User can also add background map tiles via the "Map Tile" tab. User will need to use your API key following [the instructions here](https://www.here.com/docs/bundle/identity-and-access-management-developer-guide/page/topics/plat-using-apikeys.html). ## Testing @@ -113,6 +113,6 @@ e.g. `sh makeBuild.sh 1.5.5`. ## License -Copyright (C) 2019-2023 HERE Europe B.V. +Copyright (C) 2019-2024 HERE Europe B.V. This project is licensed under the MIT license - see the [LICENSE](./LICENSE) file in the root of this project for license details.