Module để tạo địa chỉ và vị trí.Tổng quan về module#
Đối với một địa chỉ đường phố điển hình cho một locale, hãy sử dụng {{$location.streetAddress}}, {{$location.city}}, {{$location.state}} và {{$location.zipCode}}. Hầu hết các locale cung cấp các phiên bản đã được bản địa hóa cho một quốc gia cụ thể.Nếu bạn cần tọa đ ộ vĩ độ và kinh độ, hãy sử dụng {{$location.latitude}} và {{$location.longitude}}, hoặc {{$location.nearbyGPSCoordinateLatitude}} cho vĩ độ/kinh độ gần một vị trí đã cho.Đối với một quốc gia ngẫu nhiên, bạn có thể sử dụng {{$location.country}} hoặc {{$location.countryCode}}.
buildingNumber#
Tạo một số tòa nhà ngẫu nhiên.
cardinalDirection#
Trả về một hướng chính ngẫu nhiên.| Tên | Kiểu | Mặc định | Mô tả |
|---|
| abbreviated | boolean | false | Nếu là true, hàm này sẽ trả về các hướng viết tắt (N, E, v.v.). Nếu không, hàm này sẽ trả về tên đầy đủ. |
city#
Tạo tên thành phố đã bản địa hóa ngẫu nhiên.
country#
Trả về tên quốc gia ngẫu nhiên.
countryCode#
Trả về tên quốc gia ngẫu nhiên.| Tên | Kiểu | M ặc định | Mô tả |
|---|
| variant | 'alpha-2' |'alpha-3' | 'numeric' | 'alpha-2' | Mã cần trả về. Có thể là 'alpha-2' (mã hai chữ cái), 'alpha-3' (mã ba chữ cái) hoặc 'numeric' (mã số). |
direction#
Trả về một hướng ngẫu nhiên.| Tên | Kiểu | Mặc định | Mô tả |
|---|
| abbreviated | boolean | false | Nếu là true, hàm này sẽ trả về các hướng viết tắt (NW, E, v.v.). Nếu không, hàm này sẽ trả về tên đầy đủ. |
latitude#
Tạo một vĩ độ ngẫu nhiên.| Tên | Kiểu | Mặc định | Mô tả |
|---|
| max | number | 90 | Giới hạn trên cho vĩ độ cần tạo. |
| min | number | -90 | Giới hạn dưới cho vĩ độ c ần tạo. |
| precision | number | 4 | Số chữ số thập phân về độ chính xác cho vĩ độ. |
longitude#
Tạo một kinh độ ngẫu nhiên.| Tên | Kiểu | Mặc định | Mô tả |
|---|
| max | number | 90 | Giới hạn trên cho kinh độ cần tạo. |
| min | number | -90 | Giới hạn dưới cho kinh độ cần tạo. |
| precision | number | 4 | Số chữ số thập phân về độ chính xác cho kinh độ. |
nearbyGPSCoordinate#
Tạo một tọa độ GPS ngẫu nhiên trong bán kính được chỉ định từ tọa độ đã cho.Phương thức faker.location.nearbyGPSCoordinate() gốc đã được tinh chỉnh thành hai biến chính xác hơn:{{$location.nearbyGPSCoordinateLatitude}}: Tạo một vĩ độ trong bán kính được chỉ định từ tọa độ đã cho.
{{$location.nearbyGPSCoordinateLongitude}}: Tạo một kinh độ trong bán kính được chỉ định từ tọa độ đã cho.
| Tên | Kiểu | Mặc định | Mô tả |
|---|
| isMetric | boolean | false | Nếu là true, giả định bán kính tính bằng kilômét. Nếu là false, tính bằng dặm. |
| latitude | number | | Vĩ độ gốc để lấy một tọa độ mới gần đó. |
| longitude | number | | Kinh độ gốc để lấy một tọa độ mới gần đó. |
| radius | number | 10 | Khoảng cách tối đa từ tọa độ đã cho đến tọa độ mới. |
Trả về: [latitude: number, longitude: number]
ordinalDirection#
Trả về một hướng thứ tự ngẫu nhiên (tây bắc, đông nam, v.v.).| Tên | Kiểu | Mặc định | Mô tả |
|---|
| abbreviated | boolean | false | Nếu là true, hàm này sẽ trả về các hướng viết tắt (NW, SE, v.v.). Nếu không, hàm này sẽ trả về tên đầy đủ. |
secondaryAddress#
Tạo một địa chỉ phụ đã bản địa hóa ngẫu nhiên. Điều này đề cập đến một vị trí cụ thể tại một địa chỉ đã cho, chẳng hạn như căn hộ hoặc số phòng.
state#
Trả về một tiểu bang đã bản địa hóa ngẫu nhiên, hoặc thực thể hành chính cấp một tương đương khác cho quốc gia của locale, chẳng hạn như tỉnh hoặc vùng. Nhìn chung, đây là các phân khu ISO 3166-2 cho một quốc gia. Nếu một locale không tương ứng với một quốc gia cụ thể, phương thức có thể trả về các phân khu ISO 3166-2 từ một hoặc nhiều quốc gia sử dụng ngôn ngữ đó. Ví dụ, locale ar bao gồm các phân khu từ các quốc gia nói tiếng Ả Rập, chẳng hạn như Tunisia, Algeria, Syria, Lebanon, v.v. Vì lý do tương thích lịch sử, locale en mặc định chỉ bao gồm các tiểu bang ở Hoa Kỳ (giống hệt en_US). Tuy nhiên, bạn có thể sử dụng các locale tiếng Anh khác, chẳng hạn như en_IN, en_GB và en_AU, nếu cần.| Tên | Kiểu | Mặc định | Mô tả |
|---|
| abbreviated | boolean | false | Nếu là true, hàm này sẽ trả về tên thực thể hành chính cấp một viết tắt. Nếu không, hàm này sẽ trả về tên đầy đủ. |
street#
Tạo tên đường phố đã bản địa hóa ngẫu nhiên.
streetAddress#
Tạo địa chỉ đường phố đã bản địa hóa ngẫu nhiên.| Tên | Kiểu | Mặc định | Mô tả |
|---|
| useFullAddress | boolean | | Khi là true, hàm này sẽ tạo một địa chỉ đầy đủ. Nếu không, hàm này sẽ chỉ tạo một địa chỉ đường phố. |
timeZone#
Trả về một múi giờ IANA ngẫu nhiên có liên quan đến locale này.Múi giờ được trả về gắn với locale hiện tại.
zipCode#
Tạo mã zip ngẫu nhiên từ định dạng được chỉ định. Nếu định dạng không được chỉ định, định dạng zip của locale sẽ được sử dụng.| Tên | Kiểu | Mặc định | Mô tả |
|---|
| format | string | | Định dạng tùy chọn được sử dụng để tạo mã zip. Định dạng này sẽ không được sử dụng nếu tùy chọn state được chỉ định. |
Modified at 2026-06-11 10:23:06
