地点和位置（Location）

生成地点和位置的模块。

概述

对于特定语言环境的典型街道地址，请使用 {{$location.streetAddress}}、{{$location.city}}、{{$location.state}} 和 {{$location.zipCode}}。大多数语言环境都为特定国家/地区提供本地化版本。

如果您需要纬度和经度坐标，请使用 {{$location.latitude}} 和 {{$location.longitude}}，或者对于给定位置附近的纬度/经度，请使用 {{$location.nearbyGPSCoordinateLatitude}}。

对于随机国家/地区，可以使用 {{$location.country}} 或 {{$location.countryCode}}。

buildingNumber

生成一个随机的建筑物编号。

返回: 字符串

示例

cardinalDirection

返回一个随机的基本方向。

参数

名称	类型	默认值	描述
abbreviated	布尔值	`false`	如果为 true，则返回缩写方向（N、E 等）。否则将返回长名称。

返回: 字符串

示例

city

生成一个随机的本地化城市名称。

返回: 字符串

示例

country

返回一个随机的国家/地区名称。

返回: 字符串

示例

countryCode

返回一个随机的国家/地区名称。

参数

名称	类型	默认值	描述
variant	'alpha-2' \|'alpha-3' \| 'numeric'	`'alpha-2'`	要返回的代码。可以是 `'alpha-2'`（两字母代码）、`'alpha-3'`（三字母代码）或 `'numeric'`（数字代码）。

返回: 字符串

示例

direction

返回一个随机的方向。

参数

名称	类型	默认值	描述
abbreviated	布尔值	`false`	如果为 true，则返回缩写方向（NW、E 等）。否则将返回长名称。

返回: 字符串

示例

latitude

生成一个随机的纬度。

参数

名称	类型	默认值	描述
max	数字	`90`	要生成的纬度的上限。
min	数字	`-90`	要生成的纬度的下限。
precision	数字	`4`	纬度的小数位数。

返回: 数字

示例

longitude

生成一个随机的经度。

参数

名称	类型	默认值	描述
max	数字	`90`	要生成的经度的上限。
min	数字	`-90`	要生成的经度的下限。
precision	数字	`4`	经度的小数位数。

返回: 数字

示例

nearbyGPSCoordinate

在给定坐标的指定半径内生成一个随机 GPS 坐标。

原始的 faker.location.nearbyGPSCoordinate() 方法已被细化为两个更精确的变量：

{{$location.nearbyGPSCoordinateLatitude}}：在给定坐标的指定半径内生成一个纬度。

{{$location.nearbyGPSCoordinateLongitude}}：在给定坐标的指定半径内生成一个经度。

参数

名称	类型	默认值	描述
isMetric	布尔值	`false`	如果为 `true`，则假定半径以公里为单位。如果为 `false`，则以英里为单位。
latitude	数字		要在其附近获取新坐标的原始纬度。
longitude	数字		要在其附近获取新坐标的原始经度。
radius	数字	`10`	给定坐标到新坐标的最大距离。

返回: [latitude: 数字, longitude: 数字]

示例

ordinalDirection

返回一个随机的序数方向（西北、东南等）。

参数

名称	类型	默认值	描述
abbreviated	布尔值	`false`	如果为 true，则返回缩写方向（NW、SE 等）。否则将返回长名称。

返回: 字符串

示例

secondaryAddress

生成一个随机的本地化辅助地址。这指的是给定地址的特定位置，例如公寓或房间号。

返回: 字符串

示例

state

返回一个随机的本地化州，或语言环境所在国家/地区的其他等效一级行政区，例如省或地区。通常，这些是国家/地区的 ISO 3166-2 细分。如果语言环境不对应于一个特定国家/地区，则该方法可能会从使用该语言的一个或多个国家/地区返回 ISO 3166-2 细分。例如，ar 语言环境包括阿拉伯语国家/地区的细分，例如突尼斯、阿尔及利亚、叙利亚、黎巴嫩等。出于历史兼容性原因，默认的 en 语言环境仅包含美国各州（与 en_US 相同）。但是，如果需要，您可以使用其他英语语言环境，例如 en_IN、en_GB 和 en_AU。

参数

名称	类型	默认值	描述
abbreviated	布尔值	`false`	如果为 true，则返回缩写的一级行政区名称。否则将返回长名称。

返回: 字符串

示例

street

生成一个随机的本地化街道名称。

返回: 字符串

示例

streetAddress

生成一个随机的本地化街道地址。

参数

名称	类型	默认值	描述
useFullAddress	布尔值		如果为 true，则生成完整的地址。否则，它将仅生成街道地址。

返回: 字符串

示例

timeZone

返回与该语言环境相关的随机 IANA 时区。

返回的时区与当前语言环境绑定。

返回: 字符串

示例

zipCode

根据指定的格式生成随机邮政编码。如果未指定格式，则使用语言环境的邮政编码格式。

参数

名称	类型	默认值	描述
format	字符串		用于生成邮政编码的可选格式。如果指定了州选项，则不会使用此格式。

返回: 字符串

示例

buildingNumber#

cardinalDirection#

city#

country#

countryCode#

direction#

latitude#

longitude#

nearbyGPSCoordinate#

ordinalDirection#

secondaryAddress#

state#

street#

streetAddress#

timeZone#

zipCode#

buildingNumber

cardinalDirection

city

country

countryCode

direction

latitude

longitude

nearbyGPSCoordinate

ordinalDirection

secondaryAddress

state

street

streetAddress

timeZone

zipCode