Skip to content

Conversation

@bluestreak01
Copy link
Member

@bluestreak01 bluestreak01 commented Jan 19, 2026

Summary

Documents new spatial functions from questdb/questdb#6664:

  • Euclidean space functions for LIDAR point clouds, robotics, and physical AI:

    • within_box(x, y, min_x, min_y, max_x, max_y) - rectangular bounding box queries
    • within_radius(x, y, center_x, center_y, radius) - circular distance queries
  • Geographic coordinate functions for GPS/lat-lon data:

    • geo_within_radius_latlon(lat, lon, center_lat, center_lon, radius_meters) - radius queries in meters
    • geo_distance_meters(lat1, lon1, lat2, lon2) - distance calculation

Documentation highlights

  • "Choosing the right function" decision table for Euclidean vs Geographic vs Geohash
  • LIDAR scan indexing examples with zone-based lookups via JOIN
  • Vehicle tracking examples for geographic functions
  • Error handling (errors on invalid input, NULL only for NULL input)
  • Proper QuestDB table schemas with TIMESTAMP() and PARTITION BY

Use case focus

The documentation emphasizes discoverability for physical AI / robotics projects by:

  • Featuring LIDAR and point cloud use cases prominently
  • Showing practical zone-based lookup patterns (JOIN with zones table + WHERE on zone name)
  • Using realistic table schemas with S3 scan references

Test plan

  • Preview renders correctly at /docs/query/functions/spatial
  • All code blocks have proper syntax highlighting
  • Links to geohash docs and spatial operators work
  • Examples are clear and demonstrate both constant lookups and zone-based JOINs

🤖 Generated with Claude Code

Add documentation for new spatial functions from PR #6664:

- geo_within_box() - rectangular bounding box queries
- geo_within_radius() - circular Euclidean distance queries
- geo_within_radius_latlon() - lat/lon radius queries in meters
- geo_distance_meters() - distance calculation between coordinates

Key documentation features:
- "Choosing the right function" decision table
- LIDAR scan indexing examples with zone-based lookups
- Vehicle tracking examples for geographic functions
- Error handling and NULL behavior documented
- Links to related geohash documentation

Co-Authored-By: Claude Opus 4.5 <[email protected]>
@github-actions
Copy link

github-actions bot commented Jan 19, 2026

🚀 Build success!

Latest successful preview: https://preview-332--questdb-documentation.netlify.app/docs/

Commit SHA: f360b86

📦 Build generates a preview & updates link on each commit.

bluestreak01 and others added 4 commits January 19, 2026 18:13
- Rename geo_within_box to within_box
- Rename geo_within_radius to within_radius
- Remove unused pose_z column from example schema

Co-Authored-By: Claude Opus 4.5 <[email protected]>
@bluestreak01 bluestreak01 merged commit 0d15bea into main Jan 20, 2026
2 checks passed
@bluestreak01 bluestreak01 deleted the vi_geo branch January 20, 2026 22:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants