{"id":48815108,"url":"https://github.com/opengeospatial/ogcapi-styles","last_synced_at":"2026-04-14T10:34:42.326Z","repository":{"id":46567598,"uuid":"241439214","full_name":"opengeospatial/ogcapi-styles","owner":"opengeospatial","description":"A Web API that enables map servers, clients as well as visual style editors, to manage and fetch styles.","archived":false,"fork":false,"pushed_at":"2024-02-16T09:32:37.000Z","size":160,"stargazers_count":10,"open_issues_count":13,"forks_count":5,"subscribers_count":13,"default_branch":"master","last_synced_at":"2024-04-16T03:26:12.562Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://ogcapi.ogc.org/styles","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":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-02-18T18:41:38.000Z","updated_at":"2024-02-22T07:21:32.000Z","dependencies_parsed_at":"2023-01-22T14:01:00.417Z","dependency_job_id":null,"html_url":"https://github.com/opengeospatial/ogcapi-styles","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/opengeospatial/ogcapi-styles","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opengeospatial%2Fogcapi-styles","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opengeospatial%2Fogcapi-styles/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opengeospatial%2Fogcapi-styles/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opengeospatial%2Fogcapi-styles/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/opengeospatial","download_url":"https://codeload.github.com/opengeospatial/ogcapi-styles/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opengeospatial%2Fogcapi-styles/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31793222,"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:42.259Z","updated_at":"2026-04-14T10:34:42.316Z","avatar_url":"https://github.com/opengeospatial.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# OGC API - Styles\n\nThis GitHub repository contains [OGC](http://opengeospatial.org)'s proposed standard for accessing styles for rendering geospatial data (features or coverages) on the web, \"OGC API - Styles\". The editor's draft of the specification can be found at [docs.ogc.org/DRAFTS/20-009.html](https://docs.ogc.org/DRAFTS/20-009.html).\n\n[OGC API standards](https://ogcapi.ogc.org) define modular API building blocks to spatially enable Web APIs in a consistent way. [OpenAPI](http://openapis.org) is used to define the reusable API building blocks with responses in JSON and HTML.\n\nThe OGC API family of standards is organized by resource type. OGC API Styles specifies API building blocks for interacting with styles in multiple style encodings and with metadata for the styles.\n\nThe work on the API started in the Open Portrayal Framework thread of OGC Testbed-15 with the results documented in an [Engineering Report](http://docs.opengeospatial.org/per/19-010r2.html).\n\n## Overview\n\nOGC API Styles supports several types of consumers, mainly:\n\n* Visual style editors that create, update and delete styles for datasets that are shared by other Web APIs implementing OGC API Features, OGC API Tiles, or OGC API Coverages;\n* Web APIs implementing OGC API Maps fetch styles and render spatial data (features or coverages) on the server;\n* Map clients that fetch styles and render spatial data on the client.\n\nThe API building blocks implement three main concepts:\n\n* **Styles** are the main resources.\n* Each style is available as one or more **stylesheets** - the representation of a style in an encoding like OGC SLD 1.0 or Mapbox Style. Clients will use the stylesheet of a style that fits best based on the capabilities of available tools and their preferences.\n* For each style there is **style metadata** available, with general descriptive information about the style, structural information (e.g., layers and attributes), and so forth to allow users to discover and select existing styles for their data.\n\n```\nGET /styles\n```\n\nLists the styles available on the server, and each describes basic information about the geospatial data collection, like its id, title and description, as well as the available stylesheets.\n\n```\nGET /styles/topographic/metadata\n```\n\nRequests the metadata for the style \"topographic\" so that a client has more information about a potential style of interest. The response format (typically HTML or JSON, but extensions can easily supply others) is determined using [HTTP content negotiation](https://restfulapi.net/content-negotiation/).\n\n```\nGET /styles/topographic\n```\n\nReturns a stylesheet. Again, if multiple encodings are available, the style encoding is determined using [HTTP content negotiation](https://restfulapi.net/content-negotiation/).\n\nIn order to support styles, clients of data APIs (for example, supporting OGC API Features and/or OGC API Tiles) benefit from additional capabilities in these APIs, too. These are:\n\n* List and manage the applicable styles per collection (path `/collections/{collectionId}`).\n* Fetch the queryables of a collection (path `/collections/{collectionId}/queryables`) to support clients such as visual style editors to construct expressions for selection criteria in queries on features in the collection. \"Queryable\" means that the property may be used in styling rules or other filter expressions.\n\nTo support styling of coverage data, additional capabilities in the data API may be required, but have not been investigated yet.\n\n## Using the specification\n\nThe editor's draft is on the OGC website:\n\n* [Editor's Draft of OGC API - Styles](http://docs.opengeospatial.org/DRAFTS/20-009.html)\n\nA [PDF version](http://docs.opengeospatial.org/DRAFTS/20-009.pdf) is available, too.\n\nIf you prefer to view sample API definitions to get an idea, have a look at the following OpenAPI definitions on SwaggerHub (from Testbed-15):\n\n* [Styles API](https://app.swaggerhub.com/apis/cportele/opf-style-api/1.0.0)\n* [Features API with style extensions](https://app.swaggerhub.com/apis/cportele/opf-features-api/1.0.0)\n\nSeveral implementations of the draft standard exist:\n\n* [Implementations of the draft specification / demo services](implementations.md)\n\n## Communication\n\nMost of the work on the specification takes place in [GitHub issues](https://github.com/opengeospatial/ogcapi-styles/issues),\nso browse there to get a good idea of what is happening, as well as past decisions.\n\n## Additional information\n\nThe design principles of the specification is inspired by the work on [OGC API - Features](https://github.com/opengeospatial/ogcapi-features). For more information on the OGC API family of standards, see [ogcapi.org](http://ogcapi.org/).\n\nMore background information about OGC API Styles can be found in reports from OGC Testbed-15:\n* [OGC Testbed-15: Open Portrayal Framework Engineering Report](http://docs.opengeospatial.org/per/19-018.html)\n* [OGC Testbed-15: Encoding and Metadata Conceptual Model for Styles Engineering Report](http://docs.opengeospatial.org/per/19-023r1.html)\n* [OGC Testbed-15: Styles API Engineering Report](http://docs.opengeospatial.org/per/19-010r2.html)\n\n## Building\n\nThe latest drafts of each standard in this repository are build daily (based on the configuration contained in the [asciidoctor.json](https://github.com/opengeospatial/ogcapi-features/blob/master/asciidoctor.json) file):\n\n* [OGC API - Styles](http://docs.opengeospatial.org/DRAFTS/20-009.html)\n\nTo generate the HTML versions of the standards from this repository yourself, ensure that you have [Ruby](https://www.ruby-lang.org/en/) and\n[Asciidoctor](https://asciidoctor.org/) set up and [installed](https://asciidoctor.org/docs/#get-started-with-asciidoctor).\nThen run:\n\n```\nasciidoctor standard/20-009.adoc\n```\n\nThe resulting HTML files will be built in the same directory as the AsciiDoc file, e.g. as `standard/20-009.html`.\n\n## Contributing\n\nThe contributor understands that any contributions, if accepted by the OGC Membership, shall be incorporated into OGC standards documents and that all copyright and intellectual property shall be vested to the OGC.\n\nThe OGC API Styles 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-styles/issues)\n* [Copy of License Language](https://raw.githubusercontent.com/opengeospatial/ogcapi-styles/master/LICENSE)\n\nFor more information, see [CONTRIBUTING.md](CONTRIBUTING.md).\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-styles","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopengeospatial%2Fogcapi-styles","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopengeospatial%2Fogcapi-styles/lists"}