{"id":13767390,"url":"https://github.com/maptiler/qgis-maptiler-plugin","last_synced_at":"2025-10-28T07:04:18.318Z","repository":{"id":39636276,"uuid":"248510865","full_name":"maptiler/qgis-maptiler-plugin","owner":"maptiler","description":"QGIS MapTiler Plugin: vector tiles, basemaps, geocoding, OSM, QuickMapServices","archived":false,"fork":false,"pushed_at":"2025-04-14T07:29:34.000Z","size":9059,"stargazers_count":95,"open_issues_count":7,"forks_count":12,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-05-10T22:32:15.512Z","etag":null,"topics":["basemaps","geocoding","maptiler","openmaptiles","openstreetmap","osm","qgis","qgis-plugin","vector-tiles"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/maptiler.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2020-03-19T13:31:10.000Z","updated_at":"2025-04-17T07:13:44.000Z","dependencies_parsed_at":"2024-01-07T03:40:15.306Z","dependency_job_id":"b901576b-fd51-459c-9592-a29b8da82d95","html_url":"https://github.com/maptiler/qgis-maptiler-plugin","commit_stats":null,"previous_names":[],"tags_count":22,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maptiler%2Fqgis-maptiler-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maptiler%2Fqgis-maptiler-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maptiler%2Fqgis-maptiler-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maptiler%2Fqgis-maptiler-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/maptiler","download_url":"https://codeload.github.com/maptiler/qgis-maptiler-plugin/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maptiler%2Fqgis-maptiler-plugin/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259172987,"owners_count":22816560,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["basemaps","geocoding","maptiler","openmaptiles","openstreetmap","osm","qgis","qgis-plugin","vector-tiles"],"created_at":"2024-08-03T16:01:08.223Z","updated_at":"2025-10-28T07:04:13.279Z","avatar_url":"https://github.com/maptiler.png","language":"Python","funding_links":[],"categories":["amazing insight and delivery"],"sub_categories":["geospatial analysis"],"readme":"\u003cimg src=https://user-images.githubusercontent.com/19833762/85034825-c65bef00-b182-11ea-8be6-36195165de3f.png\u003e\n\n# QGIS MapTiler Plugin\n\nSimply add global base maps to QGIS. This plugin adds OpenStreetMap data from the OpenMapTiles project. Maps for this plugin are available from the [MapTiler Cloud](https://www.maptiler.com/cloud/?utm_source=github.com\u0026utm_medium=referral\u0026utm_campaign=qgis-plugin). Customize the look and feel of maps or import GL JSON styles of TileJSON.\n\nHomepage: [https://www.maptiler.com/qgis-plugin/](https://www.maptiler.com/qgis-plugin/?utm_source=github.com\u0026utm_medium=referral\u0026utm_campaign=qgis-plugin)\n\n\u003c!-- TOC --\u003e\n\n- [Installation](#installation)\n    - [Requirements](#requirements)\n    - [Fonts](#fonts)\n- [Feature \u0026 Usage](#feature--usage)\n    - [Add background maps to a project](#add-background-maps-to-a-project)\n    - [Load a map in Mapbox GL JSON format](#load-a-map-in-mapbox-gl-json-format)\n    - [Vector and raster tiles](#vector-and-raster-tiles)\n    - [Customize quickly the look\u0026feel of the base maps](#customize-the-lookfeel-of-the-base-maps-quickly)\n    - [Global Digital Elevation Model (DEM)](#global-digital-elevation-model-dem)\n    - [Geocoding / place search](#geocoding--place-search)\n    - [Authentication](#authentication)\n      - [Credentials](#credentials-for-plugin-version-30-and-higher)\n      - [Access key](#access-key-for-older-versions)\n- [Credits](#credits)\n- [For developer](#for-developer)\n\n\n\u003c!-- /TOC --\u003e\n\n## Installation\n\nThere are two ways to install this plugin.\n\n1. From the official QGIS Plugin Repository - see the step-by-step guide at [https://www.maptiler.com/qgis-plugin/#install](https://www.maptiler.com/qgis-plugin/?utm_source=github.com\u0026utm_medium=referral\u0026utm_campaign=qgis-plugin#install)\n\n2. From the [Zipfile](https://github.com/maptiler/qgis-maptiler-plugin/archive/master.zip) of this repository\n\nIf you do not see the MapTiler plugin in your QGIS Browser, try **re-launch the QGIS application**.\nThen MapTiler should be added to your QGIS Browser.\n\n\u003cimg src='imgs/readme_01.png'\u003e\n\n### Requirements\n\nFor plugin version 2.0, you need QGIS 3.16 or higher.\n\nFor plugin version 3.0, you need QGIS 3.24 or higher.\n\n### Fonts\n\nMaps from MapTiler Cloud use various fonts. You might get similar warnings in QGIS.\n\n\u003cimg src='imgs/readme_09.png'\u003e\n\nIf you want to display these maps in QGIS, you need to have these fonts \ninstalled on your system. QGIS will use a default font if the specific font is not installed on your system. \n\n\nA list of fonts used in maps at MapTiler Cloud can be found at \n[https://api.maptiler.com/fonts.json](https://api.maptiler.com/fonts.json).\n\n\n---\n\n## Feature \u0026 Usage\n\n### Add background maps to a project\n\nMapTiler plugin provides several preset maps. Some of them are visible from QGIS Browser.\n    - Basic\n    - Bright\n    - OpenStreetMap\n    - Outdoor\n    - Satellite\n    - Terrain\n    - Toner\n    - Topo\n    - Voyager\n    \nMore maps are available after you click on `Add a new map...` from MapTiler plugin contextual menu - on a tab `MapTiler Cloud`. You can choose from various maps available on the MapTiler Cloud.\n   \n\u003cimg src='imgs/readme_06.png'\u003e\n   \n\n### Load a map in Mapbox GL JSON format\n\nYou can add your own map from the tab `From URL`. Add the name of your map and URL to JSON.\n\nFor **vector tiles**, you can add either URL to style.json or TileJSON. Note that if you add a URL to TileJSON, you will get only tiles data with basic QGIS styling. For **raster tiles**, you have to add a URL to TileJSON.\n\n\u003cimg src='imgs/readme_07.png'\u003e\n\n\n### Vector and raster tiles\n\nMapTiler plugin supports loading maps via both vector and raster tiles. You can choose from the contextual menu of the map and click either on `Add as Raster` or `Add as Vector`.\n\nYou can choose the default type of tiles by checking/unchecking `Use vector tiles by default` in the Account dialog window.\n\nVector tiles support requires QGIS 3.13 or higher.\nFor the plugin version 2.0 and higher, you need QGIS 3.16 or higher.\nFor the plugin version 3.0 and higher, you need QGIS 3.24 or higher.\n\nYou can read about the difference between vector and raster tiles here [https://www.maptiler.com/news/2019/02/what-are-vector-tiles-and-why-you-should-care/](https://www.maptiler.com/news/2019/02/what-are-vector-tiles-and-why-you-should-care/?utm_source=github.com\u0026utm_medium=referral\u0026utm_campaign=qgis-plugin)\n\n \n### Customize the look\u0026feel of the base maps quickly\n\nThere is a possibility to simply adjust the default base maps in [Customize tool](https://www.maptiler.com/cloud/customize/?utm_source=github.com\u0026utm_medium=referral\u0026utm_campaign=qgis-plugin) - via a context menu on right-click in QGIS.\n\n\u003cimg src='imgs/readme_12.png'\u003e  \n\nSwitch language, select layers, and change colors to match your brand and make a perfect map.\n\n\u003cimg src='imgs/readme_13.gif'\u003e\n\n“Save” this map, and add it via URL - by copy\u0026pasting the link to “GL JSON Style” from the Cloud page of the map.\n\n### Global Digital Elevation Model (DEM)\nThe plugin offers the digital elevation model (DEM) of the entire planet.\nYou can use the layer for hillshading, hypsometry, analytical applications, and even 3D terrain modeling.\n\n\u003cimg src='imgs/readme_10.gif'\u003e\n\n\n### Geocoding / place search\n\nMapTiler plugin also provides MapTiler toolbar for basic geocoding / place search.\n\n\u003cimg src='imgs/readme_03.png'\u003e\n\nInput a place you want to find and press the return-key. MapTiler Geocoding API responds with a list of locations.\nThe map canvas will zoom to feature extent when you click on one place in the list.\n\n\u003cimg src='imgs/readme_04.png'\u003e  \n\n### Exporting/printing\n\nYou can export maps into high dpi PDFs, PNG or other formats. Benefit from high-detailed vector maps and \nQGIS Print Layout Editor. Add common elements of a map layout, such as legend, title, scale, inset map or north arrow.\n\n\u003cimg src='imgs/readme_14.png'\u003e\n\nPlease, be aware that printing/exporting map of large areas with high detail might cause big spikes in Cloud export\nrequests and might exceed your account limits.\n\nPlease, read [MapTiler Cloud Terms and Conditions](https://www.maptiler.com/terms/cloud/#LimitedPrints) to learn more\nabout permitted prints.\n\n### Authentication\n#### Credentials (for plugin version 3.0 and higher)\nThe plugin version 3.0 and higher uses credentials for authentication in MapTiler Cloud.\nYou can get your own FREE credentials at [https://cloud.maptiler.com/account/credentials](https://cloud.maptiler.com/account/credentials/?utm_source=qgis\u0026utm_medium=product\u0026utm_campaign=qgis-plugin)\n\n\u003cimg src='imgs/readme_11.png'\u003e\n\nClick on `Account...` from MapTiler plugin contextual menu to open the Account dialog window and to insert your token.\n\n\u003cimg src='imgs/readme_08.png'\u003e\n\n\n#### Access key (for older versions)\n\nThis plugin needs your access key to the MapTiler Cloud that is available for free.\nYou can get your own FREE access key at [https://cloud.maptiler.com/account/keys](https://cloud.maptiler.com/account/keys?utm_source=github\u0026utm_medium=product\u0026utm_campaign=qgis-plugin)\n\nClick on `Account...` from MapTiler plugin contextual menu to open the Account dialog window and to insert your access key.\n\n\u003cimg src='imgs/readme_02.png'\u003e\n\n---\n\n## Credits\n\nThe plugin is maintained by the MapTiler team [www.maptiler.com](https://www.maptiler.com/?utm_source=github.com\u0026utm_medium=referral\u0026utm_campaign=qgis-plugin) - made with love in Switzerland and the Czech Republic.\n\nIt has been co-developed together with [MIERUNE](https://mierune.co.jp/) in Japan.\nThe native vector tiles python APIs in QGIS were developed by @wonder-sk from [Lutra](https://www.lutraconsulting.co.uk/crowdfunding/vectortile-qgis/)\n\n## For developers\n\nIf you have any ideas or trouble, please [post an Issue](https://github.com/maptiler/qgis-maptiler-plugin/issues) first.\n\nWe very much welcome contributions from all developers out there. This project is a community-driven open-source tool - please help us to make it better.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaptiler%2Fqgis-maptiler-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmaptiler%2Fqgis-maptiler-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaptiler%2Fqgis-maptiler-plugin/lists"}