README

MCPro是菲律宾市、城市和省的缩写

用于获取菲律宾所有城市、镇和省的基本RESTful API。

安装

• 步骤1：将以下内容添加到您的根目录 composer.json

	"require": {
	    "jsdecena/mcpro": "1.1.*"
	}

• 步骤2：将以下内容添加到您的 config/app.php 中的 providers 数组

	'providers' => [
	    Jsdecena\MCPro\McproServiceProvider::class,
	]

• 步骤3：在终端中运行此命令 php artisan vendor:publish

• 步骤4：将 .env.example 重命名为 .env 并设置您的数据库凭据

• 步骤5：在终端中运行此命令 php artisan key:generate

• 步骤6：在 /database/seeds/DatabaseSeeder.php 中添加以下行

    $this->call('CountryTableSeeder');
    $this->call('ProvincesTableSeeder');
    $this->call('CitiesTableSeeder');
    $this->call('BarangayTableSeeder');

• 步骤7：在终端中运行此命令 composer dump-autoload && php artisan migrate --seed && php artisan serve

• 步骤8：转到 http://localhost:8000/api/v1/country

• 享受！

端点

• /api/v1/country - 列出所有国家

• /api/v1/country/{country_id} - 国家详情（PH是id:169）

• /api/v1/country/{country_id}/province - 列出国家的所有省份（目前为PH）

• /api/v1/country/{country_id}/province/{province_id} - 省份详情

• /api/v1/country/{country_id}/province/{province_id}/city - 省份的城市（和镇）

• /api/v1/country/{country_id}/province/{province_id}/city/{city_id} - 城市详情

• /api/v1/country/{country_id}/province/{province_id}/city/{city_id}/barangay - 列出城市的所有村（或镇）

未来

• 逆向查找 - 给出 city_id 并显示省份和该国等。

• 404 异常处理

致谢

• Oj Tibi 在 PH Provinces and Cities 上提供了数据。

• Eacomm 在 PH Barangays 上 - 提供了菲律宾村庄列表。

免责声明

数据免费提供，任何人都可以自行承担风险使用。数据按原样提供。虽然我会努力保持数据更新，但我并不声称这是一个全面的列表，某些数据可能已过时或缺失。我不会对数据中发现的任何不准确或错误承担责任。我对最终用户的最终数据使用和由此可能造成的数据损失不承担责任。