模組概覽#
若要產生某個語系的典型街道地址，請使用 {{$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#
原始的 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-11 10:26:02
