Skip to main content
GET
/
api
/
v1
/
points
/
near
Search facility/location data by proximity
curl --request GET \
  --url https://data.kushiro.app/api/v1/points/near
{
  "points": [
    {
      "id": 1,
      "source_id": "kushiro_aed_locations",
      "external_id": "aed-1",
      "name": "市役所本庁舎",
      "category": "aed",
      "address": "釧路市黒金町7丁目5番地",
      "lat": 42.984,
      "lng": 144.381,
      "geohash": null,
      "attributes": null,
      "fetched_at": "2026-04-29T00:00:00.000Z",
      "raw_blob_key": "raw/kushiro_aed_locations/2026-04-29T00-00-00.000Z/file.pdf",
      "distance_m": 142
    }
  ],
  "total": 1,
  "limit": 1000,
  "query": {
    "lat": 42.985,
    "lng": 144.382,
    "radius_m": 1000
  }
}

Query Parameters

lat
number
required

Center latitude (-90 to 90).

Required range: -90 <= x <= 90
lng
number
required

Center longitude (-180 to 180).

Required range: -180 <= x <= 180
radius_m
number
required

Search radius in meters. Capped at 50000 (50km).

Required range: x <= 50000
source
string

Source ID. When omitted, the search spans all sources.

Minimum string length: 1
category
string

Point category exact match.

Minimum string length: 1
limit
integer
default:1000

Maximum number of items to return. Defaults to 1000.

Required range: 1 <= x <= 10000

Response

Proximity search result.

points
object[]
required
total
integer
required

Total points within the radius before limit truncation.

Required range: x >= 0
limit
integer
required
Required range: 1 <= x <= 10000
query
object
required