From d63edad49d782a943d079dc87916a549d04cdef2 Mon Sep 17 00:00:00 2001 From: Alex Iannicelli Date: Thu, 15 Oct 2026 15:13:34 -0400 Subject: [PATCH] docs(base): note that physical water features overlap ocean tiles Fixes #579 Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Signed-off-by: Alex Iannicelli --- docs/guides/base/index.mdx | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/guides/base/index.mdx b/docs/guides/base/index.mdx index 211384561..510f25058 100644 --- a/docs/guides/base/index.mdx +++ b/docs/guides/base/index.mdx @@ -49,6 +49,8 @@ Land use features specify the predominant human use of an area of land, for exam #### Water Water features represent ocean and inland water bodies. In Overture data releases, water features are sourced from OpenStreetMap. There are two main categories of water feature: ocean and inland water bodies — physical representations of inland and ocean marine surfaces, translating natural and waterway tags from OpenStreetMap. +Physical water features (`subtype = "physical"`), such as named bays, straits, and seas, overlap the ocean and inland water polygons by design. Use them for labels, and filter them out (`subtype != 'physical'`) when drawing water fills or computing water area. See the [water schema reference](/schema/reference/base/water/) for the full list of subtypes. + ### Column definitions The column definitions for every type in the base theme are generated from the schema and live in the schema reference: