calc_last

Para obtener los últimos valores conocidos de los sensores, los contadores y la posición de las unidades, utilice el método unit/calc_last.

Para obtener los datos, necesita el derecho de acceso Ver objeto y sus propiedades básicas a cada unidad especificada en la solicitud.

Endpoint

Copied!

svc=unit/calc_last&params={
    "itemIds": [<long>]
}

Parámetros

La solicitud debe contener el siguiente parámetro:

Parámetro	Descripción
`itemIds`	Array de los ID de las unidades para las que desea obtener los últimos valores conocidos. El array no debe estar vacío.

La respuesta contiene un bloque solo para los ID que pertenecen a unidades. Los ID de otros tipos de elementos se omiten.

Ejemplo

A continuación se muestra un ejemplo de la solicitud unit/calc_last.

Copied!

svc=unit/calc_last&params={
    "itemIds": [16091323, 16454260]
}

Respuesta

Si la solicitud se completa con éxito, la respuesta se devuelve en el siguiente formato:

Copied!

[
    {
        "i": <long>,         /* ID de la unidad */
        "mileage": {         /* Contador de kilometraje */
            "value": <double>,
            "format": {
                "value": <text>  /* Valor formateado con unidades de medida (por ejemplo, "24498.82 km") */
            }
        },
        "engine_hours": {    /* Contador de horas de motor */
            "value": <double>,
            "format": {
                "value": <text>  /* Valor formateado con unidades de medida (por ejemplo, "0.00 h") */
            }
        },
        "pos": {             /* Última posición conocida */
            "y": <double>,   /* Latitud */
            "x": <double>,   /* Longitud */
            "c": <int>,      /* Rumbo */
            "z": {           /* Altitud */
                "value": <double>,
                "format": {
                    "value": <text>  /* Valor formateado con unidades de medida (por ejemplo, "139.00 m") */
                }
            },
            "s": {           /* Velocidad */
                "value": <double>,
                "format": {
                    "value": <text>  /* Valor formateado con unidades de medida (por ejemplo, "75.00 km/h") */
                }
            },
            "sc": <int>      /* Cantidad de satélites */
        },
        "sensors": {         /* Valores de todos los sensores de la unidad */
            "<sensor_id>": {
                "value": <double|text>,    /* Valor del sensor */
                "format": {
                    "value": <text>        /* Valor del sensor formateado con unidades de medida */
                }
            }
        }
    }
]

La respuesta tiene las siguientes particularidades:

La sección sensors contiene todos los sensores de la unidad. Para los sensores que devuelven valores de texto, value contiene texto en lugar de un número.
Si un valor del sensor entra en un intervalo de valores personalizados con una descripción de texto (el parámetro ci del método unit/update_sensor), la sección format contiene esta descripción seguida del valor entre paréntesis.
Si un valor no se puede calcular, se devuelve --- en su lugar.
Si la unidad no tiene mensajes con una posición, todos los campos de pos se establecen en cero.
Los valores se convierten al sistema de medidas de la sesión actual, que puede establecer con el método render/set_locale.

Si la solicitud falla, se devuelve un código de error.

Códigos de error

Código de error	Descripción
4	Parámetros de entrada incorrectos.
7	No hay derecho de acceso Ver objeto y sus propiedades básicas a las unidades.