[GET] NAVER API 장소 조회하기 (홍준엽)

[GET] NAVER API 장소 조회하기 (홍준엽)

준엽 - ISSUE #29

메소드	경로	설명
GET	/search/place/:groupIdx?query=김밥천	Naver API를 이용한 장소 검색

요청 예시

{baseURL}/search/place/1?query=김밥천

요청 헤더

Content-Type: application/json
token: token

요청 쿼리 (또는 파라미터, 바디)

key	설명	타입	비고
groupIdx	검색하는 그룹의 index	String	params
query	검색 키워드	String	query

응답 바디

key	설명	타입	비고
count	결과 갯수	number
result	결과 데이터	Array
placeName	장소 이름	String
placeAddress	장소 주소	String
placeRoadAddress	장소 도로명주소	String
placeMapX	장소 x좌표	Number
placeMapY	장소 y좌표	Number
link	홈페이지 주소	String
mobileNaverMapLink	네이버 지도 검색 URL	String
alreadyIn	이미 저장되어있는 장소인지	Boolean

성공

{
    "status": 200,
    "success": true,
    "message": "네이버 맵 장소 조회 성공",
    "data": {
        "result": [
            {
                "placeName": "오는정김밥",
                "placeAddress": "제주특별자치도 서귀포시 서귀동 254-6",
                "placeRoadAddress": "제주특별자치도 서귀포시 동문동로 2",
                "placeMapX": "266721",
                "placeMapY": "73591",
                "link": "",
                "mobileNaverMapLink": "https://m.map.naver.com/search2/search.nhn?query=%EC%98%A4%EB%8A%94%EC%A0%95%EA%B9%80%EB%B0%A5&sm=hty&style=v5#/map/1",
                "alreadyIn": false
            },
            {
                "placeName": "교리김밥 본점",
                "placeAddress": "경상북도 경주시 탑동 400-1",
                "placeRoadAddress": "경상북도 경주시 탑리3길 2",
                "placeMapX": "509603",
                "placeMapY": "358658",
                "link": "http://www.교리김밥.kr",
                "mobileNaverMapLink": "https://m.map.naver.com/search2/search.nhn?query=%EA%B5%90%EB%A6%AC%EA%B9%80%EB%B0%A5%20%EB%B3%B8%EC%A0%90&sm=hty&style=v5#/map/1",
                "alreadyIn": false
            },
            {
                "placeName": "제주김만복 동문시장점",
                "placeAddress": "제주특별자치도 제주시 삼도2동 1158-36",
                "placeRoadAddress": "제주특별자치도 제주시 북성로 65",
                "placeMapX": "262502",
                "placeMapY": "103128",
                "link": "http://www.kimmanbok.com/delivery/menu.htm",
                "mobileNaverMapLink": "https://m.map.naver.com/search2/search.nhn?query=%EC%A0%9C%EC%A3%BC%EA%B9%80%EB%A7%8C%EB%B3%B5%20%EB%8F%99%EB%AC%B8%EC%8B%9C%EC%9E%A5%EC%A0%90&sm=hty&style=v5#/map/1",
                "alreadyIn": false
            },
            {
                "placeName": "고릴라김밥",
                "placeAddress": "서울특별시 중구 서소문동 101-1",
                "placeRoadAddress": "서울특별시 중구 서소문로 134-6",
                "placeMapX": "309724",
                "placeMapY": "551744",
                "link": "http://blog.naver.com/gorilla1972",
                "mobileNaverMapLink": "https://m.map.naver.com/search2/search.nhn?query=%EA%B3%A0%EB%A6%B4%EB%9D%BC%EA%B9%80%EB%B0%A5&sm=hty&style=v5#/map/1",
                "alreadyIn": false
            },
            {
                "placeName": "제주김만복 서귀포점",
                "placeAddress": "제주특별자치도 서귀포시 강정동 707-2 1층",
                "placeRoadAddress": "제주특별자치도 서귀포시 월드컵로 193",
                "placeMapX": "260971",
                "placeMapY": "71780",
                "link": "http://www.kimmanbok.com/delivery/menu.htm",
                "mobileNaverMapLink": "https://m.map.naver.com/search2/search.nhn?query=%EC%A0%9C%EC%A3%BC%EA%B9%80%EB%A7%8C%EB%B3%B5%20%EC%84%9C%EA%B7%80%ED%8F%AC%EC%A0%90&sm=hty&style=v5#/map/1",
                "alreadyIn": false
            }
        ],
        "count": 5
    }
}

실패

• query 없음

{
    "status": 400,
    "message": "필요한 값이 없습니다"
}

• 서버 내부 에러

{
    "status": 500,
    "message": "서버 내부 에러"
}