PHPackages                             papposilene/geodata - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. papposilene/geodata

ActiveLibrary[Utility & Helpers](/categories/utility)

papposilene/geodata
===================

A PHP package for countries, currencies & others little data

v1.0.0(4y ago)12061[2 PRs](https://github.com/papposilene/geodata/pulls)MITPHPPHP ^8.1

Since Mar 28Pushed 3y ago1 watchersCompare

[ Source](https://github.com/papposilene/geodata)[ Packagist](https://packagist.org/packages/papposilene/geodata)[ Docs](https://github.com/papposilene/geodata)[ RSS](/packages/papposilene-geodata/feed)WikiDiscussions main Synced 4d ago

READMEChangelog (1)Dependencies (5)Versions (6)Used By (0)

Geodata
=======

[](#geodata)

[geodata](https://github.com/papposilene/geodata) is a package that offers data about continents, countries, regions and cities.

Config folder
-------------

[](#config-folder)

The `config` folder contains a config file for Laravel.

Data Folder
-----------

[](#data-folder)

The `data` folder contains all the JSON files, with `countries`, `administrative-levels` (from 4 to 6), `cities`, `currencies`. A last folder, `flags`, contains the SVG-version of countries' flags.

Database folder
---------------

[](#database-folder)

The `database` folder contains a `migrations` and a `seeders` folders. The `migrations` one has the directives for creating some databases :

- `geodata__continents` ;
- `geodata__subcontients` ;
- `geodata__countries` ;
- `geodata__regions` ;
- `geodata__cities`.

The `seeders` files will hydrate the databases :

- `geodata__continents`: 6 rows ;
- `geodata__subcontients`: 23 rows ;
- `geodata__countries`: 250 rows ;
- `geodata__regions`: 44,524 rows ;
- `geodata__cities`: still counting...

All data folders, except the `countries` one, has its files subdivided by country.

Obviously, you are totally free to install and hydrate the databases and their data you need for your own project. :)

Installation
------------

[](#installation)

You can install the package via composer:

```
composer require papposilene/geodata
```

Usage
-----

[](#usage)

You can publish all the configuration and data in one line:

```
php artisan vendor:publish --provider="Papposilene\Geodata\GeodataServiceProvider"
```

### Testing

[](#testing)

```
composer test
```

### Changelog

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently.

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

### Security

[](#security)

If you discover any security related issues, please use the issue tracker.

Sources
-------

[](#sources)

This package uses some other open source packages and, until we don't build a better documentation, you can find some more info about data on [antonioribeiro/countries](https://github.com/antonioribeiro/countries/blob/master/README.md) and [mledoze/countries](https://github.com/mledoze/countries/blob/master/README.md).

Please check the copyright section for a complete list of packages used by this one.

Credits
-------

[](#credits)

- [Philippe-Alexandre Pierre](https://github.com/papposilene)
- [Antonio Carlos Ribeiro](https://github.com/antonioribeiro)
- [Mohammed Le Doze](https://github.com/mledoze)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

PHP Package Boilerplate
-----------------------

[](#php-package-boilerplate)

This package was generated using the [PHP Package Boilerplate](https://laravelpackageboilerplate.com) by [Beyond Code](http://beyondco.de/).

###  Health Score

29

—

LowBetter than 59% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity14

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity61

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

1508d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/9886af24729844269e030093c03b4cfcc726b89bf41a8288cdac9392ba81b7a4?d=identicon)[papposilene](/maintainers/papposilene)

---

Top Contributors

[![papposilene](https://avatars.githubusercontent.com/u/7879360?v=4)](https://github.com/papposilene "papposilene (226 commits)")

---

Tags

geodatageolocationlaravel-packagelaravel9packagecurrencycountriesflagsflaggeometrycountrycityworldcurrenciestimezonesearthcitiestopologyborderscontinentgeodatacontinentssubcontinentsubcontinents

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/papposilene-geodata/health.svg)

```
[![Health](https://phpackages.com/badges/papposilene-geodata/health.svg)](https://phpackages.com/packages/papposilene-geodata)
```

###  Alternatives

[pragmarx/countries

PHP Countries and Currencies

1.9k3.3M18](/packages/pragmarx-countries)[pragmarx/countries-laravel

Countries for Laravel

1471.1M2](/packages/pragmarx-countries-laravel)[rinvex/countries

Rinvex Countries is a simple and lightweight package for retrieving country details with flexibility. A whole bunch of data including name, demonym, capital, iso codes, dialling codes, geo data, currencies, flags, emoji, and other attributes for all 250 countries worldwide at your fingertips.

1.7k7.4M48](/packages/rinvex-countries)[dipeshsukhia/laravel-country-state-city-data

Country State City Data Provider

8230.8k](/packages/dipeshsukhia-laravel-country-state-city-data)[juanparati/iso-codes

A PHP library that provides ISO codes, currencies, languages, timezones and additional geopolitical information

17146.4k](/packages/juanparati-iso-codes)[io238/laravel-iso-countries

Ready-to-use Laravel models and relations for country (ISO 3166), language (ISO 639-1), and currency (ISO 4217) information with multi-language support.

5462.3k](/packages/io238-laravel-iso-countries)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)