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. [Utility & Helpers](/categories/utility)
4. /
5. businessprocess/geo-service-sdk

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

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

Geo service sdk for php

v1.3.1(10mo ago)16.3k11MITPHPPHP ^7.4|^8.0

Since Mar 16Pushed 10mo 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 3w 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

41

—

FairBetter than 87% of packages

Maintenance54

Moderate activity, may be stable

Popularity25

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity59

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

315d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/2129435?v=4)[KAA87](/maintainers/KAA87)[@KAA87](https://github.com/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.

2.0k496.1k33](/packages/neuron-core-neuron-ai)[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3661.2M46](/packages/tencentcloud-tencentcloud-sdk-php)[civicrm/civicrm-core

Open source constituent relationship management for non-profits, NGOs and advocacy organizations.

749284.3k35](/packages/civicrm-civicrm-core)[roundcube/roundcubemail

The Roundcube Webmail suite

7.0k1.4k3](/packages/roundcube-roundcubemail)[spatie/laravel-export

Create a static site bundle from a Laravel app

672139.5k6](/packages/spatie-laravel-export)[nfse-nacional/nfse-php

This is my package nfse

1523.1k](/packages/nfse-nacional-nfse-php)

PHPackages © 2026

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