마이크로서비스 API 활용사례 4. 좌표변환기

국토부에서 제공하는 OPEN API 지도좌표를 다음지도 또는 네이버 지도로 쉽게 변환할 수 있는 좌표변환알고리즘을 적용한 API를 소개한다. 좌표계 종류 중에서 3차원 및 2차원 좌표계를 이용하여 위경도 좌표로 변환해주는 부분이 핵심이다.

좌표변환 API ?

1. 기본 기능

주요 기능	기능 설명	기타(비고)
2차원, 3차원 좌표	- 좌표계는 기하학에서 숫자나 기호를 써서 위치를 표기하는 방식을 뜻함
좌표변환	선택한 지도 유형에 맞는 위경도 좌표계 값으로 변환

2. 상세 기능 설명

지리좌표계(3차원)	2차원 좌표계-투영볍
타원체(장,단반경, 편평률)에 집중 해당 타원체 기준 위경도 좌표	bessel타원체에서 wgs84 타원체로 변경해서 좌표를 계산하려면, 7개에서 10개의 parameter값이 필요함

지리 좌표계(3차원) 예시

2차원 좌표계(투영법)

마이크로서비스 애플리케이션 설계

1. 서비스 정의

마이크로서비스 단위의 분할이 확정되면, 서비스와 서비스간의 통신 방법(규약)을 정하고 FRONTEND와 BACKEND로 구분한다. 서비스간의 통신 규약은 여러가지가 있으나 여기에서는 REST API 방식을 사용한다.

2. API 설계

좌표변환 API 전체 목록

URL	Method	Parameters		Return	Status
/api/crs/epsg/list/all	GET	none	-	LIST	200(OK)
/api/crs/ellipsoid/list/all	GET	none	-	LIST	200(OK)
/api/crs/epsg/spec?code=	GET	code	string	LIST	200(OK)
/api/crs/ellipsoid/spec?name=	GET	name	String	LIST	200(OK)
/api/crs/transform/xy?inputEllipsoid= &outputEpsg= &lat= &lng=	GET	input Ellipsoid	String	TwoDimCrs	200(OK)
		outputEpsg	String
		lat	Double
		lng	Double
/api/crs/transform/latlng?inputEpsg= &outputEllipsoid= &x= &y=	GET	inputEpsg	String	ThreeDimCrs	200(OK)
		outputEllipsoid	String
		x	Double
		y	Double

입력 Parameters 정보

입력변수명	Type	예제	설명
code	String	epsg5174	좌표계 코드명{epsg5174, epsg5179, epsg5181}
name	String	wgs84	타원체 이름 {wgs84, grs80, bessel}
inputEllipsoid	String	wgs84	입력 좌표 타원체 이름
outputEpsg	String	epsg5174	출력 좌표 좌표계 코드명
lat	Double	37.538831	위도(latitude)
lng	Double	126.891382	경도(longitude)
inputEpsg	String	epsg5174	입력 좌표 좌표계 코드명
outputEllipsoid	String	wgs84	출력 좌표 타원체 이름
x	Double	190330.62812120165	2차원 좌표계의 x값
y	Double	448514.24844640953	2차원 좌표계의 y값

출력 변수 정보

출력 변수명	Type	설명
epsg	String	측정장소 이름
x	Double	시군구 이름
y	Double	날짜
ellipsoid	String	아황산가스 측정 농도
lat	Double	일산화탄소 측정 농도
lng	Double	오존 측정 농도
a	Double	이산화질소 측정 농도
f	Double	미세먼지(pm10) 측정농도
	String	아황산가스 지수값

3. API 호출 방법

BACKEND에 정의한 API에서 호출하여 결과값을 보여줌

API 호출

@RestController@RefreshScope@RequestMapping(value="/api/dust")public class TransformController {
    @Autowired
    private TransformService transformService;

    @ApiOperation("제공하는 좌표계 목록 반환")
    @GetMapping("/epsg/list/all")
    @ResponseStatus(HttpStatus.OK)
    public List<String> epsgListAll() {
        System.out.println("request /api/crs/epsg/list/all -- Controller --");
        return transformService.epsgListAll();
 }

마이크로서비스 아키텍처 개발하기

마이크로서비스 아키텍처 기반 애플리케이션 개발은 단일 서비스로 개발하고 REST API를 이용하여 다른 서비스를 호출하는 방식으로 아주 많은 서비스와 통신할 수 있다. 프론트엔드는 모바일, 웹과 같이 하나의 앱으로 개발하고 백엔드 영역은 서비스 단위로 분할하여 서비스를 제공하도록 개발해야 한다. 마이크로서비스 아키텍처의 장점인 폴리그랏을 적용하는 경우 여러 언어로 각각 개발했더라고 각 서비스 호출 시 사용하는 규약을 정하게 되면 얼마든지 확장이 가능하다.

마이크로서비스 아키텍처 개발을 위해 애플리케이션을 분할과 더불어 여러 서비스로 구성되어 있기 때문에 Service Discovery와 Gateway(네트워크) 정보를 관리할 수 있는 서버도 구성해야 한다. 개별적으로 이를 구성하려면 Spring Cloud와 같은 프레임워크를 구성하거나 유사한 프레임워크와 아키텍처를 구성해야 하지만, 마이크로서비스 스튜디오를 사용하면 필요한 모든 서비스를 제공하고 있어 개발에만 집중할 수 있다.

각각 단일 서비스로 개발하고 REST API를 이용하여 다른 서비스 적용