地点和位置（Location）

生成地点和位置的模块。

概述

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

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

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

buildingNumber

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

返回: 字符串

示例

{{$location.buildingNumber}}  // '9954'

cardinalDirection

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

参数

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

返回: 字符串

示例

{{$location.cardinalDirection}}  // '东'

{{$location.cardinalDirection(abbreviated=true)}}  // 'E'

city

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

返回: 字符串

示例

{{$location.city}}  // '9954'

country

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

返回: 字符串

示例

{{$location.country}}  // '爱沙尼亚'

countryCode

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

参数

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

返回: 字符串

示例

{{$location.countryCode}}  // 'CZ'
{{$location.countryCode(variant='alpha-2')}}  // 'PL '
{{$location.countryCode(variant='alpha-3')}}  // 'SLE'
{{$location.countryCode(variant='numeric')}}  // '807'

direction

返回一个随机的方向。

参数

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

返回: 字符串

示例

{{$location.direction}}  // '东'
{{$location.direction(abbreviated=true)}}  // 'N'

latitude

生成一个随机的纬度。

参数

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

返回: 数字

示例

{{$location.latitude}}  // '89.855'

{{$location.latitude(max=10)}}  // '-61.3305'

{{$location.latitude(min=-10,max=10)}}  // '9.3998'

{{$location.latitude(min=-10,max=10,precision=5)}}  // '7.46934'

longitude

生成一个随机的经度。

参数

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

返回: 数字

示例

{{$location.longitude}}  // '89.855'

{{$location.longitude(max=10)}}  // '-61.3305'

{{$location.longitude(min=-10,max=10)}}  // '9.3998'

{{$location.longitude(min=-10,max=10,precision=5)}}  // '7.46934'

nearbyGPSCoordinate

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

[]

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

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

参数

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

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

示例

{{$location.nearbyGPSCoordinateLongitude}} // '76.1291'

{{$location.nearbyGPSCoordinateLongitude(latitude=33,longitude=178)}} // '178.07134671593099'

{{$location.nearbyGPSCoordinateLongitude(latitude=33,longitude=178,radius=1000,isMetric=true)}}  // '179.85715545348557'

ordinalDirection

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

参数

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

返回: 字符串

示例

{{$location.ordinalDirection}} // '西南'

{{$location.ordinalDirection(abbreviated=true)}} // '西北'

secondaryAddress

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

返回: 字符串

示例

{{$location.secondaryAddress}} // '781 号套房'

state

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

参数

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

返回: 字符串

示例

{{$location.state}}  // '密歇根州'

{{$location.state(abbreviated=true)}} // 'MD'

street

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

返回: 字符串

示例

{{$location.street}}  // 'Jast Landing'

streetAddress

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

参数

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

返回: 字符串

示例

{{$location.streetAddress}}  // '森林大道 476 号'

{{$location.streetAddress(useFullAddress=true)}}  // '豪尔赫小径 190 号 352 号套房'

timeZone

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

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

返回: 字符串

示例

{{$location.timeZone}}  // '美洲/波多韦柳'

zipCode

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

参数

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

返回: 字符串

示例

{{$location.zipCode}}  // '17711'

{{$location.zipCode(format='####')}}  // '0306'