ALOA(Advanced Logistics Operation Analytics) 플랫폼은 차량용 내비게이션 소프트웨어 분야에서 오랜 기간 동안 축척해온 경로 탐색, 통합 검색, 맵 Display 등의 내비게이션 핵심 기술을 기반으로 고객의 물류 시스템에 필요한 배차, 관제, 헤일링, 배송 전용 지도 등과 같은 다양한 요구 기능 및 컨텐츠를 구현해 REST API 형태로 제공 합니다. 본 문서는 다양한 환경의 고객이 ALOA플랫폼에서 제공하는 각종 기능들을 고객이 개발 중이거나 운영 중인 서비스에 쉽고 빠르게 연동하고, 이를 통해 고객이 제공하는 서비스의 가치를 향상 시킬 수 있도록REST API에 대한 소개 및 사용 방법을 가이드 합니다.
ALOA 플랫폼에서 제공한 API 사용을 위해서는 ALOA 개발자 사이트 (https://developers.aloa.com)에서 발급 받은 클라이언트 아이디(client id)와 클라이언트 시크릿(client secret)을 사용하여 API 접근을 위한 액세스 토큰(access token)을 발급 받아야 합니다. (“2.1.1 토큰 발급” 참고)
ALOA API 사용시에는 공통적으로 아래의 항목들이 요청 헤더(Request Header)에 포함되어야 합니다.
ALOA 플랫폼에서 제공하는 다양한 API를 사용하기 위한 액세스 토큰 발급을 요청 합니다.
Request URL
| HTTP Method | URL |
|---|---|
| POST | /api/route |
Request Body
| Name | Mandatory | 설명 |
|---|---|---|
| clientId | O | 개발자 사이트에서 부여 받은 client id |
| clientSecret | O | 개발자 사이트에서 부여 받은 client secret |
Request Body
물류 전용지도(골목길 확장, 건물 입구점, 경사도 등)를 적용한 경로 탐색 엔진기반으로 차량용, 이륜차용, EV차량용, 보행자용 경로 탐색결과를 제공합니다.
Request URL
| HTTP Method | URL |
|---|---|
| POST | /api/route |
Request Body
| Name | Mandatory | 설명 |
|---|---|---|
| reqid | O | 요청 아이디 (클라이언트에서 임의로 지정) |
| routeoption | O | 경로 탐색 옵션 (1) vehicleType (차량종류) • 1 : 차량 • 2 : 오토바이 / 도보 (2) routeAssignmentType (경로 순서 배정 기준) • 1 : 좌표간 직선 거리 기준 • 2 : 경로 거리 기준 • 3 : 경로 소요 시간 (3) routeMethod (경로 탐색 방식) • 1 : 추천 경로 • 2 : 최단 거리 • 3 : 에코 경로 |
| start | O | 시작점 위치 • dx: Longitude • dy: Latitude |
| destpos | O | 방문지 위치 목록 • nid: 방문지 아이디 • dx: Longitude • dy: Latitude |
| currentDrivableDistance | O | 현재 주행 가능 거리 (km) |
| maxDrivableDistance | O | 최대 주행 가능 거리 (km) |