Location

주소와 위치를 생성하는 모듈입니다.

모듈 개요

로캘에 대한 일반적인 도로명 주소에는 {{$location.streetAddress}}, {{$location.city}}, {{$location.state}}, {{$location.zipCode}}를 사용하십시오. 대부분의 로캘은 특정 국가에 맞게 현지화된 버전을 제공합니다.

위도 및 경도 좌표가 필요한 경우 {{$location.latitude}} 및 {{$location.longitude}}를 사용하거나, 지정된 위치 근처의 위도/경도를 위해 {{$location.nearbyGPSCoordinateLatitude}}를 사용하십시오.

무작위 국가의 경우 {{$location.country}} 또는 {{$location.countryCode}}를 사용할 수 있습니다.

buildingNumber

무작위 건물 번호를 생성합니다.

반환값: string

예시

cardinalDirection

무작위 기본 방위를 반환합니다.

매개변수

이름	타입	기본값	설명
abbreviated	boolean	`false`	true이면 축약된 방위(N, E 등)를 반환합니다. 그렇지 않으면 전체 이름을 반환합니다.

반환값: string

예시

city

무작위 현지화된 도시 이름을 생성합니다.

반환값: string

예시

country

무작위 국가 이름을 반환합니다.

반환값: string

예시

countryCode

무작위 국가 이름을 반환합니다.

매개변수

이름	타입	기본값	설명
variant	'alpha-2' \|'alpha-3' \| 'numeric'	`'alpha-2'`	반환할 코드입니다. `'alpha-2'`(두 글자 코드), `'alpha-3'`(세 글자 코드) 또는 `'numeric'`(숫자 코드) 중 하나일 수 있습니다.

반환값: string

예시

direction

무작위 방위를 반환합니다.

매개변수

이름	타입	기본값	설명
abbreviated	boolean	`false`	true이면 축약된 방위(NW, E 등)를 반환합니다. 그렇지 않으면 전체 이름을 반환합니다.

반환값: string

예시

latitude

무작위 위도를 생성합니다.

매개변수

이름	타입	기본값	설명
max	number	`90`	생성할 위도의 상한입니다.
min	number	`-90`	생성할 위도의 하한입니다.
precision	number	`4`	위도의 소수점 정밀도 자릿수입니다.

반환값: number

예시

longitude

무작위 경도를 생성합니다.

매개변수

이름	타입	기본값	설명
max	number	`90`	생성할 경도의 상한입니다.
min	number	`-90`	생성할 경도의 하한입니다.
precision	number	`4`	경도의 소수점 정밀도 자릿수입니다.

반환값: number

예시

nearbyGPSCoordinate

지정된 좌표로부터 지정된 반경 내의 무작위 GPS 좌표를 생성합니다.

INFO

원래 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 등)를 반환합니다. 그렇지 않으면 전체 이름을 반환합니다.

반환값: string

예시

secondaryAddress

무작위 현지화된 보조 주소를 생성합니다. 이는 아파트 또는 방 번호와 같이 지정된 주소의 특정 위치를 의미합니다.

반환값: string

예시

state

무작위 현지화된 주(state) 또는 주/지역과 같이 로캘 국가에 해당하는 다른 동등한 1단계 행정 구역을 반환합니다. 일반적으로 이는 국가의 ISO 3166-2 하위 구역입니다. 로캘이 특정 국가 하나에 대응하지 않는 경우, 해당 메서드는 해당 언어를 사용하는 하나 이상의 국가에서 ISO 3166-2 하위 구역을 반환할 수 있습니다. 예를 들어 ar 로캘에는 튀니지, 알제리, 시리아, 레바논 등 아랍어권 국가의 하위 구역이 포함됩니다. 과거 호환성상의 이유로 기본 en 로캘은 미국의 주만 포함합니다(en_US와 동일). 그러나 필요한 경우 en_IN, en_GB, en_AU와 같은 다른 영어 로캘을 사용할 수 있습니다.

매개변수

이름	타입	기본값	설명
abbreviated	boolean	`false`	true이면 축약된 1단계 행정 구역 이름을 반환합니다. 그렇지 않으면 전체 이름을 반환합니다.

반환값: string

예시

street

무작위 현지화된 거리 이름을 생성합니다.

반환값: string

예시

streetAddress

무작위 현지화된 도로명 주소를 생성합니다.

매개변수

이름	타입	기본값	설명
useFullAddress	boolean		true이면 전체 주소를 생성합니다. 그렇지 않으면 도로명 주소만 생성합니다.

반환값: string

예시

timeZone

이 로캘과 관련된 무작위 IANA 시간대를 반환합니다.

반환되는 시간대는 현재 로캘에 연결됩니다.

반환값: string

예시

zipCode

지정된 형식에서 무작위 우편번호를 생성합니다. 형식이 지정되지 않은 경우 로캘의 우편번호 형식이 사용됩니다.

매개변수

이름	타입	기본값	설명
format	string		우편번호를 생성하는 데 사용되는 선택적 형식입니다. state 옵션이 지정된 경우에는 사용되지 않습니다.

반환값: string

예시

모듈 개요#

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