# @harlandgomez/addresspinas 中文文档

规范地址：https://npmcn.com/package/%40harlandgomez/addresspinas/

版本：2\.1\.4
npm 元数据更新时间：2022-04-05T16:55:29.978Z
中文译文更新时间：2026-11-17T19:50:27.487Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40harlandgomez/addresspinas
原文对照：https://npmcn.com/package/%40harlandgomez/addresspinas/?lang=original
项目主页：https://github.com/edcranger/addresspinas
源码仓库：https://github.com/edcranger/addresspinas

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：3.8 MB，22 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2020-10-20T18:10:18.281Z
- 最新版本发布：2020-10-20T18:15:37.894Z
- 近 30 天下载量：4462（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：2（近 12 个月 0 个）

## 中文简介

这是一个简单的节点套件,用于获取菲律宾的地区、省、城市/城市和邦加的列表,包括可能对形式或其他应用功能有用的拉链码.

## 安装

```sh
npm install @harlandgomez/addresspinas
```

也可以使用：`pnpm add @harlandgomez/addresspinas`、`yarn add @harlandgomez/addresspinas`、`bun add @harlandgomez/addresspinas`

## README

# 地址皮纳斯

### 这是什么?

这是一个简单的javascript图书馆,用于获取菲律宾地区、省份、城市/市镇和村镇的清单,包括可能对表格或其他应用功能有用的拉链码.

# 安装

```
npm i addresspinas --save
```

# 使用量

```
import { allData, address } from 'addresspinas'

or..

const { allData, address } = require('addresspinas') 
```

### 在阵列中获取全部信息 .

##### 返回信息数组.

```
const regions = philData.allRegions

const provinces = philData.allProvinces

const cityMunicipal = philData.allCitiesAndMunicipal

const brgy = philData.allBrgys
```

#### 获取具体信息

##### 传入函数所需的代码

```
reg_code // use for fetching data connected to a region.
    {
        "name": "REGION VII (CENTRAL VISAYAS)",
        "reg_code": "07"
    }


prov_code // for fetching data connected to a province.
    {
        "name": "ORIENTAL MINDORO",
        "reg_code": "17",
        "prov_code": "1752"
    }

mun_code // for fetching data connected to a city or municipal.
    {
        "name": "LILOAN",
        "prov_code": "0864",
        "city_code": "086406"
    },
```

# API 密码

#### (确保您传递到函数的数据是"字符串")

### 接通所有地区的省份

```
//address.getProvinceOfRegion(reg_code)

import {  address } from 'addresspinas'


const provinces = address.getProvinceOfRegion("07")

console.log(provinces)

//RETURNS

    name: 'REGION VII (CENTRAL VISAYAS)',
    provinces:
        [
            {
                name: 'BOHOL',
                reg_code: '07',
                prov_code: '0712'
            },
            {
                name: 'CEBU',
                reg_code: '07',
                prov_code: '0722'
            }
        ]
```

### 接通全省的城市和市政府

```
import { address } from 'addresspinas'

const cities = address.getCityMunOfProvince("0722")

console.log(cities)

//RETURNS

    name: 'CEBU',
    cityOrMunicipal:
    [
        {
            name: 'ALCANTARA',
            prov_code: '0722',
            mun_code: '072201'
        },
        {
            name: 'ALCOY',
            prov_code: '0722',
            mun_code: '072202'
        }
    ]
```

### 接通所有城市/市镇的村镇

```
import { address } from 'addresspinas'

const barangay = address.getBarangaysOfCityMun("072201")

console.log(barangay)

//RETURNS

    name: 'ALCANTARA',
    barangays:
    [
        {

            name: 'Cabadiangan',
            mun_code: '072201'
        },
        {
            brgyDesc: 'Cabil-isan',
            mun_code: '072201'
        }
    ]
```

### 拿到村镇的拉链码

##### 返回结果作为数组,因为有些地方确实有同名名称.

##### 免责声明:如果乡镇找不到拉链码,它将自动寻找市镇拉链码,因为该省大多数村镇都使用市镇拉链码.

##### 例子:菲利平有2个被命名为"拉蒙·马格赛"(Ramon Magsaysay). 因此,它将返回一个带有2个索引的阵列.

```
import { address } from 'addresspinas'

const getZip = address.getZipcode({ name: 'Ramon Magsaysay', mun_code: '137404' })

console.log(getZip)

//RETURNS

   [ '1105', '7024' ]
```

## 属性和方法

| 财产 | 类型 | 说明 |
| --- | --- | --- |
| 代码 | 字符串 | 用于搜索参数的特定区域的代码. |
| prov 代码 | 字符串 | 用于搜索参数的特定省份的代码. |
| mun 代码 | 字符串 | 用作搜索参数的特定城市或市镇的代码. |
| philData. all 区域 | 阵列 | 所有区域名单 |
| philData. all Provinces (英语) | 阵列 | 各省列表 |
| philData.all城市与城市 | 阵列 | 所有城市和市镇列表 |
| philData.all Brgys (英语) | 阵列 | 所有村镇名单 |
| 获得省份 | 函数 | 取得特定地区的所有省份. _参数( reg code)_ |
| 获取 CityMunOf 省 | 函数 | 获取特定省份的所有城市和市镇. _参数( prov code)_ |
| 获取 BarangaysOfCityMun 数据 | 函数 | 接通某个城市的所有村镇. _参数 (mun code)_ |
| 获取Zipcode | 函数 | 获得村镇的拉链码最初使用该名称,如果找不到,将自动使用市政拉链码. _参数(对象). 例子:{名称:'Ramon Magsaysay',mun code:'137404'}_ |

* * *

## 贷项

[国家统计协调委员会](http://www.nscb.gov.ph/ "National Statistical Coordination Board") [阴道](https://github.com/clavearnel/philippines-region-province-citymun-brgy "clavearnel") [幼稚园](https://github.com/ejcubillas "ejcubillas")

## 许可证

[麻省理工学院](https://github.com/darklight721/philippines/blob/master/LICENSE "MIT")

## 常见问题

### @harlandgomez/addresspinas 是什么？

这是一个简单的节点套件,用于获取菲律宾的地区、省、城市/城市和邦加的列表,包括可能对形式或其他应用功能有用的拉链码\.

### 如何安装 @harlandgomez/addresspinas？

在项目目录运行 npm install @harlandgomez/addresspinas，或使用 pnpm add / yarn add / bun add。

### @harlandgomez/addresspinas 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/harlandgomez\_\_addresspinas 是否存在。

### @harlandgomez/addresspinas 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @harlandgomez/addresspinas 可以商用吗？

@harlandgomez/addresspinas 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @harlandgomez/addresspinas 的下载量有多少？

根据 npm 官方下载统计，@harlandgomez/addresspinas 在 2026/10/17 – 2026/11/15 这 30 天内被下载 4,462 次，日均约 149 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @harlandgomez/addresspinas 还在维护吗？

最新版本 2\.1\.4 发布于 2020/10/21（6 年前）；至今共发布 2 个版本，其中过去 12 个月发布了 0 个；首次发布于 2020/10/21。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

