Get Location Info

Description

차량의 위치를 나타내는 위도 및 경도 좌표, 고도, 방향, 속도를 조회합니다.

Endpoint

GET https://api.pleos.ai/v1/vehicles/{vin}/locations

Request

curl

curl -X GET "https://api.pleos.ai/v1/vehicles/{vin}/locations" \
  -H "Authorization: Bearer <your_access_token>" \
  -H "Brand: hyundai"

Header Params

파라미터	타입	설명	필수 여부
Authorization	string	액세스 토큰	Required
Brand	string	차량 브랜드(hyundai/kia/genesis)	Required

Path Params

파라미터	타입	설명	필수 여부
vin	string	차량 식별 번호(Vehicle Identification Number)	Required

Response

성공

200

{
  "data": {
    "location": {
      "latitude": 49.9749,
      "longitude": 8.4412,
      "altitude": 10,
      "heading": 180,
      "speed": {
        "value": 10,
        "unit": "kph"
      },
      "type": 0
    },
    "timestamp": "2025-09-01T09:10:00Z"
  },
  "meta": {
    "code": 200,
    "message": "Success",
    "success": "true",
    "timestamp": "2025-09-01T11:00:00Z",
    "requestId": "835bdbd4-1105-4a8c-b438-a1b2c3d4f5g6"
  }
}

data 필드	타입	설명
location	object	차량의 최신 위치 정보
└─ latitude	number	차량의 위도 (단위: °, 범위: -90~90)
└─ longitude	number	차량의 경도 (단위 ° , 범위: -180~180)
└─ altitude	number	차량의 고도 (단위: m, 범위: -100~10000)
└─ heading	number	차량의 방위각 (단위: °, 범위: 0~359)
└─ speed	object	차량의 속도 정보
└────── value	number	차량의 속도 (범위: 0~1000)
└────── unit	string	차량의 속도 단위 (kph, mph, mps, invalid)
└─ type	integer	GPS의 좌표계 타입 - 0: WGS84 - 1: Bessel - 2: CoordShift
timestamp	string	차량 데이터 발생 시각 (UTC+0 기준) yyyy-MM-dd'T'HH:mm:ss'Z'

실패

4002

{
  "error": {
    "code": "4002",
    "message": "Invalid request parameters",
    "details": [],
    "timestamp": "2025-09-01T12:00:00Z",
    "requestId": "835bdbd4-1105-4a8c-b438-a1b2c3d4f5g6"
  }
}

[에러 코드]

실패 시 에러 코드에 대한 상세한 설명은 에러 코드를 참조합니다.