--- title: "QGIS" slug: "qgis" updated: 2026-03-26T23:47:04Z published: 2026-03-26T23:47:04Z --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.metromap.com.au/llms.txt > Use this file to discover all available pages before exploring further. # QGIS ## Setting up a WMS Service All you will need is an API Key and this URL: ``` https://api.metromap.com.au/ogc/key/{YOUR_API_KEY}/service?REQUEST=GetCapabilities ``` You will need to have a MetroMap Enterprise, or Partner plan to access MetroMap APIs --- #### Setup Steps Follow these steps to set up QGIS 3.28 WMS integration: 1. Open QGIS. Click on the **Layer** menu, select **Add Layer**, and choose **Add WMS/WMTS Layer...** ![1](https://cdn.document360.io/64eb4fa4-1b3d-47a1-871b-be0277fc940e/Images/Documentation/1.jpg) --- 1. In the **WMS/WMTS** window, click **New**. ![2](https://cdn.document360.io/64eb4fa4-1b3d-47a1-871b-be0277fc940e/Images/Documentation/2.jpg) --- 1. In the Create a new WMS connection window: - At Name, enter any name you want. - At URL, enter the WMS URL including your API Key. For example: `https://api.metromap.com.au/ogc/key/afas679g2g4ghjiom0455no6b/service?REQUEST=GetCapabilities` - Username and Password fields are not required. - Then click **OK** ![3](https://cdn.document360.io/64eb4fa4-1b3d-47a1-871b-be0277fc940e/Images/Documentation/QGIS_WMS.JPG) --- 1. Back to the **WMS/WMTS** window, click **connect**. ![4](https://cdn.document360.io/64eb4fa4-1b3d-47a1-871b-be0277fc940e/Images/Documentation/4.jpg) --- 1. Select a map layer by a single click. 2. When you finish selecting a layer, click **Change** to set the coordinate reference system to use. 3. For the **Coordinate Reference System** option, choose the map projection you want via the **Select CRS** menu (the globe icon button). Once you find your desired projection, select it and click **OK**. > Make sure to the Coordinate Reference Systems are the same between the **Layer** and **QGIS software**. **WGS 84 / Pseudo-Mercator EPSG:3857** in this particular example. 4. Back to the **WMS/WMTS** window, we recommend **JPEG** is selected for Image encoding. **PNG** format is also available and has higher image quality, but will affect the performance and will create a large amount of data downloaded. Click **Add** once then click **Close**. You can search for **Australia Latest** to quickly add all the most recent imagery available to your map. *Note: This layer is a mosaic of the latest available captures, so imagery dates may vary by location.* ![5](https://cdn.document360.io/64eb4fa4-1b3d-47a1-871b-be0277fc940e/Images/Documentation/QGIS_3-28_WMS.jpg) --- 1. Right-click the **layer**, and click **Zoom to Layer**. ![6](https://cdn.document360.io/64eb4fa4-1b3d-47a1-871b-be0277fc940e/Images/Documentation/6.jpg) --- 1. Higher resolution imagery will be shown when you zoom in. ![7](https://cdn.document360.io/64eb4fa4-1b3d-47a1-871b-be0277fc940e/Images/Documentation/7.jpg) --- ## Setting up a WMTS Service Similar to the WMS services, you will need an API Key, but a different URL: ``` https://api.metromap.com.au/ogc/key/YOUR-API-KEY/service?REQUEST=GetCapabilities&SERVICE=WMTS ``` #### Setup Steps Follow these steps to set up QGIS 3.28 WMTS integration: 1. Open QGIS. Click on the **Layer** menu, select **Add Layer**, and choose **Add WMS/WMTS Layer...** ![1](https://cdn.document360.io/64eb4fa4-1b3d-47a1-871b-be0277fc940e/Images/Documentation/1.jpg) --- 1. In the **WMS/WMTS** window, click **New**. ![2](https://cdn.document360.io/64eb4fa4-1b3d-47a1-871b-be0277fc940e/Images/Documentation/2.jpg) --- 1. In the Create a new WMS/WMTS connection window: - At Name, enter any name you want. - At URL, enter the **WMTS URL** provided below (with your API key included): `https://api.metromap.com.au/ogc/key/YOUR-API-Key/service?REQUEST=GetCapabilities&SERVICE=WMTS` - Then click **OK** ![3](https://cdn.document360.io/64eb4fa4-1b3d-47a1-871b-be0277fc940e/Images/Documentation/QGIS_WMTS_1%281%29.PNG) --- 1. Back to the **WMS/WMTS** window, click **connect**. ![4](https://cdn.document360.io/64eb4fa4-1b3d-47a1-871b-be0277fc940e/Images/Documentation/3%281%29.jpg) --- 1. You will be brought to **Tilesets** and letting you to choose the Layers, MetroMap provides a variety of layers, so choose the one you prefer. Then click **Add** once and click **Close**. You can search for **Australia Latest** to quickly add all the most recent imagery available to your map. *Note: This layer is a mosaic of the latest available captures, so imagery dates may vary by location.* ![4(1)](https://cdn.document360.io/64eb4fa4-1b3d-47a1-871b-be0277fc940e/Images/Documentation/QGIS_WMTS_2.PNG) --- 1. Right-click the **layer**, and click **Zoom to Layer**. ![6](https://cdn.document360.io/64eb4fa4-1b3d-47a1-871b-be0277fc940e/Images/Documentation/6.jpg) 2. Higher resolution imagery is served on demand as you zoom and pan. ![7](https://cdn.document360.io/64eb4fa4-1b3d-47a1-871b-be0277fc940e/Images/Documentation/7.jpg) --- ## Adding StreetMap Layer 1. Select the layer in the [**Browser** window](/docs/qgis#browser) to load the imagery. If you would like to observe a street map under the imagery layer, expan **XYZ Tiles** list, right click **OpenStreetMap** and select **Add Layer to Project**. ![12](https://cdn.document360.io/64eb4fa4-1b3d-47a1-871b-be0277fc940e/Images/Documentation/12.jpg) [Back to Top](/docs/docs/qgis#top) --- 1. Make sure the MetroMap Imagery [**Layers**](/docs/qgis#browser) is on the top of other layers so you can see the imagery. ![9](https://cdn.document360.io/64eb4fa4-1b3d-47a1-871b-be0277fc940e/Images/Documentation/9.jpg) --- ## Display Browser & Layer view If the **Browser** window and **Layers** window not showing on your QGIS layout, click on the **View** menu, select **Panels**, then choose **Browser** and **Layers**. ![8](https://cdn.document360.io/64eb4fa4-1b3d-47a1-871b-be0277fc940e/Images/Documentation/8.jpg) --- ## Importing Image files into QGIS If you have used [**Clip It!**](https://docs.metromap.com.au/docs/2d-interface-tools#clipit) tool or [**Download Image**](https://docs.metromap.com.au/docs/2d-interface-tools#download) tool from MetroMap website and you want to project this image onto QGIS, the following steps will help you through. > Note: Please be sure to download the image with the georeferenced option selected. Images without georeferencing can be loaded but have a higher chance of being displayed incorrectly. 1. Click on the **Layer** menu, click **Data Source Manager** ![Annotation 2020-03-16 130323](https://cdn.document360.io/64eb4fa4-1b3d-47a1-871b-be0277fc940e/Images/Documentation/Annotation%202020-03-16%20130323.jpg) 2. In the **Data Source Manager** window, choose **Browser** on the left side, and locate the file you download on the right side. ![Annotation 2020-03-16 130324](https://cdn.document360.io/64eb4fa4-1b3d-47a1-871b-be0277fc940e/Images/Documentation/Annotation%202020-03-16%20130324.jpg) 3. Right click the file you have found, and click **Add Layer to Project**, and make sure the image layer is on top of the street map layer. ![Annotation 2020-03-16 130325](https://cdn.document360.io/64eb4fa4-1b3d-47a1-871b-be0277fc940e/Images/Documentation/Annotation%202020-03-16%20130325.jpg) 4. The image should have shown on the map now. ![Annotation 2020-03-16 130326](https://cdn.document360.io/64eb4fa4-1b3d-47a1-871b-be0277fc940e/Images/Documentation/Annotation%202020-03-16%20130326.jpg) > The Coordinate Reference Systems should be the same between the Layer and QGIS software. **WGS 84 / Pseudo-Mercator EPSG:3857** in this particular example. Please note that **MetroMap can provide various projection systems**. For more information how to download with different projection systems, please refer to [Clip It!](https://docs.metromap.com.au/docs/2d-interface-tools#clipit). ---