tilebox · lukasbindreiter · Jul 11, 2025 · Jul 9, 2025 · Jul 11, 2025
diff --git a/.github/styles/config/vocabularies/docs/accept.txt b/.github/styles/config/vocabularies/docs/accept.txt
@@ -64,3 +64,5 @@ bool
 boolean
 (?i)modis
 reprojected
+(?i)geospatial
+(?i)cartesian
diff --git a/api-reference/python/tilebox.datasets/Collection.find.mdx b/api-reference/python/tilebox.datasets/Collection.find.mdx
@@ -42,6 +42,8 @@ data = collection.find(
 
 
 # check if a datapoint exists
+from tilebox.datasets.sync.dataset import NotFoundError
+
 try:
     collection.find(
         "0186d6b6-66cc-fcfd-91df-bbbff72499c3",

diff --git a/assets/datasets/geometries/antimeridian-dark.png b/assets/datasets/geometries/antimeridian-dark.png
diff --git a/assets/datasets/geometries/antimeridian-light.png b/assets/datasets/geometries/antimeridian-light.png
diff --git a/assets/datasets/geometries/buggy-antimeridian-dark.png b/assets/datasets/geometries/buggy-antimeridian-dark.png
diff --git a/assets/datasets/geometries/buggy-antimeridian-light.png b/assets/datasets/geometries/buggy-antimeridian-light.png
diff --git a/assets/datasets/geometries/pole-covering-dark.png b/assets/datasets/geometries/pole-covering-dark.png
diff --git a/assets/datasets/geometries/pole-covering-light.png b/assets/datasets/geometries/pole-covering-light.png
diff --git a/assets/datasets/geometries/polygon-both-poles-north-dark.png b/assets/datasets/geometries/polygon-both-poles-north-dark.png
diff --git a/assets/datasets/geometries/polygon-both-poles-north-light.png b/assets/datasets/geometries/polygon-both-poles-north-light.png
diff --git a/assets/datasets/geometries/polygon-both-poles-south-dark.png b/assets/datasets/geometries/polygon-both-poles-south-dark.png
diff --git a/assets/datasets/geometries/polygon-both-poles-south-light.png b/assets/datasets/geometries/polygon-both-poles-south-light.png
diff --git a/assets/datasets/geometries/winding-order-ccw.png b/assets/datasets/geometries/winding-order-ccw.png
diff --git a/assets/datasets/geometries/winding-order-cw.png b/assets/datasets/geometries/winding-order-cw.png
diff --git a/assets/datasets/queries/crs-cartesian-dark.png b/assets/datasets/queries/crs-cartesian-dark.png
diff --git a/assets/datasets/queries/crs-cartesian-light.png b/assets/datasets/queries/crs-cartesian-light.png
diff --git a/assets/datasets/queries/crs-spherical-dark.png b/assets/datasets/queries/crs-spherical-dark.png
diff --git a/assets/datasets/queries/crs-spherical-light.png b/assets/datasets/queries/crs-spherical-light.png
diff --git a/assets/datasets/queries/intersection-mode-contains-dark.png b/assets/datasets/queries/intersection-mode-contains-dark.png
diff --git a/assets/datasets/queries/intersection-mode-contains-light.png b/assets/datasets/queries/intersection-mode-contains-light.png
diff --git a/assets/datasets/queries/intersection-mode-intersects-dark.png b/assets/datasets/queries/intersection-mode-intersects-dark.png
diff --git a/assets/datasets/queries/intersection-mode-intersects-light.png b/assets/datasets/queries/intersection-mode-intersects-light.png
diff --git a/assets/geometries/antimeridian_buggy.png b/assets/geometries/antimeridian_buggy.png
diff --git a/assets/geometries/antimeridian_fixed.png b/assets/geometries/antimeridian_fixed.png
diff --git a/assets/geometries/granules.png b/assets/geometries/granules.png
diff --git a/assets/geometries/single.png b/assets/geometries/single.png
diff --git a/assets/geometries/unary_union.png b/assets/geometries/unary_union.png
diff --git a/assets/guides/ingest/dataset-schema-dark.png b/assets/guides/ingest/dataset-schema-dark.png
diff --git a/assets/guides/ingest/dataset-schema-light.png b/assets/guides/ingest/dataset-schema-light.png
diff --git a/datasets/geometries.mdx b/datasets/geometries.mdx
diff --git a/datasets/ingest.mdx b/datasets/ingest.mdx
@@ -148,7 +148,7 @@ Measurements: [2025-03-28T11:44:23.000 UTC, 2025-03-28T11:45:19.000 UTC] (2 data
 #### xarray Dataset
 
 [`xarray.Dataset`](/sdks/python/xarray) is the default format in which Tilebox Datasets returns data when
-[querying data](/datasets/query) from a collection.
+[querying data](/datasets/query/querying-data) from a collection.
 Tilebox also supports it as input for ingestion. The example below shows how to construct an `xarray.Dataset`
 from scratch, that matches the schema of the `MyCustomDataset` dataset and can then be ingested into it.
 To learn more about `xarray.Dataset`, visit Tilebox dedicated [Xarray documentation page](/sdks/python/xarray).
@@ -397,3 +397,9 @@ Through the usage of `xarray` and `pandas` you can also easily ingest existing d
 formats, such as CSV, [Parquet](https://parquet.apache.org/), [Feather](https://arrow.apache.org/docs/python/feather.html) and more.
 
 Check out the [Ingestion from common file formats](/guides/datasets/ingest-format) guide for examples of how to achieve this.
+
+## Geometries
+
+Ingesting Geometries can traditionally be a bit tricky, especially when working with geometries that cross the antimeridian or cover a pole.
+Tilebox is designed to take away most of the friction involved in this, but it's still recommended to follow the [best practices for handling geometries](/datasets/geometries).
+