PHPackages                             adlino/locations - 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 &amp; Helpers](/categories/utility)
4. /
5. adlino/locations

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

adlino/locations
================

Iran Provinces, Counties and Cities with a Google Map Location for Laravel.

0.0.1(7y ago)171.3k4MITPHPPHP &gt;=7.0.0

Since May 27Pushed 7y agoCompare

[ Source](https://github.com/teamadlino/locations)[ Packagist](https://packagist.org/packages/adlino/locations)[ RSS](/packages/adlino-locations/feed)WikiDiscussions master Synced 3d ago

READMEChangelog (1)DependenciesVersions (2)Used By (0)

Locations
=========

[](#locations)

[![License](https://camo.githubusercontent.com/b8b08178f60d312b036d3c7abe328196f3fec127a0cf8bb2098d089557b8b1bc/68747470733a2f2f706f7365722e707567782e6f72672f61646c696e6f2f6c6f636174696f6e732f6c6963656e7365)](https://packagist.org/packages/adlino/locations)[![Latest Stable Version](https://camo.githubusercontent.com/25924ee100543f4c41ce340a84edb258a612543ab4e5968fac4d4e08e7fd1937/68747470733a2f2f706f7365722e707567782e6f72672f61646c696e6f2f6c6f636174696f6e732f762f737461626c65)](https://packagist.org/packages/adlino/locations)[![Total Downloads](https://camo.githubusercontent.com/38034bfee2c5e6fa50729f9ed66393f30f5ca0812408b421a3b1bc4ec202e7f5/68747470733a2f2f706f7365722e707567782e6f72672f61646c696e6f2f6c6f636174696f6e732f646f776e6c6f616473)](https://packagist.org/packages/adlino/locations)

Iran Provinces, Counties and Cities with a Google Map Location for Laravel.

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

[](#installation)

```
composer require adlino/locations
```

Publish
-------

[](#publish)

```
php artisan vendor:publish --force --provider="Adlino\Locations\LocationsServiceProvider"
composer dump-autoload
php artisan locations:init
```

Usage
-----

[](#usage)

```
// get all provinces
$provinces = Locations::getAllProvinces(); // return approved provinces

// get all counties
$counties = Locations::getAllCounties(); // return approved counties

// get all cities
$cities = Locations::getAllCities(); // return approved cities

// get cities of province
$cities = $province->getCities();

// get counties of province
$counties = $province->getCounties();

// get area code of tehran province
$areaCode = $province->getAreaCode(); // 021
```

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity25

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 Bus Factor1

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

2910d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/3b38042bf7c09d7ac4d8733b02c1f7d2394400bf219ad7068571822a514caffc?d=identicon)[alirezahamedashki](/maintainers/alirezahamedashki)

---

Top Contributors

[![alirezahamedashki](https://avatars.githubusercontent.com/u/21022035?v=4)](https://github.com/alirezahamedashki "alirezahamedashki (97 commits)")[![samanmoghimi](https://avatars.githubusercontent.com/u/20923811?v=4)](https://github.com/samanmoghimi "samanmoghimi (2 commits)")

---

Tags

citiescountiesiranlaravellatitudelocationslongitudeprovinceslaravellatitudelongitudeirancitieslocationsprovincescounties

### Embed Badge

![Health badge](/badges/adlino-locations/health.svg)

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

###  Alternatives

[anthonymartin/geo-location

Powerful GeoCoding library: Retrieve bounding box coordinates, distances between geopoints, point in polygon, get longitude and latitude from addresses and more with GeoLocation for PHP

196949.5k5](/packages/anthonymartin-geo-location)[data-values/geo

Geographical value objects, parsers and formatters

20631.0k18](/packages/data-values-geo)[laravie/geotools

Geo-related tools PHP 7+ library

19105.4k1](/packages/laravie-geotools)[gerardojbaez/geodata

Laravel 5.2 package that provides basic geographical data like Countries, Regions and Cities.

3211.9k](/packages/gerardojbaez-geodata)[usamamuneerchaudhary/country-city-state

Country City State Data Provider for Laravel 12+

242.6k](/packages/usamamuneerchaudhary-country-city-state)

PHPackages © 2026

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