자율차경로정보 (수집)

자율주행 서비스의 자율주행차량 경로정보를 수집하여 플랫폼 내에 적재하는 기능을 제공합니다.

1. 자율차경로정보 수집 API (PostVehicleRoute)

요청 URL

https://service.mqnicrnd5.com/api/v1/vehi/collect/pvr

연계 주기

경로 생성 시, 변경 시

프로토콜

HTTPS

HTTP 메서드

POST

데이터 포맷

86KB

자율차경로정보(수집)_pvr.pdf

pdf

참고사항

API를 요청할 때 다음 예와 같이 HTTP 요청 헤더에 접근 토큰(Access Token) 을 추가해야 합니다. 접근 토큰 앞에 "Bearer " 문자열을 추가해야 한다는 점에 주의하세요.

> POST /api/v1/vehi/collect/pvr
> Host: service.mqnicrnd5.com
> User-Agent: curl/7.64.1
> Accept: */*
> Authorization: Bearer <접근 토큰>

요청 예시

curl --location 'https://service.mqnicrnd5.com/api/v1/vehi/collect/pvr' \
--header 'Authorization: Bearer <접근 토큰>' \
--header 'Content-Type: application/json' \
--data '{
  "dttm": "20240723143000",
  "routeId": "SC-20250410-1426-001",
  "vehicleId": "99370",
  "routeType": "1",
  "linkIdList": [
    "2090021601",
    "2090021602",
    "2090021700",
    "2090021800"
  ],
  "pointList": [
    {
      "latitude": 37.450675,
      "longitude": 126.791891
    },
    {
      "latitude": 37.451675,
      "longitude": 126.792891
    },
    {
      "latitude": 37.452675,
      "longitude": 126.793891
    }
  ],
  "startSpot": {
    "latitude": 37.450675,
    "longitude": 126.791891
  },
  "arvlSpot": {
    "latitude": 37.452675,
    "longitude": 126.793891
  }
}'

응답 파라미터

수집 API의 경우 별도 응답 파라미터가 아닌 HTTP Status Code로 성공 여부를 구분합니다.

Status Code	설명
200	성공
400	요청 파라미터 검증 실패
401	인증 실패
500	서버 오류

2. 자율차경로정보 수집 API 구현 예제