락로보틱스·KETI·경상국립대 데이터가 기존 대동 커넥트(정밀농업)와 신규 드론 모듈 사이를 어떻게 흐르는지 정리했습니다. 근거는 과제 계획서, 9/17 미팅자료, 개발계 관리자·농민 사이트 조회 결과입니다. 주기·포맷·프로토콜은 1차년도 API 명세에서 확정할 제안값입니다.
초록 테두리는 이번 사업에서 새로 만드는 부분, 점선 테두리는 개발계에 이미 있는 기능입니다.
사전 촬영부터 리포트까지 28단계입니다. 신청은 대동 관리자가 먼저 확인한 뒤 협력기관에 분석을 요청하고, 협력기관은 별도 API 없이 기관 계정으로 필지 데이터 관리의 요청 건을 보고 처리합니다. 사람은 대동 관리자·연구원과 농가·법인(분석 신청 주체)으로 나눴고, 조종사는 락로보틱스 GCS 쪽에 둡니다. 드론은 두 번 납니다: 처방을 만들기 위한 촬영 비행(①)과, 승인된 처방대로 씨를 뿌리는 파종 비행입니다. 단계 번호 옆의 ID는 아래 인터페이스 목록과 연결됩니다.
ID는 기능 목록 엑셀의 IF 항목과 같습니다. '27 Pilot에서 쓰는 인터페이스만 정리했습니다. IF-05·06은 Pilot 동안 수동 등록이고, 회색 행 IF-07은 기존 API 재사용입니다.
| ID | 방향 | 데이터 | 포맷 | Pilot('27) 방식 | 이후 | 1차년도 명세 | 확정할 사항 |
|---|---|---|---|---|---|---|---|
| IF-01 | 플랫폼 → GCS | 임무 파일: 필지 폴리곤, 처방 구역·파종량, 파종 조건(속도·작업폭·고도), 배정 기체 | JSON / KML / SHP | 요청 시 Pull HTTPS REST | 동일 | 상세 | 경로 생성 주체, 파종 조건 최종 입력 위치 |
| IF-02 | GCS → 플랫폼 | 텔레메트리: RTK 위치·고도, 속도, Roll/Pitch/Yaw, 배터리, 링크 품질, 파종량·작업폭·배출 오차, 풍향·풍속 | JSON (MAVLink 변환) | 1~5초 · 파종량 1초 MQTT 또는 WebSocket | 동일 | 상세 | 필드·단위, 주기, 타임스탬프 기준, MQTT 브로커를 대동 커넥트 인프라에 둘 수 있는지 |
| IF-03 | GCS → 플랫폼 | 이벤트(이륙·착륙·일시정지·이탈·저전압·두절·비상정지), 완료 요약, 생성 경로 | JSON | 발생 즉시 임무 종료 | 동일 | 상세 | 이벤트 코드표(기존 '이상 감지 이벤트 관리' 코드 체계에 추가), 완료 요약 항목 |
| IF-04 | GCS ↔ 플랫폼 | 기체 인증, 전송 암호화, 재전송·중복 제거 | 토큰 | 연결 시 · TLS | 동일 | 상세 | 기체 식별자(차량 등록의 단말기 EoL 대체), 토큰 발급·갱신 |
| IF-05 | KETI → 플랫폼 | 맵레이어(NDVI 등), DEM, 작업 이력 패킷, 필지 ID·촬영 시각 메타데이터 | GeoTIFF + JSON 메타 | 수동 등록 기존 데이터 등록 화면 | '28~ 게이트웨이 자동 | 파일 포맷만 MAP-01·10에서 정의 | 레이어 종류·해상도·좌표계, 파종 후 촬영 시점 |
| IF-06 | 경상대 ↔ 플랫폼 | 수신: 처방맵(구역별 파종량, 3단계, 버전) / 송신: 실제 투입량, 현장조사(발아율·토양함수율·수확량) | SHP / GeoJSON, CSV | 수동 등록 · CSV 내보내기 | '28~ REST | 파일 포맷만 MAP-03·10, HIS-08에서 정의 | 구역 단위, 단계 값 표기, 버전 규칙 |
| IF-07 | 플랫폼 ↔ 대동 커넥트 | 계정·조직, 필지, 장비(차량·모델·단말기), 이벤트 코드·App Push, 사용자 이력 | 기존 API | 내부 호출 | — | 기존 · 제외 | 드론은 별도 '드론 관리' 메뉴로 분리(10/19 결정). 고객·조직 마스터 참조 범위만 확인 |
| IF-10 | 플랫폼 → KETI·경상대·GCS | 필지 경계·필지 ID(대동 커넥트에 구현된 기존 데이터) | GeoJSON | 화면 내려받기 협력기관 계정 · GCS는 임무 파일에 포함 | 동일 | 포맷 정의 | 기존 필지 데이터의 외부 제공 API 유무, 좌표계 |
| IF-12 | 플랫폼 ↔ 촬영 기관 | 드론 정밀 분석 신청 건(필지 ID·경계·희망 시기), 촬영 일정·완료 처리. 신청은 기존 생육 진단 화면에서 발생 | 화면 | 화면 처리 필지 데이터 관리 신청 목록 · 기관 계정 | 필요 시 API | 화면·권한 정의 | 협력기관 계정 권한 범위, 유료 과금과 실증 필지 처리 |
세 기관의 데이터와 드론 작업 기록을 한 필지 위에서 연결하려면 아래 키를 처음부터 맞춰야 합니다. 주황색은 아직 정해지지 않은 키입니다.
field_id필지 ID. 대동 커넥트에 이미 구현된 ID를 그대로 사용. 맵레이어·처방맵·임무·영농일지 모두에 필수mission_id임무 ID. 플랫폼이 발급해 IF-01로 전달하고, 로그·이벤트·완료 보고가 이 키로 돌아옴prescription_version처방맵 버전. 어떤 처방으로 파종했는지 추적하고 IF-06 피드백과 연결aircraft_id드론 기체 ID. 신규 '드론 관리' 메뉴에서 GCS 기체 식별자로 발급·관리(차량관리의 기대번호·단말기 EoL 체계와 분리)owner_id드론 소유 주체(법인·농민·실증 운영자). 기존 작업차량은 고객 보유 차량 기준이라 드론 소유 구조를 정해야 함timestampUTC, 밀리초. GCS·센서·플랫폼의 시각 기준을 하나로 정함(GPS 시각 사용 여부 협의)CRS좌표계. 전송은 WGS84(EPSG:4326), 면적 계산·저장은 EPSG:5186 제안. 기존 필지 데이터 좌표계 확인 필요기관별 협의 사항과 대동 내부에서 정할 것을 나눴습니다. 락로보틱스 항목을 먼저 정해야 GCS 연동(IF-01~04) API 명세를 쓸 수 있습니다.
근거: 연구개발계획서 v2(기관별 연차 연구 내용), 드론/파종 플랫폼 구축 관련 미팅자료('26.09.17) 7·11·12장, 개발계 관리자·농민 사이트 조회('26.10.12·10.20), 협력기관 역할 정리(10/20)