볼링장 API 구현

[xcelxlorx]

Summary

볼링장 목록 조회, 볼링장 상세 조회 구현 방법을 조사하고 구현합니다.

Description

볼링장 목록 조회

• 지도 api를 이용하면 키워드 검색, 마커 클릭 이벤트 등이 가능한 것 같아서 프론트에서 지도 api로 구현하면 될 것 같습니다.

볼링장 상세 조회

• 데이터를 지도 api를 이용해서 가져왔습니다. 카카오 맵 api는 상세 정보가 많이 없고 위도, 경도같이 기본 정보만 제공됩니다. 네이버 지역 api는 이름, 주소, 설명 등이 제공됩니다. 구글 place api는 이름, 주소, 전화번호, 운영시간, 평점, 댓글, 사진 등 많은 정보가 제공되어서 구글 place api를 사용했습니다.
• GET /api/places/{placeId}?name=테라스락볼링장 에서 name은 검색할 볼링장의 이름입니다. 동일한 이름의 볼링장이 많을 경우를 대비해서 행정구역 id(placeId)를 이용해서 함께 조회합니다. 현재는 레포지토리에 저장하지 않고 매번 조회합니다.
• map api key를 추가해야 합니다.
• 구글 api에서 장소를 검색하기 위해서는 place id를 먼저 찾아야 합니다. getGooglePlaceId()에서 place id를 찾고, placeId에 해당하는 장소의 상세 정보를 받아옵니다.
  • GEOCODING_API_URL : place id를 가져오는 url
  • PLACES_API_URL : 상세 정보를 가져오는 url
  • PHOTO_API_URL : 사진 정보를 가져오는 url
• name, address와 같은 정보는 구글 맵에 등록된 그대로 가져옵니다.
• json으로 넘어오기 때문에 적절하게 데이터를 뽑아서 dto로 반환합니다.
• 단점.. 못가져오는 데이터도 있습니다. 이유는 아직 잘 모르겠지만 구글 맵에도 있는데 안 넘어오는 데이터가 있습니다.
• 백엔드에서는 구글 api를 사용했지만 이름, 행정구역 id만 넘어오면 데이터를 반환할 수 있기 때문에 프론트에서는 지도 api 종류는 아무거나 사용해도 될 것 같습니다. 만약 프론트에서 카카오 map api를 사용한다면 등록된 볼링장 데이터가 달라서 상세 정보를 반환할 수 없는 경우도 있습니다.
• 또 단점.. 게임요금, 대화료, 레인 수 정보는 어디서 가져와야 할지 모르겠습니다ㅠㅜ

일단 구현하긴 했는데 이상한 부분이나 더 좋은 방법이 있다면 말씀해 주세요!

Related Issue

Issue Number: close #87

[xcelxlorx]

수정했습니다!

[jagaldol]

커밋 이상하게 꼬였어요

[jagaldol]

커밋 꼬였길래 제가 풀었습니다.

[xcelxlorx]

감사합니다!!! 검색 부분은 구글맵에 등록된 이름을 거의 동일하게 입력해야 검색이 되는 것 같습니다. api key가 넘어가는 부분은 많이 쓰면 돈을 내야 해서 문제가 될 것 같은데.. 이미지를 받아서 이미지 자체를 보낼 수도 있을 것 같고 url을 어떻게 막 보호해서 보낼 수 있을 것 같기도 하고.... 아직 잘 모르겠어서 좀 더 찾아봐야 할 것 같습니다😢

[jagaldol]

이 api에서 이미지 받아오고 이미지 응답까지 한번에 하면 속도가 느릴거 같아서 imageReference만 돌려주고 이미지 받아오는 별개의 api로 분리하던지, 아니면 next.js도 결국 서버니까 imageReference 정보들만 주고 프론트 쪽에 일임하거나 할 수 있을거 같아요. 이건 다음주 멘토링 때 한번 물어볼까요?

[xcelxlorx]

넵 좋습니다!