Measurement API

Parse and convert#

import { parseAPI } from '@parseapi/sdk';

const parse = parseAPI("YOUR_API_KEY");
const result = await parse.measure("5 ft 11 in", { to: "cm" });
console.log(result);

{
  "measure": "5 ft 11 in",
  "valid": true,
  "type": "length",
  "amount": "180.34",
  "unit": "cm",
  "reason": null,
  "choices": []
}

import { parseAPI } from '@parseapi/sdk';

const parse = parseAPI("YOUR_API_KEY");
const result = await parse.measure("2.5 kg", { to: "g" });
console.log(result);

{
  "measure": "2.5 kg",
  "valid": true,
  "type": "mass",
  "amount": "2500",
  "unit": "g",
  "reason": null,
  "choices": []
}

Make context explicit#

Amounts use up to 18 significant digits, rounded half away from zero, with trailing fractional zeroes omitted. Keep the decimal string when storing the result; converting it to a floating-point number can lose precision. Unit discovery returns canonical codes. URL-encode the entire measurement, including slash and plus.

import { parseAPI } from '@parseapi/sdk';

const parse = parseAPI("YOUR_API_KEY");
const result = await parse.measure("180");
console.log(result);

{
  "measure": "180",
  "valid": false,
  "type": null,
  "amount": null,
  "unit": null,
  "reason": "missing_unit",
  "choices": []
}

Find compatible units#

Use ?q=meter to search, ?type=length for one measurement type, or ?unit=m to list compatible target units. Each row has unit, name, type, and an aliases array. Use the canonical unit in subsequent calls.

Conversion boundaries#

Convert within supported measurement types. Mass to volume needs density; electrical current to power needs more than a unit change. Calendar months, currencies, substance-specific concentrations, and other conversions needing additional context are outside this lookup. Use °C or °F for absolute temperatures and delta_C or delta_F for differences. Absolute temperatures cannot be mixed with other units. Symbols are case-sensitive: MB and Mb differ. Unsupported expressions stay unresolved.

Questions? Email