PHPackages                             businessprocess/geo-service-sdk - 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. businessprocess/geo-service-sdk

ActiveLibrary

businessprocess/geo-service-sdk
===============================

Geo service sdk for php

v1.3.1(9mo ago)16.0k↓100%11MITPHPPHP ^7.4|^8.0

Since Mar 16Pushed 9mo ago1 watchersCompare

[ Source](https://github.com/businessprocess/geo-service-sdk)[ Packagist](https://packagist.org/packages/businessprocess/geo-service-sdk)[ RSS](/packages/businessprocess-geo-service-sdk/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (4)Versions (20)Used By (1)

Geo Service PHP SDK
===================

[](#geo-service-php-sdk)

[![PHP 8.x](https://camo.githubusercontent.com/29e76b25f44fd19ba3a88f85f00b3ac7329ffd604075db0fbbeda87f6c794491/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d253545382e302d626c7565)](https://camo.githubusercontent.com/29e76b25f44fd19ba3a88f85f00b3ac7329ffd604075db0fbbeda87f6c794491/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d253545382e302d626c7565)[![Laravel 8.x](https://camo.githubusercontent.com/3c7441bb2ae21c31ca18ffa084e2fb51a956727722dbd18b850336439becc367/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d382e782d6f72616e67652e737667)](http://laravel.com)[![Yii 2.x](https://camo.githubusercontent.com/ff8999e0e5a1e46689cc5a19d1d0f07ffafaa842838a983a2c4469458a1defa8/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5969692d322e782d6f72616e6765)](https://www.yiiframework.com/doc/guide/2.0/ru)[![Latest Stable Version](https://camo.githubusercontent.com/ca4767cb4bfeb338c88d1732d4dd238070120148b9284e9148cf6492fb855528/68747470733a2f2f706f7365722e707567782e6f72672f627573696e65737370726f636573732f67656f2d736572766963652d73646b2f762f737461626c65)](https://packagist.org/packages/businessprocess/geo-service-sdk)[![Release date](https://camo.githubusercontent.com/7e192a0d577ca55987e38b9b07632af4a47a234abfd0bff92353f25f36f2121e/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652d646174652f627573696e65737370726f636573732f67656f2d736572766963652d73646b)](https://camo.githubusercontent.com/7e192a0d577ca55987e38b9b07632af4a47a234abfd0bff92353f25f36f2121e/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652d646174652f627573696e65737370726f636573732f67656f2d736572766963652d73646b)[![Release Version](https://camo.githubusercontent.com/104efb475edc862a16532f932a4a8cdf461f2c08530289a9e9bb21e101ff6be2/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f627573696e65737370726f636573732f67656f2d736572766963652d73646b)](https://camo.githubusercontent.com/104efb475edc862a16532f932a4a8cdf461f2c08530289a9e9bb21e101ff6be2/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f627573696e65737370726f636573732f67656f2d736572766963652d73646b)[![Total Downloads](https://camo.githubusercontent.com/38d5df7ae6b551badd0f4bfd0bbf3be3c666798581abccdb9379736f9bc56f57/68747470733a2f2f706f7365722e707567782e6f72672f627573696e65737370726f636573732f67656f2d736572766963652d73646b2f646f776e6c6f616473)](https://camo.githubusercontent.com/38d5df7ae6b551badd0f4bfd0bbf3be3c666798581abccdb9379736f9bc56f57/68747470733a2f2f706f7365722e707567782e6f72672f627573696e65737370726f636573732f67656f2d736572766963652d73646b2f646f776e6c6f616473)[![Pull requests](https://camo.githubusercontent.com/b9be5216cc4137f19d31a7a8829df062849dc50ae616c4096b2889c50d05047e/68747470733a2f2f696d672e736869656c64732e696f2f6269746275636b65742f70722f627573696e65737370726f636573732f67656f2d736572766963652d73646b)](https://camo.githubusercontent.com/b9be5216cc4137f19d31a7a8829df062849dc50ae616c4096b2889c50d05047e/68747470733a2f2f696d672e736869656c64732e696f2f6269746275636b65742f70722f627573696e65737370726f636573732f67656f2d736572766963652d73646b)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE)[![Stars](https://camo.githubusercontent.com/76b8712b661b50d86a035848468b309bf699d56e305a2c75a70013a7e1688bdc/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f627573696e65737370726f636573732f67656f2d736572766963652d73646b3f7374796c653d736f6369616c)](https://camo.githubusercontent.com/76b8712b661b50d86a035848468b309bf699d56e305a2c75a70013a7e1688bdc/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f627573696e65737370726f636573732f67656f2d736572766963652d73646b3f7374796c653d736f6369616c)

Geo Service SDK is a PSR-compatible PHP package for working with geo service api.

[API Documentation](https://geo-service.ooo.ua/api/v1/api-docs/)

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

[](#installation)

The recommended way to install Geo service is through [Composer](http://getcomposer.org).

```
# Install Composer
curl -sS https://getcomposer.org/installer | php
```

Next, run the Composer command to install the latest stable version of Guzzle:

```
composer require businessprocess/geo-service-sdk
```

After installing, you need to require Composer's autoloader:

```
require 'vendor/autoload.php';
```

You can then later update Guzzle using composer:

```
composer update
```

Usage
-----

[](#usage)

```
$client = new \GeoService\Service\GeoService();

// set locale if we need
$client->setLocale('en')

$response = $client->countries();

print $response->all(); # '[{"id": ...}'
```

Usage Laravel
-------------

[](#usage-laravel)

```
$response = \GeoService\Facade\Geo::setLocale('ru')->countries();

print $response->all(); # '[{"id": ...}'

$citiesAndTowns = \GeoService\Facade\Geo::getCitiesByCountry('r60199');

//get only cities, default city,town
$cities = \GeoService\Facade\Geo::getCitiesByCountry('r60199', 'city');
```

#### Available Methods

[](#available-methods)

MethodsDescriptionReturn valuegetCountryWithCitiesGet all countries with childrenCollectioncountriesGet all countries without detailsCollectioncountryGet country by idCountrygetCitiesByCountryGet cities by country idCollectiongetByIdGet model by idBaseModelgetChildByIdGet all children by parent idCollectiongetCountryByCodeGet country by codeCountrygetCitiesByCodeGet cities by country codeCollectionsearchGet all model by keywordCollectionpingPing nodebooleanaliveCheck is node is alivebooleanisServiceIdCheck is id belongs to geo serviceboolean

###  Health Score

42

—

FairBetter than 89% of packages

Maintenance62

Regular maintenance activity

Popularity24

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 92.9% 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 ~48 days

Recently: every ~169 days

Total

19

Last Release

270d ago

### Community

Maintainers

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

---

Top Contributors

[![maveriksEcho](https://avatars.githubusercontent.com/u/40034131?v=4)](https://github.com/maveriksEcho "maveriksEcho (26 commits)")[![YevgenChernoguboiv](https://avatars.githubusercontent.com/u/215498881?v=4)](https://github.com/YevgenChernoguboiv "YevgenChernoguboiv (1 commits)")[![yurik687](https://avatars.githubusercontent.com/u/34558510?v=4)](https://github.com/yurik687 "yurik687 (1 commits)")

###  Code Quality

TestsPHPUnit

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/businessprocess-geo-service-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/businessprocess-geo-service-sdk/health.svg)](https://phpackages.com/packages/businessprocess-geo-service-sdk)
```

###  Alternatives

[neuron-core/neuron-ai

The PHP Agentic Framework.

1.8k245.3k20](/packages/neuron-core-neuron-ai)[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3731.2M42](/packages/tencentcloud-tencentcloud-sdk-php)

PHPackages © 2026

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