{"id":26668788,"url":"https://github.com/brazil-data-cube/lccs-ws-spec","last_synced_at":"2025-04-12T01:56:16.084Z","repository":{"id":47104098,"uuid":"238290718","full_name":"brazil-data-cube/lccs-ws-spec","owner":"brazil-data-cube","description":"Land Cover Classification System Web Service Specification","archived":false,"fork":false,"pushed_at":"2021-09-13T12:39:25.000Z","size":113,"stargazers_count":4,"open_issues_count":3,"forks_count":3,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-04-12T01:56:10.625Z","etag":null,"topics":["database","earth-science","geospatial","gis","land-cover","land-cover-classification","land-user","postgresql"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/brazil-data-cube.png","metadata":{"files":{"readme":"README.rst","changelog":"CHANGES.rst","contributing":null,"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-04T19:42:03.000Z","updated_at":"2023-08-03T14:18:36.000Z","dependencies_parsed_at":"2022-08-25T12:51:58.511Z","dependency_job_id":null,"html_url":"https://github.com/brazil-data-cube/lccs-ws-spec","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brazil-data-cube%2Flccs-ws-spec","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brazil-data-cube%2Flccs-ws-spec/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brazil-data-cube%2Flccs-ws-spec/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brazil-data-cube%2Flccs-ws-spec/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/brazil-data-cube","download_url":"https://codeload.github.com/brazil-data-cube/lccs-ws-spec/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248505864,"owners_count":21115354,"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":["database","earth-science","geospatial","gis","land-cover","land-cover-classification","land-user","postgresql"],"created_at":"2025-03-25T21:35:02.833Z","updated_at":"2025-04-12T01:56:16.065Z","avatar_url":"https://github.com/brazil-data-cube.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"..\n    This file is part of Land Cover Classification System Web Service Specification.\n    Copyright (C) 2019-2021 INPE.\n\n    Land Cover Classification System Web Service Specification is free software; you can redistribute it and/or modify it\n    under the terms of the MIT License; see LICENSE file for more details.\n\n\n============================================================\nLand Cover Classification System Web Service - Specification\n============================================================\n\n.. image:: https://img.shields.io/badge/license-MIT-green\n        :target: https://github.com//brazil-data-cube/lccs-ws-spec/blob/master/LICENSE\n        :alt: Software License\n\n.. image:: https://img.shields.io/badge/lifecycle-maturing-blue.svg\n        :target: https://www.tidyverse.org/lifecycle/#maturing\n        :alt: Software Life Cycle\n\n.. image:: https://img.shields.io/github/tag/brazil-data-cube/lccs-ws-spec.svg\n        :target: https://github.com/brazil-data-cube/lccs-ws-spec/releases\n        :alt: Release\n\n.. image:: https://img.shields.io/discord/689541907621085198?logo=discord\u0026logoColor=ffffff\u0026color=7389D8\n        :target: https://discord.com/channels/689541907621085198#\n        :alt: Join us at Discord\n\nAbout\n=====\n\nCurrently, there are several data sets on regional, national and global scales with information on land use and land cover that aim to support a large number of applications, including the management of natural resources, climate change and its impacts, and biodiversity conservation. These data products are generated using different approaches and methodologies, which present information about different classes of the earth's surface, such as forests, agricultural plantations, among others. Initiatives that generate land use and land cover maps normally develop their own classification system, with different nomenclatures and meanings of the classes used.\n\n\nIn this context, the **LCCS-WS** (**L**\\ and **C**\\ over **C**\\ lassification **S**\\ystem **W**\\eb **S**\\ ervice) aims to provide a simple interface to access the various classification systems in use and their respective classes. Therefore, this service proposes a representation for the classification systems and provides an API to access the classes and their symbolizations. It is also possible to stablish mappings between classes of different systems.\n\n\nFree and Open Source implementations based on this service can be found in the `lccs-ws \u003chttps://github.com/brazil-data-cube/lccs-ws\u003e`_ (server) and `lccs.py \u003chttps://github.com/brazil-data-cube/lccs.py\u003e`_ (Python client). See also the service **W**\\eb **L**\\and **T**\\rajectory **S**\\ystem (`WLTS \u003chttps://github.com/brazil-data-cube/wlts-spec\u003e`_), which uses LCCS-WS to represent the classes associated with the features retrieved in its queries.\n\n\nRepository Organization\n=======================\n\n- `api \u003c./api\u003e`_: LCCS Specification using `OpenAPI 3.0 \u003chttps://github.com/OAI/OpenAPI-Specification\u003e`_.\n\n- `jsonschemas \u003c./jsonschemas\u003e`_: `JSON Schema \u003chttps://json-schema.org/\u003e`_ for the classification systems and classes.\n\n\nOverview of Service Operations\n==============================\n\n- The ``/classification_systems`` operation when queried with a ``GET`` method returns the list of land use and cover classification systems available in the service. A ``POST`` request on this route allow the client to add a new classification system.\n\n- The ``/classification_systems/{system_id_or_identifier}`` operation when queried with a ``GET`` method returns a document with full information about the classification system.\n\n- The ``/classification_systems/{system_id_or_identifier}/classes`` operation when queried with a ``GET`` method returns the list of classes from a classification system.\n\n- The ``/classification_systems/{system_id_or_identifier}/classes/{class_id}`` operation when queried with a ``GET`` method returns information about a class from a classification system\n\n- The ``/classification_systems/{system_id_or_identifier}/styles`` operation when queried with a ``GET`` method returns the list of styles of the classification.\n\n- The ``/classification_system/{system_id_or_identifier}/styles/{style_id}`` operation when queried with a ``GET`` method returns a document with the style of the classification system.\n\n- The ``/mappings/{system_id_or_identifier_source}`` operation when queried with a ``GET`` method returns a list of available mappings for the classification system.\n\n- The ``/mappings/{system_id_or_identifier_source}/{system_id_or_identifier_target}``: operation when queried with a ``GET`` method returns the mapping between the classification systems. A ``POST`` request on this route allow the client to add a new mapping.\n\nBuilding the Documentation\n==========================\n\nRequirements\n------------\n\nThe build system for the REST API documentation relies on the Node.js run-time environment:\n\n  - `Node.js \u003chttps://nodejs.org/en/\u003e`_ (Version 8+).\n\n  - `ReDoc \u003chttps://github.com/Redocly/redoc\u003e`_: generates HTML reference documentation from an OpenAPI specification file.\n\n\nBuild\n-----\n\nIf you have Node.js installed, please, execute the following command to install the ReDoc dependency:\n\n.. code-block:: shell\n\n    $ npm install\n\n\nAfter that, generate the documentation:\n\n.. code-block:: shell\n\n    $ npm run build\n\n\nThe above command will create a folder named ``dist`` with the bundled file index.html. You may open it in your web browser or may serve it with an HTTP Server.\n\nFor Python developers, you can serve the HTML with:\n\n.. code-block:: shell\n\n        python3.7 -m http.server 8080 --directory dist\n\n\nLicense\n=======\n\n.. admonition::\n    Copyright (C) 2019-2021 INPE.\n\n    Land Cover Classification System Web Service is free software; you can redistribute it and/or modify it\n    under the terms of the MIT License; see LICENSE file for more details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrazil-data-cube%2Flccs-ws-spec","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbrazil-data-cube%2Flccs-ws-spec","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrazil-data-cube%2Flccs-ws-spec/lists"}