---
title: "formatDistance / formatArea"
description: "把米 / 平方米数值格式化为带单位的距离与面积读数字符串。"
seo_title: "formatDistance / formatArea"
seo_description: "Format meter and square-meter values into human-readable distance and area strings with adaptive units."
canonical_url: "https://mapbox.mhaibaraai.cn/docs/utils/measure"
---
# formatDistance / formatArea

> 把米 / 平方米数值格式化为带单位的距离与面积读数字符串。

## 简介

`formatDistance` / `formatArea` 把原始的米 / 平方米数值格式化为带单位的可读字符串：距离千米以下取整米、以上保留两位 km；面积平方千米以下取整平方米、以上保留两位 km²。[useMeasure](/docs/composables/use-measure) 的实时读数即由它们格式化。

从 `@movk/mapbox/utils/measure` 导入（非自动导入）。

## 用法

不同量级的输入对应的格式化结果：

```vue
<template>
  <MeasureFormatExample />
</template>
```

## API

### `formatDistance()`

格式化距离。

**meters** (`number`) *required*: 距离值（米）。

返回 `string`：千米以下取整米（如 `850 m`），以上保留两位 km（如 `1.23 km`）。

### `formatArea()`

格式化面积。

**squareMeters** (`number`) *required*: 面积值（平方米）。

返回 `string`：平方千米以下取整平方米（如 `5000 m²`），以上保留两位 km²（如 `1.20 km²`）。

## Changelog

See commit history for [src/runtime/utils/formatDistance  formatArea.ts](https://github.com/mhaibaraai/movk-mapbox/commits/main/src/runtime/utils/formatDistance  formatArea.ts).


## Sitemap

See the full [sitemap](/sitemap.md) for all pages.