{"id":48814839,"url":"https://github.com/opengeospatial/ogcapi-tiles","last_synced_at":"2026-04-14T10:34:16.145Z","repository":{"id":37863641,"uuid":"218033096","full_name":"opengeospatial/ogcapi-tiles","owner":"opengeospatial","description":"OGC API - Tiles draft specification","archived":false,"fork":false,"pushed_at":"2024-01-26T18:38:40.000Z","size":102792,"stargazers_count":35,"open_issues_count":18,"forks_count":16,"subscribers_count":22,"default_branch":"master","last_synced_at":"2024-04-16T03:26:12.580Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://ogcapi.ogc.org/tiles","language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/opengeospatial.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}},"created_at":"2019-10-28T11:39:52.000Z","updated_at":"2024-01-28T22:05:00.000Z","dependencies_parsed_at":"2023-01-25T05:15:49.643Z","dependency_job_id":"d2c24cc4-558a-4cdb-bd64-0857c78e23cd","html_url":"https://github.com/opengeospatial/ogcapi-tiles","commit_stats":{"total_commits":535,"total_committers":19,"mean_commits":"28.157894736842106","dds":0.6654205607476635,"last_synced_commit":"2961beeaca21e5db5f3f558dcd48c8e775061a45"},"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/opengeospatial/ogcapi-tiles","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opengeospatial%2Fogcapi-tiles","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opengeospatial%2Fogcapi-tiles/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opengeospatial%2Fogcapi-tiles/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opengeospatial%2Fogcapi-tiles/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/opengeospatial","download_url":"https://codeload.github.com/opengeospatial/ogcapi-tiles/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opengeospatial%2Fogcapi-tiles/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31793219,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-14T02:24:21.117Z","status":"ssl_error","status_checked_at":"2026-04-14T02:24:20.627Z","response_time":153,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":[],"created_at":"2026-04-14T10:34:15.439Z","updated_at":"2026-04-14T10:34:16.138Z","avatar_url":"https://github.com/opengeospatial.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# OGC API - Tiles\n\nThis GitHub repository contains OGC's multi-part _OGC API - Tiles_ standard for querying and retrieving tiles of geospatial information on the web.\n\nThis is the **current** working version of this initiative, written using many AsciiDoc files that might be difficult to follow.\n\nPlease see the latest compiled specification available in [HTML](https://docs.ogc.org/is/20-057/20-057.html) and [PDF](https://docs.ogc.org/is/20-057/20-057.pdf) which are easier to read.\n\nThis specification relies on the [_Tile Matrix Set and Tile Set Metadata_ standard](https://github.com/opengeospatial/2D-Tile-Matrix-Set/) (version 2.0: [HTML](https://docs.opengeospatial.org/is/17-083r4/17-083r4.html) or [PDF](https://docs.opengeospatial.org/is/17-083r4/17-083r4.pdf)).\n\nSee the latest [OpenAPI definition](https://github.com/opengeospatial/ogcapi-tiles/tree/master/openapi) with [SwaggerUI](https://petstore.swagger.io/?url=https://raw.githubusercontent.com/opengeospatial/ogcapi-tiles/master/openapi/ogcapi-tiles-1.bundled.json).\n\n## Overview\n\n_OGC API - Tiles_ is a standard API that provides tiles of geospatial information.\n\nDifferent forms of geospatial information are supported, such as tiles of vector features (\"vector tiles\"), coverages, maps (or imagery) and potentially eventually additional types of tiles) of geospatial information.\n\nVector data represents geospatial objects as points, lines, and polygons. Tiles of vector data (i.e. Vector Tiles) represent subsets of vector data covering a large area (e.g. lines representing rivers in a country).\n\nIn this context, a map is essentially an image representing at least one type of geospatial information. Tiles of map data (i.e. Map Tiles) represent subsets of map data covering a large area (e.g. a satellite image).\n\n### Core\n\nThe **_Core_** conformance class of _OGC API - Tiles_ simply requires that tiles can be retrieved according to a [tile matrix set](https://docs.opengeospatial.org/is/17-083r4/17-083r4.html#tile-matrix-set-concept), using some template URL made up of:\n- a tile matrix,\n- a tile row, and\n- a tile column.\n\nThat URL template and information about the tileset can either be provided through the _**TileSet**_ conformance class, or by some outside mechanism.\n\n### TileSet \u0026 TileSets List\n\nThe **_TileSets List_** and **_TileSet_** conformance classes defines transportable end-points:\n\n- `GET .../tiles`\nRetrieves the list of tilesets available (`tilesets` array property whose elements contain `links` to the tileset with `self` relation type)\n- `GET .../tiles/{tileMatrixSetId}`\nRetrieves the [metadata](https://docs.opengeospatial.org/is/17-083r4/17-083r4.html#tile-set-metadata) for a specific tileset (tiled according to a particular tile matrix set).\n- `GET .../tiles/{tileMatrixSetId}/{tileMatrix}/{tileRow}/{tileCol}`\nRetrieves a tile from a specific tileset (tiled according to a particular tile matrix set) in the requested tile matrix set, on the requested tile matrix (e.g. zoom level) with the requested row and column.\n\n### DataSet \u0026 GeoData Tile Sets\n\nThe **_DataSet TileSets_** conformance class defines how a list of tilesets can be associated to an OGC API dataset / landing page, while the **_GeoData TileSets_** conformance class defines how a list of tilesets can be associated to an OGC API collection.\n\nBy combining _Tiles_ building blocks with other OGC API standards, different types of tilesets can be provided from a single API:\n\n**Vector tiles:**\n\n(link relation: `http://www.opengis.net/def/rel/ogc/1.0/tilesets-vector`)\n\n- `{datasetAPI}/tiles`\nDataset tilesets (multi-layer vector tiles)\n- `{datasetAPI}/collections/{collectionId}/tiles`\nCollection tilesets (vector tiles)\n\n**Map tiles** (_OGC API - Maps_):\n\n(link relation: `http://www.opengis.net/def/rel/ogc/1.0/tilesets-map`)\n\n- `{datasetAPI}/map/tiles`\nDataset map tilesets\n- `{datasetAPI}/collections/{collectionId}/map/tiles`\nCollection map tilesets\n\n**Coverage tiles** (_OGC API - Coverages_):\n\n(link relation: `http://www.opengis.net/def/rel/ogc/1.0/tilesets-coverage`)\n\n- `{datasetAPI}/collections/{collectionId}/coverage/tiles`\nCollection coverage tilesets\n\n**Styled vector tiles**, e.g. filtered by scale (_OGC API - Styles_):\n\n(link relation: `http://www.opengis.net/def/rel/ogc/1.0/tilesets-vector`)\n\n- `{datasetAPI}/styles/{styleId}/tiles`\nStyled dataset tilesets (multi-layer vector tiles)\n- `{datasetAPI}/collections/{collectionId}/styles/{styleId}/tiles`\nStyled collection tilesets (vector tiles)\n\n**Styled map tiles** (_OGC API - Maps_ and _OGC API - Styles_):\n\n(link relation: `http://www.opengis.net/def/rel/ogc/1.0/tilesets-map`)\n\n- `{datasetAPI}/styles/{styleId}/map/tiles`\nStyled dataset map tilesets\n- `{datasetAPI}/collections/{collectionId}/styles/{styleId}/map/tiles`\nStyled collection map tilesets\n\n## Introduction\n\nData with a location component (i.e. geospatial data) can be very large.\n\nFor example, consider satellite images that cover vast areas of Earth's surface.\n\nTo make these datasets easier to use, they can be divided into *tiles* - smaller subsets of data that can be used individually.\n\n_OGC API - Tiles_ provides a standardized way for requesting such tiles through the web.\n\n[OGC API standards](https://ogcapi.ogc.org) define modular API building blocks to spatially enable Web APIs in a consistent way.\n\nThe _OGC API - Tiles_ specification defines building blocks that can be combined with other OGC API building blocks such as [_OGC API - Maps_](https://github.com/opengeospatial/ogcapi-maps) (to retrieve map tiles) and [_OGC API - Coverages_](https://github.com/opengeospatial/ogcapi-coverages) (to retrieve coverage tiles).\n\nThis specification is a complete rewrite of the of the [OGC](http://opengeospatial.org)'s previous Web Map Tile Service (WMTS) standards versions, focusing on simple reusable RESTful building blocks which can be described using the [OpenAPI](http://openapis.org) specification.\n\n## Quickstart guides\n[Quickstart guide for clients](QuickGuide/README.md)\n\n## Implementations\nSeveral implementations of the draft standard exist:\n\n[Implementations of the draft specification / demo services](./implementations.adoc)\n\n## Draft specifications\n\n### OGC API - Tiles - Part 1: Core\nThe definition of OGC API - Tiles - Part 1: Core is the current focus of the Standards Working Group (SWG). As agreed by the SWG, the draft specification is organized into the following main conformance classes:\n\n1. [***Core***](https://opengeospatial.github.io/ogcna-auto-review/20-057.html#rc_tiles_core) specifies that tiles are retrievable according to a [tile matrix set](https://docs.opengeospatial.org/is/17-083r4/17-083r4.html#tile-matrix-set-concept), using some template URL made up of a tile matrix, a tile row, and a tile column.\n2. [***TileSet***](https://opengeospatial.github.io/ogcna-auto-review/20-057.html#rc_tileSet) specifies a tileset resource (tiles in a single Tile Matrix Set), including\n   - a templated URL to access individual tiles (**1**),\n   - a link to the definition of the TileMatrixSet (see the [TileMatrixSet schema](https://github.com/opengeospatial/2D-Tile-Matrix-Set/blob/master/schemas/tms/2.0/json/tileMatrixSet.json) and [examples](https://github.com/opengeospatial/2D-Tile-Matrix-Set/tree/master/schemas/tms/2.0/json/examples/tilematrixset)), as well as a URI for it if applicable (e.g. if registered on a [register such as the OGC NA's](http://www.opengis.net/def/tms)), as well as\n   - additional [metadata](https://docs.opengeospatial.org/is/17-083r4/17-083r4.html#tile-set-metadata) (see the full [TileSet schema](https://github.com/opengeospatial/2D-Tile-Matrix-Set/blob/master/schemas/tms/2.0/json/tileSet.json) and [examples](https://github.com/opengeospatial/2D-Tile-Matrix-Set/tree/master/schemas/tms/2.0/json/examples/tileset))\n3. [***TileSets List***](https://opengeospatial.github.io/ogcna-auto-review/20-057.html#rc_tileSets-list) specifies a tilesets resource describing multiple tilesets (**2**).\n4. [***DatasetTileSets***](https://opengeospatial.github.io/ogcna-auto-review/20-057.html#rc_datasetTileSets) specifies how to link to a list (**3**) of tilesets (**2**) for the whole dataset distributed by an API from its landing page (as defined by [_OGC API Common - Part 1_](https://docs.opengeospatial.org/DRAFTS/19-072.html#rc_landing-page-section)).\n5. [***GeoDataTileSets***](https://opengeospatial.github.io/ogcna-auto-review/20-057.html#rc_geoDataResourceTileSets) specifies how to link to a list (**3**) of tilesets (**2**) from a resource representing a collection of geospatial data (as defined by [_OGC API Common - Part 2_](https://docs.opengeospatial.org/DRAFTS/20-024.html#rc-collections-section)).\n6. [***GeoDataSelection***](https://opengeospatial.github.io/ogcna-auto-review/20-057.html#rc_collections-selection) specifies the `collections=` query parameter allowing to select specific collections of geospatial data to include within a dynamically generated tileset (**2**).\n\nSix additional [encodings](https://opengeospatial.github.io/ogcna-auto-review/20-057.html#rc_encodings) conformance classes are pre-defined for [_PNG_](https://opengeospatial.github.io/ogcna-auto-review/20-057.html#rc_png), [_JPEG_](https://opengeospatial.github.io/ogcna-auto-review/20-057.html#rc_jpeg), [_GeoTIFF_](https://opengeospatial.github.io/ogcna-auto-review/20-057.html#rc_tiff), [_GeoJSON_](https://opengeospatial.github.io/ogcna-auto-review/20-057.html#rc_geojson), [_Mapbox Vector Tiles_](https://opengeospatial.github.io/ogcna-auto-review/20-057.html#rc_mvt) and [_netCDF_](https://opengeospatial.github.io/ogcna-auto-review/20-057.html#rc_netcdf).\n\nHow to link to tilesets of [Maps](https://docs.ogc.org/DRAFTS/20-058.html#_relationship_to_ogc_api_tiles), [Coverages](https://docs.opengeospatial.org/DRAFTS/19-087.html#rc-coverage-tiles-section) and potentially other geospatial resources, is defined in the respective specification by leveraging the _OGC API - Tiles_ building blocks.\n\n_Note that it was [decided](https://github.com/opengeospatial/ogcapi-maps/issues/76) that Map Tiles would be an optional conformance class of _OGC API - Maps - Part 1: Core_, but this is pending an update to the draft specification_.\n\n### Extensions\nWe foresee the following extensions (some of them might become OGC standards, and some might not)\n* Info (featureInfo) (started in: [clause_7_tile_info](extensions/info/standard/clause_7_tile_info.adoc))\n* Multi-tile (retrieve a ZIP with many tiles) (started in: [clause_7_multitile](extensions/multitile/standard/clause_7_tile_multitiles.adoc))\n* TileMatrixSet transactions may allow to specify custom TileMatrixSet definitions according to which a server could dynamically generate tilesets\n\n## Communication\n\nJoin the OGC API - Tiles [mailing list](https://lists.ogc.org/mailman/listinfo/ogcapi-tiles.swg).\n\nVisit the OGC API - Tiles [project on the OGC portal](https://portal.ogc.org/?m=projects\u0026a=view\u0026project_id=646) after [signing](https://portal.ogc.org/files/?artifact_id=95414) the [Observer Agreement](https://portal.ogc.org/files/?artifact_id=92169).\n\nMost work on the specification takes place in [GitHub issues](https://github.com/opengeospatial/ogcapi-tiles/issues),\nso browse there to get a good idea of what is happening, as well as past decisions.\n\n## Contributing\n\nThe contributor understands that any contributions, if accepted by the OGC Membership (and eventually the ISO/TC 211), shall be incorporated into OGC and ISO/TC 211 Web Map Service and Web Map Tile Service standards documents and that all copyright and intellectual property shall be vested to the OGC.\n\nThe OGC API - Tiles Standards Working Group (SWG) is the group at OGC responsible for the stewardship of the standard, but is working to do as much work in public as possible.\n\n* [Open issues](https://github.com/opengeospatial/ogcapi-tiles/issues)\n* [Copy of License Language](https://raw.githubusercontent.com/opengeospatial/ogcapi-tiles/master/LICENSE)\n\nPull Requests from contributors are welcomed. However, please note that by sending a Pull Request or Commit to this GitHub repository, you are agreeing to the terms in the [Observer Agreement](https://portal.ogc.org/files/?artifact_id=92169).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopengeospatial%2Fogcapi-tiles","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopengeospatial%2Fogcapi-tiles","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopengeospatial%2Fogcapi-tiles/lists"}