Skip to main content
GET
/
api
/
v1
/
libraries
/
nearby
주변 도서관 조회
curl --request GET \
  --url https://k-polaris.life/api/v1/libraries/nearby
{
  "hasNext": true,
  "nextCursor": "<string>",
  "items": [
    {
      "libraryId": 3372036854775808,
      "name": "구미시립양포도서관",
      "address": "경상북도 구미시 옥계북로 51",
      "latitude": 36.1387724,
      "longitude": 128.4187321,
      "homepageUrl": "https://lib.gumi.go.kr",
      "tel": "054-480-4770",
      "distanceKm": 2.38,
      "openNow": true
    }
  ]
}

Query Parameters

​
latitude
number<double>
required

조회하려는 위치의 위도입니다. -90.0 ~ +90.0 사이의 값이어야 합니다.

​
longitude
number<double>
required

조회하려는 위치의 경도입니다. -180.0 ~ +180.0 사이의 값이어야 합니다.

​
radiusKm
number<double>
default:5

조회하려는 위치에서 탐색할 범위입니다. 이는 원의 반지름이며, 조회하려는 위치가 원의 중심이 됩니다.

​
cursor
string

특정 도서관 아이템 이후의 도서관 아이템을 조회할 때 사용합니다.

​
limit
integer<int32>
default:10

한 번에 응답 받을 도서관의 개수이고 기본값은 10이고 최대값은 100입니다.

Response

200 - application/json;charset=UTF-8

성공

​
hasNext
boolean
​
nextCursor
string
​
items
object[]