Skip to main content
GET
/
api
/
v1
/
libraries
/
nearby
주변 도서관 조회
curl --request GET \
  --url http://localhost:8080/api/v1/libraries/nearby
{
  "hasNext": true,
  "nextCursor": "<string>",
  "items": [
    {
      "libraryId": 123,
      "name": "<string>",
      "address": "<string>",
      "latitude": 123,
      "longitude": 123,
      "homepageUrl": "<string>",
      "tel": "<string>",
      "distanceKm": 123,
      "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[]