패스트캠퍼스X야놀자: 백엔드 개발 부트 캠프 - Java 심화 과제 1

패스트캠퍼스X야놀자: 백엔드 개발 부트 캠프 - Java 심화 과제 1

 

 

✔️과제1 : 위치기반 장소 검색 Java 애플리케이션 개발

(Location Based Place Search Java Application Development)

이 Java 어플리케이션은 입력에 기반하여 특정 위치 내의 장소를 검색할 수 있도록 합니다.

자신의 위치를 기반으로 특정위치에 있는 장소를 검색하여 출력하는 자바 애플리케이션을 개발 할 수 있다.

Kakao 로컬 REST API중 키워드로 장소 검색하기, 카테고리로 장소 검색하기 API를 활용 할 수 있다.

 

---

✔️작업 옵션

다음 작업 중 하나를 선택하여 구현하세요

1. 특정 위치(키워드) 주변의 지정된 반경 내에서 주유소를 검색하는 Java 어플리케이션을 개발합니다.
2. 특정 위치(키워드) 주변의 지정된 반경 내에서 약국을 검색하는 Java 어플리케이션을 개발합니다.

---

✔️과제 일정

8월 21일 (월) ~ 8월 23일 (수) 23:59까지

 

---

✔️문제 설명

단계 1: 카카오 API 키 획득

1. 카카오 개발자에 로그인합니다.
2. 시작 가이드에 따라 어플리케이션을 생성합니다.
3. 나중에 사용할 REST API 키를 메모해 둡니다.

단계 2: 로컬 REST API 사용

1. 로컬 REST API 문서를 참고하여 키워드로 장소 검색하기와 카테고리로 장소 검색하기을 활용하여 개발합니다.
2. 요청과 응답 구조에 대한 예제 코드를 확인합니다.

단계 3: Java 어플리케이션 구현

1. 키보드로 특정 위치 키워드와 검색 반경을 입력합니다.
2. 입력한 키워드를 기반으로 위도(latitude)와 경도(longitude)를 추출합니다.
3. 추출한 위치를 사용하여 입력한 반경(radius) 내에서 주유소나 약국을 검색합니다.
4. 검색 결과(JSON)에서 원하는 정보를 추출하여 표시합니다.
5. 상위 10개 결과에 대한 추출된 데이터를 표시합니다.
6. 검색된 결과에서 장소 URL을 입력하면 브라우저에 해당 kakaomap이 출력되도록 한다.
7. exit를 입력하면 종료한다.

---

✔️예시 입력 및 출력

입력 화면

위치 키워드를 입력하세요:  
검색 반경을 입력하세요(1000:1km):

 

출력 화면

입력한 위치 키워드:  
검색 반경:  

**주유소 검색 결과**
- 장소 URL(지도 위치):
- 상호명:
- 주소:
- 전화번호:
- 거리(km):

**약국 검색 결과**
- 장소 URL(지도 위치):
- 상호명:
- 주소:
- 전화번호:
- 거리(km):

kakaomap URL(장소 URL):http://place.map.kakao.com/26338954 -> 검색된 결과에서 장소 URL을 복사하여 붙여넣기 한 후 엔터 -> 브라우져가 실행
kakaomap URL(장소 URL):exit -> exit 입력하면 프로그램이 종료된다.

프로그램 종료

---

✔️의존성

• Java 8 이상
• httpclient, json API

<dependency>
        <groupId>org.apache.httpcomponents</groupId>
        <artifactId>httpclient</artifactId>
        <version>4.5.13</version>
</dependency>
<dependency>
        <groupId>org.json</groupId>
        <artifactId>json</artifactId>
        <version>20210307</version>
</dependency>

---

✔️평가 기준

• 제시된 기한 내 제출 (5점)
• 문제 조건 준수한 코드 (5점)
• 제안된 기능 작동 여부 (5점)

1. 입출력 화면이 잘 설계 되었는가?
2. JSON 데이터 잘 파싱하여 목록을 출력하였는가?
3. 반경에 따라 데이터가 잘 출력이 되는가?
4. 장소가 브라우저에 잘 표시되는가?

---

✔️제출내용

• 소스코드 제출
• 입출력 실행화면 캡처 제출

1. 소스코드에 과제1 폴더를 만들고 과제1 폴더에 아래 2개의 이미지 파일을 추가할 것
2. 입력화면 캡처
3. 출력화면 챕처

 

---

🎯KAKAO API를 사용하여 내 주변 약국 검색

 

💉의존성

<dependencies>
        <!-- https://mvnrepository.com/artifact/org.projectlombok/lombok -->
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <version>1.18.12</version>
            <scope>provided</scope>
        </dependency>
        <!-- https://mvnrepository.com/artifact/org.json/json -->
        <dependency>
            <groupId>org.json</groupId>
            <artifactId>json</artifactId>
            <version>20210307</version>
        </dependency>
        <dependency>
            <groupId>org.apache.httpcomponents</groupId>
            <artifactId>httpclient</artifactId>
            <version>4.5.13</version>
        </dependency>
</dependencies>

 

---

📜MODEL Class

MyAddress.java

import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
 
@Data
@NoArgsConstructor
@AllArgsConstructor
public class MyAddress {
    private String query;
    private String latitude;
    private String longitude;
    private int radius;
}

검색한 내 주변에 대한 정보를 저장할 객체

검색  쿼리와 거리 그리고 응답으로 온 경도, 위도를 저장할 property를 갖고 있다.

Getter 와 Setter 그리고 기본생성자와 모든 아규먼트가 파라미터로 들어간 생성자는 lombok API를 사용해 컴포넌트로 설정해줬다.

 

 

Pharmacy.java

import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
 
@Data
@NoArgsConstructor
@AllArgsConstructor
public class Pharmacy implements Comparable<Pharmacy> {
    private String url;
    private String businessName;
    private String address;
    private String phoneNumber;
    private Float distance;
 
    @Override
    public int compareTo(Pharmacy o) {
        return (int) (this.getDistance() - o.getDistance());
    }
}

검색url주소, 상호명, 주소,  전화번호를 저장할 약국 객체

나중에 약국 리스트를 거리가 가까운 순으로 나열하기 위해 Comparable interface를 implements 하여 compareTo() 메소드를 오버라이드 해주었다.

---

🔑솔루션

요청과 응답은 apache에서 제공하는 HttpClient API를 사용하여 구현하였다.

 

 

검색 위치 찾기

kakao developers 의 지도/로컬 에서 "키워드로 장소 검색하기" API를 사용하였다.

 

파라미터로 검색 키워드를 받은 후 검색을 했을 땐 띄어쓰기가 있을 수 있으니 공백을 지운 후 하나의 쿼리도 만들어 쿼리 스트링에 넣어주었다.

헤더에는 인증 개인 API Key 를 필수로 보내주어야 하기 때문에 넣어서 보내주었다.

 

출력으로는 응답을 엔티티로 받아 json 형태로 보내온 응답을 jsonobject로 받고 배열인 documents를 파싱한 후 젤 첫번째 값만 가져오기 위해서 0을 넣어 첫번째 jsonobject를 가져온다. 

이후에는 키값에 맞는 밸류를 파싱하여 MyAddress 객체안에 넣어준 후 리턴한다.

 

 

근처 약국 위치 찾기

kakao developers 의 지도/로컬 에서 "카테고리로 장소 검색하기" API를 사용하였다.

 

카테고리 그룹 코드는 약국을 검색하기 위해 약국 코드인 PM9을 넣고 위에서 얻은 경도 , 위도와 검색할 때 넣은 거리를 넣어서 GET 요청 해준다.

 

응답으로 온 응답 엔티티를 JSONObject로 파싱하여 JSON 배열을 추출하고 약국 객체를 만들어 배열의 크기만큼 약국의 정보들을 키 값을 통해 파싱하여 저장한다. 약국 객체는 약국 리스트에 묶어 리턴해준다.

 

url을 콘솔에 입력하면 브라우저에 웹페이지 나타내기

자바에서 제공하는 java.net.URI 를 사용하여 콘솔에 url를 입력했을 때 바로 브라우저에 웹화면을 띄우게 했다.

---

🪄실행 결과

 

입력 화면

 

출력 화면

---

 

🤔프로젝트 회고

전반적인 난이도는 쉬운 편이었던 것 같다.

처음 위치 키워드를 넣어 검색했을때 잘못된 쿼리라는 오류를 받았다. 쿼리에 띄어쓰기가 되어있으면 안 된다는 걸 알았다. replaceAll()을 쓰기전 strip()을 썼는데도 여백이 지워지지 않아 찾아보니 strip()은 문장 처음과 끝에 있는 여백만을 지우는 것임을 배웠다. 사이사이에 있는 공백은 replaceAll() 메소드를 이용해야만 했다. 이때 공백을 표현하는 정규식 또한 배웠다.

쿼리스트링을 파워코딩 식으로 말고 더 깔끔하게 표현할 수 있을 거 같단 생각을 했다. java.net.URI API는 처음 사용해 보았는데, 웹 프로그래밍이 아니라 자바 어플리케이션으로 작게 만든다면 꽤 강력한 기술인 것 같다. 작동원리가 궁금하다. 추측해 보건데 운영체제 내에 기본으로 설정된 브라우저에 URL을 전송하여 웹페이지를 띄울 거 같다. 

여차저차 들리는 소식에 의하면 누군가는 ExceptionHandler 까지 만들어 구현 했다고 하는데, 그정도까지 해야했나 생각에 빠졌다. 과제에서 지켜야하는 사항에만 포거스를 맞춘 거 같기도 하다. 다음 과제에선 좀 더 신경을 써봐야겠다.