📍 MapMatching 모듈

Java 기반 GIS 시스템에서 Map Matching 기능을 간편하게 활성화할 수 있도록 설계된 커스텀 어노테이션 모듈입니다.
Spring 기반 애플리케이션에서 @EnableMatching 어노테이션을 사용하여 도로 링크 또는 정점 기반의 매칭 기능을 손쉽게 적용할 수 있습니다.

🔧 활성화 방법

import matching.annotation.EnableMatching;

@EnableMatching(type = "Link") // 또는 "Vertex"
@SpringBootApplication
public class MyApp {
    public static void main(String[] args) {
        SpringApplication.run(MyApp.class, args);
    }
}

type 속성

• "Link": 도로 링크 기반 매칭 (테이블: LINK_GEOM)
• "Vertex": 정점 기반 매칭 (테이블: VERTEX_GEOM)

주의: 대소문자를 구분하지 않으며, 잘못된 값 입력 시 런타임 오류 발생 가능

🔧 사용 방법

import matching.data.GeoLink;
import matching.data.GeoVertex;
import matching.service.MATCHING;

public class Test {
  public void sample(double x , double y){
    GeoLink link = MATCHING.link(x,y);
    GeoVertex vertex = MATCHING.vertex(x,y);
  }
}

link , vertex 차이

• "link": 링크 활성화시 사용가능
• "vertex": 버택스 활성화시 사용가능

🗂 요구 테이블 구조

이 모듈은 다음과 같은 테이블이 데이터베이스에 존재해야 정상 작동합니다.

LINK_GEOM

VERTEX_GEOM

✅ 작동 방식 요약

• @EnableMatching 어노테이션을 선언하면 내부적으로 다음이 자동 구성됩니다:
  • MatchingConfiguration을 통한 Bean 구성
  • DataLoad를 통한 테이블 로드 및 인메모리 구조화
  • MapMatching 클래스가 주입되어 매칭 처리
• EnableMatchingRegistrar가 @Import를 통해 동작을 등록합니다.

🛠 필요 환경

• Java 8 이상
• Spring Framework (Boot 포함 권장)
• JPA 또는 JDBC 환경 설정 필요 (데이터소스 연결)

✨ 기여자 전용

이 소스는 외부에 공개되지 않은 개인 프로젝트입니다. 무단 사용 및 배포를 금합니다.