{"id":48815044,"url":"https://github.com/opengeospatial/poi","last_synced_at":"2026-04-14T10:34:34.141Z","repository":{"id":909647,"uuid":"12298609","full_name":"opengeospatial/poi","owner":"opengeospatial","description":"OGC Points of Interest Encoding Specification","archived":false,"fork":false,"pushed_at":"2025-06-05T12:08:29.000Z","size":204825,"stargazers_count":21,"open_issues_count":49,"forks_count":28,"subscribers_count":40,"default_branch":"main","last_synced_at":"2025-06-05T12:37:13.663Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/opengeospatial.png","metadata":{"files":{"readme":"README.adoc","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":"2013-08-22T14:11:50.000Z","updated_at":"2025-06-05T12:08:30.000Z","dependencies_parsed_at":"2023-07-05T21:01:29.659Z","dependency_job_id":"7b1a005c-641d-4cac-aa3d-791d5dfc5828","html_url":"https://github.com/opengeospatial/poi","commit_stats":{"total_commits":285,"total_committers":22,"mean_commits":"12.954545454545455","dds":0.656140350877193,"last_synced_commit":"f0787245f32168a8331ffc99a14735b15841c223"},"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/opengeospatial/poi","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opengeospatial%2Fpoi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opengeospatial%2Fpoi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opengeospatial%2Fpoi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opengeospatial%2Fpoi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/opengeospatial","download_url":"https://codeload.github.com/opengeospatial/poi/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opengeospatial%2Fpoi/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31793221,"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:34.082Z","updated_at":"2026-04-14T10:34:34.133Z","avatar_url":"https://github.com/opengeospatial.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# About OGC Points of Interest (PoI) GitHub Repository\n\n*NOTICE:* An analysis of alternatives for internationalized text is available for review and comment in https://htmlpreview.github.io/?https://github.com/opengeospatial/poi/blob/main/21-049/Internationalized_Text.html[HTML] and https://github.com/opengeospatial/poi/blob/main/21-049/Internationalized_Text.pdf[PDF]  \n\nThis repository is the development space for the future versions of the OGC Point of Interest (POI) Part 1: Conceptual Model Standard. Future development of this Standard is taking place in the 21-049 directory. The PUBLISHED VERSION is available in https://docs.ogc.org/is/21-049/21-049.html[HTML] and https://docs.ogc.org/is/21-049/21-049.pdf[PDF] formats.\n\nThis Standard is accompanied by a POI Best Practices document. Development of the Best Practices is taking place in the 22-053 directory. The current draft is available in https://docs.ogc.org/DRAFTS/22-053.html[HTML] and https://docs.ogc.org/DRAFTS/22-053.pdf[PDF] formats.\n\nThe draft OGC Point of Interest (POI) Part 2: JSON Encoding Standard defines how the POI Conceptual model should be implemented in JSON. Development of this Standard is taking place in the 23-045 directory. The current draft is available in https://docs.ogc.org/DRAFTS/23-045.html[HTML] and https://docs.ogc.org/DRAFTS/23-045.pdf[PDF] formats.\n\nThis repository also contains legacy files about and for the purpose of developing the PoI specification(s).\n\nThese files are from the following sources:\n\n1. All contents of this repo beginning from when it was created by the transfer of work from the W3C to end of 2014 when the activity of the POI SWG stopped. These files were moved into a https://github.com/opengeospatial/poi/tree/main/POI-repo-files-Pre-2014[dedicated folder] in order to preserve the prior work of the OGC POI SWG. At the same time as the files were put into their folder on this repo, all the issues created prior to the end of 2014 are labelled and closed.\n\n2. https://github.com/opengeospatial/templates[OGC Templates GitHub Repository]\nThis is the origin of one file at the top level of this repo, the https://github.com/opengeospatial/poi/blob/main/Draft_PoI_SWG_charter.adoc[Draft PoI SWG charter template]\n\n3. A folder containing the template for the new POI draft specification.\n\n# Generating Documentation \n\nOGC uses [Metanorma](https://www.metanorma.org) software for creating Standards documents.\n\nYou can compile documents using either a local installation of Metanorma or optionally a docker-containerized instance of Metanorma.\n\n## Using Metanorma from a local installation\n\n### Pre-requisite\n\nConfirm that you have Metanorma installed locally on your operating system. If you do not have Metanorma installed, follow the steps at the [Metanorma website](https://www.metanorma.org/install/) to install it.\n\n### Getting the Templates\n\n**Step 1**. Obtain the template for a Draft OGC Standard from the `template` sub-folder.\n\n### Editing a Draft OGC Standard for compilation with Metanorma\n\nNow that you have obtained a copy of the template, you can edit the document. The following steps assume that you have read the **authoring guidelines** are at https://www.metanorma.org/author/ogc/authoring-guide/\n\n**Step 2**. Next, edit the asciidoc file `document.adoc` by filling the document properties: `docsubtype`, `status`, `abbrev`, `edition` (i.e. version of the document), `docnumber` (OGC Document Number), `keywords`, `fullname` (of the editors).\n\n**Step 3**. Ensure that the `doctype` property is set to `standard`.\n\nRefer to the authoring guidelines for the complete list of document properties.\n\nNOTE: If there are multiple editors, the names of the editors are listed in the sequence `fullname`, `fullname_2`, `fullname_3`,...\n\n### Compiling a Draft OGC Standard with a local Metanorma instance\n\nTo convert the draft document from asciidoc format to HTML and PDF formats, we use the metanorma software to **compile** the document.\n\n**Step 4**. From the folder containing the `document.adoc` file, run the following command.\n\n`metanorma compile --agree-to-terms -t ogc -x xml,html,doc document.adoc`\n\nNOTE: You need to add this option to retrieve licensed fonts  `--agree-to-terms`\n\n## Using Metanorma from within Docker\n\n### Pre-requisite\n\nConfirm that you have docker installed on your operating system. If you do not have docker installed, follow the steps at the [Get Docker page](https://docs.docker.com/get-docker/) to install it.\n\n### Creating a copy of the template\n\nThe template for Standards documents is organized as a folder of asciidoc files, with nested folders for sections, abstract tests, requirements and other resources.\n\nTo create a copy of the template, follow these steps.\n\n**Step 1**. Pull the latest version of the Metanorma image on to your local docker installation.\n\n`docker pull metanorma/metanorma:latest`\n\n**Step 2**.  Generate a copy of the template for OGC Standards by running the following command from a terminal (i.e. from the command prompt).\n\n`docker run --rm -v \"$(pwd)\":/metanorma metanorma/metanorma  metanorma new -d standard -t ogc  -l https://github.com/metanorma/metanorma-templates-ogc folder_for_standard`\n\nNOTE: The `-d standard -t ogc` flags instruct metanorma that the template is for OGC Standards.\n\nNOTE: The `folder_for_standard` value can be replaced with whatever you would like to be the name of the folder that contains the copy of the template.\n\n### Editing a Draft OGC Standard for compilation with Metanorma\n\nNow that you have generated a copy of the template, you can edit the document. The following steps assume that you have read the **authoring guidelines** are at https://www.metanorma.org/author/ogc/authoring-guide/\n\n**Step 3**. Next, edit the asciidoc file `document.adoc` by filling the document properties: `docsubtype`, `status`, `abbrev`, `edition` (i.e. version of the standard), `docnumber` (OGC Document Number), `keywords`, `fullname` (of the editors).\n\n**Step 4**. Ensure that the `doctype` property is set to `standard`.\n\nRefer to the authoring guidelines for the complete list of document properties.\n\nNOTE: If there are multiple editors, the names of the editors are listed in the sequence `fullname`, `fullname_2`, `fullname_3`,...\n\n### Compiling a Draft OGC Standard with a docker-containerized Metanorma instance\n\nTo convert the draft standard from asciidoc format to HTML and PDF formats, we use the metanorma software to **compile** the document.\n\n**Step 5**. From the folder containing the `document.adoc` file, run the following command.\n\n`docker run -v \"$(pwd)\":/metanorma -v ${HOME}/.fontist/fonts/:/config/fonts  metanorma/metanorma  metanorma compile --agree-to-terms -t ogc -x xml,html,doc document.adoc`\n\nNOTE: You need to add this option to retrieve licensed fonts  `--agree-to-terms`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopengeospatial%2Fpoi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopengeospatial%2Fpoi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopengeospatial%2Fpoi/lists"}