モジュール概要#
ロケールに対応した一般的な番地住所には、{{$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'（2 文字コード）、'alpha-3'（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() メソッドは、より正確な 2 つの変数に改善されています。{{$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#
Returns a random localized state, or other equivalent first-level administrative entity for the locale's country such as a province or region. Generally, these are the ISO 3166-2 subdivisions for a country. If a locale doesn't correspond to one specific country, the method may return ISO 3166-2 subdivisions from one or more countries that uses that language. For example, the ar locale includes subdivisions from Arabic-speaking countries, such as Tunisia, Algeria, Syria, Lebanon, etc. For historical compatibility reasons, the default en locale only includes states in the United States (identical to en_US). However, you can use other English locales, such as en_IN, en_GB, and en_AU, if needed.| 名前 | 型 | デフォルト | 説明 |
|---|
| abbreviated | boolean | false | true の場合、省略形の第一レベル行政区画名を返します。それ以外の場合は正式名称を返します。 |
street#
streetAddress#
ランダムなローカライズ済みの番地住所を生成します。| 名前 | 型 | デフォルト | 説明 |
|---|
| useFullAddress | boolean | | true の場合、完全な住所を生成します。それ以外の場合は番地住所のみを生成します。 |
timeZone#
このロケールに関連するランダムな IANA タイムゾーンを返します。返されるタイムゾーンは現在のロケールに関連付けられています。
zipCode#
指定された形式からランダムな郵便番号を生成します。形式が指定されていない場合は、ロケールの郵便番号形式が使用されます。| 名前 | 型 | デフォルト | 説明 |
|---|
| format | string | | 郵便番号を生成するために使用される任意の形式です。state オプションが指定されている場合、これは使用されません。 |
Modified at 2026-06-11 07:06:02
