GitHubX

Location

Location-related operations

Find nearby pins using spatial query

get

Returns pins within a specified radius of a geographic location using PostGIS spatial queries. Radius is in meters.

Query parameters
latstringRequired

Latitude in decimal degrees (will be parsed as a number)

Example: 40.735554
lonstringRequired

Longitude in decimal degrees (will be parsed as a number)

Example: -73.987968
radiusstring · max: 100000Optional

Search radius in meters (default: 1000m / 1km, min: 0m, max: 100,000m, will be parsed as a number)

Default: 1000Example: 200
Responses
200

List of nearby pins with distances

application/json
get
GET /api/location/pins?lat=text&lon=text HTTP/1.1
Host: 
Accept: */*

{
  "pins": [
    {
      "id": 1,
      "title": "text",
      "geoPose": {
        "position": {
          "lat": 1,
          "lon": 1,
          "h": 0
        },
        "angles": {
          "yaw": 0,
          "pitch": 0,
          "roll": 0
        }
      },
      "contentType": "IMAGE",
      "contentUrl": "text",
      "zoneId": 1,
      "gcpId": 1,
      "createdAt": "2025-10-16T18:02:51.927Z",
      "updatedAt": "2025-10-16T18:02:51.927Z",
      "distance": 123.45
    }
  ]
}
PreviousZonesNextUpload