技术博客
单位换算器支持哪些单位?14 大类与完整单位清单

单位换算器支持哪些单位?14 大类与完整单位清单

作者: 万维易源
2026-09-03
单位清单单位代码支持的类型对照表
# 单位换算器支持哪些单位?14 大类与完整单位清单 > 接口/接入点:免费单位换算 1690-16(支持的类型)|是否免费:是|请求方式:POST/GET|返回格式:JSON|适用人群:选型/开发前想确认覆盖面的开发者|阅读时间:约 8 分钟 ## 核心要点 - 单位换算器覆盖 **14 大类**物理量:`angle`/`dataStorage`/`speed`/`time`/`energy`/`density`/`work`/`power`/`pressure`/`temperature`/`weight`/`volume`/`area`/`longness`。 - 每个类别下有多个单位,`1690-16` 接入点返回全量单位清单(单位名 + 代码),可直接用于前端下拉、校验。 - 少数单位代码在接口返回中带有来源数据特征(如 `nnhg`/`oR`/`lli`),本文按接口**原样**引用,以实际返回为准。 ## Why:先确认「能不能换」再写代码 开发前最该搞清楚的是:我要的单位在不在?代码怎么写?`1690-16` 接入点就是干这个的——它把接口支持的全部单位一次性返回,你拿去建下拉框、做输入校验,避免用户填了不支持的单位却等到调用才报错。 ## What:接口速览 | 项 | 值 | |----|----| | 接口地址 | `https://route.showapi.com/1690-16?appKey={your_appKey}` | | 接入点 | 支持的类型(1690-16) | | 返回结构 | `showapi_res_body.result` 为数组,每项含 `unit`(单位名) / `type`(类别) / `code`(单位代码) | 调用 `1690-16` 可不传 `type` 拿全量,也可传某一类拿该类的单位。 ## How:拉取单位清单 ```python import requests r = requests.post( "https://route.showapi.com/1690-16", params={"appKey": "YOUR_APPKEY"}, data={"type": "longness"}, # 不传 type 则取全部 timeout=10, ) body = r.json()["showapi_res_body"] for u in body["result"]: print(u["code"], u["unit"], u["type"]) ``` ```bash curl -X POST "https://route.showapi.com/1690-16?appKey=YOUR_APPKEY" \ -H "content-type: application/x-www-form-urlencoded" \ -d "type=longness" ``` ## 14 大类与单位代码(按接口返回整理) > 下列 `code` 为接口返回的单位代码,传入 1690-1 的 `from`/`to` 时即用此代码。`type` 为所属类别。 **angle(角度)**:circumference 圆周 / branch 分 / mrad 毫弧度 / degree 度 / right_angle 直角 / gon 百分度 / sec 秒 / rad 弧度 **dataStorage(数据存储)**:bit 比特 / b 字节 / kb 千字节 / mb 兆字节 / gb 千兆字节 / tb 太字节 / pb 拍字节 / eb 艾字节 **speed(速度)**:m_s 米/秒 / km_s 千米/秒 / km_h 千米/时 / mile_h 英里/时 / in_s 英寸/秒 / c 光速 / mach 马赫 **time(时间)**:s 秒 / ms 毫秒 / μs 微秒 / ns 纳秒 / min 分 / h 时 / d 天 / week 周 / yr 年 **energy(力)**:n 牛 / dyn 达因 / gf 克力 / kgf 千克力 / tf 公吨力 / kip 千磅力 / kn 千牛 / lbf 磅力 **density(密度)**:kg_m3 千克/立方米 / kg_dm3 千克/立方分米 / kg_cm3 千克/立方厘米 / g_cm3 克/立方厘米 / g_dm3 克/立方分米 / g_m3 克/立方米 (注:`kg_cm3` 对应页面单位名「千克/立方厘米」,代码按接口返回原样使用。) **work(功、能、热)**:j 焦耳 / kj 千焦 / cal 卡 / kcal 千卡 / kw_h 千瓦·时(度) / kg_m 公斤·米 / ft_lb 英尺·磅 / btu 英热单位 / hp_h 英制马力·时 / ps_h 米制马力·时 **power(功率)**:w 瓦 / kw 千瓦 / j_s 焦耳/秒 / kcal_s 千卡/秒 / kg_m_s 公斤·米/秒 / N_m_s 牛顿·米/秒 / btu_s 英热单位/秒 / ft_lb_s 英尺·磅/秒 / hp 英制马力 / ps 米制马力 **pressure(压力)**:pa 帕斯卡 / hpa 百帕 / kpa 千帕 / mpa 兆帕 / bar 巴 / mbar 毫巴 / atm 标准大气压 / psi 磅力/平方英寸 / psf 磅力/平方英尺 / kgf_m2 公斤力/平方米 / kgf_cm2 公斤力/平方厘米 / mmwater 毫米水柱 / in_hg 英寸汞柱 / nnhg 毫米汞柱 (注:`nnhg` 对应「毫米汞柱」,代码按接口返回原样使用。) **temperature(温度)**:oC 摄氏度 / oF 华氏度 / oK 开氏度 / oR 列氏度 / oRe 兰氏度 (注:`oR`/`oRe` 为接口返回的温度单位代码,按原样使用。) **weight(质量)**:g 克 / mg 毫克 / μg 微克 / kg 千克 / t 吨 / jin 斤 / liang 两 / qian 钱 / ct 克拉 / lb 磅 / oz 盎司 / gr 格令 / dr 打兰 / point 分 / q 公担 / dan 担 / st 短吨 / lt 长吨 / uk_dan 英担 / us_dan 美担 / uk_st 英石 **volume(体积)**:ml 毫升 / ul 微升 / l 升 / dl 分升 / cl 厘升 / hl 公石 / cm3 立方厘米 / mm3 立方毫米 / dm3 立方分米 / m3 立方米 / cu_in 立方英寸 / cu_ft 立方英尺 / cu_yd 立方码 / mu_ft 亩英尺 / us_gal 美制加仑 / uk_gal 英制加仑 / us_oz 美制液体盎司 / uk_oz 英制液体盎司 **area(面积)**:m2 平方米 / cm2 平方厘米 / mm2 平方毫米 / dm2 平方分米 / km2 平方千米 / ha 公顷 / are 公亩 / mu2 亩 / fen2 分 / qing2 平方公顷 / sq_in 平方英寸 / sq_ft 平方英尺 / sq_yd 平方码 / sq_mi 平方英里 / sq_rd 平方竿 / cun2 平方寸 / chi2 平方尺 **longness(长度)**:m 米 / cm 厘米 / mm 毫米 / km 千米 / um 微米 / nm 纳米 / pm 皮米 / ly 光年 / AU 天文单位 / inch 英寸 / ft 英尺 / yd 码 / mi 英里 / fm 英寻 / fur 弗隆 / nmi 海里 / li 里 / zhang 丈 / chi 尺 / cun 寸 / fen 分 / hao 毫 / lli 厘 (注:`lli` 对应「厘」,代码按接口返回原样使用。) > 说明:以上单位名与代码均取自接口 `1690-16` 返回示例,跨类别同名单位(如「分」在角度/长度/质量/面积中)代码不同,调用时务必带对 `type` 或用全代码。 ## 进阶 / 边界 - 单位代码以接口返回为准,前端做下拉/校验时建议直接消费 `1690-16` 的返回,不要手抄硬编码。 - 个别代码(`nnhg`/`oR`/`oRe`/`lli`/`kg_cm3`)带有来源数据特征,属接口原样数据,使用时照搬即可,不要自行「修正」为 `mmHg` 等。 - 跨类换算(如长度→温度)接口不支持,需先选对 `type` 再调 `1690-1`。 ## FAQ **Q1:怎么拿到全部单位做下拉框?** A:调 `1690-16` 不传 `type`,遍历 `result` 数组,每项 `code`+`unit`+`type` 即可渲染下拉与选项校验。 **Q2:单位代码会变动吗?** A:文档标注「数据持续更新中」,建议运行时拉取而非写死;若缓存,设置合理过期时间并监听变更。 **Q3:`from`/`to` 能用中文单位名吗?** A:用代码(如 `cm`/`m`),不用中文名;中文名仅用于展示。 **Q4:同名叫「分」的单位怎么区分?** A:靠 `type` 或完整代码区分(角度 branch、长度 fen、质量 point、面积 fen2),调用 1690-1 时带对 `type` 最稳妥。 **Q5:支持货币/汇率换算吗?** A:不支持。本接口覆盖物理量单位,不含货币类。 ## 相关能力 / 下一步阅读 - [单位换算器:5 分钟接入(从注册到第一次单位换算)](https://www.showapi.com/guides/unit-convert-quickstart-1690) - [单位换算器参数怎么填?from/to 必填与常见报错排查](https://www.showapi.com/guides/unit-convert-params-errors-1690) - [单位换算器返回字段全解:ret_code 与 result_list 一文读懂](https://www.showapi.com/guides/unit-convert-response-codes-1690) - **本系列共 12 篇**:查看[单位换算器(免费单位换算)指南总目录](https://www.showapi.com/guides/unit-convert-guides-1690)