Get Places (장소 검색)

검색기색어를 기반으로 장소를 검색합니다.

엔드포인트

GET /api/v1/places

Query Parameters:

파라미터	타입	기본 검색	원형 검색	직사각형 검색	설명
search	string	✔	✔	✔	검색어
categoryId	number	✖	✖	✖	장소 카테고리 ID
lat	number	-	✔	-
lon	number	-	✔	-
radius	number	-	✔	-	반지름(미터)
minLat	number	-	-	✔
minLon	number	-	-	✔
maxLat	number	-	-	✔
maxLon	number	-	-	✔
page	number	✖	✖	✖	페이지 번호 (기본값: 1)
limit	number	✖	✖	✖	페이지당 결과 수 (기본값: 20)

Response:

{
  "code": 200,
  "message": "요청이 성공적으로 완료되었습니다.",
  "places": [
    {
      "id": "placeId",
      "name": "러너스",
      "description": "라이프테크 스타트업",
      "status": "OPERATIONAL",
      "phone": "[phone]",
      "address": "대한민국 성남시 분당구",
      "todayTime": "월요일: 오전 11:00 ~ 오후 10:00",
      "openingHours": [
      "월요일: 오전 11:00 ~ 오후 10:00"
      ],
      "rating": 4.1,
      "ratingCount": 100,
      "latitude": 35.0595668,
      "longitude": 128.9712379,
      "websiteUri": "https://runners.im/main",
      "priceRange": {
        "min": 1,
        "max": 10000
      },
      "parkingOptions": {
        "freeParkingLot": true,
        "paidParkingLot": true,
        "freeStreetParking": true,
        "paidStreetParking": true,
        "valetParking": true,
        "freeGarageParking": true,
        "paidGarageParking": true
      },
      "paymentOptions": {
        "acceptsCreditCards": true,
        "acceptsCashOnly": false
      },
      "accessibilityOptions": {
        "wheelchairAccessibleParking": true,
        "wheelchairAccessibleEntrance": true,
        "wheelchairAccessibleSeating": true,
        "wheelchairAccessibleRestroom": true
      },
      "serviceOptions": {
        "takeout": true,
        "delivery": true,
        "dineIn": true,
        "isReservable": true,
        "outdoorSeating": true,
        "allowsDogs": true,
        "restroom": true,
        "goodForChildren": true,
        "wifi": true,
        "servesBreakfast": true,
        "servesBrunch": true,
        "servesLunch": true,
        "servesDinner": true,
        "servesVegeterian": true,
        "servesBeer": true,
        "servesWine": true,
        "servesCocktail": true,
        "servesDessert": true,
        "servesCoffee": true,
        "liveMusic": true,
        "menuForChildren": true,
        "goodForGroups": true,
        "goodForWatchingSports": true,
        "curbsidePickup": true
      },
      "reviews": [
        {
          "id": "reviewId",
          "writer": "김덕구",
          "title": "그럭저럭",
          "contents": "소고기보다 돼지고기",
          "publiahedAt": "2020-02-20T15:24:43.551"
        }
      ],
      "category": {
        "id": 1,
        "title": "맛집"
      }
    }
  ]
}

상태 코드

코드	설명
200	요청이 성공적으로 처리됨
400	잘못된 요청 (파라미터 오류 등)