模块概览#
对于某个区域设置的典型街道地址，请使用 {{$location.streetAddress}}、{{$location.city}}、{{$location.state}} 和 {{$location.zipCode}}。大多数区域设置会为特定国家提供本地化版本。如果你需要纬度和经度坐标，请使用 {{$location.latitude}} 和 {{$location.longitude}}，或使用 {{$location.nearbyGPSCoordinateLatitude}} 获取给定位置附近的纬度/经度。对于随机国家/地区，你可以使用 {{$location.country}} 或 {{$location.countryCode}}。
buildingNumber#
cardinalDirection#
| 名称 | 类型 | 默认值 | 描述 |
|---|
| abbreviated | boolean | false | 如果为 true，则返回缩写方位（N、E 等）。否则返回完整名称。 |
city#
country#
countryCode#
| 名称 | 类型 | 默认值 | 描述 |
|---|
| variant | 'alpha-2' |'alpha-3' | 'numeric' | 'alpha-2' | 要返回的代码。可以是 'alpha-2'（两个字母代码）、'alpha-3'（三个字母代码）或 'numeric'（数字代码）。 |
direction#
| 名称 | 类型 | 默认值 | 描述 |
|---|
| abbreviated | boolean | false | 如果为 true，则返回缩写方向（NW、E 等）。否则返回完整名称。 |
latitude#
| 名称 | 类型 | 默认值 | 描述 |
|---|
| max | number | 90 | 要生成的纬度上限。 |
| min | number | -90 | 要生成的纬度下限。 |
| precision | number | 4 | 纬度的小数精度位数。 |
longitude#
| 名称 | 类型 | 默认值 | 描述 |
|---|
| max | number | 90 | 要生成的经度上限。 |
| min | number | -90 | 要生成的经度下限。 |
| precision | number | 4 | 经度的小数精度位数。 |
nearbyGPSCoordinate#
在距给定坐标的指定半径范围内生成随机 GPS 坐标。原始的 faker.location.nearbyGPSCoordinate() 方法已细化为两个更精确的变量：{{$location.nearbyGPSCoordinateLatitude}}：在距给定坐标的指定半径范围内生成一个纬度。
{{$location.nearbyGPSCoordinateLongitude}}：在距给定坐标的指定半径范围内生成一个经度。
| 名称 | 类型 | 默认值 | 描述 |
|---|
| isMetric | boolean | false | 如果为 true，则假定半径单位为公里 。如果为 false，则单位为英里。 |
| latitude | number | | 用于获取附近新坐标的原始纬度。 |
| longitude | number | | 用于获取附近新坐标的原始经度。 |
| radius | number | 10 | 从给定坐标到新坐标的最大距离。 |
返回： [latitude: number, longitude: number]
ordinalDirection#
返回随机序数方位（northwest、southeast 等）。| 名称 | 类型 | 默认值 | 描述 |
|---|
| abbreviated | boolean | false | 如果为 true，则返回缩写方向（NW、SE 等）。否则返回完整名称。 |
secondaryAddress#
生成随机本地化二级地址。这指的是给定地址中的特定位置，例如公寓或房间号。
state#
返回随机本地化州/省，或该区域设置国家/地区的其他等效一级行政实体，例如省或地区。通常，这些是某个国家/地区的 ISO 3166-2 细分。如果某个区域设置不对应一个特定国家/地区，该方法可能会返回使用该语言的一个或多个国家/地区的 ISO 3166-2 细分。例如，ar 区域设置包含来自阿拉伯语国家/地区的细分，如突尼斯、阿尔及利亚、叙利亚、黎巴嫩等。出于历史兼容性原因，默认的 en 区域设置仅包含美国的州（与 en_US 相同）。不过，如果需要，你可以使用其他英语区域设置，例如 en_IN、en_GB 和 en_AU。| 名称 | 类型 | 默认值 | 描述 |
|---|
| abbreviated | boolean | false | 如果为 true，则返回缩写的一级行政实体名称。否则返回完整名称。 |
street#
streetAddress#
| 名称 | 类型 | 默认值 | 描述 |
|---|
| useFullAddress | boolean | | 为 true 时，将生成完整地址。否则仅生成街道地址。 |
timeZone#
zipCode#
根据指定格式生成随机邮政编码。如果未指定格式，则使用该区域设置的邮政编码格式。| 名称 | 类型 | 默认值 | 描述 |
|---|
| format | string | | 用于生成邮政编码的可选格式。如果指定了 state 选项，则不会使用此格式。 |
Modified at 2026-06-09 08:55:47
