운송수단의 마지막 측정값 조회

24시간 내 운송수단이 운행을 했을 경우 운송수단의 마지막 측정값을 조회합니다.
만약 해당 기간 내 차량이 운행중이지 않았다면, 측정데이터는 조회되지 않습니다.

배터리는 최근 24시간 내 마지막으로 수신된 배터리 정보를 조회합니다.

Request

---

GET https://openapi.willog.io/hub/v1/vehicles/latest-measurements

Query Parameters

Name	Type	Required	Description
page	Number	false	페이지 번호, default: 1
size	Number	false	데이터 갯수, default: 500, max: 500
vehicleStatus	String	false	운송수단 상태
measurementTypes	Array	true	측정 데이터 타입

Vehicle Statuses

Name	Description
IDLE	미운행
DRIVING	운행중

Measurement Types

Name	Description
TEMPERATURE	온도
HUMIDITY	습도
BATTERY	배터리

Example Request

GET /hub/v1/vehicles/latest-measurements?page=1&size=300&vehicleStatus=DRIVING&measurementTypes=TEMPERATURE&measurementTypes=HUMIDITY
Authorization: Bearer apiKey

Response

---

Response Body

Name	Type	Not-null	Description
items	Array	true	반환되는 배열 데이터
items[].identifier	String	true	운송수단 식별자
items[].identifierType	String	true	운송수단 식별자 타입
items[].vehicleStatus	String	true	운송수단 상태
items[].latestMeasurements	Array	true	매핑된 디바이스가 측정한 마지막 데이터
items[].latestMeasurements[].serial	String	true	디바이스 시리얼
items[].latestMeasurements[].time	Unix Timestamp(ms)	false	데이터를 측정한 시간
items[].latestMeasurements[].temperature	Number	false	온도 데이터
items[].latestMeasurements[].humidity	Number	false	습도 데이터
items[].latestMeasurements[].battery	Object	false	디바이스 최근 배터리 정보
items[].latestMeasurements[].battery.value	Number	true	배터리 값
items[].latestMeasurements[].battery.measuredAt	Unix Timestamp(ms)	true	배터리를 측정한 시간
pagination	Object	true	페이지네이션 메타 데이터
pagination.page	Number	true	요청 페이지 번호
pagination.totalPages	Number	true	전체 페이지 수
pagination.size	Number	true	요청 데이터 갯수
pagination.total	Number	true	전체 데이터 갯수

identifier Types

Name	Description
CAR_LICENSE_NUMBER	차량 번호

Example Response

HTTP/1.1 200 OK

{
    "items": [
        {
            "identifier": "vehicle-001",
            "identifierType": "CAR_LICENSE_NUMBER",
            "vehicleStatus": "DRIVING",
            "latestMeasurements": [
                {
                    "serial": "device-serial-1",
                    "time": 1738741600000,
                    "temperature": 36.5,
                    "humidity": 55,
                    "battery": {
                        "value": 85,
                        "measuredAt": 1738742000000
                    }
                },
                {
                    "serial": "device-serial-2",
                    "time": 1738741600000,
                    "temperature": null,
                    "humidity": 60,
                    "battery": {
                        "value": 90,
                        "measuredAt": 1738742100000
                    }
                }
            ]
        },
        {
            "identifier": "vehicle-002",
            "identifierType": "CAR_LICENSE_NUMBER",
            "vehicleStatus": "IDLE",
            "latestMeasurements": []
        }
    ],
    "pagination": {
        "page": 1,
        "size": 100,
        "total": 2,
        "totalPages": 1
    }
}

Error Responses

- 유효하지 않은 토큰 및 인증키

HTTP/1.1 400 Bad Request

{
    "code": "A0010"
}

- 잘못된 파라미터로 요청

HTTP/1.1 400 Bad Request

{
    "code": "E0021"
}