PHPackages                             matasarei/osm-client - 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. matasarei/osm-client

ActiveLibrary

matasarei/osm-client
====================

00PHPCI failing

Since Jan 2Pushed 6y ago1 watchersCompare

[ Source](https://github.com/matasarei/osm-client)[ Packagist](https://packagist.org/packages/matasarei/osm-client)[ RSS](/packages/matasarei-osm-client/feed)WikiDiscussions master Synced today

READMEChangelogDependenciesVersions (1)Used By (0)

Open Street Map Client
======================

[](#open-street-map-client)

An unofficial client for OSM services

Restrictions
------------

[](#restrictions)

By default the client using official search endpoint `https://nominatim.openstreetmap.org/search.php` which is allowed **only for developing or debugging purpose**!

You must [setup](http://nominatim.org/release-docs/latest/admin/Installation/) your own Nominatim service or use third-party providers if you going to use it on regular basis or for commercial:

```
$client = new \OsmClient\OsmClient();
$client->setSearchEndpoint('https://nominatim.3rd-party.server/search.php');
```

For more info please read [Nominatim Usage Policy](https://operations.osmfoundation.org/policies/nominatim/).

Usage example
-------------

[](#usage-example)

```
$client = new \OsmClient\OsmClient();
$client->setCountryIso('UA');
$result = $client->findOne('Kyiv, Independence Square');

var_dump($result);
```

Output:

```
array(12) {
  ["place_id"]=>
  int(252253866)
  ["licence"]=>
  string(71) "Data © OpenStreetMap contributors, ODbL 1.0. https://osm.org/copyright"
  ["osm_type"]=>
  string(8) "relation"
  ["osm_id"]=>
  int(9287875)
  ["boundingbox"]=>
  array(4) {
    [0]=>
    string(10) "50.4487372"
    [1]=>
    string(10) "50.4516909"
    [2]=>
    string(10) "30.5216409"
    [3]=>
    string(10) "30.5270455"
  }
  ["lat"]=>
  string(11) "50.45016285"
  ["lon"]=>
  string(16) "30.5241869112747"
  ["display_name"]=>
  string(176) "Майдан Незалежності, Хрещатик вулиця, Бегічевська Гора, Клов, Печерський район, Київ, 1001, Україна"
  ["class"]=>
  string(5) "place"
  ["type"]=>
  string(6) "square"
  ["importance"]=>
  float(0.468492664476)
  ["address"]=>
  array(9) {
    ["address29"]=>
    string(37) "Майдан Незалежності"
    ["road"]=>
    string(29) "Хрещатик вулиця"
    ["neighbourhood"]=>
    string(31) "Бегічевська Гора"
    ["suburb"]=>
    string(8) "Клов"
    ["county"]=>
    string(31) "Печерський район"
    ["city"]=>
    string(8) "Київ"
    ["postcode"]=>
    string(4) "1001"
    ["country"]=>
    string(14) "Україна"
    ["country_code"]=>
    string(2) "ua"
  }
}

```

###  Health Score

16

—

LowBetter than 5% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity0

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity34

Early-stage or recently created project

 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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/44632227efd38dd8598ceb71812e223865e994f1f35f027b423469133fb29d6b?d=identicon)[matasarei](/maintainers/matasarei)

---

Top Contributors

[![matasarei](https://avatars.githubusercontent.com/u/6638367?v=4)](https://github.com/matasarei "matasarei (1 commits)")

### Embed Badge

![Health badge](/badges/matasarei-osm-client/health.svg)

```
[![Health](https://phpackages.com/badges/matasarei-osm-client/health.svg)](https://phpackages.com/packages/matasarei-osm-client)
```

PHPackages © 2026

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