Learn how to filter your query results using a specified geographical area of interest.
Polygon
and MultiPolygon
geometries as query filters.
Polygon
or MultiPolygon
geometry as the spatial extent parameter.
Here is how to query Sentinel-2 S2A_S2MSI2A
data over Colorado for a specific day in April 2025.
mode: intersects
mode: contains
intersects
mode is the default for spatial queries. It matches all datapoints whose geometries intersect with the query geometry.
contains
mode matches all datapoints whose geometries are fully contained within the query geometry.
spherical
coordinate reference system
for querying (which is the default), as it correctly handles the non-linearity introduced by the antimeridian in cartesian
space.
spherical
coordinate reference system when querying, it’s still recommended to follow the
best practices for handling geometries. In doing so,
you can ensure that no geometry related issues will arise even when interfacing with other libraries and tools that may not properly
support non-linearities in geometries.lat/lon
coordinate system.
Spherical coordinate reference system
Cartesian coordinate reference system
spherical
coordinate reference system is the default and recommended choice. It correctly handles antimeridian
crossings and is the most robust option, regardless of how datapoint geometries are cut along the antimeridian.
spherical
coordinate reference system, Tilebox automatically converts all geometries to
their x, y, z
coordinates on the unit sphere and performs the intersection and containment checks in 3D.
lat/lon
coordinate system for geometry intersection and containment checks.
This is done by specifying the cartesian
coordinate reference system when querying.
cartesian
coordinate system, antimeridian crossings may cause issues if datapoint geometries
or the query geometry do not properly respect the antimeridian cut. Check out the best practices
for handling geometries to learn more about how to avoid such issues.