dabeeomaps_api4_navigation v1.1.2

dabeeomaps_library_navigation

dabeeomaps api 4 navigation server

description

• node server와 typescript로 개발

get started

• npm run dev : 개발 모드
• npm run build : build
• npm run start : build 실행
• npm run test : jest를 통한 test. npm run start 또는 npm run dev를 한 상태에서 실행해야 함.

Version History

• 1.0.0 : 내비게이션 node js로 구축
• 1.1.0 : waypoints cloneDeep

NavigationRequest

• 내비게이션 생성 객체
• 생성자

let req = new navigation.NavigationRequest(mapInfo, ComputingType.RECOMMENDATION);

• 인자 설명
  • mapInfo : 지도 조회 V2 api 를 통해 얻은 정보 전체
  • computingType : RECOMMENDATION(추천경로), SAFETY (안전경로 - 엘리베이터만 이용한 경로)

DijkstraNavigationManager

• 다익스트라 내비게이션 매니저 생성

let navi = new navigation.DijkstraNavigationManager(req);

• 출발, 경유지, 목적지 생성

locations = {
        computingTypeList: ['RECOMMENDATION'],
        locations: [
            {
                poiId: 'PO-4JvSQCWHC2270', // 남자화장실 (11층)
                floorId: 'FL-t4vqgyek3jnb8146',
            },
            {
                poiId: 'PO-NMvw3E0pe1690', // 플랫폼사업부 회의실 (11층)
                floorId: 'FL-t4vqgyek3jnb8146',
            },
            {
                poiId: 'PO-WgCv1-qBo8094', // 사업전략부 (11층)
                floorId: 'FL-t4vqgyek3jnb8146',
            },
            {
                poiId: 'PO-M02DvTVjp8449', // 회의실1 (11층)
                floorId: 'FL-t4vqgyek3jnb8146',
            },
        ],
    },
    ```

-   내비게이션에 경로를 뽑을 목적지들을 전달하여 경로 추출

```javascript
let routes = [destination1, origin, destination, destination3, destination2];
let response = navi.getPath(routes);

응답 정의

• locations : 예상 경로 위치 배열
  • position : 위치 좌표
  • floorId : 층 아이디
  • nodeId : 노드 아이디
  • destination : 경유지 여부 (출발/도착 포함)
  • distance : 이전 노드부터 현재 노드까지 거리 (cm)
  • idx: 인덱스
  • transCode: 이동수단 코드 (실제로 타층과 연결된 경우에만 표시)
    • OB-ELEVATOR : 엘리베이터
    • OB-ESCALATOR : 에스컬레이터 양방향
    • OB-ESCALATOR_UP : 에스컬레이터 상행
    • OB-ESCALATOR_DOWN : 에스컬레이터 하행
    • OB-STAIRS : 계단
  • direction : 현재 노드에서 다음 노드까지의 방향
    • LEFT : 좌회전
    • RIGHT : 우회전
    • STRAIGHT : 직진
• pathInfo : 경로 안내 정보 (with simplify)
• totalDistance : 예상 총 이동거리 (cm)
• totalTime : 예상 이동 시간 (milliseconds)
• origin : 출발지 위치 정보
• finalDestination : 최종 목적지 위치 정보
• wayPoints : 경유지들 위치 정보