包简介

Help Thailand developer for address database

README 文档

README

Provide Thailand geographic database like provinces, districts, sub-districts and generate api route for you application.

Features

Thailand provinces, district, sub district and postal codes database.
REST API Routes.
Support UUID (Set in config file).

Roadmap

Add English Name
Add Latitude & Longitude Information
Add Address Extractor

Requirement

PHP 7.1 - 8.1
Laravel 7.0 - 9.0

Installation

Install Laravel Thai Address with Composer

composer require topkstt/laravel-thai-address

Publishing package config file

php artisan vendor:publish --provider="TopKSTT\ThaiAddress\ThaiAddressServiceProvider" --tag="config"

Publishing package migration file & migrate database

php artisan vendor:publish --provider="TopKSTT\ThaiAddress\ThaiAddressServiceProvider" --tag="migrations"
php artisan migrate

Publishing package migration seeder & seed database

php artisan vendor:publish --provider="TopKSTT\ThaiAddress\ThaiAddressServiceProvider" --tag="seeders"
php artisan db:seed --class=ThaiAddressTablesSeeder

API Reference

Please enabled API config in thai_address.php config file before call API endpoint.
Please set prefix API route in thai_address.php config file before call API endpoint.
Postman Collection -> Click here

Province

Get all province

  GET /api/{YOUR_PREFIX_IF_SET}/province/all

Parameter	Type	Description
`with_all`	`boolean`	Optional. Include postal_code, sub_district, district to result.

Get province by ID

  GET /api/{YOUR_PREFIX_IF_SET}/province/${id}

Parameter	Type	Description
`with_all`	`boolean`	Optional. Include postal_code, sub_district, district to result.

Search province by name

  GET /api/{YOUR_PREFIX_IF_SET}/province/search/${id}

Parameter	Type	Description
`with_all`	`boolean`	Optional. Include postal_code, sub_district, district to result.

District

Get all district

  GET /api/{YOUR_PREFIX_IF_SET}/district/all

Parameter	Type	Description
`with_province`	`boolean`	Optional. Include province to result.
`with_sub_district`	`boolean`	Optional. Include sub district to result.

Get district by ID

  GET /api/{YOUR_PREFIX_IF_SET}/district/${id}

Parameter	Type	Description
`with_province`	`boolean`	Optional. Include province to result.
`with_sub_district`	`boolean`	Optional. Include sub district to result.

Search district by name

  GET /api/{YOUR_PREFIX_IF_SET}/district/search/${id}

Parameter	Type	Description
`with_province`	`boolean`	Optional. Include province to result.
`with_sub_district`	`boolean`	Optional. Include sub district to result.

Sub District

Get all sub district

  GET /api/{YOUR_PREFIX_IF_SET}/sub-district/all

Parameter	Type	Description
`with_district`	`boolean`	Optional. Include district to result.
`with_postal_code`	`boolean`	Optional. Include postal code to result.

Get sub district by ID

  GET /api/{YOUR_PREFIX_IF_SET}/sub-district/${id}

Parameter	Type	Description
`with_district`	`boolean`	Optional. Include district to result.
`with_postal_code`	`boolean`	Optional. Include postal code to result.

Search sub district by name

  GET /api/{YOUR_PREFIX_IF_SET}/sub-district/search/${id}

Parameter	Type	Description
`with_district`	`boolean`	Optional. Include district to result.
`with_postal_code`	`boolean`	Optional. Include postal code to result.

Postal Code

Get all postal code

  GET /api/{YOUR_PREFIX_IF_SET}/postal-code/all

Parameter	Type	Description
`with_district`	`boolean`	Optional. Include district to result.
`with_sub_district`	`boolean`	Optional. Include sub district to result.
`with_province`	`boolean`	Optional. Include province to result.

Get postal code by ID

  GET /api/{YOUR_PREFIX_IF_SET}/postal-code/${id}

Parameter	Type	Description
`with_district`	`boolean`	Optional. Include district to result.
`with_sub_district`	`boolean`	Optional. Include sub district to result.
`with_province`	`boolean`	Optional. Include province to result.

Search postal code by name

  GET /api/{YOUR_PREFIX_IF_SET}/postal-code/search/${id}

Parameter	Type	Description
`with_district`	`boolean`	Optional. Include district to result.
`with_sub_district`	`boolean`	Optional. Include sub district to result.
`with_province`	`boolean`	Optional. Include province to result.

topkstt/laravel-thai-address 适用场景与选型建议

topkstt/laravel-thai-address 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 2.19k 次下载、GitHub Stars 达 2，最近一次更新时间为 2022 年 11 月 05 日，在 PHP 生态内属于活跃度较高的组件。

我们在过去多个企业项目中使用过 topkstt/laravel-thai-address 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 topkstt/laravel-thai-address 我们能提供哪些服务？

定制开发 / 二次开发

基于 topkstt/laravel-thai-address 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

topkstt/laravel-thai-address

包简介