Create staging_deploy.yaml

Author: jenningsanderson

.eslintrc.js

@@ -0,0 +1,32 @@
+module.exports = {
+  root: true,
+  env: {
+    browser: true,
+    es2021: true,
+    node: true,
+  },
+  extends: [
+    'eslint:recommended',
+    'plugin:react/recommended',
+    'plugin:react/jsx-runtime',
+    'prettier',
+  ],
+  parserOptions: {
+    ecmaFeatures: {
+      jsx: true,
+    },
+    ecmaVersion: 'latest',
+    sourceType: 'module',
+  },
+  plugins: ['react'],
+  settings: {
+    react: {
+      version: 'detect',
+    },
+  },
+  rules: {
+    'react/prop-types': 'off',
+    'no-unused-vars': ['warn', { argsIgnorePattern: '^_' }],
+  },
+  ignorePatterns: ['build/', '.docusaurus/', 'node_modules/'],
+};

.github/workflows/lint_queries.yml

@@ -1,28 +1,28 @@
 ---
-  name: SQLFluff lint the queries
-  run-name: Basic testing of the queries in src/queries
+name: SQLFluff lint the queries
+run-name: Basic testing of the queries in src/queries
 
-  on:
-    pull_request:
-      paths:
-        - 'src/queries/**'
-    workflow_dispatch:
+on:
+  pull_request:
+    paths:
+      - 'src/queries/**'
+  workflow_dispatch:
 
-  permissions:
-    id-token: write
-    contents: read
+permissions:
+  id-token: write
+  contents: read
 
-  jobs:
-    run:
-      runs-on: ubuntu-latest
-      steps:
+jobs:
+  run:
+    runs-on: ubuntu-latest
+    steps:
       - name: Checkout Repo
         uses: actions/checkout@v3
 
       - name: Set up Python 3.11
         uses: actions/setup-python@v3
         with:
-          python-version: "3.11"
+          python-version: '3.11'
 
       - name: Install dependencies
         run: |

.github/workflows/production_deploy_documentation.yml

@@ -8,11 +8,6 @@ on:
 
   # Allow running from the actions tab
   workflow_dispatch:
-    inputs:
-      schema_branch:
-        description: 'Schema branch to pull from for /reference'
-        required: true
-        default: 'main'
 
 permissions:
   id-token: write # required to use OIDC authentication
@@ -29,24 +24,22 @@ jobs:
         uses: actions/checkout@v3
 
       - name: Set up Node.js
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v6
         with:
-          node-version: "20"
+          node-version: '24'
 
       - name: Install NPM dependencies
         run: npm install --prefer-dedupe
 
       - name: Build Docusaurus Pages 🔧
-        env:
-          SCHEMA_BRANCH: ${{ inputs.schema_branch }}
         run: npm run build
 
       - name: Setup Pages 🗂️
         uses: actions/configure-pages@v5
 
       - name: Upload static files as GH-Pages artifact 📦
         id: docs-website
-        uses: actions/upload-pages-artifact@v3
+        uses: actions/upload-pages-artifact@v4
         with:
           path: build
 

.github/workflows/staging_deploy.yaml

@@ -4,7 +4,7 @@ run-name: Publish docs to staging website (for PR)
 
 on:
   pull_request:
-    branches: [ main ]
+    branches: [main]
 
 permissions:
   id-token: write
@@ -19,9 +19,9 @@ jobs:
         uses: actions/checkout@v4
 
       - name: Set up Node.js
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v6
         with:
-          node-version: "20"
+          node-version: '24'
 
       - name: Install NPM dependencies
         run: npm ci --omit=dev
@@ -30,10 +30,9 @@ jobs:
         env:
           DOCUSAURUS_URL: https://staging.overturemaps.org/
           DOCUSAURUS_BASE_URL: /${{ github.event.repository.name }}/pr/${{ github.event.number }}/
-          SCHEMA_BRANCH: ${{ inputs.schema_branch }}
         run: npm run build
 
-      - name: Upload docs build as GH-Pages artifact 📦
+      - name: Upload docs build as an artifact 📦
         uses: actions/upload-artifact@v4
         with:
           path: build

.markdownlint.json

@@ -0,0 +1,9 @@
+{
+  "default": true,
+  "MD013": false,
+  "MD033": false,
+  "MD041": false,
+  "MD024": {
+    "siblings_only": true
+  }
+}

.prettierignore

@@ -0,0 +1,5 @@
+build/
+.docusaurus/
+node_modules/
+package-lock.json
+*.md

.prettierrc

@@ -0,0 +1,10 @@
+{
+  "semi": true,
+  "singleQuote": true,
+  "tabWidth": 2,
+  "trailingComma": "es5",
+  "printWidth": 100,
+  "bracketSpacing": true,
+  "arrowParens": "always",
+  "proseWrap": "preserve"
+}

blog/2023-alpha/2023-07-26-alpha.0.mdx

@@ -4,39 +4,42 @@ slug: 2023-07-26-alpha.0
 ---
 
 ### Highlights
-Overture `2023-07-26-alpha.0` is a first release version of open map data, establishing a baseline for future releases by the Overture Maps Foundation. The data is available for use under the designated licenses for each theme.  Users should note that while Overture intends to release open map data on a regular cadence in the future, the date of subsequent releases has not been established yet.
+
+Overture `2023-07-26-alpha.0` is a first release version of open map data, establishing a baseline for future releases by the Overture Maps Foundation. The data is available for use under the designated licenses for each theme. Users should note that while Overture intends to release open map data on a regular cadence in the future, the date of subsequent releases has not been established yet.
 
 <!-- truncate -->
 
-We would like feedback on the data, its usefulness and how it could be improved.  Please use this Github repo for discussions and feedback related to this data release.
+We would like feedback on the data, its usefulness and how it could be improved. Please use this Github repo for discussions and feedback related to this data release.
 
 Overture `2023-07-26-alpha.0` is formatted in the Overture Maps schema described here. It is available in cloud-native Parquet and stored on AWS and Azure.
 
 ### Changelog
+
 See our [changelog](https://github.com/OvertureMaps/schema/releases/tag/v0.4.0) here.
 
 ### Theme-specific updates
+
 Overture `2023-07-26-alpha.0` is being released in four themes:
 
 **Places Theme**
-The Places theme includes Point of Interest (POI) Data on approximately 59M places worldwide. Place records include the name, address, pin location, category and social media handles to the extent these are available.  The data also includes a confidence score for each record. The sources of the Places theme include Meta and Microsoft places data. The Places data is formated in the Overture Maps schema for Places.
+The Places theme includes Point of Interest (POI) Data on approximately 59M places worldwide. Place records include the name, address, pin location, category and social media handles to the extent these are available. The data also includes a confidence score for each record. The sources of the Places theme include Meta and Microsoft places data. The Places data is formated in the Overture Maps schema for Places.
 
 Data in the Places theme is licensed under CDLA Permissive 2.0.
 
-
 **Buildings Theme**
-The Buildings theme includes building footprint and height data as available.  It includes approximately 785M building outlines worldwide.  The sources include OpenStreetMap, Microsoft Building footprints and Esri Community Partners. Some building heights have also been derived using lidar from USGS 3DEP. The Building data is in the Overture Maps data schema for Buildings.
+The Buildings theme includes building footprint and height data as available. It includes approximately 785M building outlines worldwide. The sources include OpenStreetMap, Microsoft Building footprints and Esri Community Partners. Some building heights have also been derived using lidar from USGS 3DEP. The Building data is in the Overture Maps data schema for Buildings.
 
 Data in the Buildings theme is licensed under ODbL.
 
 **Transportation Theme**
-The transportation theme includes road networks data based on OpenStreetMap.  This release is a demonstration of our Shape and Connectivity model of the transportation network, and also showcases how Geometric Scoping (LR) interacts with a subset of the final properties. The data has been put into the Overture Maps data schema for transportation.  As such, the data has been re-segmented and structured with some conditional attributes. For example, scoping dimensions related to speed limits have geometric scoping when speed limits change along a road segment.
+The transportation theme includes road networks data based on OpenStreetMap. This release is a demonstration of our Shape and Connectivity model of the transportation network, and also showcases how Geometric Scoping (LR) interacts with a subset of the final properties. The data has been put into the Overture Maps data schema for transportation. As such, the data has been re-segmented and structured with some conditional attributes. For example, scoping dimensions related to speed limits have geometric scoping when speed limits change along a road segment.
 
 :::note
 The data includes some provisional Global Entity Reference System (GERS) data which is used to express relationships between road segments. This may not be representative of the final GERS format and should not be the basis for long term development work.
 :::
 
 There are several missing properties in this data release that will be added in future releases:
+
 - Only includes road segments made from Ways that include a 'highway' tag
 - Non-geometric scoping properties are not included
 - Turn and Access restrictions are not included
@@ -55,6 +58,7 @@ Placeholder GERS IDs are populated in the data. These are needed to populate the
 Data in the Admins theme is licensed under CDLA Permissive 2.0.
 
 ### Attribution
+
 - © OpenStreetMap contributors available under the Open Database License (www.openstreetmap.org/copyright)
 - U.S. Geological Survey, 2019, USGS 3D Elevation Program Digital Elevation Program
 - Building data © OpenStreetMap contributors, Microsoft, Esri Community Maps contributors

blog/2023-alpha/2023-10-19-alpha.0.mdx

@@ -4,7 +4,8 @@ slug: 2023-10-19-alpha.0
 ---
 
 ### Highlights
-Overture `2023-10-19-alpha.0` is now available. This release includes several improvements to the data quality and coverage as well as updates for data currency.  There are two new additions of note:
+
+Overture `2023-10-19-alpha.0` is now available. This release includes several improvements to the data quality and coverage as well as updates for data currency. There are two new additions of note:
 
 - **Base Theme**: A new Base theme that provides three context data subtypes. These can be used with the other themes to allow developers to build complete maps using any Overture release.
 - **Buildings Theme**: Stable identifiers have been added to 1.6M buildings in 8 cities to demonstrate how Overture will implement stable identifiers (named Global Entity Reference System or GERS).
@@ -22,13 +23,16 @@ We would like feedback on the data, its usefulness, and how it could be improved
 Overture `2023-10-19-alpha.0` is formatted in the Overture Maps schema described here. It is available in cloud-native Parquet and stored on AWS and Azure.
 
 ### Changelog
+
 See our [changelog](https://github.com/OvertureMaps/schema/releases/tag/v0.5.0) here.
 
 ### Theme-specific updates
+
 Overture `2023-10-19-alpha.0` is released in five themes.
 
 **Base Theme**
 The Base theme is an entirely new theme with 3 subTypes: land, landUse, and water. The overall purpose of this new theme is to allow users to create a complete map using any Overture release. Descriptions of the subTypes for Base are:
+
 - land: Physical representations of land surfaces. Derived from the inverse of OSM Coastlines.
 - landUse: Classifications of the human use of a section of land. Mostly derived from the key landuse in OpenStreetMap
 - water: Physical representations of inland and ocean marine surfaces. Derived from OSM Coastlines, and the keys natural and waterway in OpenStreetMap.
@@ -44,6 +48,7 @@ The order of conflation is OpenStreetMap > Esri Community Maps > Microsoft ML Bu
 
 :::note
 A sample set of 1.6M buildings from OpenStreetMap and Esri have been assigned an initial GERS ID for demonstration purposes. These IDs are 32 character strings. By referencing these other datasets to this data release, we can match GERS IDs to external datasets and demonstrate how GERS can enable ID-based joins between two geospatial datasets. These are located in the following cities:
+
 - United States: Seattle, Washington; Macon, Georgia; Charleston, South Carolina; Spokane, Washington
 - Canada: Kingston, Ontario
 - Netherlands: Leeuwarden, Friesland
@@ -59,10 +64,11 @@ Data in the Buildings theme is licensed under ODbL.
 
 **Administrative Boundaries (Admins) Theme**
 The Admins theme includes multiple locality types:
+
 - Countries formed from OpenStreetMap relations, primarily admin_level=2, with few exceptions such as admin_level=3 French Polynesia.
 - First-level subdivisions under the country which was mapped from OpenStreetMap admin_level depending on country, in most countries admin_level=4.
 - Second-level subdivisions under the country which was mapped from OpenStreetMap admin_level depending on country, in most countries admin_level=6.
-- Cities, Town, Villages, Neighborhoods... based on place=* tag. In most cases these are just points. When relation with place=* tag exist we provide polygon geometry.
+- Cities, Town, Villages, Neighborhoods... based on place=_ tag. In most cases these are just points. When relation with place=_ tag exist we provide polygon geometry.
 
 It also includes administrative boundaries representing borders of countries, first-level subdivisions and second-level subdivisions. The Administrative Boundary data is in the Overture Maps data schema for Admin.
 Second-level subdivision did not undergo worldwide inspection of quality so some missing or wrong data is expected. All first-level subdivisions have `type=state` and all second-level subdivisions have `type=county` which is not always true; we plan to address this issue in future releases. We plan to use admin_level=8,9,10 to add polygons to cities, town, villages and other localities when available depending on individual country mapping.
@@ -71,6 +77,7 @@ Data in the Admin theme is licensed under ODbL. The sources of the admin theme a
 
 **Places Theme**
 This release has over 57M place records. The Places theme in this release includes several modifications to improve the accuracy and quality of the dataset:
+
 - Increased deduplication on significant landmarks by revising the screening criteria for signals based on check-ins only
 - Removal of places determined to be non-existent
 - Address normalization bug fix that was yielding incorrect pin locations. In addition, support for website, phone and category was added to the Microsoft sourced data.
@@ -80,6 +87,7 @@ Data in the Places theme is licensed under CDLA Permissive 2.0.
 
 **Transportation Theme**
 The Transportation theme includes the following improvements:
+
 - Collective OSM changes through September 15th, updated and converted to Overture's Schema.
 - Addition of Linear Referenced features, enabling the description of properties that apply along only portions of a segment.
 - Over 1.3 million turn restrictions worldwide
@@ -88,12 +96,13 @@ The Transportation theme includes the following improvements:
 
 :::note
 There are several missing properties in this data release that will be added in future releases:
+
 - Only includes road segments made from Ways that include a ‘highway’ tag
 - Non-geometric scoping properties are not included
 - Turn and Access restrictions are not included
 - Lane information is not included
 - Some language/scripts are not included in names properties
-:::
+  :::
 
 :::note
 The data includes some provisional Global Entity Reference System (GERS) data which is used to express relationships between road segments. This may not be representative of the final GERS format and should not be the basis for long-term development work.
@@ -102,6 +111,7 @@ The data includes some provisional Global Entity Reference System (GERS) data wh
 Data in the Transportation theme is licensed under ODbL.
 
 ### Attribution
+
 - © OpenStreetMap contributors available under the Open Database License (www.openstreetmap.org/copyright)
 - U.S. Geological Survey, 2019, USGS 3D Elevation Program Digital Elevation Program
 - Building data © OpenStreetMap contributors, Microsoft, Esri Community Maps contributors

blog/2023-alpha/2023-11-14-alpha.0.mdx

@@ -4,6 +4,7 @@ slug: 2023-11-14-alpha.0
 ---
 
 ### Highlights
+
 Overture `2023-11-14-alpha.0` is now available. This is an incremental release that includes several improvements to the data quality and coverage as well as updates for data currency. More information about these additions is available in the relevant sections below.
 
 <!-- truncate -->
@@ -17,13 +18,16 @@ We would like feedback on the data, its usefulness, and how it could be improved
 Overture `2023-11-14-alpha.0` is available in cloud-native Parquet and stored on AWS and Azure.
 
 ### Changelog
+
 See our [changelog](https://github.com/OvertureMaps/schema/releases/tag/v0.6.0) here.
 
 ### Theme-specific updates
+
 Overture `2023-11-14-alpha.0` is released in five themes. Updated to Geo Parquet format for this release:
 
 **Transportation Theme**
 The Transportation theme includes the following improvements:
+
 - Collective OSM changes through October 15th, updated and converted to Overture’s Schema.
 - Over 1.5 million turn restrictions worldwide.
 
@@ -49,28 +53,32 @@ Data in the Buildings theme is licensed under ODbL.
 
 **Places Theme**
 This release has over 57M place records. The Places theme in this release includes incremental improvements to improve the accuracy and quality of the dataset:
+
 - Corrected missing postal codes from the previous release (2023-10-19-alpha.0).
 - New data has been included to improve category coverage.
 
 Data in the Places theme is licensed under CDLA Permissive 2.0.
 
 **Administrative Boundaries (Admins) Theme**
 The Admins theme in this release includes several modifications to improve schema of the dataset:
+
 - We added ability for admins to have point and area, in future multiple areas like landmass and maritime area
 - Fixed issue with invalid format of updateTime property
 
 :::note
 Known issues:
+
 - Second-level subdivision did not undergo worldwide inspection of quality so some missing or wrong data is expected.
 - All first-level subdivisions have type=state and all second-level subdivisions have type=county which is not always true, we plan to address this issue in following releases.
 - We plan to use admin_level=8,9,10 to add polygons to cities, towns, villages and other localities when available depending on individual country mapping.
-:::
+  :::
 
 The sources of the admin theme are OpenStreetMap and Esri. The Administrative Boundary data is in the Overture Maps data schema for Admin.
 
 Data in the Admin theme is licensed under ODbL.
 
 ### Attribution
+
 - © OpenStreetMap contributors available under the Open Database License (www.openstreetmap.org/copyright)
 - U.S. Geological Survey, 2019, USGS 3D Elevation Program Digital Elevation Program
 - Building data © OpenStreetMap contributors, Microsoft, Esri Community Maps contributors