PHPackages                             juicecrm/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. juicecrm/geodata

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

juicecrm/geodata
================

Geographical Data for Laravel 10 and later

v1.3.1(2y ago)0103GPL-3.0-onlyPHPPHP ^8.1||^8.2

Since Mar 4Pushed 2y ago1 watchersCompare

[ Source](https://github.com/juicecrm/geodata)[ Packagist](https://packagist.org/packages/juicecrm/geodata)[ RSS](/packages/juicecrm-geodata/feed)WikiDiscussions main Synced today

READMEChangelog (10)Dependencies (10)Versions (15)Used By (0)

Geographical Data for Laravel
=============================

[](#geographical-data-for-laravel)

[![version](https://camo.githubusercontent.com/8f77c0b45f8c0a6b85fbc523fd64f83ca4ccaf15a605929a381d1b882bd2d8e4/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6a7569636563726d2f67656f64617461)](https://camo.githubusercontent.com/8f77c0b45f8c0a6b85fbc523fd64f83ca4ccaf15a605929a381d1b882bd2d8e4/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6a7569636563726d2f67656f64617461)

Store geographical data, and make it available via Laravel 10 Models.

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

[](#installation)

```
composer require "juicecrm/geodata" "^1.0"
```

Usage
-----

[](#usage)

At first you may need to run migrations. The generated tables have no prefix by default. See the [Customizations](#customizations) section below.

The initial setup of the data is accomplished by running the following commands

```
php artisan migrate
php artisan geodata:retrieve
php artisan geodata:extract
php artisan geodata:store
```

You can also use `php artisan geodata:refresh`. This will run the above three geodata artisan commands in succession for you.

### Customizations

[](#customizations)

If you want to prefix the table names, so that you can make a distinction in your own data model between JuiceCRM GeoData Country models vs your own models, you change the GeoData configuration. In order to so, you will need to publish the configuration file.

```
php artisan vendor:publish --provider="JuiceCRM\\GeoData\\GeoDataServiceProvider" --tag=config
```

This will create a geodata.php file in the config directory of your project. In that file, you'll find a setting `table_prefix` that you can update to your liking.

Testing
-------

[](#testing)

The package will have tests where it is deemed necessary.

Changelog
---------

[](#changelog)

There is a [Changelog.md](./Changelog.md) file that lists all the changes made since version 1.0.0.

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

[](#contributing)

Anybody can contribute anything to this software. Feel free to participate. Please be mindful to have an overall pleasant demeanor and be polite to your co-contributors. Exsessive rude or impolite behavior will not be tolerated.

Credits
-------

[](#credits)

- Antonio Carlos Ribeiro, whose [countries](https://github.com/antonioribeiro/countries) package provided much of the underlying data knowledge.
- Guus Leeuw (aka [PHPGuus](https://twitter.com/PHPGuus)) as maintainer of this package.

License
-------

[](#license)

This software is protected by the [GPLv3 License](./LICENSE).

###  Health Score

29

—

LowBetter than 57% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity66

Established project with proven stability

 Bus Factor1

Top contributor holds 90% 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

Every ~13 days

Recently: every ~24 days

Total

13

Last Release

1055d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/bf22cfdf29726845798b02556196f50c8e1dc2c75a1f1d05e46b9da728cb8a41?d=identicon)[JuiceCrmWorks](/maintainers/JuiceCrmWorks)

---

Top Contributors

[![PHPGuus](https://avatars.githubusercontent.com/u/36767653?v=4)](https://github.com/PHPGuus "PHPGuus (54 commits)")[![JuiceCRMWorks](https://avatars.githubusercontent.com/u/125727907?v=4)](https://github.com/JuiceCRMWorks "JuiceCRMWorks (6 commits)")

###  Code Quality

TestsPHPUnit

Code StyleLaravel Pint

### Embed Badge

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

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

###  Alternatives

[osm/sitemap-php

Fast and lightweight library for generating Google sitemap XML files and index of sitemaps

30413.3k](/packages/osm-sitemap-php)[loadsys/cakephp_sitemap

A CakePHP Plugin for adding automatic XML and HTML Sitemaps to an app

2819.6k](/packages/loadsys-cakephp-sitemap)[pyyoshi/shortuuid-php

2226.2k](/packages/pyyoshi-shortuuid-php)

PHPackages © 2026

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