sukohi / laravel-jp-postal-code

一个Laravel包,允许您通过日本邮政编码搜索地址。

1.0.1 2019-12-10 11:03 UTC

This package is auto-updated.

Last update: 2024-09-10 21:25:57 UTC


README

一个Laravel包,允许您通过日本邮政编码搜索地址。
(此包在Laravel 5.7下维护。)

安装

运行以下命令。

composer require sukohi/laravel-jp-postal-code:1.*

准备

迁移文件将自动加载。
所以只需运行此命令。

php artisan migrate

然后点击“全国一括”下载下面的“ken_all.zip”。

以小写字母表示促音和拗音的假名数据

解压后,将csv文件放置在/storage/app/csv/KEN_ALL.CSV中。

现在开始导入邮政数据。
运行此命令。

php artisan import:jp-postal-code

注意: 导入需要时间,因为csv文件有超过120,000行。

配置

如果您想进行配置,发布jp_postal_code.php

php artisan vendor:publish --provider="Sukohi\LaravelJpPostalCode\LaravelJpPostalCodeServiceProvider"

现在您在/config文件夹中有jp_postal_code.php

端点

这是提供地址搜索功能的URL。
因此,您可以通过Ajax搜索以下日本地址。

  1. /api/jp_postal_code?code=131-0045
  2. /api/jp_postal_code?first_code=131&last_code=0045

多字节字符如“1310045”也可用。

[响应示例]

{
    address: "押上"
    city: "墨田区"
    first_code: "131"
    full_address: "〒131-0045 東京都墨田区押上"
    full_code: "131-0045"
    id: 39342
    last_code: "0045"
    prefecture: "東京都"
}
  • 您可以在/config/jp_postal_code.php中更改full_addressfull_code的格式。

import_path

"KEN_ALL.CSV"的路径。

address_format

检索地址时full_address的格式。

postal_code_format

检索地址时full_code的格式。

许可证

此包在MIT许可证下授权。版权所有2019 Sukohi Kuhoh