Weave Code
Trgeozones Laravel Package
epigra/trgeozones
Laravel package for Turkey's administrative geography. It provides migrations, Eloquent models, and ready-to-use seed data for provinces, districts, and neighborhoods, helping you add address selection, location filters, and region-based features to your app quickly.
Ülkeler ve Türkiye İl İlçe Semt Mahalle ve Posta Kodu Veritabanı (Laravel)
Frequently asked questions about Trgeozones
- How do I install epigra/trgeozones in a Laravel application?
- Install it with Composer using composer require epigra/trgeozones. Then run the package's migrations and seeders as documented in the README, typically php artisan migrate --seed or vendor publish followed by migrate and db:seed. Check the README for exact publish tags and seeder class names.
- Does epigra/trgeozones provide Eloquent models and relationships for provinces, districts, and neighborhoods?
- According to the package description, it ships Eloquent models alongside migrations and seed data, so you can query provinces, districts, and neighborhoods through Laravel relationships. Confirm the exact model names and foreign keys in the README, because the overview does not detail every relationship.
- Which Laravel and PHP versions does epigra/trgeozones support?
- The provided overview does not list supported Laravel or PHP versions. Inspect composer.json for illuminate/support and php constraints, and test on your Laravel 9, 10, or 11 line before committing. A broad constraint is not a substitute for an integration test.
- What seed data is included for Turkey's administrative geography?
- The package is described as seed data for provinces (il), districts (ilçe), neighborhoods (semt/mahalle), and postal codes. Verify whether semt, muhit, mahalle, and posta kodu are separate tables or combined fields in the schema. This matters when mapping the package to your address forms.
- How do I create cascading province, district, and neighborhood selects with epigra/trgeozones?
- Install and seed the package, then build cascading selects that query districts by province_id and neighborhoods by district_id. Map the package IDs to your address columns using foreign keys rather than replacing your existing address model. The UI wiring is the main integration work, so design the response format for your frontend early.
- Is the Turkey address data in epigra/trgeozones current and what is its source?
- The overview does not state the dataset source or last refresh date, so treat data currency as a key due diligence item. Check the README and repository for references to PTT postal codes, Interior Ministry or e-Devlet administrative units, and a documented refresh process. Turkish districts, neighborhoods, and postal codes change over time, so plan how you will update the snapshot.
- Does epigra/trgeozones support MySQL, PostgreSQL, and Turkish characters correctly?
- The overview does not state supported database engines, so verify the migrations against MySQL/MariaDB and PostgreSQL before relying on them. Turkish characters require utf8mb4 and Turkish-aware collation or normalization; confirm the schema and seeders handle ı/İ, ş, ğ, ç, ö, and ü correctly. Test search and sort behavior in your target database.
- How large are the migrations and seeders, and will they slow down CI or fresh installs?
- The full hierarchy is large: roughly 81 provinces, about 970 districts, and tens of thousands of neighborhoods and postal codes. Seeder runtime and migration size can affect CI and fresh-install workflows, so measure them in your pipeline. Consider seeding only in development or using a prebuilt dump for production.
- Can I use epigra/trgeozones with my existing address tables in an e-commerce or KYC flow?
- Yes, that is the primary use case: address selection, delivery, onboarding, and location filters for Turkish users. The data-centric package should compose with existing address tables via foreign keys, but you must design the mapping yourself because there is no large public reference implementation. Keep your own address entity and reference the package's province, district, and neighborhood IDs.
- Are there tests and data integrity checks, and how actively is epigra/trgeozones maintained?
- The overview does not confirm test coverage or data integrity checks; look for tests that verify all provinces exist and there are no orphan districts or neighborhoods. Maintenance signals are small, with 91 stars and zero dependents, so pin the version and plan to own dataset refreshes. For critical address data, keep a fallback path and validate seed data in your own test suite.
Weaver
How can I help you explore Laravel packages today?